eBusiness Integration

XML Guideline Version: V2.10c

eBusiness Integration XML Guideline

VERSIONSINFORMATION Version

Datum

Name

Beschreibung

2.00 2.10

07.10.2004 21.01.2005

Lars Rektorschek Lars Rektorschek

Freigabe Dokument Freigabe Dokument

2.10b 2.10c 2.10c

22.03.2005 03.05.2005 31.05.2005

Lars Rektorschek Lars Rektorschek Lars Rektorschek

Freigabe Dokument Freigabe Dokument Freigabe nach Anpassungen

Stand: 31.05.2005

Version: V2.10c

Seite 1

eBusiness Integration XML Guideline

INHALTSVERZEICHNIS 1.

Allgemeine Hinweise .............................................................................................................................. 3 1.1 Ziel des Dokuments ........................................................................................................................... 3 1.2 Erläuterungen zu den Schnittstellentabellen...................................................................................... 3 1.3 Ansprechpartner bei Actebis Holding GmbH ..................................................................................... 3 2. Kommunikationsparameter ................................................................................................................... 4 2.1 Codierung der XML Nachrichten........................................................................................................ 4 2.2 Kommunikationsprotokolle................................................................................................................. 4 2.2.1 Eingehende Nachrichten (Partner à Actebis) ............................................................................ 4 2.2.2 Ausgehende Nachrichten (Actebis à Partner) ........................................................................... 4 2.3 Prämissen für die HTTP Kommunikation........................................................................................... 5 2.3.1 MIME Header .............................................................................................................................. 5 2.3.2 HTTP Methoden.......................................................................................................................... 5 2.3.3 HTTP Status Codes .................................................................................................................... 5 2.4 Authentifizierung ................................................................................................................................ 6 2.4.1 Eingehende Nachrichten (Partner à Actebis) ............................................................................ 6 2.4.2 Ausgehende Nachrichten (Actebis à Partner) ........................................................................... 6 2.5 Partnernummern ................................................................................................................................ 6 2.6 Empfangsparameter des Actebis HTTP Gateways ........................................................................... 6 3. Beschreibung der Nachrichten ............................................................................................................. 7 3.1 Nachricht ReceiptAcknowledgement ................................................................................................. 7 3.1.1 Beschreibung des Prozessablaufs.............................................................................................. 7 3.1.2 Tabellarische Erläuterung des Nachrichtenaufbaus ................................................................... 7 3.1.3 Codelisten ................................................................................................................................... 7 3.2 Nachricht ReceiptAcknowledgementException ................................................................................. 7 3.2.1 Beschreibung des Prozessablaufs.............................................................................................. 7 3.2.2 Tabellarische Erläuterung des Nachrichtenaufbaus ................................................................... 8 3.2.3 Codelisten ................................................................................................................................... 8 3.3 Nachricht PriceCatalogue .................................................................................................................. 8 3.3.1 Beschreibung des Prozessablaufs.............................................................................................. 8 3.3.2 Tabellarische Erläuterung des Nachrichtenaufbaus ................................................................... 8 3.3.3 Codelisten ................................................................................................................................... 9 3.4 Nachricht StockInfo............................................................................................................................ 9 3.4.1 Beschreibung des Prozessablaufs.............................................................................................. 9 3.4.2 Tabellarische Erläuterung des Nachrichtenaufbaus ................................................................. 10 3.5 Nachricht CnetData.......................................................................................................................... 10 3.5.1 Beschreibung des Prozessablaufs............................................................................................ 10 3.5.2 Tabellarische Erläuterung des Nachrichtenaufbaus ................................................................. 10 3.5.3 Codelisten ................................................................................................................................. 11 3.6 Nachricht Order................................................................................................................................ 11 3.6.1 Beschreibung des Prozessablaufs............................................................................................ 11 3.6.2 Tabellarische Erläuterung des Nachrichtenaufbaus ................................................................. 11 3.6.3 Codelisten ................................................................................................................................. 13 3.7 Nachricht OrderChange ................................................................................................................... 14 3.7.1 Beschreibung des Prozessablaufs............................................................................................ 14 3.7.2 Tabellarische Erläuterung des Nachrichtenaufbaus ................................................................. 14 3.7.3 Codelisten ................................................................................................................................. 15 3.8 Nachricht OrderResponse ............................................................................................................... 15 3.8.1 Beschreibung des Prozessablaufs............................................................................................ 15 3.8.2 Tabellarische Erläuterung des Nachrichtenaufbaus ................................................................. 15 3.8.3 Codelisten ................................................................................................................................. 17 3.9 Nachricht Delivery............................................................................................................................ 17 3.9.1 Beschreibung des Prozessablaufs............................................................................................ 17 3.9.2 Tabellarische Erläuterung des Nachrichtenaufbaus ................................................................. 17 3.10 Nachricht Invoice ............................................................................................................................. 18 3.10.1 Beschreibung des Prozessablaufs............................................................................................ 18 3.10.2 Tabellarische Erläuterung des Nachrichtenaufbaus ................................................................. 19 3.10.3 Codelisten ................................................................................................................................. 21 4. Änderungshistorie ................................................................................................................................ 22 4.1 Kommunikationsparameter .............................................................................................................. 22 4.2 Nachrichten...................................................................................................................................... 22

Stand: 31.05.2005

Version: V2.10c

Seite 2

eBusiness Integration XML Guideline

1. Allgemeine Hinweise 1.1 Ziel des Dokuments Dieses Dokument beschreibt detailliert die technische Spezifikation für die Entwicklung der Actebis / Partner-Schnittstelle zur Kopplung der entsprechenden Warenwirtschaftssysteme.

1.2 Erläuterungen zu den Schnittstellentabellen Alle Elemente der Nachrichten der Partnerschnittstelle werden in Tabellenform erläutert. Beispiel: §

Spalte 1: definiert das Element (Tag oder Attribut) samt Hierarchieebene. Hierarchieebenen sind bei den Tags durch das Pipe-Zeichen „ | " dargestellt. Attribute sind stets kursiv und durch das „ Zeichen zugehörig zu einem Tag dargestellt. Beispiel: XML Tags / Attribute | |-- DateStamp | Request"

Beschreibung Hierbei handelt es sich um ein XML-Tag namens DateStamp, das sich zwei Ebenen unterhalb des Wurzelelements befindet Hierbei handelt es sich um ein Attribut namens type, das dem XML-Tag DateStamp zugehörig ist. Das Attribut type kann die Ausprägung Message oder Request haben

Hinweis: §

§

§

§

Bei Attributen sind i.d.R. die möglichen Ausprägungen des Attributs durch die Spezifikation fix vorgegeben. Spalte 2: definiert die Anzahl der Iterationen / Wiederholungen des Elements. Beispiele: 0..1 Das Element kann ein mal vorkommen, muss aber nicht 1 Das Element muss genau ein mal vorkommen 0..n Das Element kann mehrfach vorkommen, muss aber nicht 1..n Das Element muss ein mal vorkommen und kann bis zu n mal vorkommen Hinweis: Enthält ein Tag in der Spezifikation keine Iteration und keine Formatbeschreibung des Datentyps, so wird für das Tag kein Inhalt erwartet. Es leitet dann lediglich einen Informationsblock ein. Spalte 3: definiert den Datentyp des Elements. Folgende Datentypen werden aktuell verwendet: o S: String o N: numerischer Wert o D: Datumswert Spalte 4: definiert das Format des Datentyps. o bei Strings: max. Feldlänge o bei numerischen Werten: Stellen vor und hinter dem Komma. Dezimaltrenner ist der Punkt. o bei Datumswerten: max. Feldlänge Hinweis: Enthält ein Tag in der Spezifikation keine Iteration und keine Formatbeschreibung des Datentyps, so wird für das Tag kein Inhalt erwartet. Es leitet dann lediglich einen Informationsblock ein. Spalte 5: beschreibt den Dateninhalt des Elements, ggf. mit Beispiel.

1.3 Ansprechpartner bei Actebis Holding GmbH Sollten Sie technische Fragen zu der Spezifikation haben, wenden Sie sich bitte an Ihren Ansprechpartner im Team eBusiness Integration oder an folgende Mailadresse: [email protected].

Stand: 31.05.2005

Version: V2.10c

Seite 3

eBusiness Integration XML Guideline

