CSV-Bestelldokumente
Diese Seite beschreibt die CSV-Dateien, die STREAM Cloud für freigegebene Warenkörbe versendet, wenn eine Lieferstelle das CSV-Format verwendet (siehe Lieferstellen). Sie richtet sich an alle, die diese Dateien in ein ERP-, Materialwirtschafts- oder Shopsystem einlesen.
Zustellung
Die CSV-Dateien hängen an denselben E-Mails, die sonst die PDF-Dokumente enthalten. Jeder freigegebene Warenkorb erzeugt bis zu zwei Dateien, eine pro Dokumenttyp:
| Dokumenttyp | Dateiname (Deutsch / Englisch) | Inhalt |
|---|---|---|
stocked | Kommissionierbeleg_<MOYACODE>.csv / Picking-List_<MOYACODE>.csv | Lagerartikel |
order_only | Bestellliste_<MOYACODE>.csv / Order-List_<MOYACODE>.csv | Bestellartikel und Freitextpositionen |
Die Sprache des Dateinamens richtet sich nach der Sprache der Organisation. Eine Datei wird nur versendet, wenn der Warenkorb Positionen dieses Typs enthält.
Dateiformat
- Kodierung: UTF-8 mit Byte Order Mark (BOM).
- Trennzeichen: Semikolon (
;). - Zeilenende: CRLF. Zeilenumbrüche innerhalb einer Zelle in Anführungszeichen werden ebenfalls als CRLF geschrieben.
- Quoting: RFC 4180. Zellen, die
;,"oder Zeilenumbrüche enthalten, stehen in doppelten Anführungszeichen; Anführungszeichen innerhalb einer Zelle werden verdoppelt. - Die erste Zeile ist eine Kopfzeile mit den Spaltennamen.
- Jede weitere Zeile ist eine Position. Die Angaben zum Warenkorb (MOYACODE, Freigebende Person, Codes) wiederholen sich in jeder Zeile.
Spalten
Die Spaltennamen sind in allen Sprachen englisch.
| Spalte | Typ | Beispiel | Beschreibung |
|---|---|---|---|
position | Zahl | 1 | Position im Dokument, sortiert nach Lagerort. Entspricht der Position im PDF. |
moyacode | Text | AB12CD | Eindeutiger Code des Warenkorbs. |
document_type | Text | stocked | stocked oder order_only. |
approved_at | Datum | 2026-10-08T14:30:00+02:00 | Zeitpunkt der Freigabe, ISO 8601 mit Offset, in der Zeitzone der Organisation. |
approver | Text | Erika Mustermann | Name der Person, die den Warenkorb freigegeben hat. |
location_code | Text | KH1 | Code des Standorts. |
unit_code | Text | ZL | Code der Lieferstelle. |
supply_area_code | Text | STA3 | Code des anfordernden Versorgungsbereichs. |
product_id | Text | 100200 | Artikelnummer aus Ihrem ERP. Leer bei Freitextpositionen. |
product_ref | Text | REF-1 | Hersteller- oder Lieferantenreferenz. Leer bei Freitextpositionen. |
product_name | Text | Spritze 5 ml | Artikelname oder Text der Freitextposition. |
quantity | Zahl | 3 | Bestellmenge in Verpackungseinheiten. |
packages | Zahl | 1 | Anzahl Packungen pro Verpackungseinheit. Leer bei Freitextpositionen. |
package_descriptor | Text | PK | Bezeichnung der Packung. Leer bei Freitextpositionen. |
items_per | Zahl | 100 | Anzahl Stück pro Packung. Leer bei Freitextpositionen. |
item_descriptor | Text | Stk | Bezeichnung der Stückeinheit. Leer bei Freitextpositionen. |
storage_path | Text | A-01 | Lagerort der Position. Leer bei Freitextpositionen. |
Die Verpackungsspalten beschreiben zusammen die Verpackungseinheit, zum Beispiel
1 PK á 100 Stk. Bei einer quantity von 3 werden drei solche
Verpackungseinheiten bestellt.
Schutz vor Formeln
Damit Tabellenkalkulationen Zellinhalte nicht als Formeln ausführen, erhalten
Textzellen, die mit =, +, -, @, einem Tabulator oder einem Wagenrücklauf
beginnen, einen vorangestellten Apostroph ('). Wenn Ihr Import solche Werte
verarbeitet, entfernen Sie den führenden Apostroph.
Regeln für den Import
- Duplikate über
moyacodeunddocument_typeerkennen. In seltenen Fällen, etwa wenn eine Freigabe wiederholt wird, kann dasselbe Dokument mehrfach versendet werden. - Spalten über ihren Namen lesen, nicht über Position oder Anzahl. In künftigen Versionen können am Ende neue Spalten hinzukommen. Bestehende Spalten werden nie umbenannt, umsortiert oder entfernt.
- Leere Werte erwarten in den Artikel- und Verpackungsspalten von Freitextpositionen.
Beispiel
position;moyacode;document_type;approved_at;approver;location_code;unit_code;supply_area_code;product_id;product_ref;product_name;quantity;packages;package_descriptor;items_per;item_descriptor;storage_path
1;AB12CD;order_only;2026-10-08T14:30:00+02:00;Erika Mustermann;KH1;ZL;STA3;100200;REF-1;"Spritze 5 ml; steril";3;1;PK;100;Stk;A-01
2;AB12CD;order_only;2026-10-08T14:30:00+02:00;Erika Mustermann;KH1;ZL;STA3;;;Bleistifte;1;;;;;