Auftragsbestätigungen (Order Confirmations)

openTRANS 2.1

Dateiendung: .xml
Dateiname: <ID>.xml

Auftragsbestätigungen liefert Workist im openTRANS-2.1-Format ORDERRESPONSE. Bei Auftragsbestätigungen sind Sie der Käufer: Das Dokument kommt von Ihrem Lieferanten und bestätigt Ihre Bestellung.

Die Grundstruktur entspricht der des Lieferscheins. Zusätzlich enthält die Auftragsbestätigung Einzelpreise, Positionssummen, Liefertermine je Position und den Nettogesamtbetrag. Die Nummer der Auftragsbestätigung steht in SUPPLIER_ORDER_ID, ihr Datum in ORDERRESPONSE_DATE.

Das Format hat eine feste Struktur. Die Feldauswahl Ihres Kanals ändert es nicht. Jede Position braucht eine Menge, die sich als Zahl lesen lässt, sonst erzeugt Workist keine Datei. Formate wie proALPHA baut Workist auf Anfrage, siehe Individuelle Formate auf Anfrage.

Vollständiges Beispiel

<?xml version="1.0" encoding="utf-8"?>
<ORDERRESPONSE 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">
  <ORDERRESPONSE_HEADER>
    <CONTROL_INFO>
      <GENERATOR_INFO>Workist</GENERATOR_INFO>
      <GENERATION_DATE>2025-03-15T14:30:25.123456</GENERATION_DATE>
    </CONTROL_INFO>
    <ORDERRESPONSE_INFO>
      <ORDER_ID>PO-2025-0001</ORDER_ID>
      <ORDERRESPONSE_DATE>2025-03-18</ORDERRESPONSE_DATE>
      <ALT_CUSTOMER_ORDER_ID>https://wb.workist.com/order-confirmations/3f2b8c1e-5a7d-4e19-8c2f-6b0d9a4e7c15</ALT_CUSTOMER_ORDER_ID>
      <SUPPLIER_ORDER_ID>OC-2025-0042</SUPPLIER_ORDER_ID>
      <DELIVERY_DATE>
        <DELIVERY_START_DATE>2025-04-01</DELIVERY_START_DATE>
        <DELIVERY_END_DATE>2025-04-01</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">K-1001</bmecat:PARTY_ID>
          <PARTY_ROLE>buyer</PARTY_ROLE>
        </PARTY>
        <PARTY>
          <bmecat:PARTY_ID>SUP-500</bmecat:PARTY_ID>
          <PARTY_ROLE>supplier</PARTY_ROLE>
          <ADDRESS>
            <bmecat:NAME>Best Supplier GmbH</bmecat:NAME>
            <bmecat:STREET>Lieferantenweg 10</bmecat:STREET>
            <bmecat:ZIP>20095</bmecat:ZIP>
            <bmecat:CITY>Hamburg</bmecat:CITY>
            <bmecat:COUNTRY>DE</bmecat:COUNTRY>
            <bmecat:COUNTRY_SUBDIVISION>HH</bmecat:COUNTRY_SUBDIVISION>
          </ADDRESS>
        </PARTY>
        <PARTY>
          <bmecat:PARTY_ID>WH-01</bmecat:PARTY_ID>
          <PARTY_ROLE>delivery</PARTY_ROLE>
          <ADDRESS>
            <bmecat:NAME>Acme Corporation GmbH</bmecat:NAME>
            <bmecat:NAME2>Goods Receipt</bmecat:NAME2>
            <bmecat:STREET>Lager Strasse 5</bmecat:STREET>
            <bmecat:ZIP>20095</bmecat:ZIP>
            <bmecat:CITY>Hamburg</bmecat:CITY>
            <bmecat:COUNTRY>DE</bmecat:COUNTRY>
            <bmecat:COUNTRY_SUBDIVISION>HH</bmecat:COUNTRY_SUBDIVISION>
          </ADDRESS>
        </PARTY>
      </PARTIES>
      <ORDER_PARTIES_REFERENCE>
        <bmecat:BUYER_IDREF>K-1001</bmecat:BUYER_IDREF>
        <bmecat:SUPPLIER_IDREF>SUP-500</bmecat:SUPPLIER_IDREF>
      </ORDER_PARTIES_REFERENCE>
      <MIME_INFO>
        <MIME>
          <bmecat:MIME_TYPE>application/pdf</bmecat:MIME_TYPE>
          <bmecat:MIME_SOURCE>9f8c2b7e-4d1a-4c3e-9b6f-2a7d5e1c0b34.pdf</bmecat:MIME_SOURCE>
          <MIME_PURPOSE>original_document</MIME_PURPOSE>
        </MIME>
      </MIME_INFO>
    </ORDERRESPONSE_INFO>
  </ORDERRESPONSE_HEADER>
  <ORDERRESPONSE_ITEM_LIST>
    <ORDERRESPONSE_ITEM>
      <LINE_ITEM_ID>10</LINE_ITEM_ID>
      <PRODUCT_ID>
        <bmecat:SUPPLIER_PID type="supplier_specific">SUP-ART-777</bmecat:SUPPLIER_PID>
        <bmecat:INTERNATIONAL_PID>4006381333931</bmecat:INTERNATIONAL_PID>
        <bmecat:BUYER_PID>ART-001-A</bmecat:BUYER_PID>
        <bmecat:DESCRIPTION_LONG>Industrial Sensor Module Type A</bmecat:DESCRIPTION_LONG>
      </PRODUCT_ID>
      <QUANTITY>100.0</QUANTITY>
      <bmecat:ORDER_UNIT>PCE</bmecat:ORDER_UNIT>
      <PRODUCT_PRICE_FIX>
        <bmecat:PRICE_AMOUNT>12.5</bmecat:PRICE_AMOUNT>
      </PRODUCT_PRICE_FIX>
      <PRICE_LINE_AMOUNT>1250.0</PRICE_LINE_AMOUNT>
      <DELIVERY_DATE>
        <DELIVERY_START_DATE>2025-04-01</DELIVERY_START_DATE>
        <DELIVERY_END_DATE>2025-04-01</DELIVERY_END_DATE>
      </DELIVERY_DATE>
    </ORDERRESPONSE_ITEM>
  </ORDERRESPONSE_ITEM_LIST>
  <ORDERRESPONSE_SUMMARY>
    <TOTAL_ITEM_NUM>1</TOTAL_ITEM_NUM>
    <TOTAL_AMOUNT>1250.0</TOTAL_AMOUNT>
  </ORDERRESPONSE_SUMMARY>