2. Kommunikationsparameter 2.1 Codierung der XML Nachrichten Sämtliche von Actebis versendeten XML Nachrichten sind UTF-8 codiert. Für die eingehende XML Order / Order Change Schnittstelle werden die Nachrichten zwingend in ISO 8859-1, UTF-8 oder UTF-16 codiert erwartet. Die Angabe der innerhalb der Nachricht verwendeten Codierung wird im XML Prolog erwartet. Beispiel für eine eingehende in UTF-8 codierte Nachricht: […]

2.2 Kommunikationsprotokolle 2.2.1 Eingehende Nachrichten (Partner à Actebis) HTTPS: Für die Übertragung der Daten wird bevorzugt das HTTPS Protokoll verwendet. Bitte beachten Sie, dass Actebis eingehend lediglich eine Kommunikation über den HTTPS Standardport 443 erlaubt. AS2: Alternativ kann für die Übertragung der Nachrichten AS2 als Kommunikationsprotokoll verwendet werden. AS2 bietet einen sicheren Transport über HTTPS, verwendet optional eine digitale Signatur sowie Nachrichtenverschlüsselung und liefert eine synchrone / asynchrone Empfangsbestätigung (Message Disposition Notifications, MDN). Eingehende Nachrichten können wahlweise SHA-1 oder MD5 signiert werden. Für eingehende Nachrichten werden folgende Verschlüsselungsalgorithmen unterstützt: Triple DES, DES oder RC2 (40 Bit, 64 Bit oder 128 Bit). FTP: Nach Absprache kann ein Actebis FTP Server verwendet werden.

2.2.2 Ausgehende Nachrichten (Actebis à Partner) HTTP(S): Für die Übertragung der Daten wird das HTTP Protokoll verwendet. Ausgehend kann nach Wunsch eine unverschlüsselte HTTP Kommunikation über Port 80 oder eine verschlüsselte HTTPS Kommunikation über Port 443 erfolgen. AS2: Alternativ kann für die Übertragung der Nachrichten AS2 als Kommunikationsprotokoll verwendet werden. AS2 bietet einen sicheren Transport über HTTPS, verwendet optional eine digitale Signatur sowie Nachrichtenverschlüsselung und liefert eine synchrone / asynchrone Empfangsbestätigung (Message Disposition Notifications, MDN). Für die ausgehende Verschlüsselung (Triple DES, DES oder RC2 (40 Bit, 64 Bit oder 128 Bit)) und Signierung (SHA-1) der Nachrichten wird S/MIME Version 2 verwendet. FTP: Nach Absprache kann ein FTP Server verwendet werden.

Stand: 31.05.2005

Version: V2.10c

Seite 4

eBusiness Integration XML Guideline SMTP: Nach Absprache können die Nachrichten ausgehend per Mail als Anhang an eine zu definierende Mailadresse versendet werden.

2.3 Prämissen für die HTTP Kommunikation 2.3.1 MIME Header Für die korrekte Übermittlung und Routing der Nachricht wird eingehend eine der folgenden ContentType und MIME Header Deklarationen erwartet. Nähere Informationen hierzu unter http://www.faqs.org/rfcs/rfc2376.html Content-Type: text/xml; charset=“utf-8“ à Das ist der empfohlene charset Wert für die Verwendung mit text/xml. Alternativ kann innerhalb des MIME Headers der charset auch weggelassen werden: Content-Type: text/xml

2.3.2 HTTP Methoden Eine Methode gibt dem empfangenden Server vor, wie er den eingehenden Request verarbeiten soll. Die Methode sendet Daten zur Weiterverarbeitung an einen Server. Das bedeutet, Actebis versendet alle ausgehenden Nachrichten mit der POST Methode. Ebenso werden die eingehenden Nachrichten mit der HTTP POST Methode erwartet.

2.3.3 HTTP Status Codes Ein HTTP Status Code übermittelt dem Client eine Information, ob und wie sein Request verarbeitet wurde. HTTP Status Codes sind Bestandteil der ersten Zeile der Response. Beispielsweise ist in der Zeile „HTTP/1.0 200 OK“ der HTTP Status Code 200 integriert. Wurde ein Auftrag seitens Actebis erfolgreich empfangen wird ein HTTP Status Code 200 an den Client zurückgesendet. Ebenso wird bei erfolgreicher Übermittlung von Daten von Actebis an den Partner ein 200er Status Code erwartet. Tabelle mit Status Code Klassen: Overall Range 100-199 200-299 300-399 400-499 500-599

Defined Range 100-101 200-206 300-305 400-415 500-505

Category Informational Successful Redirection Client Error Server Error

Nähere Informationen hierzu bspw. unter http://www.helpwithpcs.com/courses/html/html_http_status_codes.htm

Stand: 31.05.2005

Version: V2.10c

Seite 5

eBusiness Integration XML Guideline

2.4 Authentifizierung 2.4.1 Eingehende Nachrichten (Partner à Actebis) Für eingehende Nachrichten wird zur Identifizierung des Partners eine Authentifizierung erwartet. Hierzu wird eine HTTP Basic Authentifizierung verwendet. Dabei müssen Benutzername und Passwort im Authorization Header base64 codiert (durch einen Doppelpunkt „:“ getrennt) innerhalb des MIME Headers übergeben werden. Beispiel: Content-Type: text/xml Authorization: Basic VXNlcm5hbWU6UGFzc3dvcnQ= Nähere Informationen zur Basic Authentifizierung bspw. unter http://www.bolege.de/http-header/#art2_authorization Ein base64 Encoder / Decoder findet sich bspw. unter http://www.motobit.com/util/base64-decoder-encoder.asp Alternativ kann eine zertifikatsbasierte Client Authentifizierung (x.509v3 Zertifikate) vorgenommen werden.

2.4.2 Ausgehende Nachrichten (Actebis à Partner) Bei ausgehenden Nachrichten kann abhängig vom Empfangssystem des Partners eine Authentifizierung vorgenommen werden. Sowohl eine HTTP Basic Authentifizierung als auch eine zertifikatsbasierte Client Authentifizierung (x.509v3 Zertifikate) sind möglich.

2.5 Partnernummern Actebis präferiert für die Sender-/Empfängerkennungen unternehmensübergreifende Partnernummern. Für Actebis wird hierfür die ILN verwendet: Actebis Peacock GmbH & Co. KG Deutschland Actebis AG Schweiz Actebis Computerhandels GmbH Österreich Actebis B.V. Holland Actebis Computer S.p.A. Italien

innerhalb

des



4005922010102 4005922021009 4005922022006 4005922024000 4005922027001

Für den Partner kann alternativ die DUNS, wenn keine ILN vorhanden ist, verwendet werden. Diese kann kostenlos bei D&B angefragt werden: http://dbgermany.dnb.com/German/default.htm?Loc=/German/DataBase/duns.htm Sollte weder eine ILN noch eine DUNS existieren kann für den Partner die Actebis Kundennummer als Partnerkennung verwendet werden.

2.6 Empfangsparameter des Actebis HTTP Gateways Actebis verfügt über zwei Systeme (Test und Produktion) zum Empfang der Nachrichten: Testbetrieb: Produktivbetrieb:

https://b2b-test.actebis.com/invoke/ActDelivery_HTTP.Inbound/receiveXML https://b2b.actebis.com/invoke/ActDelivery_HTTP.Inbound/receiveXML

Bitte beachten Sie die Hinweise zum Versand unter 2.1 – 2.4.

Stand: 31.05.2005

Version: V2.10c

Seite 6

eBusiness Integration XML Guideline

3. Beschreibung der Nachrichten 3.1 Nachricht ReceiptAcknowledgement 3.1.1 Beschreibung des Prozessablaufs Die Nachricht ReceiptAcknowledgement kann nach Empfang einer Nachricht (Order oder OrderChange) über das HTTP Gateway als Empfangsbestätigung zurückgesendet werden. Der Versand erfolgt in einer separaten Sendesession. Das ReceiptAcknowledgement signalisiert dem Partner, dass das eingehende Dokument erfolgreich validiert und an das Backend System weitergegeben wurde.

3.1.2 Tabellarische Erläuterung des Nachrichtenaufbaus XML Tags / Attribute ReceiptAcknowledgement |-- SenderEnvelope | |-- SenderID | |-- ReceiverID | |-- DateStamp

