Zum Hauptinhalt springen
Markdown

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 Bestellung
  • Invoicing: Rechnungsadresse
  • Shipping: Lieferadresse und Liefertermine
  • Line: 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)​

ElementTypBeschreibung
Sell_to_CustomerBlockBestellender Kunde, gefüllt aus Ihren Kundenstammdaten
Sell_to_Customer/Customer_NumberTextKundennummer
Sell_to_Customer/NameTextKundenname
Sell_to_Customer/Contact_NumberTextNummer des Ansprechpartners beim Kunden
Sell_to_Customer/ContactTextName des Ansprechpartners
Sell_to_Customer/Contact_EmailTextE-Mail-Adresse des Ansprechpartners
Sell_to_Customer/Contact_PhoneTextTelefonnummer des Ansprechpartners
Sell_to_Customer/CountryTextLändercode der Kundenadresse (z. B. DE)
Sell_to_Customer/Country_SubdivisionTextBundesland- oder Regionscode der Kundenadresse (z. B. BY)
Sell_to_Customer/Customer_TypeTextKundentyp aus Ihren Stammdaten
Dispatch_ContactBlockVersandkontakt beim Kunden. Nur vorhanden, wenn mindestens ein Wert erfasst ist
Dispatch_Contact/Contact_NumberTextNummer des Versandkontakts
Dispatch_Contact/ContactTextName des Versandkontakts
Dispatch_Contact/Contact_EmailTextE-Mail-Adresse des Versandkontakts
Dispatch_Contact/Contact_PhoneTextTelefonnummer des Versandkontakts
Order_DateDatumBestelldatum
VAT_Registration_NumberTextUSt-IdNr. des Kunden
Customer_Order_NumberTextBestellnummer des Kunden
Quote_Reference_NumberTextNummer des Angebots, auf das sich die Bestellung bezieht
Project_NumberTextProjektnummer
Distribution_ChannelTextVertriebsweg bzw. Vertriebsorganisation
Order_TypeTextAuftragsart
Delivery_TermsTextLieferbedingungen
Shipping_TermsTextVersandbedingungen
Payment_TermsTextZahlungsbedingungen
Total_Amount_NetDezimalNettogesamtbetrag
Total_AmountDezimalBruttogesamtbetrag
Framework_Contract_NumberTextRahmenvertragsnummer
Goods_Receiving_TimeTextWarenannahmezeiten, wie auf der Bestellung angegeben
Info_TextTextFreitext. Workist teilt ihn in Abschnitte zu 70 Zeichen auf, ein Element je Abschnitt, höchstens 5 Elemente; der Rest entfällt
Commission_NumberTextKommissionsnummer
IncotermTextIncoterm (z. B. DAP)
Delivery_Unload_MethodTextEntladeart am Lieferort
External_Document_LinkTextDateiname des Originaldokuments, das Workist zusammen mit der XML-Datei überträgt (<ID>.pdf). Kein Link
Workist_URLTextLink zum Dokument in der Workbench
Received_ByTextAbsenderadresse (Von) der E-Mail, mit der das Dokument bei Workist eingegangen ist
ERP_LockedBooleantrue, wenn ein Bearbeiter die Bestellung in der Workbench als für die Weiterverarbeitung gesperrt markiert hat, sonst false
Additional_FilesBlockWeitere 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_FileBlockEin Element je Datei
Additional_Files/Additional_File/File_NameTextDateiname, unter dem Workist die Datei überträgt (<ID>_file_<n>.<Endung>)
Additional_Files/Additional_File/ClassificationTextDokumentart des Anhangs: ORDER, ORDER_CONFIRMATION, REQUEST_FOR_QUOTATION, INVOICE, DELIVERY_NOTE, OFFER oder OTHER
Additional_Files/Additional_File/File_Name_OriginalTextUrsprünglicher Dateiname des Anhangs

Rechnungsadresse, Lieferadresse und Liefertermine​

Invoicing und Shipping erscheinen nur, wenn mindestens ein enthaltenes Feld gefüllt ist.

