Nachrichtenhandbuch
AC03
Version 1.2
![]()
DAKOSY Datenkommunikationssystem 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: Im Element 'CustomsInformationZODIAK' folgende
Datenelemente ergänzt: - Im
Element 'CustomsInformationHABISZoll' folgendes Datenelement ergänzt: 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 |
Alle |
Überarbeitung nach Review Nachrichtenelement 'StatusInformation': - Definition der Facette 'DEC1..3' korrigiert |
S.Buse |
15.03.2006 29.06.2006 |
|
1.1 |
Kapitel 1 Kapitel 3 |
- Kapitel 1.3.1 Beispiel für Löschung korrigiert - Kapitel 1.3.2 – Statuscode für Zollstatus 'Warten auf MRN' korrigiert (korrekter Code 25000) - Kapitel 3 – redaktionelle Korrekturen |
S.Buse |
29.06.2007 |
|
1.2 |
Alle |
Layout und mitgeltende Dokumente aktualisiert |
S. Buse |
03.06.2013 |
Änderungsdienst
DAKOSY
Datenkommunikationssystem AG
Mattentwiete 2
20457 Hamburg
Verwendete
Werkzeuge
Dieses Dokument wurde mit dem Textverarbeitungsprogramm MS Word 2010 erstellt.
Mitgeltende
Dokumente
Im EDI - Handbuch "Allgemeiner Teil" sind die Grundsätze beschrieben, die für jeden Datenaustausch, der über DAKOSY erfolgt, gültig sind. Die dort niedergelegten Definitionen, die beschriebenen Mitwirkungspflichten des Kunden sowie die Grundlagen des Kommunikationsablaufes gelten auch für die im vorliegenden Handbuch beschriebene Schnittstelle.
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.
Beispiel Vormeldung
(Buchungsanfrage)
Die nachfolgende Grafik stellt die Struktur der Freistellung dar und ist mit einer detaillierten Beschreibung der einzelnen Nachrichtenelemente verlinkt:

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:
|
customer |
customs |
sales |
quay |
production |
||||||||||
|
code |
text |
meaning |
code |
text |
meaning |
code |
text |
meaning |
code |
text |
meaning |
code |
text |
meaning |
|
10000 |
AUFTRAG |
initial
status transport order |
11000 |
AUFTRAG |
initial
status transport order |
12000 |
AUFTRAG |
initial
status transport order |
13000 |
AUFTRAG |
initial
status transport order |
|
|
|
|
|
|
|
11010 |
KLV_AUFTRAG |
intial status 'KLV' transport order |
12010 |
AUFTRAG
VF |
intial status 'VF' transport order |
|
|
|
|
|
|
|
|
|
|
11100 |
HA
NR ERHALTEN |
initial
status HABIS Zoll system |
|
|
|
|
|
|
|
|
|
|
20000 |
RUECKW
ZOLL |
customs
rejection |
21000 |
RUECKWEISUNG |
rejection |
22000 |
RUECKW
ABS |
rejection
sales |
23000 |
RUECKW
KAI |
rejection
quay |
|
|
|
|
20010 |
RUECKW
ABS |
sales
rejection |
|
|
|
|
|
|
|
|
|
|
|
|
|
20020 |
RUECKW
KAI |
quay
rejection |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21100 |
RUECKWEISUNG |
rejection
HABIS Zoll |
|
|
|
|
|
|
|
|
|
|
|
|
|
21200 |
RUECKWEISUNG
STORNO |
rejection of deletion by HABIS Zoll |
|
|
|
|
|
|
|
|
|
|
|
|
|
25000 |
WARTEN
AUF MRN |
HABIS Zoll is waitung for missing MRN |
|
|
|
|
|
|
|
|
|
|
|
|
|
30000 |
MASSNAHME
ANGEORDNET |
customs inspection by HABIS Zoll |
|
|
|
|
|
|
|
|
|
|
|
|
|
31000 |
GESICHTET |
inspected
by customs |
32000 |
BEARBEITET |
processed |
|
|
|
|
|
|
|
|
|
|
31010 |
GESICHTET
* |
inspected
by customs |
32100 |
DB
VORGEPR |
prececked
by DB |
|
|
|
|
|
|
|
|
|
|
|
|
|
32200 |
TEIL
BEREIT |
transport
order partially ready |
33200 |
TEIL
BEREIT |
transport
order partially ready |
|
|
|
|
|
|
|
|
|
|
32210 |
TEIL
NICHT |
transport
order not ready |
33210 |
TEIL
NICHT |
transport
order not ready |
|
|
|
|
|
|
|
|
|
|
32300 |
GANZ
BEREIT |
transport
order ready |
33300 |
GANZ
BEREIT |
transport
order ready |
|
|
|
|
|
|
|
41000 |
LDST_ZOSI_N |
the loading location does not require a customs
inspection |
|
|
|
|
|
|
|
|
|
|
|
|
|
41010 |
BHFB_ZOSI_N |
the rail station does not require a customs
inspection |
|
|
|
|
|
|
|
|
|
|
|
|
|
41020 |
UMFUHR |
no customs inspection required für the transshipment |
|
|
|
|
|
|
|
|
|
|
|
|
|
45000 |
EINZELFALL |
manual
procedure HABIS Zoll |
|
|
|
|
|
|
|
|
|
|
|
|
|
51000 |
ABGEFERTIGT |
cleared
by customs |
|
|
|
|
|
|
|
|
|
|
|
|
|
55000 |
UEBERLASSEN |
cleared
by HABIS Zoll |
|
|
|
|
|
|
|
|
|
|
|
|
|
56000 |
UEBERLASSUNG
AUFGEHOBEN |
revoked clearance by HABIS Zoll |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
62000 |
GANZ
DISPO |
planning
complete |
63000 |
GANZ
DISPO |
planning
complete |
64000 |
GANZ
DISPO |
planning
complete |
|
70000 |
VERLADEN |
transport
order loaded |
|
|
|
72000 |
VERLADEN |
transport
order loaded |
73000 |
VERLADEN |
transport
order loaded |
74000 |
VERLADEN |
transport
order loaded |
Die nachfolgende Grafik stellt die Struktur der Fakturadaten dar und ist mit einer detaillierten Beschreibung der einzelnen Nachrichtenelemente verlinkt:

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' |
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.
Auftragserteilung mit
Buchungsanfrage

Auftragserteilung mit
Stornierung

Auftragserteilung mit
Fakturierung

Auftragserteilung mit
ZODIAK

Auftragserteilung mit
HBZ (HABIS Zoll)
Auftraggeber

Die Quittungsmeldung wird als Antwort auf jede Nachricht gesendet. Quittungsmeldungen selber werden nicht quittiert.
Die Quittungsmeldung erfüllt folgende Aufgaben:
Normalfall

Verlorene Nachricht

Verlorene Quittung

Syntaktisch oder
inhaltlich fehlerhafte Nachricht

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.
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