It.

| |-- VersionID | |-- ControlNumber |-- Header | |-- Status | |-- DocumentReference | | |-- DocumentNumber PurchaseOrder"

1 0..1 1 1 1 1

1 1 1 1 1

Typ Länge Beschreibung Wurzelelement Sender Umschlag S 13 Eindeutige ID des Senders der Nachricht S 13 Eindeutige ID des Empfängers der Nachricht D 8 Zeitstempel YYYYMMDD Erstelldatum der Nachricht S 5 Version der Spezifikation, z.B. 2.10 wird hier nicht verwendet Acknowledgement Kopfdaten S 10 Status der eingegangenen Nachricht Referenzdaten S 35 Belegnummer Bestellnummer

3.1.3 Codelisten XML Tag Status

Zulässige Werte des Tags Accept

Beschreibung Validierung erfolgreich, Dokument wird an das Backend System weitergegeben

3.2 Nachricht ReceiptAcknowledgementException 3.2.1 Beschreibung des Prozessablaufs Die Nachricht ReceiptAcknowledgementException kann nach Empfang einer Nachricht (Order oder OrderChange) über das HTTP Gateway als Empfangsbestätigung zurückgesendet werden. Der Versand erfolgt in einer separaten Sendesession. Das ReceiptAcknowledgementException signalisiert dem Partner, dass das eingehende Dokument auf einen Validierungsfehler gelaufen ist. Das eingehende Dokument kann nicht an das Backend System weitergegeben werden und muss korrigiert nochmals versendet werden. Das ReceiptAcknowledgementException enthält, soweit im Fehlerfall verfügbar, nähere Informationen über die Fehlerursache.

Stand: 31.05.2005

Version: V2.10c

Seite 7

eBusiness Integration XML Guideline

3.2.2 Tabellarische Erläuterung des Nachrichtenaufbaus XML Tags / Attribute ReceiptAcknowledgementException |-- SenderEnvelope | |-- SenderID | |-- ReceiverID | |-- DateStamp

It.

| |-- VersionID | |-- ControlNumber |-- Header | |-- Status | |-- DocumentReference | | |-- DocumentNumber PurchaseOrder " |-- Error | |-- PathName

1 0..1 1 1 1 1

| |

0..1 1

|-- ErrorCode |-- ErrorMessage

1 1 1 1 1

1..n 0..1

Typ Länge Beschreibung Wurzelelement Sender Umschlag S 13 Eindeutige ID des Senders der Nachricht S 13 Eindeutige ID des Empfängers der Nachricht D 8 Zeitstempel YYYYMMDD Erstelldatum der Nachricht S 5 Version der Spezifikation, z.B. 2.10 wird hier nicht verwendet Acknowledgement Kopfdaten S 10 Status der eingegangenen Nachricht Referenzdaten S 35 Belegnummer Bestellnummer Validierungsfehler S 200 Pfad innerhalb der eingegangenen Nachricht, in dem der Fehler aufgetreten ist S 100 Fehlercode S 500 Textuelle Beschreibung des Validierungsfehlers

3.2.3 Codelisten XML Tag Status

Zulässige Werte des Tags Reject

Beschreibung Validierungsfehler, Dokument kann nicht weiterverarbeitet werden.

3.3 Nachricht PriceCatalogue 3.3.1 Beschreibung des Prozessablaufs Die Nachricht PriceCatalogue enthält den tagesgültigen Actebis Produktkatalog inklusive dem individuellen Einkaufspreis bei Actebis sowie dem morgendlichen Bestand. Die Actebis Produkthierarchie kann nach vorheriger Abstimmung mit übermittelt werden. Darüber hinaus sind in der Nachricht weitere Produktattribute pro Artikel enthalten. Die Nachricht PriceCatalogue wird in der Regel montags-samstags morgens um ~3:20 Uhr übertragen. Nach Absprache können auch individuelle Übertragungszeiten vereinbart werden.

3.3.2 Tabellarische Erläuterung des Nachrichtenaufbaus Hinweis: bei mit * gekennzeichneten Feldern die zulässigen Codelisten aus 3.3.3 beachten XML Tags / Attribute PriceCatalogue |-- SenderEnvelope | |-- SenderID | |-- ReceiverID | |-- DateStamp | |-- VersionID | |-- ControlNumber |-- ProductCategoryStructure | |-- ProductCategory

Stand: 31.05.2005

It.

Typ Länge Beschreibung Wurzelelement Sender Umschlag S 13 Eindeutige ID des Senders der Nachricht S 13 Eindeutige ID des Empfängers der Nachricht D 8 Zeitstempel YYYYMMDD Erstelldatum der Nachricht 1 S 5 Version der Spezifikation, z.B. 2.10 0..1 N 10,0 wird hier nicht verwendet 0..1 Produkthierarchie 1..n 1 1 1 1 1

Version: V2.10c

Seite 8

eBusiness Integration XML Guideline |

|

|-- ProductCategoryCode

|

|

parent="… " |-- ProductCategoryDescription "Distributor"

|-- LineItem | |-- ProductCategoryCode

1

S

0..1 1 1 1 1..n 0..1

S S S N

1

N

0..1

S

0..1

N

1

S

S

|

|-- ProductNumber

| |

|-- ProductNumber ufacturer" |-- ProductNumber

|

|-- ProductDescription

| | |

|-- AdditionalProductDescription |-- ManufacturerName |-- MonetaryAmount

0..1 0..1 1

S S N

|

|-- MonetaryAmount

0..1

N

| | |

|-- Currency |-- VAT |-- Quantity

1 1 1

S N N

| | | | | | | |

|-- ReplenishmentLeadTime |-- Length |-- Width |-- Height |-- Weight |-- Guarantee |-- EndOfLife |-- ProductStatus

0..1 0..1 0..1 0..1 0..1 0..1 0..1 0..1

N N N N N S S S

|

|-- DateStamp

0..1

D

18 Code der Produkthierarchie Produkthierarchie Actebis 18 Code der übergeordneten Produkthierarchie 255 Textuelle Beschreibung der Produkthierarchie 15 Produkthierarchie Actebis 1,0 Ebene der Produkthierarchie, z.B. 2 Positionsdaten 18 Code Produkthierarchie Actebis Produkthierarchie 18,0 Materialnummer Actebis Materialnummer 40 Materialnummer HerstellerTeileNr 14,0 Materialnummer EAN 40 Produktbeschreibung / Artikelkurztext Beschreibung Actebis 255 Produktbeschreibung / Artikellangtext 35 Name des Herstellers 10,2 Betrag Nettobetrag pro Stück / Kunden Einkaufspreis 10,0 Betrag Empfohlener Verkaufspreis netto 3 ISO Währungsschlüssel, z.B. EUR (Euro) 3,2 Mehrwertsteuer Prozentsatz 6,0 Menge ATP Menge in Stück 3,0 Plan Wiederbeschaffungszeit in Tagen 15,2 Länge in mm 15,2 Breite in mm 15,2 Höhe in mm 15,0 Gewicht in Gramm 40 Text (mehrsprachig) der Kundengarantie 3 End-of-Life Kennzeichen* 20 Produktstatus, bspw. vom Umtausch ausgeSchlossen* 8 Zeitstempel YYYYMMDD Gültigkeitsdatum "bis" bei Aktionspreisen

3.3.3 Codelisten Die folgende Tabelle enthält die zulässigen Werte für folgende XML Tags: XML Tag EndOfLife ProductStatus

Zulässige Werte des Tags Yes ChangeExcluded

Beschreibung Material ist End of Life Produkt vom Umtausch ausgeschlossen

3.4 Nachricht StockInfo 3.4.1 Beschreibung des Prozessablaufs Die Nachricht StockInfo enthält die Materialien der Nachricht PriceCatelogue mit stündlich aktualisiertem Bestand. Die Nachricht StockInfo wird montags-freitags stündlich in der Zeit von ~07:20h bis ~21:20h übertragen.

Stand: 31.05.2005

Version: V2.10c

Seite 9

eBusiness Integration XML Guideline

3.4.2 Tabellarische Erläuterung des Nachrichtenaufbaus XML Tags / Attribute StockInfo |-- SenderEnvelope | |-- SenderID | |-- ReceiverID | |-- DateStamp

It.

| |-- VersionID | |-- ControlNumber |-- LineItem | |-- ProductNumber