ElementTypBeschreibung
Invoicing/Bill_to_CustomerBlockRechnungsadresse; Felder siehe Adressfelder
Shipping/Ship_to_CustomerBlockLieferadresse; Felder siehe Adressfelder
Shipping/Expected_Delivery_DateDatumGewünschter Liefertermin
Shipping/Expected_Delivery_End_DateDatumEnde des Lieferzeitraums
Shipping/Expected_Delivery_Time_FromTextBeginn des Lieferzeitfensters (HH:MM)
Shipping/Expected_Delivery_Time_UntilTextEnde des Lieferzeitfensters (HH:MM)
Shipping/Goods_Issue_DateDatumWarenausgangsdatum

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.

ElementTypBeschreibung
CodeTextAdressnummer aus Ihren Stammdaten
NameTextName des Empfängers; der Firmenname, wenn kein Name erfasst ist
Additional_Name_InfoTextFirmenname; nur vorhanden, wenn zusätzlich ein Name erfasst ist
AddressTextStraße und Hausnummer. Immer vorhanden, ggf. leer
Additional_Address_InfoTextAdresszusatz (z. B. Gebäude, Tor)
CityTextOrt. Immer vorhanden, ggf. leer
Post_CodeTextPostleitzahl. Immer vorhanden, ggf. leer
CountryTextLändercode (z. B. DE). Immer vorhanden, ggf. leer
Country_SubdivisionTextBundesland- oder Regionscode (z. B. BY)
PhoneTextTelefonnummer
EmailTextE-Mail-Adresse

Positionsfelder (Line)​

Workist schreibt ein Line-Element je Position, sofern mindestens ein Positionsfeld konfiguriert ist. Die Artikelnummern stammen aus Ihren Artikelstammdaten.

ElementTypBeschreibung
Batch_NumberTextChargennummer
DescriptionTextArtikelbeschreibung
Unit_of_MeasureTextMengeneinheit
QuantityDezimalBestellmenge
Unit_PriceDezimalEinzelpreis
Price_UnitDezimalPreiseinheit: Anzahl Einheiten, auf die sich der Einzelpreis bezieht (z. B. 1 oder 100)
Total_PriceDezimalPositionsgesamtpreis
Line_Discount_PercentTextRabatt in Prozent, so übernommen, wie in Workist erfasst
Line_Discount_AmountTextRabattbetrag, so übernommen, wie in Workist erfasst
Item_VariantTextArtikelvariante
Common_Item_NumberTextIhre Artikelnummer (article_id1 aus Ihren Artikelstammdaten)
Common_Item_Number_2TextZweite Artikelnummer (article_id2)
Common_Item_Number_3TextDritte Artikelnummer (article_id3, z. B. EAN)
Customer_Item_NumberTextArtikelnummer des Kunden
Item_Number_ConfidenceDezimalSicherheit der automatischen Artikelzuordnung zwischen 0 und 1, immer mit Dezimalkomma (z. B. 0,95)
Expected_Delivery_DateDatumLiefertermin der Position
Expected_Delivery_Time_FromTextBeginn des Lieferzeitfensters der Position (HH:MM)
Expected_Delivery_Time_UntilTextEnde des Lieferzeitfensters der Position (HH:MM)
Goods_Issue_DateDatumWarenausgangsdatum der Position
Commission_NumberTextKommissionsnummer der Position
Sales_OrganisationTextVerkaufsorganisation
PosTextPositionsnummer
Framework_Contract_NumberTextRahmenvertragsnummer der Position
Quote_Reference_NumberTextAngebotsnummer der Position
Container_QuantityTextUmgerechnete Menge (z. B. in Gebinden), so übernommen, wie in Workist erfasst
Container_TypeTextUmgerechnete Einheit (z. B. box)
Order_NumberTextBestellnummer der Position (z. B. bei Sammelbestellungen)
Sell_to_CustomerBlockKunde dieser Position bei Sammelbestellungen
Sell_to_Customer/Customer_NumberTextKundennummer
Sell_to_Customer/NameTextKundenname
Sell_to_Customer/Customer_AddressBlockAdresse dieses Kunden; Felder siehe Adressfelder
CurrencyTextWährung der Position (z. B. EUR)
Article_CommentsTextBemerkung zur Position
Article_MarkingsTextMarkierung 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 Sie erp_locked unter 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​

ElementInhalt
EDI_DC40Kontrollsatz. 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).
E1EDK01Belegkopf: 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.
E1EDP01Eine 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.

