mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-25 06:00:28 +01:00
1 line
6.5 KiB
Plaintext
1 line
6.5 KiB
Plaintext
<h1><strong><span style="font-size:28px;">Amazon Vendor</span></strong></h1><p>Mit Hilfe der Amazon Vendor-Schnittstelle können Lieferungen für das Amazon Vendorenprogramm bearbeitet werden. Voraussetzung ist das <a href="index.php?module=uebertragungen&action=list&cmd=uebertragungen" target="_blank">Übertragungen Modul</a>.<br /><br />Dazu ist es möglich Bestellungen von Amazon zu empfangen und zu verarbeiten (ORDER).<br />Nach Abschluß der Lieferung kann gegenüber Amazon angerechnet werden (INVOICE).<br /><br />Die Datenübertragung erfolgt z.B. mit SFTP. Alternativ kann AS2 verwendet werden, ein signiertes Nachrichtenverfahren für das wir Ihnen bei Bedarf in Form eines AS2-Servers bereitstellen können - wir unterstützen Sie auch beim Prozess der Freischaltung durch amazon. Bitte wenden Sie sich dazu an unseren Vertrieb.<br /> </p><h1>EDI-Verbindung</h1>EDI Messages sind in in Codezeilen unterteilt, in denen jeweils genau definierte Daten übermittelt werden.<br /> <h2>UNB: Kommunikationspartner</h2>Die UNB Zeile definiert unter anderem den Empfänger und Absender. Das "Gegenüber" erwartet hier meist ein "weltweit" eindeutiges Kennzeichen für den Kommunikationspartner.<br />Dafür existieren verschiedene Möglichkeiten:<ul><li>Quasi-Standard ist hier eine GLN (Global Location Number, früher auch ILN) aus dem GS1 System (vormals EAN System), die in Deutschland von der <a href="https://gs1.de">GS1.de</a> verwaltet wird. Diese GLN UNB ID Typ "14" ist aber nur eine Möglichkeit von vielen.</li><li>Für einen schnellen Start und wenn die Schnittstellte selbst entwickelt wird kann als UNB-ID auch der Typ "9" gewählt werden, dort wird die DUNS Nummer (auch D-U-N-S, kurz für Data Universal Numbering System) erwartet, die unter <a href="https://www.upik.de/upik_suche.cgi">https://www.upik.de/upik_suche.cgi</a> abgefragt werden kann. Alle Kapitalgesellschaften bekommen nach Anmeldung bei den entsprechenden Behörden automatisch eine DUNS-Nummer zugewiesen.</li><li>Zuletzt besteht auch die Möglichkeit die Telefonnummer mit intl. Vorwahl und als UNB-ID Typ "12" zu verwenden.<br /> </li></ul><h2>Übertragungsstandard EDI / EDIFACT</h2>Bei EDI/EDIFACT wird so gut wie alles mit Codelisten übertragen, denn das Protokoll stammt aus den 1980er Jahren wo jedes Byte noch teuer war. Dafür existieren einige Quellen, die das Format erläutern und den Umgang damit aufzeigen:<ul><li>Einen guten Einstieg bekommt man unter <a href="https://www.stylusstudio.com/edifact/">https://www.stylusstudio.com/edifact/</a></li><li>etwas komplizierter aber dafür sehr umfangreich <a href="https://service.unece.org/trade/untdid/d96a/trmd/orders_t.htm">https://service.unece.org/trade/untdid/d96a/trmd/orders_t.htm</a></li></ul>Die Datenübertragung erfolgt z.B. mit SFTP ausschließlich per keyfile (ssh pub-key), alternativ wird AS2 verwendet. Wir können Ihnen dazu bei Bedarf einen AS2-Server bereitstellen, bitte wenden Sie sich dazu an unseren Vertieb oder den Partner-Betreuer. Die EDI-Datei an sich ist eine reine Textdatei, idealerweise codiert in UTF8 - das ist aber nicht zwingend im Standard vorgeschrieben. Wird eine Datei vom Gegenüber gesendet die nur eine eine Zeile enthält, kann das EDI Satzendzeichen ' (einfaches Anführungszeichen, das wird im UNA Segment definiert) durch ein LF bzw. CR/LF ersetzen damit wird die Struktur sehr gut lesbar.<br />Bestimme Segmente können in EDI mehrfach vorkommen und haben dann evtl. eine unterschiedliche Bedeutung z.B. Daten im Kopf (Header) und auf Positions-Ebene.<h2><br />Beispiel ORDER</h2>Zum schnellen Start in das Thema haben wir ein paar Segmente in einer ORDER zusammengefasst - so lässt sich schnell verstehen, wie eine ORDER zu parsen wäre.<br /><br />BGM+220+4HQ7EBLG+9' → Bestellung mit PO Nummer 4HQ7EBLG,<br /> → die 9 am Schluss bedeutet es werden die EAN/GS1 Codelisten verwendet<br />DTM+137:20190107:102' → Belegdatum im Format 102<br />DTM+63:20190111:102' → Lieferdatum spätestens im Format 102<br />DTM+64:20190107:102' → Lieferdatum frühstens im Format 102<br /><br />Benötigt wird das GLN Verzeichnis aus dem Vendor-Central, damit die Lieferadressen zugeordnet werden können.<br /><br />NAD+BY+5450534000017::9' → Käufer, GLN Codiert<br />NAD+SU+4016428000009::9' → Lieferant, hier wird die eigene UNB-ID wieder angegeben<br />NAD+DP+5450534002325::9+++++++DE' → Lieferadresse mit Land<br />NAD+IV+5450534005838::9++AMAZON EU SARL:NIEDERLASSUNG DEUTSCHLAND+MARCEL-BREUER-STR. 12+MUENCHEN++80807+DE'<br /> → Rechnungsadresse als GLN und Klartext muss in der INVOICE Message auch komplett<br /> → im Klartext übertragen werden.<br /><br />Im Folgenden (ab LIN) beginnen die Positionen, zwischen NAD und LIN können noch weitere Zeilen kommen zb. RFF (Referenz jeweils zum aktuellen Element) und CUX (hier wird die Währung definiert).<br /><br />Jedes LIN definiert den Beginn einer neuen Position an (LIN+1, LIN+2, LIN+3 usw.)<br />LIN+1++4016428352115:EN' → Artikel Pos 1 mit Artikel EAN, EN=Datenherkunft EAN, könnte evtl. auch SA sein<br />QTY+21:52' → Pos Menge in Stück<br />PRI+AAA:55.9' → Preis pro Stück netto<br /><br />Im Anschluss folgen noch Rahmendaten die vor allem der Validierung dienen:<ul><li>Mit UMS+S beginnt der Summenblock, der mit Hilfe verschiedener Summen eine Validierung ermöglicht.</li><li>Sollten mehrere Belege ein einer UNB Übertragung enthalten sein, folgen diese nun durch ein UNH bzw. BGM getrennt wieder mit dem Belegkopf.</li></ul> |