1 0..1 1..n 1

|

1 1 1 1 1

|-- Quantity

1

Typ Länge Beschreibung Wurzelelement Sender Umschlag S 13 Eindeutige ID des Senders der Nachricht S 13 Eindeutige ID des Empfängers der Nachricht D 8 Zeitstempel YYYYMMDD Erstelldatum der Nachricht S 5 Version der Spezifikation, z.B. 2.10 wird hier nicht verwendet Positionsdaten N 18,0 Materialnummer Actebis Materialnummer N 6,0 Menge ATP Menge

3.5 Nachricht CnetData 3.5.1 Beschreibung des Prozessablaufs Die Nachricht enthält zusätzliche Artikelinformationen von CNet, den CNet Kurztext, den CNet Marketingtext, einen Link zum Produktbild sowie einen Link zum CNet Datenblatt. Die Nachricht CnetData wird in der Regel montags-samstags morgens um ~4:30 Uhr übertragen. Die Nachricht wird in zwei Varianten abgelegt: a) Ac_cnetdata.zip: Die Nachricht enthält alle Materialien, die für den jeweiligen Tag Gültigkeit haben. Aufgrund der Dateigröße ist die vollständige Nachricht nur gezippt erhältlich. b) Ac_cnetdata_delta.xml: Die Nachricht enthält lediglich neue / geänderte / gelöschte Materialien im Vergleich zum vorherigen File. Vor Empfang der Änderungsnachricht muss zumindest einmalig die vollständige Nachricht importiert werden. Die Nachricht CnetData wird ausschließlich in einem kundenspezifischen Verzeichnis auf einem Actebis FTP Server abgelegt und nicht über andere Kommunikationsprotokolle versendet.

3.5.2 Tabellarische Erläuterung des Nachrichtenaufbaus Hinweis: bei mit * gekennzeichneten Feldern die zulässigen Codelisten aus 3.5.3 beachten XML Tags / Attribute CnetData |-- SenderEnvelope | |-- SenderID | |-- ReceiverID | |-- DateStamp

It.

| |-- VersionID | |-- ControlNumber |-- LineItem | |-- ProductNumber

1 0..1 1..n 1

|

|-- ProductModificationIdentifier

0..1

| | |

|-- Attributes | |-- AttributeName | |-- AttributeValue

0..7 1 1

Stand: 31.05.2005

1 1 1 1 1

Typ Länge Beschreibung Wurzelelement Sender Umschlag S 13 Eindeutige ID des Senders der Nachricht S 13 Eindeutige ID des Empfängers der Nachricht D 8 Zeitstempel YYYYMMDD Erstelldatum der Nachricht S 5 Version der Spezifikation, z.B. 2.10 wird hier nicht verwendet Positionsdaten N 18,0 Materialnummer Actebis Materialnummer S 6 Änderungskennzeichen*, Verwendung nur in der Änderungsnachricht CNet Produktattribute S 80 Name des Cnet Attributs, z.B. Gewicht S 255 Ausprägung des CNet Attributs, z.B. 5kg

Version: V2.10c

Seite 10

eBusiness Integration XML Guideline |

|-- ProductDescription

0..1

S

|

|-- ProductDescription Marketing" |-- ProductPicture |-- ProductDatasheet

0..1

S

0..1 0..1

S S

| |

300 Produktbeschreibung Kurztext CNet 8000 Produktbeschreibung CNet Marketingtext 100 Link (URL) zum Produktbild 100 Link (URL) zum CNet Datenblatt

3.5.3 Codelisten Die folgende Tabelle enthält die zulässigen Werte für folgende XML Tags: XML Tag ProductModificationIdentifier

Zulässige Werte des Tags Add Change Delete

Beschreibung Änderungskennzeichen: Hinzufügen eines Produkts in den CNetDaten Änderung CNetDaten zum Produkt Löschen eines Produkts

3.6 Nachricht Order 3.6.1 Beschreibung des Prozessablaufs Die Nachricht Order wird bei Empfang über das HTTP Gateway sofort in das SAP IDoc Format konvertiert und direkt im SAP System verbucht. Bei erfolgreicher Auftraganlage wird unmittelbar nach Verbuchung der Order eine Auftragsbestätigung versendet (Voraussetzung: der Auftrag ist nicht gesperrt).

3.6.2 Tabellarische Erläuterung des Nachrichtenaufbaus Hinweis: bei mit * gekennzeichneten Feldern die zulässigen Codelisten aus 3.6.3 beachten XML Tags / Attribute Order |-- SenderEnvelope | |-- SenderID | |-- ReceiverID | |-- DateStamp | |-- VersionID | |-- ControlNumber |-- Header | |-- OrderType | |-- DocumentReference | | |-- DocumentNumber

It. 1 1 1 1 1 1 0..1 1 1 1 1

|

|

|-- DateStamp

1

|

|-- PartnerDescription

1

|

|

|-- PartnerNumber

0..1

|

|

|-- PartnerNumber

0..1

|

|-- PartnerDescription

1

Stand: 31.05.2005

Typ Länge Beschreibung Wurzelelement Sender Umschlag S 13 Eindeutige ID des Senders der Nachricht S 13 Eindeutige ID des Empfängers der Nachricht D 8 Zeitstempel YYYYMMDD Erstelldatum der Nachricht S 5 Version der Spezifikation, z.B. 2.10 N 10,0 fortlaufende Kontrollnummer Auftrag Kopfdaten S 10 Art des Auftrags*, z.B. Standard Referenzdaten S 35 Belegnummer Bestellnummer D 8 Zeitstempel YYYYMMDD Bestelldatum Partner Adresssatz Partnerrolle Auftraggeber N 17,0 Partner Nummer Actebis Debitorennummer (Pflichtfeld, wenn keine ILN verwendet wird) N 13,0 Partner Nummer ILN (Pflichtfeld, wenn keine Actebis Debitorennr. verwendet wird) Partner Adresssatz Partnerrolle Warenempfänger

Version: V2.10c

Seite 11

eBusiness Integration XML Guideline |

|

0..1

N

|

|-- PartnerNumber utor" |-- PartnerNumber

|

0..1

N

|

|

|-- PartnerNumber

0..1

S

|

|

|-- PartnerName1

0..1

S

| | | | | | | | | | |

| |-- PartnerName2 | |-- PartnerName3 | |-- PartnerName4 | |-- PartnerAddress | |-- PartnerPostalCode | |-- PartnerCity | |-- PartnerCountryCode |-- CompleteDelivery |-- DeliveryBlock |-- ShippingTerms |-- Comments

0..1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 1 0..1

S S S S N S S S S S S

| |

|-- ProjectInformation | |-- ProjectIdentifier

0..1 0..1

S

|

|

|-- ProjectIdentifier

0..1

S

|

|

|-- ProjectDescription

0..1

S

| | | | | |

| |-- ProjectManufacturer |-- Services | |-- Distribution | | |-- Required | | |-- Branch | | |-- DocumentNumber

1 0..1 0..1 1 0..1 0..3

S

|

|

|

Shop" |-- Comments

0..30

S

|

|

|

|-- ContactInformation

0..1

| | | |

| | | |

| | | |

| |-- ContactName | |-- ContactPhone | |-- ContactFax |-- DeliveryNoteLanguage

1 1 0..1 0..1

S S S S

|

|

|

|-- DeliveryNoteNumber

0..1

N

| | | |

| | | |

|-- Consignment | |-- Required | |-- ConsignmentType | |-- ConsignmentSpecification

0..1 1 1 1

S S S

|

|

|

|-- PartnerDescription

0..1

|

|

|

|

0..1

|-- PartnerNumber

Stand: 31.05.2005

S S S

N