FeldStandardMax. Zeichen
MANDT050–
SNDPORWORKIST10
SNDPRTLS2
SNDPRNWORKIST10
RCVPORXML_WKI10
RCVPRTLS2
RCVPRNSUPPLIER10
RECIPNT_NOSUPPLIER10

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​

ElementInhalt
CONTROL_INFOGENERATOR_INFO = Workist, GENERATION_DATE = Erstellungszeitpunkt (UTC).
SOURCING_INFONur, wenn eine Angebots- oder Projektnummer erfasst ist: QUOTATION_ID = Angebotsnummer, AGREEMENT_ID = Projektnummer, AGREEMENT_END_DATE = Erstellungszeitpunkt (Pflichtangabe des Standards ohne fachliche Bedeutung).
ORDER_INFOORDER_ID = Bestellnummer, ORDER_DATE = Bestelldatum, CURRENCY = immer EUR.
DELIVERY_DATENur mit Liefertermin: DELIVERY_START_DATE = Liefertermin, DELIVERY_END_DATE = Ende des Lieferzeitraums (sonst der Liefertermin).
PARTY document_creatorWorkist als Ersteller: PARTY_ID = workist (type = party_specific), PARTY_ROLE = document_creator.
PARTY supplierSie als Lieferant, fester Platzhalter: PARTY_ID = supplier (type = party_specific), PARTY_ROLE = supplier.
PARTY buyerBestellender 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 deliveryLieferadresse, 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_recipientRechnungsadresse, 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_REFERENCEBUYER_IDREF = Kundennummer, SUPPLIER_IDREF = supplier, INVOICE_RECIPIENT_IDREF = Adressnummer der Rechnungsadresse, DELIVERY_IDREF = Adressnummer der Lieferadresse.
ORDER_ITEMEine 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_IDSUPPLIER_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_SUMMARYTOTAL_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​

ElementInhalt
cXMLpayloadID = ID des Dokuments in Workist, timestamp = Erstellungszeitpunkt.
FromCredential (domain = SystemId) = Kundennummer.
ToCredential (domain = SystemId) = Empfänger-ID, standardmäßig supplier.
SenderCredential (domain = SystemId) = workist, UserAgent = Workist Platform.
Request, OrderRequestdeploymentMode = production (oder test, siehe unten).
OrderRequestHeaderorderID = Bestellnummer, orderDate = Bestelldatum mit Uhrzeit (2025-03-15T00:00:00+00:00), orderType = regular, orderVersion = 1, type = new.
TotalMoney = Nettogesamtbetrag (0.0, wenn keiner erfasst ist), currency = Währung der Bestellung (sonst EUR).
ShipToLieferadresse, 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).
BillToDer 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.
ContactAnsprechpartner, 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.
ItemOutEine 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:

EinstellungStandardBeschreibung
Empfänger-IDsupplierWert im Credential unter To
Deployment-ModusproductiondeploymentMode von Request und OrderRequest, z. B. test für Testsysteme

Hinweise​

  • BillTo enthä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​

SegmentInhalt
ISAInterchange-Kopf: Absender-ID = Kundennummer, Empfänger-ID = Ihr Workist-Kurzname (je auf 15 Zeichen aufgefüllt), Datum (JJMMTT) = Bestelldatum, Uhrzeit 0000, Version 00401, Kontrollnummer
GSFunktionsgruppe PO, Absender = Kundennummer, Datum = Bestelldatum, Version 004010
STTransaktion 850 und Kontrollnummer
BEG00 (Original), Bestellnummer, Bestelldatum (JJJJMMTT)
PERAnsprechpartner (BD): Name, Telefon (TE), E-Mail (EM)
DTM002 = Liefertermin (JJJJMMTT)
MSGFreitext der Bestellung (nur, wenn vorhanden)
N1ST, Name und Nummer des bestellenden Kunden. Eine Lieferadresse wird nicht übertragen
PO1Position: Positionsnummer, Menge, Einheit, Einzelpreis, VN und Ihre Artikelnummer
PIDF (Freitext) und Artikelbeschreibung
CTTAnzahl der Positionen
SEAnzahl der Segmente der Transaktion und Kontrollnummer
GEAnzahl der Transaktionen und Kontrollnummer
IEAAnzahl der Funktionsgruppen und Kontrollnummer

PO1 und PID wiederholen sich für jede Position. Die Feldauswahl Ihres Kanals ändert den Aufbau nicht.