# EDI

> Unser Electronic Data Interchange (EDI)-Bestellsystem vereinfacht den Empfang von Bestellungen, indem es diese direkt an Ihr ERP- oder Auftragsverwaltungssystem sendet.

Source: https://www.purchaseplus.com/de/docs/for-suppliers/electronic-data-interchange-edi-purchase-orders

Markdown: https://www.purchaseplus.com/de/docs/for-suppliers/electronic-data-interchange-edi-purchase-orders.md

# EDI
Direkt zu:

-   [Übersicht](#Overview)
-   [Vorteile](#Benefits)
-   [Erste Schritte](#GettingStartedWithEDI)
-   [Unterstützte Datenformate](#SupportedFormats)
-   [JSON-Beispiel-Payload](#SampleJSONPayload)
-   [Wichtige Felder](#ImportantFields)

### Übersicht

Unser Electronic Data Interchange (EDI)-Bestellsystem vereinfacht den Empfang von Bestellungen, indem es diese direkt an Ihr ERP- oder Auftragsverwaltungssystem sendet und so die manuelle Dateneingabe überflüssig macht.

Wir empfehlen EDI für den Empfang von Bestellungen insbesondere für mittlere bis größere Lieferanten und solche mit starken Integrationsmöglichkeiten.

### Vorteile

EDI-Bestellungen helfen Lieferanten, effizienter zu arbeiten, da Bestellungen nicht mehr manuell in ein Enterprise Resource Planning (ERP)- oder Auftragsverwaltungssystem eingegeben werden müssen. Sie verbessern außerdem die Genauigkeit durch die Reduzierung manueller Fehler und beschleunigen die Auftragsabwicklung zwischen Einkäufern und Lieferanten. Wir sind davon überzeugt, dass ein schnellerer und präziserer Datenaustausch zu weniger Problemen bei Bestellungen führt, wovon Einkäufer, Lieferanten und wir gleichermaßen profitieren.

In der Vergangenheit kam es vor, dass Lieferanten Bestellungen per E-Mail nicht erhielten, weil Spam-Filter diese fälschlicherweise blockierten. Obwohl wir einen verwalteten E-Mail-Dienst nutzen, können solche E-Mails gelegentlich dennoch blockiert werden.

Wir sind zudem überzeugt, dass HTTPS oder SFTP – die für EDI verwendeten Protokolle – eine robustere und sicherere Möglichkeit für den Austausch vertraulicher Bestellinformationen bieten als E-Mail.

### Erste Schritte

1.  Endpunkt einrichten: Sie müssen einen Endpunkt für den Empfang von Bestellungen einrichten. Alternativ können entweder Sie oder wir ein SFTP-Verzeichnis einrichten.
    
2.  Kontakt aufnehmen: Sobald Ihr Endpunkt bereit ist (oder wenn Sie möchten, dass wir ein SFTP-Verzeichnis einrichten), wenden Sie sich bitte mit den Details zu Ihrem Endpunkt an unser Team unter [help.suppliers@purchaseplus.com](mailto:help.suppliers@purchaseplus.com).
    
3.  Integration: Wir fügen Ihren Endpunkt zu unserem System hinzu.
    
4.  Testen: Um einen reibungslosen Übergang zu gewährleisten, können wir einen kleinen Test durchführen, indem wir ein oder zwei Einkäufer auf den neuen Endpunkt umstellen. Alternativ können wir E-Mail und EDI während einer Testphase parallel laufen lassen.
    
5.  Pilotphase: Wir wählen gemeinsam mit Ihnen eine kleine Gruppe von Testkunden aus, die auf den neuen Endpunkt umgestellt werden.
    
6.  Vollständige Implementierung: Sobald alles wie gewünscht funktioniert, stellen wir alle Ihre Bestellungen auf EDI um.
    

### Unterstützte Datenformate

Wir unterstützen in erster Linie JSON für EDI-Transaktionen. Wir können auch XML senden und stellen auf Anfrage gerne ein Payload-Beispiel zur Verfügung, unterstützen jedoch kein cXML.

### JSON-Beispiel-Payload

`{     "purchase_orders": [       {         "purchase_order": {           "identity": "singer.test.sleep",           "purchaser": {             "id": 262388,             "name": "Sample Purchaser",             "customer_number": "PUR12345",             "requestor": "Han Solo",             "phone": "1300 123 456",             "email": "han.solo@purchaseplus.com"           },           "supplier": {             "name": "Sample Supplier",             "vendor_number": "SUP98765"           },           "purchase_order_number": "PO00001",           "purchaser_reference": "Daily food order",           "supplier_reference": null,           "expected_delivery_date": "2025-03-15",           "sent_date": "2025-03-15T05:51:57.122Z",           "cancelled": false,           "comments": [],           "confirmation_instructions": "Confirmation instructions example.",           "delivery_instructions": "Delivery instructions example.",           "delivery_address": {             "location_name": "Default",             "line1": "Level 4, 11 York Street",             "line2": "",             "city": "Sydney",             "state_province": "NSW",             "postal_code": "2000",             "country_code": "AU"           },           "currency": "AUD",           "net_amount": 826.1,           "delivery_amount": 0,           "tax_amount": 20.25,           "gross_amount": 846.35,           "lines": [             {               "code": "YOGH",               "brand": "Farmers Union",               "item_description": "Greek Style Yoghurt : Natural",               "item_size": 1,               "item_measure": "lt",               "item_package": "tub",               "pack_quantity": 1,               "pack_name": "each",               "gs1_code": null,               "order_instruction": null,               "unit_price": 6.75,               "quantity": 30,               "net_amount": 202.5,               "tax_amount": 20.25,               "gross_amount": 222.75,               "is_purchaser_price": true             },             {               "code": "WMBD",               "brand": "Mighty Soft",               "item_description": "Bread Sliced Wholemeal Sandwich Frozen",               "item_size": 650,               "item_measure": "g",               "item_package": null,               "pack_quantity": 10,               "pack_name": "carton",               "gs1_code": null,               "order_instruction": null,               "unit_price": 20,               "quantity": 25,               "net_amount": 500,               "tax_amount": 0,               "gross_amount": 500,               "is_purchaser_price": true             },             {               "code": "MILK",               "brand": "Pauls - Professional",               "item_description": "Milk : Full Cream",               "item_size": 3,               "item_measure": "lt",               "item_package": "bottle",               "pack_quantity": 6,               "pack_name": "carton",               "gs1_code": null,               "order_instruction": null,               "unit_price": 8.24,               "quantity": 15,               "net_amount": 123.6,               "tax_amount": 0,               "gross_amount": 123.6,               "is_purchaser_price": true             }           ]         }       }     ]   }` 

### Umgang mit Stornierungen

Gelegentlich storniert ein Einkäufer eine Bestellung über die Benutzeroberfläche und entscheidet sich dafür, eine Stornierungsbenachrichtigung zu senden. Dadurch wird ein Duplikat der Webhook-Payload gesendet, bei dem das Feld `cancelled` auf `true` gesetzt ist.

Bitte stellen Sie sicher, dass Sie diese entweder vollständig herausfiltern oder über eine Benachrichtigung an Ihr Support-Team verarbeiten.

Wir schulen Benutzer darin, sich direkt an den Lieferanten zu wenden, wenn sie eine Bestellung stornieren oder ändern möchten, da Systeme dies nicht immer zuverlässig verarbeiten.

### Wichtige Felder

| **Feld** | **Beschreibung** |
| --- | --- |
| `identity` | Eine eindeutige, aus drei Wörtern bestehende Kennung, die die Beziehung zwischen einem bestimmten Lieferantenkonto und einem Einkäuferkonto darstellt. Diese Kennung ist für jede Einkäufer-Lieferanten-Kombination eindeutig und kann als `identity` beim Senden von Rechnungen an PurchasePlus verwendet werden. |
| `vendor_number` | Eine eindeutige Kennung, die Sie jedem Einkäufer in Ihrem System zuweisen. Dadurch können Sie Einkäufer über verschiedene Systeme hinweg abgleichen. Dieses Feld kann im PurchasePlus-Portal aktualisiert werden. |
| `purchase_order_number` | Die vom Einkäufer zugewiesene Bestellnummer. Obwohl sie nicht global eindeutig ist, ist sie im Kontext eines einzelnen Einkäufers eindeutig. Um einen eindeutigen Schlüssel zu erstellen, verknüpfen Sie dieses Feld mit dem Feld `vendor_number`. Wichtig: Wenn der PurchasePlus-Benutzer das Feld „Einkäufercode“ leer lässt, kann die Verwendung dieser Verknüpfung als eindeutiger Schlüssel zu Problemen führen. |
| `cancelled` | Ein boolescher Wert (Flag), der angibt, ob die Bestellung vom Einkäufer in der MarketBoomer-Benutzeroberfläche storniert wurde. Wenn `true`, wurde die Bestellung storniert. MarketBoomer sendet die Bestellung bei einer Stornierung erneut mit diesem Feld auf `true` gesetzt. Die Verarbeitung dieses Felds ist optional, falls Ihr System Auftragsstornierungen nicht unterstützt, wird jedoch als Best Practice empfohlen. |
| `lines.code` | Der eindeutige Produktcode, den Sie jedem Produkt in unserem System zuweisen. Dieses Feld entspricht dem „Owner Code“ in P+ New oder dem „Lieferantencode“ in P+ Legacy. Sie können diesen Code in den jeweiligen P+-Oberflächen aktualisieren. |

Der eindeutige Produktcode, den Sie jedem Produkt in unserem System zuweisen. Dieses Feld entspricht dem „Owner Code“ in PurchasePlus oder dem „Lieferantencode“ in Legacy PurchasePlus. Sie können diesen Code in den jeweiligen P+-Oberflächen aktualisieren.
