Skip to main content

CSV Order Documents

This page describes the CSV files that STREAM Cloud sends for approved carts when a fulfillment unit uses the CSV order document format (see Fulfillment Units). It is intended for anyone who imports these files into an ERP, materials management or shop system.

Delivery​

The CSV files are attached to the same emails as the PDF documents would be. Each approved cart produces up to two files, one per document type:

Document typeFile name (German / English)Contents
stockedKommissionierbeleg_<MOYACODE>.csv / Picking-List_<MOYACODE>.csvStocked items
order_onlyBestellliste_<MOYACODE>.csv / Order-List_<MOYACODE>.csvOrder-only items and free text positions

The file name language follows the organization's language. A file is only sent if the cart contains items of that type.

File Format​

  • Encoding: UTF-8 with byte order mark (BOM).
  • Delimiter: semicolon (;).
  • Line endings: CRLF. Line breaks inside a quoted cell are also written as CRLF.
  • Quoting: RFC 4180. Cells that contain ;, " or line breaks are enclosed in double quotes; double quotes inside a cell are doubled.
  • The first row is a header row with the column names.
  • Each following row is one line item. The cart information (MOYACODE, approver, codes) is repeated on every row.

Columns​

ColumnTypeExampleDescription
positionInteger1Position in the document, sorted by storage path. Matches the position in the PDF.
moyacodeTextAB12CDUnique code of the cart.
document_typeTextstockedstocked or order_only.
approved_atDate2026-10-08T14:30:00+02:00Time of approval, ISO 8601 with offset, in the organization's time zone.
approverTextJane DoeName of the user who approved the cart.
location_codeTextKH1Code of the location.
unit_codeTextZLCode of the fulfillment unit.
supply_area_codeTextSTA3Code of the supply area that placed the order.
product_idText100200Article number from your ERP. Empty for free text positions.
product_refTextREF-1Manufacturer or supplier reference. Empty for free text positions.
product_nameTextSyringe 5 mlProduct name, or the text of a free text position.
quantityInteger3Ordered quantity in packaging units.
packagesInteger1Number of packages per packaging unit. Empty for free text positions.
package_descriptorTextPKPackage designation. Empty for free text positions.
items_perInteger100Number of items per package. Empty for free text positions.
item_descriptorTextpcsItem designation. Empty for free text positions.
storage_pathTextA-01Storage location of the item. Empty for free text positions.

The packaging columns together describe the packaging unit, for example 1 PK of 100 pcs. With a quantity of 3, three such packaging units are ordered.

Protection Against Formulas​

To prevent spreadsheet programs from executing cell contents as formulas, text cells that start with =, +, -, @, a tab or a carriage return are prefixed with an apostrophe ('). If your import processes such values, remove the leading apostrophe.

Rules for Importers​

  • Deduplicate on moyacode and document_type. In rare cases, for example when an approval is retried, the same document can be sent more than once.
  • Read columns by name, not by position or count. New columns may be added at the end in future versions. Existing columns are never renamed, reordered or removed.
  • Expect empty values in the product and packaging columns for free text positions.

Example​

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;Jane Doe;KH1;ZL;STA3;100200;REF-1;"Syringe 5 ml; sterile";3;1;PK;100;pcs;A-01
2;AB12CD;order_only;2026-10-08T14:30:00+02:00;Jane Doe;KH1;ZL;STA3;;;Pencils;1;;;;;