17,0 Partner Nummer Actebis Debitorennummer (Pflichtfeld, wenn keine ILN verwendet wird) 13,0 Partner Nummer ILN (Pflichtfeld, wenn keine Actebis Debitorennr. verwendet wird) 35 Partner Nummer Partnernr. des Bestellkunden 35 Name 1 zur Partnerrolle (nur bei abweichender Lieferanschrift !) 35 Name 2 zur Partnerrolle 35 Name 3 zur Partnerrolle 35 Name 4 zur Partnerrolle 35 Straße zur Partnerrolle 9,0 Postleitzahl zur Partnerrolle 35 Stadt zur Partnerrolle 3 ISO-Länderkennzeichen 3 Komplettlieferkennzeichen* (Yes oder No) 3 Liefersperre* (Yes oder No) 10 Versandbedingung*, z.B. Standard 70 Kopftext Information, nicht druckbar Kontraktdaten 35 Kontraktnummer Actebis (Pflicht, wenn keine Hersteller Kontraktnummer kommt) 35 Kontraktnummer Hersteller (Deal ID bzw. SBO), Bsp. 70569730-001 DE-ACCGS-5HUMHP-2-I2, Pflicht wenn keine Actebis Kontraktnr. kommt 35 Projektspezifikation – Deal Reference bzw. Enduser; Beispiel OPG-11FEB03-EUR 3 Kontrakt Hersteller: HP oder IBM Logistik Dienstleistungen Versand im Namen Dritter 3 Service verwendet* (Yes oder No) 35 Name der Filiale 35 Referenzdaten: die zu verwendenden Felder müssen vorab bilateral vereinbart werden. Endkundenbestellnr. zum Andruck auf Lieferschein | Filialbestellnr. | Shopbestellnr. 70 Kopftext zum Andruck auf dem Lieferschein Kontaktdaten Kundenbetreuer des Bestellkunden 35 Name Kontakt 35 Telefonnummer Kontakt 35 Faxnummer Kontakt 2 Sprachkennzeichen für den zu verwendenden Lieferschein 2,0 Nr. des zu verwendenden Lieferscheins bei mehreren TPDis Lieferscheinen Konsignationsabwicklung 3 Service verwendet* (Yes oder No) 8 Konsityp (internal oder external) 8 Konsibeschickung oder -entnahme (FillUp oder TakeFrom) Partner Adresssatz Konsignationsabwicklung 17,0 Partner Nummer Actebis Debitorennummer (Pflichtfeld, wenn keine ILN verwendet wird)

Version: V2.10c

Seite 12

eBusiness Integration XML Guideline |

|

|

|

|-- PartnerNumber

0..1

N

13,0 Partner Nummer ILN (Pflichtfeld, wenn keine Actebis Debitorennr. verwendet wird) 35 Partner Nummer des Bestellkunden

|

|

|

|

|-- PartnerNumber

0..1

S

| | | | | | | | | | |

| | | | | | | | | | |

| | |-- PartnerName1 | | |-- PartnerName2 | | |-- PartnerName3 | | |-- PartnerName4 | | |-- PartnerAddress | | |-- PartnerPostalCode | | |-- PartnerCity | | |-- PartnerCountryCode |-- RequestedDeliveryDate | |-- Required | |-- DateStamp

0..1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 1 1

S S S S S N S S

35 35 35 35 35 9 35 3

S D

3 8

| | |

| | |

|-- CashOnDelivery | |-- Required | |-- MonetaryAmount

0..1 1 0..1

S N

3 10,2

|-- LineItem | |-- LineNumber

1..n 1

S

6

|

|-- ProductNumber

0..1

N

18,0

|

|-- ProductNumber

0..1

N

14,0

|

|-- ProductNumber

0..1

S

35

|

|-- Quantity

1

N

6,0

|

|-- MonetaryAmount

0..1

N

10,2

| | |

|-- Services | |-- Consignment | | |-- SerialNumber

0..1 0..1 1..n

S

20

Name 1 zur Partnerrolle Name 2 zur Partnerrolle Name 3 zur Partnerrolle Name 4 zur Partnerrolle Straße zur Partnerrolle Postleitzahl zur Partnerrolle Stadt zur Partnerrolle ISO-Länderkennzeichen Service Liefertermin Service verwendet* (Yes oder No) Zeitstempel YYYYMMDD Gewünschtes Auslieferungsdatum Nachnahmeabwicklung Service verwendet* (Yes oder No) Betrag Nachnahmebetrag Positionsdaten Positionsnummer Bestellposition Materialnummer Actebis (Pflicht, wenn keine EAN kommt) Materialnummer EAN (Pflicht, wenn keine Actebis Materialnummer kommt) Materialnummer Kundenmaterialnummer Menge Bestellmenge Betrag Nettobetrag pro Stück (aus PriceCatalogue) Logistik Dienstleistungen Konsignationsabwicklung Seriennummer(n); nur bei Konsientnahme (ConsignmentSpecification=TakeFrom)

3.6.3 Codelisten Die folgende Tabelle enthält die zulässigen Werte für folgende XML Tags: XML Tag CompleteDelivery DeliveryBlock OrderType ProjectManufacturer Required ShippingTerms

Stand: 31.05.2005

Zulässige Werte des Tags Yes No Yes No Standard HP IBM Yes No Standard ExternalProduct

Version: V2.10c

Beschreibung Komplettlieferung für Auftrag setzen Komplettlieferung für Auftrag nicht gefordert Auftrag mit Liefersperre versehen Auftrag ohne Liefersperre verbuchen Standardauftrag Kontraktauftrag HP Kontraktauftrag IBM Logistik Dienstleistung auf Auftrag anwenden Logistik Dienstleistung auf Auftrag n. anwenden Standard Versandbedingung Abwicklung Fremdware

Seite 13

eBusiness Integration XML Guideline

3.7 Nachricht OrderChange 3.7.1 Beschreibung des Prozessablaufs Die Nachricht OrderChange wird bei Empfang über das HTTP Gateway sofort in das SAP IDoc Format konvertiert und direkt im SAP System verbucht. Bei erfolgreicher Auftragsänderung wird unmittelbar nach Verbuchung des OrderChange eine Auftragsbestätigung versendet (Voraussetzung: der Auftrag ist nicht gesperrt).

3.7.2 Tabellarische Erläuterung des Nachrichtenaufbaus Hinweis: bei mit * gekennzeichneten Feldern die zulässigen Codelisten aus 3.7.3 beachten XML Tags / Attribute OrderChange |-- SenderEnvelope | |-- SenderID | |-- ReceiverID | |-- DateStamp

It.

| |-- VersionID | |-- ControlNumber |-- Header | |-- PartnerDescription

1 0..1 1 1..2

|

|

|-- PartnerNumber

0..1

|

|

|-- PartnerNumber

0..1

| | | | | | | | | |

| |-- PartnerName1 | |-- PartnerName2 | |-- PartnerName3 | |-- PartnerName4 | |-- PartnerAddress | |-- PartnerPostalCode | |-- PartnerCity | |-- PartnerCountryCode |-- DocumentReference | |-- DocumentNumber

| |-- CompleteDelivery | |-- DeliveryBlock |-- LineItem | |-- ProductModificationIdentifier

1 1 1 1 1

0..1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 1 1 0..1 0..1 0..n 1

|

|-- LineNumber

|

|-- ProductNumber

0..1

|

|-- ProductNumber

0..1

|

|-- ProductNumber Buyer" |-- Quantity

0..1

|-- MonetaryAmount ype="NetCustomer"

0..1

| |

Stand: 31.05.2005

1

0..1

