Bestellungen (Orders)
Für Bestellungen gibt es diese Standardformate: Workist XML (Standard), SAP IDoc ORDERS05, openTRANS 2.1, cXML OrderRequest und ANSI X12 850. Formate wie EDIFACT, EDX, proALPHA oder Excel baut Workist auf Anfrage, siehe Individuelle Formate auf Anfrage.
Alle Beispiele auf dieser Seite wurden mit den Workist-Serialisierern aus denselben Beispieldaten erzeugt. Allgemeine Regeln zu Dateinamen, Datums- und Zahlenformaten finden Sie in der Übersicht.
Workist XML
Dateiendung: .xml
Dateiname: <ID>.xml
Das Standardformat für Bestellungen. Die Datei hat vier Bereiche:
General: Kopfdaten der BestellungInvoicing: RechnungsadresseShipping: Lieferadresse und LiefertermineLine: ein Element je Position
Welche Elemente erscheinen, hängt von den Kopf- und Positionsfeldern Ihres Kanals ab. Leere Felder lässt Workist weg. Datumsangaben haben das Format JJJJ-MM-TT. Dezimalzahlen stehen standardmäßig mit Dezimalkomma und ohne abschließende Nullen in der Datei (1487,5).
Vollständiges Beispiel
<?xml version="1.0" encoding="utf-8"?>
<Order_v1>
<General>
<Sell_to_Customer>
<Customer_Number>CUST-12345</Customer_Number>
<Name>Acme Corporation</Name>
<Contact_Number>CP-001</Contact_Number>
<Contact>Max Mustermann</Contact>
<Contact_Email>max@acme.de</Contact_Email>
<Contact_Phone>+49 89 12345678</Contact_Phone>
<Country>DE</Country>
<Country_Subdivision>BY</Country_Subdivision>
<Customer_Type>regular</Customer_Type>
</Sell_to_Customer>
<Dispatch_Contact>
<Contact_Number>CP-007</Contact_Number>
<Contact>Erika Versand</Contact>
<Contact_Email>shipping@acme.de</Contact_Email>
<Contact_Phone>+49 89 12345679</Contact_Phone>
</Dispatch_Contact>
<Order_Date>2025-03-15</Order_Date>
<VAT_Registration_Number>DE123456789</VAT_Registration_Number>
<Customer_Order_Number>PO-2025-0001</Customer_Order_Number>
<Quote_Reference_Number>QT-2025-100</Quote_Reference_Number>
<Project_Number>PRJ-500</Project_Number>
<Distribution_Channel>10</Distribution_Channel>
<Order_Type>standard</Order_Type>
<Delivery_Terms>DDP</Delivery_Terms>
<Shipping_Terms>express</Shipping_Terms>
<Payment_Terms>net 30</Payment_Terms>
<Total_Amount_Net>1250</Total_Amount_Net>
<Total_Amount>1487,5</Total_Amount>
<Framework_Contract_Number>FC-2025-200</Framework_Contract_Number>
<Goods_Receiving_Time>08:00-16:00</Goods_Receiving_Time>
<Info_Text>Please deliver to loading dock B. Handle with care - fragile items, do</Info_Text>
<Info_Text>not stack pallets.</Info_Text>
<Commission_Number>COM-999</Commission_Number>
<Incoterm>DAP</Incoterm>
<Delivery_Unload_Method>forklift</Delivery_Unload_Method>
<External_Document_Link>9f8c2b7e-4d1a-4c3e-9b6f-2a7d5e1c0b34.pdf</External_Document_Link>
<Workist_URL>https://wb.workist.com/orders/3f2b8c1e-5a7d-4e19-8c2f-6b0d9a4e7c15</Workist_URL>
<Received_By>max@acme.de</Received_By>
<ERP_Locked>false</ERP_Locked>
<Additional_Files>
<Additional_File>
<File_Name>9f8c2b7e-4d1a-4c3e-9b6f-2a7d5e1c0b34_file_1.pdf</File_Name>
<Classification>DELIVERY_NOTE</Classification>
<File_Name_Original>delivery-schedule.pdf</File_Name_Original>
</Additional_File>
</Additional_Files>
</General>
<Invoicing>
<Bill_to_Customer>
<Code>BILL-001</Code>
<Name>Accounts Payable</Name>
<Additional_Name_Info>Acme Corporation GmbH</Additional_Name_Info>
<Address>Billing Strasse 10</Address>
<Additional_Address_Info>Building C, 3rd Floor</Additional_Address_Info>
<City>Munich</City>
<Post_Code>80331</Post_Code>
<Country>DE</Country>
<Country_Subdivision>BY</Country_Subdivision>
<Phone>+49 89 11111111</Phone>
<Email>billing@acme.de</Email>
</Bill_to_Customer>
</Invoicing>
<Shipping>
<Ship_to_Customer>
<Code>SHIP-002</Code>
<Name>Warehouse Team</Name>
<Additional_Name_Info>Acme Corporation GmbH</Additional_Name_Info>
<Address>Lager Strasse 5</Address>
<Additional_Address_Info>Gate 3</Additional_Address_Info>
<City>Hamburg</City>
<Post_Code>20095</Post_Code>
<Country>DE</Country>
<Country_Subdivision>HH</Country_Subdivision>
<Phone>+49 40 22222222</Phone>
<Email>warehouse@acme.de</Email>
</Ship_to_Customer>
<Expected_Delivery_Date>2025-04-01</Expected_Delivery_Date>
<Expected_Delivery_End_Date>2025-04-05</Expected_Delivery_End_Date>
<Expected_Delivery_Time_From>08:00</Expected_Delivery_Time_From>
<Expected_Delivery_Time_Until>16:00</Expected_Delivery_Time_Until>
<Goods_Issue_Date>2025-03-28</Goods_Issue_Date>
</Shipping>
<Line>
<Batch_Number>LOT-2025-A</Batch_Number>
<Description>Industrial Sensor Module Type A</Description>
<Unit_of_Measure>PCE</Unit_of_Measure>
<Quantity>100</Quantity>
<Unit_Price>12,5</Unit_Price>
<Price_Unit>1</Price_Unit>
<Total_Price>1250</Total_Price>
<Line_Discount_Percent>5</Line_Discount_Percent>
<Line_Discount_Amount>62,5</Line_Discount_Amount>
<Item_Variant>blue</Item_Variant>
<Common_Item_Number>ART-001-A</Common_Item_Number>
<Common_Item_Number_2>ART-001-A-ALT</Common_Item_Number_2>
<Common_Item_Number_3>4006381333931</Common_Item_Number_3>
<Customer_Item_Number>CUST-ART-555</Customer_Item_Number>
<Item_Number_Confidence>0,95</Item_Number_Confidence>
<Expected_Delivery_Date>2025-04-01</Expected_Delivery_Date>
<Expected_Delivery_Time_From>08:00</Expected_Delivery_Time_From>
<Expected_Delivery_Time_Until>12:00</Expected_Delivery_Time_Until>
<Goods_Issue_Date>2025-03-28</Goods_Issue_Date>
<Commission_Number>COM-LINE-01</Commission_Number>
<Sales_Organisation>1000</Sales_Organisation>
<Pos>10</Pos>
<Framework_Contract_Number>FC-2025-200</Framework_Contract_Number>
<Quote_Reference_Number>QT-2025-100</Quote_Reference_Number>
<Container_Quantity>10</Container_Quantity>
<Container_Type>box</Container_Type>
<Order_Number>SUB-ORD-001</Order_Number>
<Sell_to_Customer>
<Customer_Number>CUST-67890</Customer_Number>
<Name>Acme Branch North</Name>
<Customer_Address>
<Name>Acme Branch North</Name>
<Address>Nordring 7</Address>
<City>Hamburg</City>
<Post_Code>22303</Post_Code>
<Country>DE</Country>
</Customer_Address>
</Sell_to_Customer>
<Currency>EUR</Currency>
<Article_Comments>Pack individually</Article_Comments>
<Article_Markings>A1</Article_Markings>
<Article_Markings>B2</Article_Markings>
</Line>
</Order_v1>
Allgemeine Felder (General)
| Element | Typ | Beschreibung |
|---|---|---|
Sell_to_Customer | Block | Bestellender Kunde, gefüllt aus Ihren Kundenstammdaten |
Sell_to_Customer/Customer_Number | Text | Kundennummer |
Sell_to_Customer/Name | Text | Kundenname |
Sell_to_Customer/Contact_Number | Text | Nummer des Ansprechpartners beim Kunden |
Sell_to_Customer/Contact | Text | Name des Ansprechpartners |
Sell_to_Customer/Contact_Email | Text | E-Mail-Adresse des Ansprechpartners |
Sell_to_Customer/Contact_Phone | Text | Telefonnummer des Ansprechpartners |
Sell_to_Customer/Country | Text | Ländercode der Kundenadresse (z. B. DE) |
Sell_to_Customer/Country_Subdivision | Text | Bundesland- oder Regionscode der Kundenadresse (z. B. BY) |
Sell_to_Customer/Customer_Type | Text | Kundentyp aus Ihren Stammdaten |
Dispatch_Contact | Block | Versandkontakt beim Kunden. Nur vorhanden, wenn mindestens ein Wert erfasst ist |
Dispatch_Contact/Contact_Number | Text | Nummer des Versandkontakts |
Dispatch_Contact/Contact | Text | Name des Versandkontakts |
Dispatch_Contact/Contact_Email | Text | E-Mail-Adresse des Versandkontakts |
Dispatch_Contact/Contact_Phone | Text | Telefonnummer des Versandkontakts |
Order_Date | Datum | Bestelldatum |
VAT_Registration_Number | Text | USt-IdNr. des Kunden |
Customer_Order_Number | Text | Bestellnummer des Kunden |
Quote_Reference_Number | Text | Nummer des Angebots, auf das sich die Bestellung bezieht |
Project_Number | Text | Projektnummer |
Distribution_Channel | Text | Vertriebsweg bzw. Vertriebsorganisation |
Order_Type | Text | Auftragsart |
Delivery_Terms | Text | Lieferbedingungen |
Shipping_Terms | Text | Versandbedingungen |
Payment_Terms | Text | Zahlungsbedingungen |
Total_Amount_Net | Dezimal | Nettogesamtbetrag |
Total_Amount | Dezimal | Bruttogesamtbetrag |
Framework_Contract_Number | Text | Rahmenvertragsnummer |
Goods_Receiving_Time | Text | Warenannahmezeiten, wie auf der Bestellung angegeben |
Info_Text | Text | Freitext. Workist teilt ihn in Abschnitte zu 70 Zeichen auf, ein Element je Abschnitt, höchstens 5 Elemente; der Rest entfällt |
Commission_Number | Text | Kommissionsnummer |
Incoterm | Text | Incoterm (z. B. DAP) |
Delivery_Unload_Method | Text | Entladeart am Lieferort |
External_Document_Link | Text | Dateiname des Originaldokuments, das Workist zusammen mit der XML-Datei überträgt (<ID>.pdf). Kein Link |
Workist_URL | Text | Link zum Dokument in der Workbench |
Received_By | Text | Absenderadresse (Von) der E-Mail, mit der das Dokument bei Workist eingegangen ist |
ERP_Locked | Boolean | true, wenn ein Bearbeiter die Bestellung in der Workbench als für die Weiterverarbeitung gesperrt markiert hat, sonst false |
Additional_Files | Block | Weitere Anhänge derselben E-Mail, die Workist zusammen mit der Bestellung überträgt. Nur vorhanden, wenn zusätzliche Dateien aktiviert sind und passende Anhänge existieren |
Additional_Files/Additional_File | Block | Ein Element je Datei |
Additional_Files/Additional_File/File_Name | Text | Dateiname, unter dem Workist die Datei überträgt (<ID>_file_<n>.<Endung>) |
Additional_Files/Additional_File/Classification | Text | Dokumentart des Anhangs: ORDER, ORDER_CONFIRMATION, REQUEST_FOR_QUOTATION, INVOICE, DELIVERY_NOTE, OFFER oder OTHER |
Additional_Files/Additional_File/File_Name_Original | Text | Ursprünglicher Dateiname des Anhangs |
Rechnungsadresse, Lieferadresse und Liefertermine
Invoicing und Shipping erscheinen nur, wenn mindestens ein enthaltenes Feld gefüllt ist.
| Element | Typ | Beschreibung |
|---|---|---|
Invoicing/Bill_to_Customer | Block | Rechnungsadresse; Felder siehe Adressfelder |
Shipping/Ship_to_Customer | Block | Lieferadresse; Felder siehe Adressfelder |
Shipping/Expected_Delivery_Date | Datum | Gewünschter Liefertermin |
Shipping/Expected_Delivery_End_Date | Datum | Ende des Lieferzeitraums |
Shipping/Expected_Delivery_Time_From | Text | Beginn des Lieferzeitfensters (HH:MM) |
Shipping/Expected_Delivery_Time_Until | Text | Ende des Lieferzeitfensters (HH:MM) |
Shipping/Goods_Issue_Date | Datum | Warenausgangsdatum |
Adressfelder
Bill_to_Customer, Ship_to_Customer und Customer_Address (bei Sammelbestellungen in Line) haben dieselbe Struktur. Ein Adressblock erscheint nur, wenn Name, Firma, Straße oder Ort erfasst sind.
| Element | Typ | Beschreibung |
|---|---|---|
Code | Text | Adressnummer aus Ihren Stammdaten |
Name | Text | Name des Empfängers; der Firmenname, wenn kein Name erfasst ist |
Additional_Name_Info | Text | Firmenname; nur vorhanden, wenn zusätzlich ein Name erfasst ist |
Address | Text | Straße und Hausnummer. Immer vorhanden, ggf. leer |
Additional_Address_Info | Text | Adresszusatz (z. B. Gebäude, Tor) |
City | Text | Ort. Immer vorhanden, ggf. leer |
Post_Code | Text | Postleitzahl. Immer vorhanden, ggf. leer |
Country | Text | Ländercode (z. B. DE). Immer vorhanden, ggf. leer |
Country_Subdivision | Text | Bundesland- oder Regionscode (z. B. BY) |
Phone | Text | Telefonnummer |
Email | Text | E-Mail-Adresse |
Positionsfelder (Line)
Workist schreibt ein Line-Element je Position, sofern mindestens ein Positionsfeld konfiguriert ist. Die Artikelnummern stammen aus Ihren Artikelstammdaten.
| Element | Typ | Beschreibung |
|---|---|---|
Batch_Number | Text | Chargennummer |
Description | Text | Artikelbeschreibung |
Unit_of_Measure | Text | Mengeneinheit |
Quantity | Dezimal | Bestellmenge |
Unit_Price | Dezimal | Einzelpreis |
Price_Unit | Dezimal | Preiseinheit: Anzahl Einheiten, auf die sich der Einzelpreis bezieht (z. B. 1 oder 100) |
Total_Price | Dezimal | Positionsgesamtpreis |
Line_Discount_Percent | Text | Rabatt in Prozent, so übernommen, wie in Workist erfasst |
Line_Discount_Amount | Text | Rabattbetrag, so übernommen, wie in Workist erfasst |
Item_Variant | Text | Artikelvariante |
Common_Item_Number | Text | Ihre Artikelnummer (article_id1 aus Ihren Artikelstammdaten) |
Common_Item_Number_2 | Text | Zweite Artikelnummer (article_id2) |
Common_Item_Number_3 | Text | Dritte Artikelnummer (article_id3, z. B. EAN) |
Customer_Item_Number | Text | Artikelnummer des Kunden |
Item_Number_Confidence | Dezimal | Sicherheit der automatischen Artikelzuordnung zwischen 0 und 1, immer mit Dezimalkomma (z. B. 0,95) |
Expected_Delivery_Date | Datum | Liefertermin der Position |
Expected_Delivery_Time_From | Text | Beginn des Lieferzeitfensters der Position (HH:MM) |
Expected_Delivery_Time_Until | Text | Ende des Lieferzeitfensters der Position (HH:MM) |
Goods_Issue_Date | Datum | Warenausgangsdatum der Position |
Commission_Number | Text | Kommissionsnummer der Position |
Sales_Organisation | Text | Verkaufsorganisation |
Pos | Text | Positionsnummer |
Framework_Contract_Number | Text | Rahmenvertragsnummer der Position |
Quote_Reference_Number | Text | Angebotsnummer der Position |
Container_Quantity | Text | Umgerechnete Menge (z. B. in Gebinden), so übernommen, wie in Workist erfasst |
Container_Type | Text | Umgerechnete Einheit (z. B. box) |
Order_Number | Text | Bestellnummer der Position (z. B. bei Sammelbestellungen) |
Sell_to_Customer | Block | Kunde dieser Position bei Sammelbestellungen |
Sell_to_Customer/Customer_Number | Text | Kundennummer |
Sell_to_Customer/Name | Text | Kundenname |
Sell_to_Customer/Customer_Address | Block | Adresse dieses Kunden; Felder siehe Adressfelder |
Currency | Text | Währung der Position (z. B. EUR) |
Article_Comments | Text | Bemerkung zur Position |
Article_Markings | Text | Markierung der Position; ein Element je Markierung |
Optionale Elemente
Einige Elemente schalten Sie in der Kanal-Konfiguration ein (siehe Exportierte verarbeitete Dokumente):
External_Document_Link: Verweis auf die analysierte Datei einfügen (standardmäßig aktiv). Das Element enthält den Dateinamen des Originaldokuments, das Workist neben der XML-Datei ablegt.Workist_URL: Link zur Workbench einfügen.Received_By: E-Mail-Absenderinformationen einfügen. Ist das Dokument nicht per E-Mail eingegangen, fehlt das Element.ERP_Locked: Tragen Sieerp_lockedunter Zusätzliche Kopfzeilendatenfelder ein. Bearbeiter können eine Bestellung dann in der Workbench mit Für die Weiterverarbeitung als gesperrt markieren kennzeichnen.Additional_Files: Aktivieren Sie in der Upload-Konfiguration Zusätzliche Dateien und wählen Sie unter Zusätzliche Dateitypen die Dokumentarten. Workist überträgt dann passende Anhänge derselben E-Mail zusammen mit der Bestellung und listet sie hier auf.
SAP IDoc ORDERS05
Dateiendung: .xml
Dateiname: <IDoc-Nummer>.xml
Das IDoc-Format für die direkte Übernahme in SAP. Es besteht aus einem Kontrollsatz (EDI_DC40) und Datensegmenten für Kopf, Termine, Partner und Positionen. Dasselbe Format gibt es für Anfragen mit dem Nachrichtentyp REQOTE.
Vollständiges Beispiel
In diesem Beispiel haben Liefer- und Rechnungsadresse eine Adressnummer, deshalb bleiben ihre Adressfelder leer.
<?xml version="1.0" encoding="utf-8"?>
<ORDERS05>
<IDOC BEGIN="1">
<EDI_DC40 SEGMENT="1">
<TABNAM>EDI_DC40</TABNAM>
<MANDT>050</MANDT>
<DOCNUM>0000000000004711</DOCNUM>
<STATUS>30</STATUS>
<DIRECT>2</DIRECT>
<IDOCTYP>ORDERS05</IDOCTYP>
<MESTYP>ORDERS</MESTYP>
<STD>0</STD>
<STDMES>ORDERS</STDMES>
<SNDPOR>WORKIST</SNDPOR>
<SNDPRT>LS</SNDPRT>
<SNDPRN>WORKIST</SNDPRN>
<RCVPOR>XML_WKI</RCVPOR>
<RCVPRT>LS</RCVPRT>
<RCVPRN>SUPPLIER</RCVPRN>
<CREDAT>20250315</CREDAT>
<CRETIM>143025</CRETIM>
</EDI_DC40>
<E1EDK01 SEGMENT="1">
<ACTION>000</ACTION>
<BELNR>PO-2025-0001</BELNR>
<RECIPNT_NO>SUPPLIER</RECIPNT_NO>
</E1EDK01>
<E1EDK03 SEGMENT="1">
<IDDAT>012</IDDAT>
<DATUM>20250315</DATUM>
</E1EDK03>
<E1EDK03 SEGMENT="1">
<IDDAT>002</IDDAT>
<DATUM>20250401</DATUM>
</E1EDK03>
<E1EDKA1 SEGMENT="1">
<PARVW>AG</PARVW>
<PARTN>CUST-12345</PARTN>
</E1EDKA1>
<E1EDKA1 SEGMENT="1">
<PARVW>Z1</PARVW>
<PARTN>CP-001</PARTN>
<NAME1>Max Mustermann</NAME1>
<TELF1>+49 89 12345678</TELF1>
<TELBX>max@acme.de</TELBX>
</E1EDKA1>
<E1EDKA1 SEGMENT="1">
<PARVW>WE</PARVW>
<PARTN>SHIP-002</PARTN>
<NAME1 />
<NAME2 />
<STRAS />
<ORT01 />
<PSTLZ />
<LAND1 />
</E1EDKA1>
<E1EDKA1 SEGMENT="1">
<PARVW>RE</PARVW>
<PARTN>BILL-001</PARTN>
<NAME1 />
<NAME2 />
<STRAS />
<ORT01 />
<PSTLZ />
<LAND1 />
</E1EDKA1>
<E1EDK02 SEGMENT="1">
<QUALF>001</QUALF>
<BELNR>PO-2025-0001</BELNR>
<DATUM>20250315</DATUM>
</E1EDK02>
<E1EDP01 SEGMENT="1">
<POSEX>0</POSEX>
<ACTION>001</ACTION>
<MENGE>100</MENGE>
<MENEE>PCE</MENEE>
<E1EDP03 SEGMENT="1">
<IDDAT>002</IDDAT>
<DATUM>20250401</DATUM>
<UZEIT>000000</UZEIT>
</E1EDP03>
<E1EDP19 SEGMENT="1">
<QUALF>002</QUALF>
<IDTNR>ART-001-A</IDTNR>
</E1EDP19>
</E1EDP01>
</IDOC>
</ORDERS05>
Segmente
| Element | Inhalt |
|---|---|
EDI_DC40 | Kontrollsatz. TABNAM, STATUS (30), DIRECT (2), IDOCTYP (ORDERS05), STD (0), MESTYP und STDMES (ORDERS) sind fest. DOCNUM ist eine fortlaufende 16-stellige IDoc-Nummer, CREDAT/CRETIM der Erstellungszeitpunkt (UTC). MANDT, SNDPOR, SNDPRT, SNDPRN, RCVPOR, RCVPRT und RCVPRN stellt Workist für Sie ein (siehe unten). |
E1EDK01 | Belegkopf: ACTION = 000, BELNR = Bestellnummer des Kunden (max. 35 Zeichen), RECIPNT_NO = Empfängernummer (einstellbar, max. 10). |
E1EDK03 (IDDAT = 012) | IDDAT = 012, DATUM = Bestelldatum (JJJJMMTT). Pflichtangabe. |
E1EDK03 (IDDAT = 002) | IDDAT = 002, DATUM = gewünschter Liefertermin (JJJJMMTT). Pflichtangabe. |
E1EDKA1 (PARVW = AG) | Auftraggeber: PARVW = AG, PARTN = Kundennummer (max. 17 Zeichen). |
E1EDKA1 (PARVW = Z1) | Ansprechpartner: PARVW = Z1, PARTN = Nummer (max. 30), NAME1 = Name (max. 35), TELF1 = Telefon (max. 25), TELBX = E-Mail-Adresse (max. 25, längere Adressen werden abgeschnitten). Nur vorhanden, wenn mindestens ein Wert erfasst ist. |
E1EDKA1 (PARVW = WE) | Warenempfänger, immer vorhanden: PARVW = WE, PARTN = Adressnummer der Lieferadresse. NAME1 = Firma, NAME2 = Name, STRAS = Straße, ORT01 = Ort (je max. 35 Zeichen), PSTLZ = Postleitzahl (max. 9), LAND1 = Ländercode (max. 3). Ist eine Adressnummer vorhanden, bleiben diese Felder leer. |
E1EDKA1 (PARVW = RE) | Rechnungsempfänger: PARVW = RE, PARTN = Adressnummer der Rechnungsadresse. NAME1 = Firma, NAME2 = Name, STRAS = Straße, ORT01 = Ort (je max. 35 Zeichen), PSTLZ = Postleitzahl (max. 9), LAND1 = Ländercode (max. 3). Ist eine Adressnummer vorhanden, bleiben diese Felder leer. Nur vorhanden, wenn die Rechnungsadresse zu den Kopffeldern Ihres Kanals gehört. |
E1EDK02 (QUALF = 001) | QUALF = 001, BELNR = Bestellnummer, DATUM = Bestelldatum. |
E1EDP01 | Eine je Position: POSEX = laufende Nummer ab 0 (nicht die Positionsnummer der Bestellung), ACTION = 001, MENGE = Menge (max. 15 Zeichen), MENEE = Mengeneinheit, wie in Workist erfasst. |
E1EDP03 (IDDAT = 002) | Liefertermin der Position: IDDAT = 002, DATUM (JJJJMMTT), UZEIT = 000000. Nur, wenn die Position einen Liefertermin hat. |
E1EDP19 (QUALF = 002) | QUALF = 002, IDTNR = Ihre Artikelnummer (max. 35 Zeichen). |
Einstellungen
Diese Werte stellt Workist bei der Einrichtung passend zu Ihrem SAP-System ein. Längere Werte werden abgeschnitten.
| Feld | Standard | Max. Zeichen |
|---|---|---|
MANDT | 050 | – |
SNDPOR | WORKIST | 10 |
SNDPRT | LS | 2 |
SNDPRN | WORKIST | 10 |
RCVPOR | XML_WKI | 10 |
RCVPRT | LS | 2 |
RCVPRN | SUPPLIER | 10 |
RECIPNT_NO | SUPPLIER | 10 |
Hinweise
- Bestelldatum und Liefertermin sind Pflicht. Fehlt einer der beiden Werte, erzeugt Workist keine Datei.
- Je Position überträgt das IDoc nur Menge, Einheit, Liefertermin und Ihre Artikelnummer. Preise, Artikelbeschreibung und die Artikelnummer des Kunden sind nicht enthalten.
- Die Mengeneinheit überträgt Workist so, wie sie in Workist erfasst ist, ohne Umschlüsselung auf ISO-Codes.
- Die Feldauswahl Ihres Kanals ändert den Aufbau nicht. Einzige Ausnahme ist der Rechnungsempfänger (
RE).
openTRANS 2.1
Dateiendung: .xml
Dateiname: <UUID>.xml
Bestellung im openTRANS-2.1-Format (ORDER). Geschäftspartner stehen im Abschnitt PARTIES und werden über ihre PARTY_ID referenziert.
Vollständiges Beispiel
In diesem Beispiel ist für die Position eine umgerechnete Menge (10 box) erfasst, deshalb stehen in QUANTITY und ORDER_UNIT die umgerechneten Werte.
<?xml version="1.0" encoding="utf-8"?>
<ORDER xmlns:bmecat="http://www.bmecat.org/bmecat/2005" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.1" xmlns="http://www.opentrans.org/XMLSchema/2.1" xsi:schemaLocation="http://www.opentrans.org/XMLSchema/2.1 opentrans_2_1.xsd" type="standard">
<ORDER_HEADER>
<CONTROL_INFO>
<GENERATOR_INFO>Workist</GENERATOR_INFO>
<GENERATION_DATE>2025-03-15T14:30:25.123456</GENERATION_DATE>
</CONTROL_INFO>
<SOURCING_INFO>
<QUOTATION_ID>QT-2025-100</QUOTATION_ID>
<AGREEMENT>
<bmecat:AGREEMENT_ID>PRJ-500</bmecat:AGREEMENT_ID>
<bmecat:AGREEMENT_END_DATE>2025-03-15T14:30:25.123456</bmecat:AGREEMENT_END_DATE>
</AGREEMENT>
</SOURCING_INFO>
<ORDER_INFO>
<ORDER_ID>PO-2025-0001</ORDER_ID>
<ORDER_DATE>2025-03-15</ORDER_DATE>
<DELIVERY_DATE>
<DELIVERY_START_DATE>2025-04-01</DELIVERY_START_DATE>
<DELIVERY_END_DATE>2025-04-05</DELIVERY_END_DATE>
</DELIVERY_DATE>
<PARTIES>
<PARTY>
<bmecat:PARTY_ID type="party_specific">workist</bmecat:PARTY_ID>
<PARTY_ROLE>document_creator</PARTY_ROLE>
</PARTY>
<PARTY>
<bmecat:PARTY_ID type="party_specific">supplier</bmecat:PARTY_ID>
<PARTY_ROLE>supplier</PARTY_ROLE>
</PARTY>
<PARTY>
<bmecat:PARTY_ID>CUST-12345</bmecat:PARTY_ID>
<PARTY_ROLE>buyer</PARTY_ROLE>
<ADDRESS>
<bmecat:NAME>Acme Corporation</bmecat:NAME>
<CONTACT_DETAILS>
<bmecat:CONTACT_ID>CP-001</bmecat:CONTACT_ID>
<bmecat:CONTACT_NAME>Mustermann</bmecat:CONTACT_NAME>
<bmecat:FIRST_NAME>Max</bmecat:FIRST_NAME>
<bmecat:PHONE>+49 89 12345678</bmecat:PHONE>
<bmecat:EMAILS>
<bmecat:EMAIL>max@acme.de</bmecat:EMAIL>
</bmecat:EMAILS>
</CONTACT_DETAILS>
<bmecat:STREET>Hauptstrasse 42</bmecat:STREET>
<bmecat:ZIP>80331</bmecat:ZIP>
<bmecat:CITY>Munich</bmecat:CITY>
<bmecat:COUNTRY_CODED>DE</bmecat:COUNTRY_CODED>
<bmecat:COUNTRY_SUBDIVISION>BY</bmecat:COUNTRY_SUBDIVISION>
</ADDRESS>
</PARTY>
<PARTY>
<bmecat:PARTY_ID>SHIP-002</bmecat:PARTY_ID>
<PARTY_ROLE>delivery</PARTY_ROLE>
<ADDRESS>
<bmecat:NAME>Acme Corporation GmbH</bmecat:NAME>
<bmecat:NAME2>Warehouse Team</bmecat:NAME2>
<bmecat:NAME3>Gate 3</bmecat:NAME3>
<bmecat:STREET>Lager Strasse 5</bmecat:STREET>
<bmecat:ZIP>20095</bmecat:ZIP>
<bmecat:CITY>Hamburg</bmecat:CITY>
<bmecat:COUNTRY_CODED>DE</bmecat:COUNTRY_CODED>
<bmecat:COUNTRY_SUBDIVISION>HH</bmecat:COUNTRY_SUBDIVISION>
<bmecat:PHONE>+49 40 22222222</bmecat:PHONE>
</ADDRESS>
</PARTY>
<PARTY>
<bmecat:PARTY_ID>BILL-001</bmecat:PARTY_ID>
<PARTY_ROLE>invoice_recipient</PARTY_ROLE>
<ADDRESS>
<bmecat:NAME>Acme Corporation GmbH</bmecat:NAME>
<bmecat:NAME2>Accounts Payable</bmecat:NAME2>
<bmecat:STREET>Billing Strasse 10</bmecat:STREET>
<bmecat:ZIP>80331</bmecat:ZIP>
<bmecat:CITY>Munich</bmecat:CITY>
<bmecat:COUNTRY_CODED>DE</bmecat:COUNTRY_CODED>
<bmecat:COUNTRY_SUBDIVISION>BY</bmecat:COUNTRY_SUBDIVISION>
<bmecat:PHONE>+49 89 11111111</bmecat:PHONE>
</ADDRESS>
</PARTY>
</PARTIES>
<ORDER_PARTIES_REFERENCE>
<bmecat:BUYER_IDREF>CUST-12345</bmecat:BUYER_IDREF>
<bmecat:SUPPLIER_IDREF>supplier</bmecat:SUPPLIER_IDREF>
<INVOICE_RECIPIENT_IDREF>BILL-001</INVOICE_RECIPIENT_IDREF>
<SHIPMENT_PARTIES_REFERENCE>
<DELIVERY_IDREF>SHIP-002</DELIVERY_IDREF>
</SHIPMENT_PARTIES_REFERENCE>
</ORDER_PARTIES_REFERENCE>
<bmecat:CURRENCY>EUR</bmecat:CURRENCY>
</ORDER_INFO>
</ORDER_HEADER>
<ORDER_ITEM_LIST>
<ORDER_ITEM>
<LINE_ITEM_ID>10</LINE_ITEM_ID>
<PRODUCT_ID>
<bmecat:SUPPLIER_PID type="supplier_specific">ART-001-A</bmecat:SUPPLIER_PID>
<bmecat:BUYER_PID>CUST-ART-555</bmecat:BUYER_PID>
<bmecat:DESCRIPTION_LONG>Industrial Sensor Module Type A</bmecat:DESCRIPTION_LONG>
</PRODUCT_ID>
<QUANTITY>10</QUANTITY>
<bmecat:ORDER_UNIT>BOX</bmecat:ORDER_UNIT>
<DELIVERY_DATE>
<DELIVERY_START_DATE>2025-04-01</DELIVERY_START_DATE>
<DELIVERY_END_DATE>2025-04-01</DELIVERY_END_DATE>
</DELIVERY_DATE>
</ORDER_ITEM>
</ORDER_ITEM_LIST>
<ORDER_SUMMARY>
<TOTAL_ITEM_NUM>1</TOTAL_ITEM_NUM>
</ORDER_SUMMARY>
</ORDER>
Elemente
| Element | Inhalt |
|---|---|
CONTROL_INFO | GENERATOR_INFO = Workist, GENERATION_DATE = Erstellungszeitpunkt (UTC). |
SOURCING_INFO | Nur, wenn eine Angebots- oder Projektnummer erfasst ist: QUOTATION_ID = Angebotsnummer, AGREEMENT_ID = Projektnummer, AGREEMENT_END_DATE = Erstellungszeitpunkt (Pflichtangabe des Standards ohne fachliche Bedeutung). |
ORDER_INFO | ORDER_ID = Bestellnummer, ORDER_DATE = Bestelldatum, CURRENCY = immer EUR. |
DELIVERY_DATE | Nur mit Liefertermin: DELIVERY_START_DATE = Liefertermin, DELIVERY_END_DATE = Ende des Lieferzeitraums (sonst der Liefertermin). |
PARTY document_creator | Workist als Ersteller: PARTY_ID = workist (type = party_specific), PARTY_ROLE = document_creator. |
PARTY supplier | Sie als Lieferant, fester Platzhalter: PARTY_ID = supplier (type = party_specific), PARTY_ROLE = supplier. |
PARTY buyer | Bestellender Kunde: PARTY_ID = Kundennummer, PARTY_ROLE = buyer. Adresse: NAME = Name aus der Kundenadresse, STREET, ZIP, CITY (max. 35 Zeichen), COUNTRY_CODED, COUNTRY_SUBDIVISION. CONTACT_DETAILS, wenn ein Ansprechpartner erfasst ist: CONTACT_ID, FIRST_NAME = erstes Wort des Namens, CONTACT_NAME = restlicher Name, PHONE, EMAIL. |
PARTY delivery | Lieferadresse, wenn Firma, Name oder Adressnummer erfasst sind: PARTY_ID = Adressnummer, PARTY_ROLE = delivery; NAME = Firma, NAME2 = Name, NAME3 = Adresszusatz, STREET, ZIP, CITY (max. 35 Zeichen), COUNTRY_CODED, COUNTRY_SUBDIVISION, PHONE. |
PARTY invoice_recipient | Rechnungsadresse, wenn Firma, Name oder Adressnummer erfasst sind: PARTY_ID = Adressnummer, PARTY_ROLE = invoice_recipient; NAME = Firma, NAME2 = Name, STREET, ZIP, CITY (max. 35 Zeichen), COUNTRY_CODED, COUNTRY_SUBDIVISION, PHONE. |
ORDER_PARTIES_REFERENCE | BUYER_IDREF = Kundennummer, SUPPLIER_IDREF = supplier, INVOICE_RECIPIENT_IDREF = Adressnummer der Rechnungsadresse, DELIVERY_IDREF = Adressnummer der Lieferadresse. |
ORDER_ITEM | Eine je Position: LINE_ITEM_ID = Positionsnummer (sonst laufende Nummer ab 1), QUANTITY und ORDER_UNIT = Menge (mit Dezimalpunkt) und Einheit (in Großbuchstaben). Sind umgerechnete Menge und Einheit erfasst, stehen hier die umgerechneten Werte. |
PRODUCT_ID | SUPPLIER_PID = Ihre Artikelnummer (type = supplier_specific), BUYER_PID = Artikelnummer des Kunden, DESCRIPTION_LONG = Artikelbeschreibung. |
DELIVERY_DATE (Position) | Liefertermin der Position in DELIVERY_START_DATE und DELIVERY_END_DATE. |
ORDER_SUMMARY | TOTAL_ITEM_NUM = Anzahl der Positionen. |
Hinweise
- Das Format enthält keine Preise, Positionssummen oder Gesamtbeträge.
- Die Feldauswahl Ihres Kanals ändert den Aufbau nicht.
cXML OrderRequest
Dateiendung: .xml
Dateiname: <UUID>.xml
Bestellung im cXML-Format (OrderRequest) mit Kopf, Lieferadresse, bestellendem Kunden, Ansprechpartner und Positionen mit Preisen.
Vollständiges Beispiel
<?xml version="1.0" encoding="utf-8"?>
<cXML payloadID="3f2b8c1e-5a7d-4e19-8c2f-6b0d9a4e7c15" timestamp="2025-03-15T14:30:25.123456">
<Header>
<From>
<Credential domain="SystemId">CUST-12345</Credential>
</From>
<To>
<Credential domain="SystemId">supplier</Credential>
</To>
<Sender>
<Credential domain="SystemId">workist</Credential>
<UserAgent>Workist Platform</UserAgent>
</Sender>
</Header>
<Request deploymentMode="production">
<OrderRequest deploymentMode="production">
<OrderRequestHeader orderDate="2025-03-15T00:00:00+00:00" orderID="PO-2025-0001" orderType="regular" orderVersion="1" type="new">
<Total>
<Money currency="EUR">1250</Money>
</Total>
<ShipTo>
<Address isoCountryCode="DE" addressID="SHIP-002">
<Name xml:lang="de">Acme Corporation GmbH</Name>
<Email>warehouse@acme.de</Email>
</Address>
<PostalAddress>
<DeliverTo>Warehouse Team</DeliverTo>
<DeliverTo>Gate 3</DeliverTo>
<Street>Lager Strasse 5</Street>
<City>Hamburg</City>
<State>HH</State>
<PostalCode>20095</PostalCode>
<Country isoCountryCode="DE">DE</Country>
</PostalAddress>
</ShipTo>
<BillTo>
<Address isoCountryCode="DE" addressID="CUST-12345">
<Name xml:lang="de">Acme Corp GmbH</Name>
</Address>
<PostalAddress>
<DeliverTo>Acme Corporation</DeliverTo>
<DeliverTo>Finance Department</DeliverTo>
<Street>Hauptstrasse 42</Street>
<City>Munich</City>
<State>BY</State>
<PostalCode>80331</PostalCode>
<Country isoCountryCode="DE">DE</Country>
</PostalAddress>
<IdReference domain="buyerID" identifier="CUST-12345" />
</BillTo>
<Contact role="buyerCorporate">
<Name xml:lang="de">Max Mustermann</Name>
<PostalAddress name="Max Mustermann">
<DeliverTo>CP-001</DeliverTo>
<DeliverTo>Max Mustermann</DeliverTo>
<Street />
<City />
<State />
<PostalCode />
<Country />
</PostalAddress>
</Contact>
</OrderRequestHeader>
</OrderRequest>
</Request>
<ItemOut lineNumber="10" quantity="100.0">
<ItemID>
<SupplierPartID>ART-001-A</SupplierPartID>
</ItemID>
<ItemDetail>
<UnitPrice>
<Money currency="EUR">12.5</Money>
</UnitPrice>
<Description xml:lang="de">Industrial Sensor Module Type A</Description>
<UnitOfMeasure>PCE</UnitOfMeasure>
</ItemDetail>
<ScheduleLine lineNumber="10" quantity="100.0" requestedDeliveryDate="2025-04-01T00:00:00+00:00">
<UnitOfMeasure>PCE</UnitOfMeasure>
</ScheduleLine>
</ItemOut>
</cXML>
Elemente
| Element | Inhalt |
|---|---|
cXML | payloadID = ID des Dokuments in Workist, timestamp = Erstellungszeitpunkt. |
From | Credential (domain = SystemId) = Kundennummer. |
To | Credential (domain = SystemId) = Empfänger-ID, standardmäßig supplier. |
Sender | Credential (domain = SystemId) = workist, UserAgent = Workist Platform. |
Request, OrderRequest | deploymentMode = production (oder test, siehe unten). |
OrderRequestHeader | orderID = Bestellnummer, orderDate = Bestelldatum mit Uhrzeit (2025-03-15T00:00:00+00:00), orderType = regular, orderVersion = 1, type = new. |
Total | Money = Nettogesamtbetrag (0.0, wenn keiner erfasst ist), currency = Währung der Bestellung (sonst EUR). |
ShipTo | Lieferadresse, wenn Firma, Name oder Adressnummer erfasst sind. Address: addressID = Adressnummer, isoCountryCode = Ländercode, Name (xml:lang = de) = Firma, Email. PostalAddress (neben Address): DeliverTo = Name, zweites DeliverTo = Adresszusatz (wenn vorhanden), Street, City, State = Bundesland/Region, PostalCode, Country mit isoCountryCode (Standard DE). |
BillTo | Der bestellende Kunde aus Ihren Kundenstammdaten. Address: addressID = Kundennummer, isoCountryCode, Name (xml:lang = de) = Firmenname der Kundenadresse. PostalAddress: DeliverTo = Name, zweites DeliverTo = Adresszusatz, Street, City, State, PostalCode, Country mit isoCountryCode. IdReference mit domain = buyerID und identifier = Kundennummer. |
Contact | Ansprechpartner, wenn Name oder Nummer erfasst sind: role = buyerCorporate, Name (xml:lang = de). PostalAddress (name = Name): DeliverTo = Nummer, zweites DeliverTo = Name; Street, City, State, PostalCode und Country bleiben leer. |
ItemOut | Eine je Position, direkt unter cXML: lineNumber = Positionsnummer (sonst laufende Nummer ab 1), quantity = Menge mit Dezimalpunkt. SupplierPartID = Ihre Artikelnummer. UnitPrice: Money = Einzelpreis mit Dezimalpunkt, currency = Währung der Bestellung (sonst EUR). Description (xml:lang = de) = Artikelbeschreibung, UnitOfMeasure = Mengeneinheit. ScheduleLine wiederholt lineNumber, quantity und UnitOfMeasure; requestedDeliveryDate = Liefertermin der Position. |
Einstellungen
Diese Werte stellt Workist bei der Einrichtung für Sie ein:
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Empfänger-ID | supplier | Wert im Credential unter To |
| Deployment-Modus | production | deploymentMode von Request und OrderRequest, z. B. test für Testsysteme |
Hinweise
BillToenthält den bestellenden Kunden. Die Rechnungsadresse der Bestellung überträgt cXML nicht.- Jede Position braucht eine Menge, die sich als Zahl lesen lässt, sonst erzeugt Workist keine Datei.
- Die Feldauswahl Ihres Kanals ändert den Aufbau nicht.
ANSI X12 850
Dateiendung: .edi
Dateiname: <kundennummer>_<bestellnummer>_<uuid>.edi (siehe Dateinamen)
Das EDI-Format für Bestellungen, das vor allem in Nordamerika verbreitet ist. Datenelemente sind durch * getrennt, jedes Segment endet mit ~ und steht in einer eigenen Zeile.
Vollständiges Beispiel
ISA*00* *00* *ZZ*CUST-12345 *ZZ*musterlieferant*250315*0000*U*00401*212075055*0*P*>~
GS*PO*CUST-12345* *20250315*0000*2120*X*004010~
ST*850*212075055~
BEG*00**PO-2025-0001**20250315~
PER*BD*Max Mustermann*TE*+49 89 12345678*EM*max@acme.de~
DTM*002*20250401~
MSG*Please deliver to loading dock B. Handle with care - fragile items, do not stack pallets.~
N1*ST*Acme Corporation**CUST-12345~
PO1*10*100*PCE*12.5**VN*ART-001-A~
PID*F****Industrial Sensor Module Type A~
CTT*1~
SE*10*212075055~
GE*1*2120~
IEA*1*212075055~
Segmente
| Segment | Inhalt |
|---|---|
ISA | Interchange-Kopf: Absender-ID = Kundennummer, Empfänger-ID = Ihr Workist-Kurzname (je auf 15 Zeichen aufgefüllt), Datum (JJMMTT) = Bestelldatum, Uhrzeit 0000, Version 00401, Kontrollnummer |
GS | Funktionsgruppe PO, Absender = Kundennummer, Datum = Bestelldatum, Version 004010 |
ST | Transaktion 850 und Kontrollnummer |
BEG | 00 (Original), Bestellnummer, Bestelldatum (JJJJMMTT) |
PER | Ansprechpartner (BD): Name, Telefon (TE), E-Mail (EM) |
DTM | 002 = Liefertermin (JJJJMMTT) |
MSG | Freitext der Bestellung (nur, wenn vorhanden) |
N1 | ST, Name und Nummer des bestellenden Kunden. Eine Lieferadresse wird nicht übertragen |
PO1 | Position: Positionsnummer, Menge, Einheit, Einzelpreis, VN und Ihre Artikelnummer |
PID | F (Freitext) und Artikelbeschreibung |
CTT | Anzahl der Positionen |
SE | Anzahl der Segmente der Transaktion und Kontrollnummer |
GE | Anzahl der Transaktionen und Kontrollnummer |
IEA | Anzahl der Funktionsgruppen und Kontrollnummer |
PO1 und PID wiederholen sich für jede Position. Die Feldauswahl Ihres Kanals ändert den Aufbau nicht.