Lieferscheine (Delivery Notes)

openTRANS 2.1

Dateiendung: .xml
Dateiname: <ID>.xml

Lieferscheine liefert Workist im openTRANS-2.1-Format ORDERRESPONSE. Bei Lieferscheinen sind Sie der Käufer: Das Dokument kommt von Ihrem Lieferanten und bezieht sich auf Ihre Bestellung.

Das Format hat eine feste Struktur. Die Feldauswahl Ihres Kanals ändert es nicht. Preise und Liefertermine je Position sind nicht enthalten. Die Lieferscheinnummer steht in SUPPLIER_ORDER_ID, das Lieferscheindatum in ORDERRESPONSE_DATE. Mit Kurzen externen Dateinamen verwenden erhält die Datei eine kurze ID statt einer UUID; die übrigen Optionen der Ausgabedatei-Konfiguration wirken bei Lieferscheinen nicht.

Jede Position braucht eine Menge, die sich als Zahl lesen lässt, sonst erzeugt Workist keine Datei.

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-20</ORDERRESPONSE_DATE>
      <SUPPLIER_ORDER_ID>DN-2025-300</SUPPLIER_ORDER_ID>
      <DELIVERY_DATE>
        <DELIVERY_START_DATE>2025-03-20</DELIVERY_START_DATE>
        <DELIVERY_END_DATE>2025-03-20</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>
    </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>
    </ORDERRESPONSE_ITEM>
  </ORDERRESPONSE_ITEM_LIST>
  <ORDERRESPONSE_SUMMARY>
    <TOTAL_ITEM_NUM>1</TOTAL_ITEM_NUM>
  </ORDERRESPONSE_SUMMARY>
</ORDERRESPONSE>

Elemente

Element	Inhalt
CONTROL_INFO	GENERATOR_INFO = Workist, GENERATION_DATE = Erstellungszeitpunkt (UTC).
ORDERRESPONSE_INFO	ORDER_ID = Ihre Bestellnummer, auf die sich der Lieferschein bezieht; ORDERRESPONSE_DATE = Lieferscheindatum; SUPPLIER_ORDER_ID = Lieferscheinnummer (wenn vorhanden).
DELIVERY_DATE	Nur mit Lieferdatum: DELIVERY_START_DATE und DELIVERY_END_DATE = Lieferdatum.
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.
ORDERRESPONSE_ITEM	Eine je Position: LINE_ITEM_ID = Positionsnummer, QUANTITY = Menge mit Dezimalpunkt (z. B. 100.0), ORDER_UNIT = Mengeneinheit.
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.
ORDERRESPONSE_SUMMARY	TOTAL_ITEM_NUM = Anzahl der Positionen.