Typ Länge Beschreibung Wurzelelement Sender Umschlag S 13 Eindeutige ID des Senders der Nachricht S 13 Eindeutige ID des Empfängers der Nachricht D 8 Zeitstempel YYYYMMDD Erstelldatum der Nachricht S 5 Version der Spezifikation, z.B. 2.10 N 10,0 fortlaufende Kontrollnummer Auftragsänderung Kopfdaten Partner Adresssatz Warenempfänger | Auftraggeber N 17,0 Partner Nummer Actebis Debitorennummer (Pflichtfeld, wenn keine ILN verwendet wird) N 13,0 Partner Nummer ILN (Pflichtfeld, wenn keine Actebis Debitorennr. S 35 Name 1 zur Partnerrolle S 35 Name 2 zur Partnerrolle S 35 Name 3 zur Partnerrolle S 35 Name 4 zur Partnerrolle S 35 Straße zur Partnerrolle N 9,0 Postleitzahl zur Partnerrolle S 35 Stadt zur Partnerrolle S 3 ISO-Länderkennzeichen Referenzdaten N 15,0 Belegnummer Auftragsnummer Actebis S 3 Komplettlieferkennzeichen* (Yes oder No) S 3 Liefersperre* (Yes oder No) Positionsdaten S 6 Anzuwendende Aktion auf die Bestellposition: Ändern oder Hinzufügen der Position* S 6 Positionsnummer Bestellposition N 18,0 Materialnummer Actebis (Pflichtfeld wenn keine EAN verwendet wird) N 14,0 Materialnummer EAN (Pflichtfeld wenn keine Actebis Materialnummer verwendet wird) S 35 Materialnummer Kundenmaterialnummer, nur beim Hinzufügen von Positionen erlaubt N 6,0 Menge Bestellmenge N 10,2 Betrag Nettobetrag pro Stück (aus PriceCatalogue), nur beim Hinzufügen von Positionen erlaubt

Version: V2.10c

Seite 14

eBusiness Integration XML Guideline

3.7.3 Codelisten Die folgende Tabelle enthält die zulässigen Werte für folgende XML Tags: XML Tag CompleteDelivery DeliveryBlock ProductModificationIdentifier

Zulässige Werte des Tags Yes No Yes No Add Change

Beschreibung Komplettlieferung für Auftrag setzen Komplettlieferung für Auftrag nicht gefordert Auftrag mit Liefersperre versehen Auftrag ohne Liefersperre verbuchen Hinzufügen einer Bestellposition Änderung einer Bestellposition

3.8 Nachricht OrderResponse 3.8.1 Beschreibung des Prozessablaufs Die Nachricht OrderResponse wird sofort nach erfolgreicher Auftragsanlage erzeugt. Ebenso wird eine neue Nachricht OrderResponse bei Änderung des Auftrages, bspw. bei Terminänderungen von Einteilungen, erzeugt. Die Nachricht OrderResponse wird seitens Actebis unmittelbar nach erfolgreicher Auftragsanlage versendet. Voraussetzung ist, dass der Beleg nicht in irgendeiner Form gesperrt ist.

3.8.2 Tabellarische Erläuterung des Nachrichtenaufbaus Hinweis: bei mit * gekennzeichneten Feldern die zulässigen Codelisten aus 3.8.3 beachten XML Tags / Attribute OrderResponse |-- SenderEnvelope | |-- SenderID | |-- ReceiverID | |-- DateStamp

It.

| |-- VersionID | |-- ControlNumber |-- Header | |-- DocumentReference | | |-- DocumentNumber

1 0..1 1 1 1

|

|

| |

|-- DocumentReference | |-- DocumentNumber

|

|

|-- DateStamp

1

|

|-- PartnerDescription

1

|

|

|-- PartnerNumber

1

|

|

|-- PartnerNumber

0..1

|

|-- PartnerDescription DeliveryParty" | |-- PartnerNumber Distributor"

|

|-- DateStamp

1 1 1 1 1

Stand: 31.05.2005

1 0..1 1

1 1

Typ Länge Beschreibung Wurzelelement Sender Umschlag S 13 Eindeutige ID des Senders der Nachricht S 13 Eindeutige ID des Empfängers der Nachricht D 8 Zeitstempel YYYYMMDD Erstelldatum der Nachricht S 5 Version der Spezifikation, z.B. 2.10 wird hier nicht verwendet Auftragsbestätigung Kopfdaten Referenzdaten N 15,0 Belegnummer Auftragsnummer Actebis D 8 Zeitstempel YYYYMMDD Auftragsdatum Referenzdaten S 35 Belegnummer Bestellnummer Kunde D 8 Zeitstempel YYYYMMDD Bestelldatum Partner Adresssatz Partnerrolle Auftraggeber N 17,0 Partner Nummer Actebis Debitorennummer N 13,0 Partner Nummer ILN Partner Adresssatz Partnerrolle Warenempfänger N 17,0 Partner Nummer Actebis Debitorennummer

Version: V2.10c

Seite 15

eBusiness Integration XML Guideline |

|

| | | | | | | | | | | | | | | |

| |-- PartnerName1 | |-- PartnerName2 | |-- PartnerName3 | |-- PartnerName4 | |-- PartnerAddress | |-- PartnerPostalCode | |-- PartnerCity | |-- PartnerCountryCode |-- CompleteDelivery |-- ShippingTerms |-- Services | |-- Distribution | | |-- Required | |-- RequestedDeliveryDate | | |-- Required | | |-- DateStamp Request" | |-- CashOnDelivery | | |-- Required | | |-- MonetaryAmount

| | |

|-- PartnerNumber

0..1

N

1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 1 0..1 1 1

S S S S S N S S S S

S S D

0..1 1 1

S N

|-- LineItem | |-- LineNumber

1..n 1

N

|

|-- LineNumber

0..1

S

|

|-- ProductNumber

1

N

|

|-- ProductNumber

0..1

N

|

|-- ProductNumber

0..1

S

|

|-- ProductNumber

0..1

S

|

|-- ProductDescription

1

S

|

|-- Quantity

1

N

| | |

|-- Conditions | |-- ConditionType | |-- MonetaryAmount

0..n 1 1

S N

| | |

| |-- ConditionPercentage | |-- ConditionDescription |-- MonetaryAmount

1 1 1

N S N

|

|-- MonetaryAmount

0..1

N

|

|-- MonetaryAmount SumNetPosition"

0..1

N

|

|-- Reject

S N

| |

|-- Schedule | |-- DateStamp

0..1 0..1 1..n 1

1)

Stand: 31.05.2005

D

13,0 Partner Nummer ILN 35 Name 1 zur Partnerrolle 35 Name 2 zur Partnerrolle 35 Name 3 zur Partnerrolle 35 Name 4 zur Partnerrolle 35 Straße zur Partnerrolle 9,0 Postleitzahl zur Partnerrolle 35 Stadt zur Partnerrolle 3 Länderkennzeichen zur Partnerrolle 3 Komplettlieferkennzeichen* (Yes oder No) 10 Versandbedingung*, z.B. Standard Logistik Dienstleistungen Versand im Namen Dritter 3 Service verwendet* (Yes oder No) Service Liefertermin 3 Service verwendet* (Yes oder No) 8 Zeitstempel YYYYMMDD Gewünschtes Auslieferungsdatum Nachnahmeabwicklung 3 Service verwendet* (Yes oder No) 10,2 Betrag Nachnahmebetrag Positionsdaten 6 Positionsnummer Auftragsposition 6 Positionsnummer Bestellposition 18,0 Materialnummer Actebis Materialnummer 14,0 Materialnummer EAN 35 Materialnummer Kundenmaterialnummer 40 Materialnummer HerstellerTeileNr. 40 Produktbeschreibung Beschreibung Actebis 6,0 Menge Bestellmenge Zu-/Abschlagskonditionen (Position) 1 + (=Zuschlag) oder - (=Abschlag) 10,2 Betrag Konditionsbetrag 3,2 Konditionsprozentsatz 80 Konditionsbeschreibung 10,2 Betrag Nettobetrag pro Stück 10,2 Betrag Nettobetrag pro Stück inkl. aller Zuschlagskonditionen 10,2 Betrag Netto Positionssumme inkl. aller Zuschlagskonditionen 40 Absagegrund bei Absage einer Position 2,0 zweistelliger Code des Absagegrunds Einteilungen 8 Zeitstempel YYYYMMDD Einteilungsdatum

Version: V2.10c

Seite 16

eBusiness Integration XML Guideline

|

|

|-- Quantity

1

N

6,0 Menge Einteilungsmenge

1)

Falls im SAP keine Einteilung erzeugt werden kann wird ein Dummy Einteilungsdatum 20501231 mit Einteilungsmenge 0 eingefügt. Es kann noch keine genauere Aussage über den zu erwartenden Liefertermin gemacht werden. Bei abgesagten Positionen wird als Einteilungsmenge 0 und als Einteilungsdatum 19991231 eingefügt.

3.8.3 Codelisten Die folgende Tabelle enthält die zulässigen Werte für folgende XML Tags: XML Tag CompleteDelivery Required ShippingTerms

Zulässige Werte des Tags Yes No Yes No Standard

Beschreibung Komplettlieferung für Auftrag setzen Komplettlieferung für Auftrag nicht gefordert Logistik Dienstleistung auf Auftrag anwenden Logistik Dienstleistung auf Auftrag n. anwenden Standard Versandbedingung

3.9 Nachricht Delivery 3.9.1 Beschreibung des Prozessablaufs Die Nachricht Delivery wird sofort bei Warenausgangsbuchung der Lieferung erzeugt. Die Nachricht Delivery wird seitens Actebis unmittelbar nach Erzeugung der Warenausgangsbuchung versendet.