</ORDERRESPONSE>

Elemente

Element	Inhalt
`CONTROL_INFO`	`GENERATOR_INFO` = `Workist`, `GENERATION_DATE` = Erstellungszeitpunkt (UTC).
`ORDERRESPONSE_INFO`	`ORDER_ID` = Ihre Bestellnummer, die bestätigt wird; `ORDERRESPONSE_DATE` = Datum der Auftragsbestätigung; `ALT_CUSTOMER_ORDER_ID` = Link zur Auftragsbestätigung in der Workbench (nur mit Link zur Workbench einfügen); `SUPPLIER_ORDER_ID` = Nummer der Auftragsbestätigung (wenn vorhanden).
`DELIVERY_DATE`	Nur mit Liefertermin: `DELIVERY_START_DATE` und `DELIVERY_END_DATE` = bestätigter Liefertermin.
`PARTY` `document_creator`	Workist als Ersteller: `PARTY_ID` = `workist` (`type` = `party_specific`), `PARTY_ROLE` = `document_creator`.
`PARTY` `buyer`	Sie als Käufer: `PARTY_ID` (`type` = `party_specific`) = Kundennummer des Käufers (Sie bzw. Ihre Niederlassung), sonst `buyer`; `PARTY_ROLE` = `buyer`. Ohne Adresse.
`PARTY` `supplier`	Lieferant, wenn erkannt: `PARTY_ID` = Lieferantennummer aus Ihren Stammdaten, `PARTY_ROLE` = `supplier`; `NAME`, `STREET`, `ZIP`, `CITY`, `COUNTRY` (Ländercode), `COUNTRY_SUBDIVISION`.
`PARTY` `delivery`	Lieferadresse: `PARTY_ID` = Adressnummer, `PARTY_ROLE` = `delivery`; `NAME` = Firma, `NAME2` = Name, `STREET`, `ZIP`, `CITY`, `COUNTRY` (Ländercode), `COUNTRY_SUBDIVISION`.
`ORDER_PARTIES_REFERENCE`	`BUYER_IDREF` = `PARTY_ID` des Käufers, `SUPPLIER_IDREF` = Lieferantennummer.
`MIME_INFO`	Nur mit Verweis auf die analysierte Datei einfügen: `MIME_TYPE` = `application/pdf`, `MIME_SOURCE` = Dateiname des Originaldokuments, das Workist mitliefert (`<ID>.pdf`), `MIME_PURPOSE` = `original_document`.
`ORDERRESPONSE_ITEM`	Eine je Position: `LINE_ITEM_ID` = Positionsnummer (mit Position überschreiben die Position der zugeordneten Bestellposition), `QUANTITY` = Menge mit Dezimalpunkt (z. B. `100.0`), `ORDER_UNIT` = Mengeneinheit, `PRICE_LINE_AMOUNT` = Positionsgesamtpreis (`0.0`, wenn keiner erfasst ist).
`PRODUCT_ID`	`SUPPLIER_PID` (`type` = `supplier_specific`) = Artikelnummer des Lieferanten, wie auf dem Dokument; `INTERNATIONAL_PID` = dritte Artikelnummer aus Ihren Stammdaten (`article_id3`, z. B. EAN); `BUYER_PID` = Ihre Artikelnummer (`article_id1`); `DESCRIPTION_LONG` = Artikelbeschreibung.
`PRODUCT_PRICE_FIX`	`PRICE_AMOUNT` = Einzelpreis mit Dezimalpunkt (`0.0`, wenn keiner erfasst ist).
`DELIVERY_DATE` (Position)	Liefertermin der Position in `DELIVERY_START_DATE` und `DELIVERY_END_DATE` (wenn vorhanden).
`ORDERRESPONSE_SUMMARY`	`TOTAL_ITEM_NUM` = Anzahl der Positionen, `TOTAL_AMOUNT` = Nettogesamtbetrag (wenn vorhanden).

Optionen

Diese Optionen der Ausgabedatei-Konfiguration wirken bei Auftragsbestätigungen:

Option	Wirkung
Verweis auf die analysierte Datei einfügen (standardmäßig aktiv)	Schreibt `MIME_INFO` mit dem Dateinamen des mitgelieferten Originaldokuments.
Link zur Workbench einfügen	Schreibt den Link zur Auftragsbestätigung in der Workbench in `ALT_CUSTOMER_ORDER_ID`.
Position überschreiben	Wurde eine Position beim Abgleich mit Ihren Bestellungen einer Bestellposition zugeordnet, schreibt Workist deren Positionsnummer in `LINE_ITEM_ID`. Sonst bleibt die Positionsnummer der Auftragsbestätigung.
Kurzen externen Dateinamen verwenden	Verwendet eine kurze ID statt einer UUID im Dateinamen.

openTRANS 2.1​

Vollständiges Beispiel​

Elemente​

Optionen​

openTRANS 2.1

Vollständiges Beispiel

Elemente

Optionen