# Lieferscheine (Delivery Notes)

## openTRANS 2.1 {#opentrans}

**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
<?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. |