# Auftragsbestätigungen (Order Confirmations)

## openTRANS 2.1 {#opentrans}

**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](/docs/output-formats/delivery-notes.md#opentrans). 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](/docs/output-formats.md#custom-formats).

### 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-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](/docs/channel-configuration/exported-documents.md) 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](/docs/channel-configuration/document-processing/matching.md) 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. |