3.9.2 Tabellarische Erläuterung des Nachrichtenaufbaus XML Tags / Attribute Delivery |-- SenderEnvelope | |-- SenderID | |-- ReceiverID | |-- DateStamp

It.

| |-- VersionID | |-- ControlNumber |-- Header | |-- DocumentReference | | |-- DocumentNumber

1 0..1 1 1 1

|

|

| |

|

|-- DocumentReference | |-- DocumentNumber PurchaseOrder" | |-- DateStamp PurchaseOrder " |-- PartnerDescription

|

|

|

|-- DateStamp

|-- PartnerNumber

Stand: 31.05.2005

1 1 1 1 1

1 0..1 0..1 0..1 2 1

Typ Länge Beschreibung Wurzelelement Sender Umschlag S 13 Eindeutige ID des Senders der Nachricht S 13 Eindeutige ID des Empfängers der Nachricht D 8 Zeitstempel YYYYMMDD Erstelldatum der Nachricht S 5 Version der Spezifikation, z.B. 2.10 wird hier nicht verwendet Lieferschein Kopfdaten Referenzdaten N 15,0 Belegnummer Lieferscheinnummer D 8 Zeitstempel YYYYMMDD Lieferdatum Referenzdaten S 35 Belegnummer Bestellnummer D 8 Zeitstempel YYYYMMDD Bestelldatum Partner Adresssatz Partnerrolle Auftraggeber | Warenempfänger N 17,0 Partner Nummer Actebis Debitorennummer

Version: V2.10c

Seite 17

eBusiness Integration XML Guideline |

|

|-- PartnerNumber

0..1

N

| | |-- PartnerName1 | | |-- PartnerName2 | | |-- PartnerName3 | | |-- PartnerName4 | | |-- PartnerAddress | | |-- PartnerPostalCode | | |-- PartnerCity | | |-- PartnerCountryCode |-- LineItem | |-- LineNumber

1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 1..n 1

S S S S S N S S S

|

|-- ProductNumber

1

N

|

|-- ProductNumber

0..1

N

|

|-- ProductNumber

0..1

S

|

|-- Quantity

1

N

| | |

|-- Unit |-- DocumentReference | |-- DocumentNumber

1 1 1

S N

|

|

|-- LineNumber

1

N

|

|

|-- DateStamp

1

D

| |

|-- DocumentReference | |-- DocumentNumber

0..1 0..1

S

|

|

|-- LineNumber

0..1

S

|

|

|-- DateStamp

0..1

D

| |-- SerialNumber |-- ShipmentInformation | |-- PartnerDescription

0..n 0..1 1

S

| |

1 0..n

S S

| |-- PartnerName1 |-- PackageNumber

13,0 Partner Nummer ILN 35 Name 1 zur Partnerrolle 35 Name 2 zur Partnerrolle 35 Name 3 zur Partnerrolle 35 Name 4 zur Partnerrolle 35 Straße zur Partnerrolle 9,0 Postleitzahl zur Partnerrolle 35 Stadt zur Partnerrolle 3 Länderkennzeichen Positionsdaten 6 Positionsnummer Lieferscheinposition 18,0 Materialnummer Actebis Materialnummer 13,0 Materialnummer EAN 35 Materialnummer Kundenmaterialnr. 6,0 Menge Liefermenge 3 Mengeneinheit (PCE = Stück) Referenzdaten 15,0 Belegnummer Actebis Auftragsnummer 6 Positionsnummer Auftragsposition 8 Zeitstempel YYYYMMDD Auftragsdatum Referenzdaten 35 Belegnummer Bestellnummer 6 Positionsnummer Bestellposition 8 Zeitstempel YYYYMMDD Bestelldatum 20 Seriennummer(n) zur Lieferungsposition Versandinformationen Partner Adresssatz Partnerrolle Spediteur 35 Name 1 zur Partnerrolle 20 Nummer des Versandelements (Palette / Paket) Typ des Versandelements (Palette / Paket)

3.10 Nachricht Invoice 3.10.1 Beschreibung des Prozessablaufs Die Nachricht Invoice wird nach Auslieferung erzeugt. Die zu übermittelnden Fakturaarten sind vorab abzustimmen (Rechnungen, Gutschriften, Lastschriften). Fakturen können auf folgende Arten übertragen werden: 1. Die Übertragung findet einmal täglich für alle Fakturen des Vortages statt. Die Nachrichten werden morgens um ~08:15 Uhr übertragen. 2. Die Übertragung findet unmittelbar nach Erzeugung der Fakturabeleges statt.

Stand: 31.05.2005

Version: V2.10c

Seite 18

eBusiness Integration XML Guideline

3.10.2 Tabellarische Erläuterung des Nachrichtenaufbaus Hinweis: bei mit * gekennzeichneten Feldern die zulässigen Codelisten aus 3.10.3 beachten XML Tags / Attribute Invoice |-- SenderEnvelope | |-- SenderID | |-- ReceiverID | |-- DateStamp | |-- VersionID | |-- ControlNumber |-- Header | |-- DocumentType

It. 1 1 1 1 1 1 0..1 1 1

| |

|-- DocumentReference | |-- DocumentNumber

1 1

|

|

1

|

|-- DateStamp Invoice" |-- DocumentReference | |-- DocumentNumber PurchaseOrder" | |-- DateStamp "Purchase Order" |-- PartnerDescription

|

|

InvoicingParty" |-- PartnerNumber

0..1

|

|

|-- PartnerNumber

0..1

| | | | | | | | | |

| |-- PartnerName1 | |-- PartnerName2 | |-- PartnerName3 | |-- PartnerName4 | |-- PartnerAddress | |-- PartnerPostalCode | |-- PartnerCity | |-- PartnerCountryCode | |-- VATRegNumber |-- DateStamp

1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 0..1 1

|

|-- DateStamp

0..1

|

|-- DateStamp

0..1

| | | | |

|-- Currency |-- VAT |-- Conditions | |-- ConditionType | |-- MonetaryAmount

1 0..1 0..n 1 0..1

| | | |

| |-- ConditionPercentage | |-- ConditionDescription |-- PaymentAndShippingTerms | |-- TextualDescription

| | |

Stand: 31.05.2005

0..1 0..1 0..1 4

0..1 0..1 0..1 1..20

Typ Länge Beschreibung Wurzelelement Sender Umschlag S 13 Eindeutige ID des Senders der Nachricht S 13 Eindeutige ID des Empfängers der Nachricht D 8 Zeitstempel YYYYMMDD Erstelldatum der Nachricht S 5 Version der Spezifikation, z.B. 2.10 wird hier nicht verwendet Faktura Kopfdaten S 15 Fakturaart: Invoice, CreditNote oder DebitAdvice Referenzdaten N 15,0 Belegnummer Fakturanummer D 8 Zeitstempel YYYYMMDD Fakturadatum Referenzdaten S 35 Belegnummer Bestellnummer D 8 Zeitstempel YYYYMMDD Bestelldatum Partner Adresssatz Partnerrolle Auftraggeber | Warenempfänger | Rechnungsempfänger | Regulierer N 17,0 Partner Nummer Actebis Debitorennummer Pflichtfeld, wenn keine ILN N 13,0 Partner Nummer ILN Pflichtfeld, wenn keine Actebis Kundennummer S 35 Name 1 zur Partnerrolle S 35 Name 2 zur Partnerrolle S 35 Name 3 zur Partnerrolle S 35 Name 4 zur Partnerrolle S 35 Straße zur Partnerrolle N 9,0 Postleitzahl zur Partnerrolle S 35 Stadt zur Partnerrolle S 3 Länderkennzeichen S 20 Umsatzsteuer-ID zur Partnerrolle D 8 Zeitstempel YYYYMMDD Belegdatum D 8 Zeitstempel YYYYMMDD Lieferdatum D 8 Zeitstempel YYYYMMDD Fälligkeitsdatum S 3 ISO Währungsschlüssel, z.B. EUR (Euro) N 3,2 Mehrwertsteuer Prozentsatz Zu-/Abschlagskonditionen S 1 + (=Zuschlag) oder - (=Abschlag) N 10,2 Betrag Konditionsbetrag N 3,2 Konditionsprozentsatz S 80 Konditionsbeschreibung Liefer- und Zahlungsbedingungen S 71 Rechnungsinformationen zu Liefer-, ZahlungsBedingungen, Hinweis zu AGBs, […]

