openTRANS 2.0

openTRANS 2.0

Einführung

Für die Übergabe von Warenkörben/Bestellungen an externe Systeme (z.B. Warenwirtschaften) verwenden wir das Format openTRANS in den Versionen 1.0 und 2.0. Die vollständige Beschreibung des openTRANS-Standards finden Sie auf der openTRANS Website, diese Dokumentation beschreibt daher nur Besonderheiten unserer Implementierung sowie die verwendeten Felder.

openTRANS ist ein offener Standard zur Unterstützung des elektronischen Datenaustauschs (EDI) bei Geschäftstransaktionen zwischen Handelsunternehmen. Der Standard begründete sich in einer Initiative von Industrie- und Handelsunternehmen unter der Leitung von Fraunhofer IAO in Kooperation mit der Universität Duisburg-Essen BLI mit dem Ziel einer Standardisierung von Geschäftsprozessdokumenten (z. B. Lieferavis, Rechnung) als Grundlage für eine elektronische System-zu-System-Kommunikation.

Quelle: wikipedia (https://de.wikipedia.org/wiki/OpenTRANS)

Überblick

openTRANS 2.0 ist die von uns aktuell unterstützte Version. Verwenden Sie eine der Implementierungen für neue Schnittstellen. Anpassungen sind bei begründetem Bedarf möglich und werden als eine eigene Schnittstellenversion geführt. Bitte wenden Sie sich bei Bedarf per Mail an support@cobai.com und beschreiben Sie Ihren Anwendungsfall.

Für Version 2.0 der openTRANS-Schnittstelle existieren die folgenden Implementierungen:

Standard: Unsere Standardimplementierung. Bei Bedarf werden Erweiterungen implementiert, der vorhandene Funktionsumfang bleibt aber garantiert erhalten. Sollten Erweiterungen die Abwärtskompatibilität beeinträchtigen erzeugen wir eine neue Variante der Schnittstelle

Gega-IT: Eine angepasste Version für Nutzer des Warenwirtschaftssystems der Firma Gega-IT. Sie können dieses Format auch für andere Anbindungen verwenden, wir garantieren allerdings nicht das der implementierte Umfang erhalten bleibt.

openTRANS 2.0 - Standardformat

Beispielbestellung

Felder

Felder die nicht in dieser Liste enthalten sind sollten selbsterklärend sein. Sie finden ihre Bedeutung in der offiziellen openTRANS-Dokumentation.

ORDER_HEADER/ORDER_INFO/ORDER_ID

Eine eindeutige Id für die Bestellung. Die Id ist garantiert eindeutig innerhalb eines Shops und innerhalb aller von uns gehosteten Shops.

ORDER_HEADER/ORDER_INFO/PARTIES/PARTY[PARTY_ROLE='delivery']

Abhängig vom Inhalte der Felder "Kundennummer (extern)" und "WE-Nummer" werden in den Kindelementen dieses Knotens unterschiedliche Informationen übergeben:

• Ist das Feld "WE-Nummer" gefüllt wird eine PARTY_ID mit type="supplier_specific" übergeben. Wert ist der Inhalt aus dem Feld "WE-Nummer".
• Ist das Feld "WE-Nummer" nicht gefüllt wird eine PARTY_ID mit type="buyer_specific" übergeben. Wert ist der Inhalt aus dem Feld "Kundennummer (extern)". Bitte beachten Sie, dass dadurch auch eine leere PARTY_ID übergeben werden kann.
• Ist dem Auftrag kein Kunde zugeordnet (z.B. wenn er direkt im opCenter ohne Kunde erzeugt wurde) wird ebenfalls eine PARTY_ID mit type="supplier_specific" übergeben. Wert ist in diesem Fall die dem Shop zugeordnete Kundennummer des Shopbetreibers.

ORDER_HEADER/ORDER_INFO/PARTIES/PARTY[PARTY_ROLE='delivery']/ADDRESS/CONTACT_DETAIL

Dieser Knoten wird nur übergeben wenn der Bestellung ein Kunde zugeordnet ist. Der Unterknoten EMAILS/EMAIL enthält die Mailadresse des bestellenden Nutzers.

ORDER_ITEM_LIST/ORDER_ITEM/QUANTITY

Stückzahl einer Position. Ist für den Artikel der aktuellen Position eine Preiseinheit ungleich Eins definiert wird

• der Einzelpreis durch die Preiseinheit dividiert
• die Stückzahl mit der Preiseinheit multipliziert

Siehe auch ORDER_ITEM_LIST/ORDER_ITEM/PRODUCT_PRICE_FIX/PRICE_AMOUNT

ORDER_ITEM_LIST/ORDER_ITEM/PRODUCT_PRICE_FIX/PRICE_AMOUNT

Einzelpreis einer Position. Ist für den Artikel der aktuellen Position eine Preiseinheit ungleich Eins definiert wird

• der Einzelpreis durch die Preiseinheit dividiert
• die Stückzahl mit der Preiseinheit multipliziert

Siehe auch ORDER_ITEM_LIST/ORDER_ITEM/QUANTITY

openTRANS 2.0 - Gega-IT Format