Nachrichtenhandbuch

AC03

 

Version 1.2

 

 

 

DAKOSY-Logo_ohneUnterzeile_140x21

 

 

 

 

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:
'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

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.

 


1.  Nachrichtenelemente

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.3.2    HABIS Statuscodes

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


 

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

Auftragserteilung mit Stornierung

Auftragserteilung mit Fakturierung

 

1.7    DAKOSY spezifische Szenarien

Auftragserteilung mit ZODIAK

Auftragserteilung mit HBZ (HABIS Zoll)

Auftraggeber

 

2      Technischer Nachrichtenaustausch

2.1    Quittierung

Die Quittungsmeldung wird als Antwort auf jede Nachricht gesendet. Quittungsmeldungen selber werden nicht quittiert.

Die Quittungsmeldung erfüllt folgende Aufgaben:

 

Normalfall

Beispiel positive Quittung

 

Verlorene Nachricht

Verlorene Quittung

 

Syntaktisch oder inhaltlich fehlerhafte Nachricht

 

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