Version: V2.10c

Seite 19

eBusiness Integration XML Guideline |-- LineItem | |-- LineNumber

1..n 1

S

|

|-- ProductNumber

1

N

|

0..1

N

0..1

S

|

|-- ProductNumber EAN" |-- ProductNumber Buyer" |-- ProductNumber

0..1

S

|

|-- ProductNumber

0..1

S

|

|-- Quantity

1

N

| | |

|-- Unit |-- DocumentReference | |-- DocumentNumber

1 1..3 0..1

S

|

|

0..1 0..1 0..1 0..1

S N S D

|

S

| Delivery" |-- LineNumber

|

|

|-- DateStamp

| | |

| Delivery" |-- Conditions | |-- ConditionType | |-- MonetaryAmount

0..n 1 0..1

S N

| | |

| |-- ConditionPercentage | |-- ConditionDescription |-- MonetaryAmount

0..1 0..1 1

N S N

|

|-- MonetaryAmount

0..1

N

|

|-- MonetaryAmount

1

N

|

|-- MonetaryAmount

1

N

1 0..1 0..n 1..4 1

N S S

| |-- VAT | |-- CountryOfOrigin | |-- SerialNumber |-- CalculationSum

S

|

|-- MonetaryAmount

1

N

|

|-- MonetaryAmount

1

N

|

|-- MonetaryAmount

0..1

N

Stand: 31.05.2005

Positionsdaten 6 Positionsnummer Fakturaposition 18,0 Materialnummer Actebis Materialnummer 13,0 Materialnummer EAN 35 Materialnummer Kundenmaterialnummer 40 Materialnummer HerstellerTeileNr 17 Materialnummer statistische Warennummer 6,0 Menge fakturierte Menge 3 Mengeneinheit (PCE=Stück) Referenzangaben 35 Belegnummer Bestellnummer | Actebis Auftragsnummer | Lieferscheinnummer Positionsnummer 6 Bestellposition 6 Auftragsposition 6 Lieferscheinposition 8 Zeitstempel YYYYMMDD Bestelldatum | Auftragsdatum | Lieferdatum Zu-/Abschlagskonditionen 1 + (=Zuschlag) oder - (=Abschlag) 10,2 Betrag Konditionsbetrag 3,2 Konditionsprozentsatz 80 Konditionsbeschreibung 10,2 Betrag Nettobetrag pro Stück 10,2 Betrag Nettobetrag pro Stück inkl. aller Zuschlagskonditionen 10,2 Betrag Netto Positionssumme inkl. aller Zuschlagskonditionen 10,2 Betrag Mehrwertsteuerbetrag Position 3,2 Mehrwertsteuer Prozentsatz 3 Ursprungsland 20 Seriennummer(n) zur Position Summensegment, VAT=Total kommt immer 5 MWSt Prozentsatz (16.00, …) oder über alle MWSt (Total) 15,2 Betrag Nettobetrag 15,2 Betrag Mehrwertsteuerbetrag 15,2 Betrag Bruttobetrag

Version: V2.10c

Seite 20

eBusiness Integration XML Guideline

3.10.3 Codelisten Die folgende Tabelle enthält die zulässigen Werte für folgende XML Tags: XML Tag ConditionType DocumentType

Stand: 31.05.2005

Zulässige Werte des Tags + Invoice CreditNote DebitAdvice

Version: V2.10c

Beschreibung Zuschlagskondition Abschlagskondition Rechnung Gutschrift Lastschrift

Seite 21

eBusiness Integration XML Guideline

4. Änderungshistorie 4.1 Kommunikationsparameter Version

Datum

Name

Beschreibung

2.10c

13.04.2005

Lars Rektorschek

2.2 Hinzufügen AS2 / SMTP als Kommunikationsprotokolle 2.4 Hinzufügen eingehende / ausgehende Authentifizierung 2.5 Hinzufügen Beschreibung der Partnernummern 2.6 Änderung: Empfangsparameter Actebis http Gateway

4.2 Nachrichten Nachricht ReceiptAcknowledgement Version

Datum

Name

Beschreibung

2.10c 2.10c

13.04.2005 31.05.2005

Lars Rektorschek Lars Rektorschek

Hinzufügen der Nachricht Fehlerkorrektur innerhalb DocumentNumber

Nachricht ReceiptAcknowledgementException Version

Datum

Name

Beschreibung

2.10c 2.10c

13.04.2005 31.05.2005

Lars Rektorschek Lars Rektorschek

Hinzufügen der Nachricht Fehlerkorrektur innerhalb DocumentNumber, Anpassung der Feldlängen

Nachricht PriceCatalogue Version

Datum

Name

Beschreibung

2.10

10.01.2005

Lars Rektorschek

Erweiterung PriceCatalogue im LineItem: Einfügung ProductStatus

2.10 2.10c

19.01.2005 13.04.2005

Lars Rektorschek Lars Rektorschek

Ersetzung MaterialNumber durch ProductNumber Anpassung ProductCategoryStructure für neue Actebis Produkthierarchie: Attribut parent=“…“ zur Kennzeichnung der Übergeordneten Hierarchie

Nachricht CnetData Version

Datum

Name

Beschreibung

2.10

10.01.2005

Lars Rektorschek

Erweiterung CnetData im LineItem: Einfügung ProductDescription type=“CnetMarketing“ Einfügung ProductDatasheet

2.10

19.01.2005

Lars Rektorschek

Einfügung ProductModificationIdentifier Ersetzung MaterialNumber durch ProductNumber

Nachricht StockInfo Version

Datum

Name

2.10

19.01.2005

Lars Rektorschek

Stand: 31.05.2005

Beschreibung Ersetzung MaterialNumber durch ProductNumber

Version: V2.10c

Seite 22

eBusiness Integration XML Guideline Nachricht Order Version

Datum

Name

2.10 2.10c

19.01.2005 13.04.2005

Lars Rektorschek Lars Rektorschek

Beschreibung Ersetzung MaterialNumber durch ProductNumber Anpassung Beschreibung des Prozessablaufs (3.6.1)

Nachricht OrderChange Version

Datum

Name

Beschreibung

2.10

21.12.2004

Lars Rektorschek

Erweiterung OrderChange im LineItem: Einfügung ProductNumber type=“Buyer“ Einfügung MonetaryAmount type=“NetCustomer“ (zum Hinzufügen von Positionen) Einfügung ProductModificationIdentifier (zur Separierung

2.10 2.10c

19.01.2005 13.04.2005

Lars Rektorschek Lars Rektorschek

Hinzufügen / Ändern von Positionen) Ersetzung MaterialNumber durch ProductNumber Anpassung Beschreibung des Prozessablaufs (3.7.1)

Nachricht OrderResponse Version

Datum

Name

2.10 2.10b

19.01.2005 22.03.2005

Lars Rektorschek Lars Rektorschek

Beschreibung Ersetzung MaterialNumber durch ProductNumber Einfügung Conditions Einfügung MonetaryAmount type=“NetCustomerIncludingConditions“ Einfügung MonetaryAmount type=“SumNetPosition“

Nachricht Delivery Version

Datum

Name

Beschreibung

2.10

07.12.2004

Thomas Haucap

2.10

19.01.2005

Lars Rektorschek

Erweiterung Delivery im Header: Einfügung DocumentNumber type=“PurchaseOrder“ Ersetzung MaterialNumber durch ProductNumber

Nachricht Invoice Version

Datum

Name

Beschreibung

2.10

07.12.2004

Thomas Haucap

Erweiterung Invoice im Header: Einfügung DocumentNumber type=“PurchaseOrder“

2.10 2.10 2.10b

03.01.2005 19.01.2005 22.03.2005

Lars Rektorschek Lars Rektorschek Lars Rektorschek

Einfügung PaymentAndShippingTerms Ersetzung MaterialNumber durch ProductNumber Einfügung Conditions auf LineItem Ebene Einfügung MonetaryAmount im LineItem type=“NetCustomerIncludingConditions“ Einfügung MonetaryAmount type=“SumNetPosition“

Stand: 31.05.2005

Version: V2.10c

Seite 23