Nachrichtenhandbuch
AC03
Version 1.0
DAKOSY AG
Mattentwiete 2
20457 Hamburg
Tel. 040 / 37003 - 0
Fax. 040 / 37007 –
370
Änderungsnachweis:
|
Version
|
Betr. Abschnitte
|
Grund
|
Name
|
Datum
|
|
0.8
|
Alle
|
Erstellung
|
S.Buse
|
14.09.2005
|
|
0.9
|
Alle
|
Kapitel 2 und 3 inhaltlich ergänzt
Alle Nachrichtenelemente:
- Codierung in
ISO-8859-1 geändert
- für das Attribut
Status des XML-Elements Document/Messages/Message den Wert 'cancel' ergänzt
- Pflichtangabe des
Passworts im XML-Element PWD für die Rolle 'SENDER' entfernt
- Attribut 'TYP' des XML-Elements
TransactionDef in 'TYPE' umbenannt
- Längendefinition des
Attributs 'ReferenceNumber' des Elements 'Message' korrigiert
-
Nachrichtenelement Vormeldung / Transportauftrag / Verlade-Ist:
- Maximales Vorkommen
des Elements 'DangerousGoods' ('TransportOrder/TransportContainer') auf 999
korrigiert
- Schreibweise des
Elements 'Tarrif' in 'Tariff' korrigiert
- Schreibweise des
Elements 'CuntryCode' in 'CountryCode' korrigiert
- Datentyp des
Elements 'ArrivalDate' ('TransportOrder/Discharge') in DateTime geändert
- Name des Elements 'FeederShip' ('TransportOrder/FeederShip') in 'FeederShipName'
geändert
- Schreibweise des
komplexen Elements 'TreinTyp2' in 'TrainTyp2' korrigiert
- Länge der Elemente
'Memoranda', 'LastTransported' und 'Regulations' ('TransportContainer/DangerousGoods')
korrigiert
- Kommentar zum
Element 'Position' in dem Element 'TransportContainer' erweitert
- Im Element 'GoodsItem'
folgende Datenelemente ergänzt:
'Position'
'CustomsTarifNumber'
'PreviousDokumentType'
'PreviousDokumentReference'
'ExportRegulationsConformance'
'RestrictionOnExport'
'ExportTaxCollection'
Im Element 'CustomsInformationZODIAK' folgende
Datenelemente ergänzt:
'MeansOfTransport/Identity'
'MeansOfTransport/Nationality'
- Im Element 'CustomsInformationHABISZoll'
folgendes Datenelement ergänzt:
'AnmeldungKonventionell'
Nachrichtenelement Statusmeldungen:
- Verlagerung der
Elemente 'WagonNumber', 'Quay', 'OceanCarrier' und 'DispatchInformation' des
Elements 'StatusInformation' in das Element 'StatusInformation/Container'
- Ergänzung des
Elements 'Position' in den Elementen 'StatusInformation/Container' und 'ErrorMessage'
- Kommentar zum
Element 'Position' in dem Element 'StatusInformation/Deletion' erweitert
Nachrichtenelement Quittung:
- Begrenzung des
Elements 'Code' ('Texts/Text') auf 10 Stellen
- Begrenzung des
Elements 'FreeText' (Texts/Text') auf 50 Stellen
|
S.Buse
|
10.12.2005
26.01.2006
|
|
1.0
|
|
Überarbeitung nach Review
Nachrichtenelement 'StatusInformation':
- Definition der Facette
'DEC1..3' korrigiert
|
S.Buse
|
15.03.2006
29.06.2006
|
|
|
|
|
|
|
1.1
Vormeldung / Transportauftrag / Verlade-Ist
Vormeldungen, Transportaufträge und
Verlade-Ist Meldungen werden bei der Kommunikation strukturell gleich
behandelt. Sie unterscheiden sich in der praktischen Verwendung in ihrer
Bedeutung und im Umfang der jeweils kommunizierten Daten. Der konkrete Typ der
Nachricht wird über ein entsprechendes XML-Element (OrderType)
festgelegt.
Die nachfolgende Grafik stellt die Struktur der
Vormeldung,
Transportauftrags und Verlade-Ist Meldung dar und ist mit einer
detaillierten Beschreibung der einzelnen Nachrichtenelemente verlinkt:
Die Nachrichtenelemente Transport
Order, Address
Data, Transport
Container und Dangerous
Goods Information beschreiben respektive – die bereits aus AC02 bekannten –
inhaltlichen Elemente des Auftragskopfs, der Adressdaten, des Containers und
der Gefahrgutinformationen.
Die Nachrichtenelemente Goods
Item und Goods
Item Allocation ermöglichen die Kommunikation von Warenpositionen und deren
Zuordnung zu Containern. Hierdurch ist es möglich in Kombination mit den
Nachrichtenelementen Customs
Information ZODIAK und Customs
Information HABIS Zoll den für die Systeme HABIS Zoll und ZODIAK (ATLAS)
den benötigten Datenumfang mit Hilfe von AC03 zu übermitteln.
1.1.1
XSD-Schema und Beispiele
TransportOrder.xsd
Beispiel Vormeldung
(Buchungsanfrage)
Beispiel Auftrag
Beispiel Verlade-Ist
1.2
Freistellung
Die nachfolgende Grafik stellt die
Struktur der Freistellung
dar und ist mit einer detaillierten Beschreibung der einzelnen
Nachrichtenelemente verlinkt:
1.2.1
XSD-Schema und Beispiele
Release.xsd
Beispiel Freistellung
1.3
Statusmeldungen
Die Statusmeldungen dienen zur
Kommunikation verschiedener Inhalte. Mit ihnen werden Statusinformationen (im
engeren Sinne), Fehlermeldungen oder Rückweisungen, Buchungsbestätigungen und
Löschungen übermittelt.
Die nachfolgende Grafik stellt die Struktur der
Statusmeldungen
dar und ist mit einer detaillierten Beschreibung der einzelnen
Nachrichtenelemente verlinkt:
1.3.1
XSD-Schema und Beispiele
StatusInformation.xsd
Beispiel Status
Beispiel Rückweisung
Beispiel Buchungsbestätigung
Beispiel Löschung
1.4
Fakturadaten
Die nachfolgende Grafik stellt die
Struktur der Fakturadaten
dar und ist mit einer detaillierten Beschreibung der einzelnen
Nachrichtenelemente verlinkt:
1.4.1
XSD-Schema und Beispiele
InvoiceData.xsd
Beispiel Fakturadaten
1.5
Quittung
Jede kommunizierte Nachricht wird quittiert. Dies geschieht
mit Hilfe einer technischen Quittung.
Die nachfolgende Grafik stellt die
Struktur der Quittung
dar und ist mit einer detaillierten Beschreibung der einzelnen
Nachrichtenelemente verlinkt:
Das Nachrichtenelement 'Response' kann folgende Werte für
das Element 'Code' des komplexen Typs 'Text' enthalten:
|
Code
|
Type
|
Bedeutung
|
|
00000
|
INFO
|
Der Code wird zur positiven Quittierung einer Nachricht
verwendet – ein erläuternder Text ist nicht notwendig
|
|
00100
|
INFO
|
Positive Quittierung einer doppelt erhaltenen Nachricht (Vorraussetzung:
gleiche Nachrichtenreferenz)
|
|
10000
|
ERROR
|
Fehler beim Parsen der Nachricht – der Fehlertext kann im
Element 'Free Text' übermittelt werden
|
|
85000
|
ERROR, INFO, STATUS, WARNING
|
Freier Text – Details siehe Element 'Free Text'
|
1.5.1
XSD-Schema und Beispiele
Response.xsd
Beispiel positive Quittung
Beispiel negative Quittung
Fachlicher Nachrichtenaustausch
Die hier dargestellten Szenarien stellen beispielhaft den
Nachrichtenaustausch aus fachlicher Sicht dar. Die technischen Aspekte des
Nachrichtenaustauschs werden in Kapitel 3 Technischer Nachrichtenaustausch erörtert.
1.6
Allgemeine Szenarien
Auftragserteilung mit Buchungsanfrage
- Übermittlung einer Buchungsanfrage mit anschließender
Auftragserteilung (Übermittlung des Auftrags mit gleicher Referenz)
- Annahme des Auftrags
- Änderung des Auftrags durch den Auftraggeber
- Rückmeldung von Statusinformationen und der Verlade-Ist
Meldung
Auftragserteilung mit Stornierung
- Übermittlung des Auftrags
- Annahme des Auftrags durch den Auftragnehmer
- Stornierung des Auftrags durch den Auftraggeber und
anschließende Löschung des Auftrags durch den Auftragnehmer
Auftragserteilung mit Fakturierung
- Übermittlung des Auftrags
- Annahme des Auftrags durch den Auftragnehmer
- Rückmeldung von Statusinformationen und der Verlade-Ist
Meldung
- Rückmeldung von Fakturadaten an den Auftraggeber
1.7
DAKOSY spezifische Szenarien
Auftragserteilung mit ZODIAK
- Szenario für Aufträge mit ATLAS-Anmeldung
- Übermittlung einer Transport Order (Auftrag) mit
Nachrichtenelementen Goods Item und Customs Information ZODIAK
- Weiterleitung der Daten an ZODIAK und nach entsprechender
Verarbeitung an ATLAS
- Rückmeldung von Statusinformationen aus ATLAS und ZODIAK
(z.B. Zollregistriernummern)
- Weitere Verarbeitung des Auftrags (mit ergänzten
Zolldaten) in ACTION / UNIKAT
Auftragserteilung mit HBZ (HABIS Zoll)
- Szenario für Bahnauftrage ab/nach Hamburg
- Übermittlung einer Transport Order (Auftrag) mit
Nachrichtenelementen Goods Item und Customs Information HABIS Zoll
- Automatische Weiterleitung und Verarbeitung der HABIS Zoll
Anmeldung
2.1
Quittierung
Die Quittungsmeldung wird als Antwort auf jede Nachricht
gesendet. Quittungsmeldungen selber werden nicht quittiert.
Die Quittungsmeldung erfüllt folgende Aufgaben:
- Bestätigung der korrekten Verarbeitung bzw. Ablehnung
aufgrund einer fehlerhaften Syntax (Prüfung gegen XML-Schema)
- Erkennung von Nachrichtenverlust / -doppelung zusätzlich zur
Sicherung auf der technischen Ebene.
Normalfall
- Nachricht syntaktisch korrekt.
- Der Absender erhält für jede Nachricht eine
Quittungsmeldung mit dem 'Response Type = INFO' und dem 'Code 00000'.
Beispiel positive
Quittung
Verlorene Nachricht
- der Absender erhält keine Quittungsmeldung
- erneute Übermittlung der Nachricht (kann mit gleicher
Nachrichtenreferenz erfolgen).
- Hierfür sind beim Absender entsprechende Timeout und Retry-Verfahren
zu implementieren.
Verlorene Quittung
- Der Absender erhält keine Quittungsmeldung – die Nachricht
muss erneut gesendet werden.
- Der Empfänger ignoriert die doppelte Nachricht
(Vorraussetzung: gleiche Nachrichtenreferenz) und sendet erneut eine
Quittungsmeldung mit der Information 'Nachricht doppelt empfangen'.
Syntaktisch oder inhaltlich fehlerhafte Nachricht
- die Nachricht lässt sich nicht gegen das Nachrichtenschema
validieren
- die Nachricht enthält inhaltliche Fehler
- Übermittlung der korrigierten Nachricht mit einer neuen
Nachrichtenreferenz und gleicher fachlicher Version.
Beispiel negative Quittung
2.2
Protokolle
Bevorzugtes Protokoll für den Austausch von AC03 XML-Nachrichten
ist FTP. Das generelle Verfahren zum Nachrichtenaustausch mit DAKOSY per FTP
ist in dem folgenden Handbuch beschrieben:
Datenaustausch
mit DAKOSY über FTP
Aufgrund der expliziten Quittierung aller Nachrichten ist
ebenfalls ein gesicherter Austausch der Nachrichten per E-Mail möglich.
Das konkrete Verfahren ist jeweils zwischen den
Kommunikationspartnern bilateral abzustimmen.
3
Migration AC02 Þ AC03
Die Transaktion AC03 bildet den gesamten Funktionsumfang der
Transaktion AC02 ab:
Die einzelnen Feldnummerngruppen werden folgendermaßen
abgebildet:
·
Transportauftrag – Kopfdaten
Version 02
·
Transportauftrag- Container
Version 02
·
Freistellung – Kopfdaten
Version 01
·
Freistellung –
Containerdaten Version 01
·
Fakturadaten – Die Umsetzung der AC02 Fakturadaten
(Feldnummerngruppe 400) findet nicht 1 zu 1 statt, sondern wird im AC03
inhaltlich von den gleichnamigen Nachrichtenelement Fakturadaten
wahrgenommen.
·
Verlade-Ist – Kopfdaten
Version 02
·
Verlade-Ist – Container
Version 02
·
Statusinformation Version 01
·
Adressdaten Transportauftrag
Version 01
·
Adressdaten Verlade-Ist
Version 01
·
Fehlermeldung Version 01
