Mattentwiete Hamburg

Transkript

1 EDI APERAK Bookings Implementierungshandbuch Version (Gültig ab 1. Juli 2016) Mattentwiete Hamburg Phone: Fax: info@dakosy.de Alle Rechte, auch die der Übersetzung, des Nachdruckes oder der Vervielfältigung des Dokumentes oder Teilen daraus, vorbehalten. Kein Teil des Dokumentes darf ohne Genehmigung der AG reproduziert, unter Verwendung elektronischer Systeme verarbeitet, vervielfältigt und verbreitet werden.

2 Änderungsverzeichnis Version Art der Änderung Geändert durch/ Datum Datum Ersterstellung M. Kramper, J. Diettrich SG2->RFF: neue Codes ZZZ (- Referenznummer) und IT ( INTTRA- Referenznummer) SG BGM > neue Codes 749 (VGM APERAK) und 23 (Rückmeldung VGM, Alternative zu 749), RFF > neuer Code AAQ (Containernr.) J. Diettrich/A.Kunze M. Kramper/ J. Diettrich Änderungsdienst Mattentwiete Hamburg 1. Telefon: Fax: info@dakosy.de Verwendete Werkzeuge Nummer Verwendete Werkzeuge W1 Dieses Dokument wurde mit Textverarbeitungsprogramm MS Word 2010 erstellt. Haftung 1. Trotz sorgfältiger Erarbeitung und Prüfung dieses Dokumentes können aus dem Inhalt keine Haftungsansprüche gegenüber der AG abgeleitet werden! APERAK Bookings, Version Seite: 2 von 23

3 Inhaltsverzeichnis 1. Erläuterungen zur Segmentdarstellung Beschreibung der Nachrichtenstruktur Nachrichtenaufbaudiagramm Segmentbeschreibung... 9 APERAK Bookings, Version Seite: 3 von 23

4 1. Erläuterungen zur Segmentdarstellung Die Segmente werden nach einem durchgängigen Schema dargestellt, z. B: Die erste (Haupt-)Spalte EDIFACT beschreibt mit ihren drei Unterspalten die Struktur der verwendeten EDIFACT-Nachricht. Hierbei wird in der ersten Spalte die Bezeichnung/Nummer des jeweiligen Composites oder Datenelements angegeben, in der zweiten Spalte die zugehörige Bedeutung beschrieben und in der dritten Spalte die Verwendung und das Format angegeben. Die zweite (Haupt-)Spalte Anwendung beschreibt mit ihren drei Unterspalten, wie die jeweiligen Composites und Datenelemente für die Nachricht anzuwenden sind. Die erste Spalte ST = Status hat folgende Bedeutung: M (Mandatory) oder R (Required) Falls ein Composite oder Datenelement bereits in der eigentlichen EDIFACT-Nachricht eine Pflichtangabe (M = Mandatory) ist, dann wird das M in diese Spalte übernommen. In anderen Fällen kennzeichnet das R = Required ein aus B/L-Anwendungssicht erforderliches Pflichtfeld. D (Depending) Die Dateneinheiten müssen gesendet werden, wenn bestimmte Bedingungen zutreffen, die entweder in der Spalte Verwendung/Hinweise beschrieben werden oder sich aus dem Anwendungsfall ableiten lassen. So hat z.b. die Segmentgruppe 32 (Gefahrgutangaben) den Status D, weil deren Anwendung davon abhängt, ob es sich bei der Position/dem Item um Gefahrgut handelt. C (Conditional/Optional) Es ist dem Absender der Nachricht überlassen, ob er die Dateneinheiten übermittelt. Im Zweifelsfall ist eine individuelle Regelung zwischen Sender und Empfänger zu vereinbaren. X / N (not used/nicht verwendet) Die so gekennzeichneten Composites oder Datenelemente werden nicht benutzt. Die zweite Spalte zeigt Beispielangaben zu den jeweiligen Datenelementen und die dritte Spalte enthält wichtige Angaben zur Verwendung, wie z. B.: Codeangaben, hafenspezifische Regelungen oder Formateinschränkungen. APERAK Bookings, Version Seite: 4 von 23

5 2. Beschreibung der Nachrichtenstruktur Zähler Nr Bez St MaxWdh Ebene Inhalt UNA C 1 0 Service string advice UNB M 1 0 Interchange header UNG C 1 0 Functional group header UNH M 1 0 Nachrichten-Kopfsegment BGM M 1 0 Beginn der Nachricht DTM C 9 1 Datum/Uhrzeit/Zeitspanne 0090 SG2 C 9 1 RFF RFF M 1 1 Referenzangaben 0120 SG3 C 9 1 NAD-CTA-COM NAD M 1 1 Name und Anschrift CTA C 1 2 Ansprechpartner COM C 9 2 Kommunikationsverbindung 0160 SG4 C ERC-FTX ERC M 1 1 Fehlercode FTX C 1 2 Freier Text UNT M 1 0 Nachrichten-Endesegment UNE C 1 0 Functional group trailer UNZ M 1 0 Interchange trailer 3. Nachrichtenaufbaudiagramm APERAK Bookings, Version Seite: 5 von 23

6 1 Ebene 0 UNA C UNB M UNG C UNH M BGM M Ebene 1 DTM C APERAK Bookings, Version Seite: 6 von 23

7 1 2 Ebene 0 UNT M SG2 C SG3 C SG4 C Ebene 1 RFF M NAD M ERC M Ebene 2 CTA C COM C FTX C APERAK Bookings, Version Seite: 7 von 23

8 2 Ebene 0 UNE C UNZ M APERAK Bookings, Version Seite: 8 von 23

9 4. Segmentbeschreibung UNA ( 1 ) C 1 0 Service string advice UNA UNA1 Component data element M an1 M an1 : separator UNA2 Data element separator M an1 M an1 + UNA3 Decimal notation M an1 M an1. UNA4 Release indicator M an1 M an1? UNA5 Reserved for future use M an1 M an1 Leerzeichen UNA6 Segment terminator M an1 M an1 ' Es wird die Verwendung der im Beispiel angezeigten Trennzeichen empfohlen. UNA:+.? ' APERAK Bookings, Version Seite: 9 von 23

10 UNB ( 1 ) M 1 0 Interchange header UNB S001 Syntax identifier M M 0001 Syntax identifier M a4 M a4 UNOC UN/ECE level C 0002 Syntax version number M n1 M n1 3 Version 3 S002 Interchange sender M M 0004 Sender identification M an..35 M an..35 (+DAKOS) 0007 Partner identification code C an..4 N Not used qualifier 0008 Address for reverse routing C an..14 N Not used S003 Interchange recipient M M 0010 Recipient identification M an..35 M an..35 Es wird die Verwendung des eigenen - Teilnehmercodes empfohlen. Es können aber auch andere Bezeichnungen verwendet werden, diese sind mit abzustimmen. Teilnehmer-Code 0007 Partner identification code C an..4 N Not used qualifier 0014 Routing address C an..14 N Not used S004 Date/time of preparation M M 0017 Date of preparation M n6 M n6 Format: JJMMTT 0019 Time of preparation M n4 M n4 Die Zeitangabe wird in UTC (GMT) angenommen Interchange control reference M an..14 M an..14 Die Referenz muss eindeutig vergeben werden. S005 Recipient's reference, C N Nicht verwendet password 0022 Recipient's reference/password M an..14 N Nicht verwendet Not used 0025 Recipient's reference/password C an2 N Not used qualifier 0026 Application reference C an..14 N Nicht verwendet Not used 0029 Processing priority code C a1 N Nicht verwendet Not used 0031 Acknowledgement request C n1 N Nicht verwendet Not used 0032 Communications agreement ID C an..35 N Nicht verwendet Not used 0035 Test indicator C n1 C n1 1 Interchange is a test Nur für Testübertragungen einzugeben. UNB+UNOC:3+DAKOS+Participant code :1249+unb-reference ' APERAK Bookings, Version Seite: 10 von 23

11 UNG ( 1 ) C 1 0 Functional group header UNG 0038 Functional group identification M an..6 M an..6 S006 Application sender's M M identification 0040 Sender identification M an..35 M an..35 In diesem Datenelement wird die Teilnehmerbezeichnung des Absenders angegeben Partner identification code C an..4 N Not used qualifier S007 Application recipient's M M identification 0044 Recipient's identification M an..35 M an..35 In diesem Element wird die Teilnehmerbezeichnung des Empfängers angegeben Partner identification code C an..4 N Not used qualifier S004 Date/time of preparation M M 0017 Date of preparation M n6 M n6 Format: JJMMTT 0019 Time of preparation M n4 M n4 Die Referenz muss eindeutig vergeben werden Functional group reference M an..14 M an..14 number 0051 Controlling agency M an..2 M an..2 UN UN/CEFACT S008 Message version M M 0052 Message version number M an..3 M an..3 D Draft version/un/edifact Directory 0054 Message release number M an..3 M an..3 00B Release B 0057 Association assigned code C an..6 N Not used 0058 Application password C an..14 N Not used Das UNG-Segment eröffnet eine Nachrichtengruppe "UNG/UNE". Die Nachrichtengruppe wird bei der Übertragung von Buchungsdaten über das Hafenkommunikationssystem für die Adressierung des Empfängers benötigt. Eine Nachrichtengruppe "UNG/UNE" kann eine oder mehrere Buchungsnachrichten für den im UNG angegebenen Empfänger enthalten. UNG+X+Sender+Recipient :1249+UNG-Reference+UN:00B' APERAK Bookings, Version Seite: 11 von 23

12 UNH ( 1 ) M 1 0 Nachrichten-Kopfsegment UNH 0062 Message reference number M an..14 M an..14 Die Referenz muss eindeutig vergeben werden. S009 Message identifier M M 0065 Message type M an..6 M an..6 APERAK Application error and acknowledgement message 0052 Message version number M an..3 M an..3 D Draft version/un/edifact Directory 0054 Message release number M an..3 M an..3 00B Release B 0051 Controlling agency M an..2 M an..2 UN UN/CEFACT 0057 Association assigned code C an..6 N Not used 0068 Common access reference C an..35 N Not used S010 Status of the transfer C N 0070 Sequence of transfers M n..2 N Not used 0073 First and last transfer C a1 N Not used UNH+UNH-Reference+APERAK:D:00B:UN' APERAK Bookings, Version Seite: 12 von 23

13 BGM ( 1 ) M 1 0 Beginn der Nachricht BGM C002 Dokumenten-/ C C Nachrichtenname 1001 Dokumentenname, Code C an..3 C an Buchungsanforderung für Transportraum 770 Buchungsbestätigung 749 VGM APERAK 23 Status information 23 = Rückmeldung VGM, alternativ zu Code Codeliste, Code C an..3 N Not used 3055 Verantwortliche Stelle für die C an..3 N Not used Codepflege, Code 1000 Dokumentenname C an..35 N Not used C106 Dokumenten-/Nachrichten- C N Identifikation 1004 Dokumentennummer C an..35 N Not used 1056 Versionsnummer C an..9 N Not used 1060 Revisionsnummer C an..6 N Not used 1225 Nachrichtenfunktion, Code C an..3 C an..3 9 Original 4343 Art der Antwort, Code C an..3 C an..3 AP Accepted RE Rejected BGM AP' APERAK Bookings, Version Seite: 13 von 23

14 DTM ( 1 ) C 9 1 Datum/Uhrzeit/Zeitspanne DTM C507 Datum/Uhrzeit/Zeitspanne M M 2005 Datums- oder Uhrzeits- oder M an..3 M an..3 9 Bearbeitungs-/Verarbeitungsdatum/-zeit Zeitspannen-Funktion, Qualifier 2380 Datum oder Uhrzeit oder C an..35 C an..35 Zeitspanne, Wert 2379 Datums- oder Uhrzeit- oder Zeitspannen-Format, Code C an..3 C an CCYYMMDDHHMM DTM+9: :203' APERAK Bookings, Version Seite: 14 von 23

15 0090 SG2 ( 1 ) C 9 1 RFF RFF ( 1 ) M 1 1 Referenzangaben RFF C506 Referenz M M 1153 Referenz, Qualifier M an..3 M an..3 AGO Absenderreferenz für die Original-Nachricht ACW Referenznummer einer vorangegangenen Nachricht AAQ ULD-Identifikationsnummer (z. B. Container) BN Buchungsnummer IT Internal customer number INO Übertragungdateinummer, alt ZZZ Beiderseitig vereinbarte Referenznummer INO = Interchangenummer der vorhergehenden Nachricht AAQ = Containernummer ACW = Eindeutige Sendungsidentifikationsnummer des Kunden (Dokumentenkennung aus BGM) AGO = MessageReferenceNumber der vorhergehenden Nachricht BN = Buchungsnummer des Carriers der vorhergehenden Nachricht IT = INTTRA Referenznummer ZZZ = Referenz 1154 Referenz, Identifikation C an..35 C an Zeilennummer C an..6 N Not used 4000 Referenzversion, Identifikation C an..35 N Not used 1060 Revisionsnummer C an..6 N Not used RFF+AGO:Reference' APERAK Bookings, Version Seite: 15 von 23

16 0120 SG3 ( 1 ) C 9 1 NAD-CTA-COM NAD ( 1 ) M 1 1 Name und Anschrift NAD 3035 Beteiligter, Qualifier M an..3 M an..3 CA Frachtführer GF Slot charter party TY Provider C082 Identifikation des Beteiligten C C 3039 Beteiligter, Identifikation M an..35 M an Codeliste, Code C an..3 N Not used 3055 Verantwortliche Stelle für die C an..3 N Not used Codepflege, Code C058 Name und Anschrift C N 3124 Zeile für Name und Anschrift M an..35 N Not used 3124 Zeile für Name und Anschrift C an..35 N Not used 3124 Zeile für Name und Anschrift C an..35 N Not used 3124 Zeile für Name und Anschrift C an..35 N Not used 3124 Zeile für Name und Anschrift C an..35 N Not used C080 Name des Beteiligten C N 3036 Beteiligter M an..35 N Not used 3036 Beteiligter C an..35 N Not used 3036 Beteiligter C an..35 N Not used 3036 Beteiligter C an..35 N Not used 3036 Beteiligter C an..35 N Not used 3045 Format für den Namen des C an..3 N Not used Beteiligten, Code C059 Straße C N 3042 Straße und Hausnummer oder M an..35 N Not used Postfach 3042 Straße und Hausnummer oder C an..35 N Not used Postfach 3042 Straße und Hausnummer oder C an..35 N Not used Postfach 3042 Straße und Hausnummer oder C an..35 N Not used Postfach 3164 Ort C an..35 N Not used C819 Region/Bundesland, C N Einzelheiten 3229 Name einer Region/eines C an..9 N Not used Bundeslandes, Code 1131 Codeliste, Code C an..3 N Not used 3055 Verantwortliche Stelle für die C an..3 N Not used Codepflege, Code 3228 Region/Bundesland C an..35 N Not used 3251 Postleitzahl, Code C an..17 N Not used 3207 Ländername, Code C an..3 N Not used NAD+CA+' APERAK Bookings, Version Seite: 16 von 23

17 0120 SG3 ( 1 ) C 9 1 NAD-CTA-COM CTA ( 1 ) C 1 2 Ansprechpartner CTA 3139 Funktion des C an..3 C an..3 IC Informationskontakt Ansprechpartners, Code C056 Abteilung oder Bearbeiter C C 3413 Abteilung oder Bearbeiter, C an..17 N Not used Code 3412 Abteilung oder Bearbeiter C an..35 C an..35 -SUPPORT CTA+IC: Support' APERAK Bookings, Version Seite: 17 von 23

18 0120 SG3 ( 1 ) C 9 1 NAD-CTA-COM COM ( 1 ) C 9 2 Kommunikationsverbindung COM C076 Kommunikationsverbindung M M 3148 Kommunikationsnummer M an..512 M an / Kommunikationsnummer, Qualifier M an..3 M an..3 TE Telefon FX Telefax EM Elektronische Post COM+040 / :TE' APERAK Bookings, Version Seite: 18 von 23

19 0160 SG4 ( 1 ) C ERC-FTX ERC ( 1 ) M 1 1 Fehlercode ERC C901 Anwendungsfehler M M 9321 Anwendungsfehler, Code M an..8 M an Codeliste, Code C an..3 N Not used 3055 Verantwortliche Stelle für die Codepflege, Code C an..3 N Not used ERC+X' APERAK Bookings, Version Seite: 19 von 23

20 0160 SG4 ( 1 ) C ERC-FTX FTX ( 1 ) C 1 2 Freier Text FTX 4451 Textbezug, Qualifier M an..3 M an..3 AAO Fehlerbeschreibung (Freier Text) 4453 Textfunktion, Code C an..3 N Not used C107 Text-Referenz C N 4441 Freier Text, Code M an..17 N Not used 1131 Codeliste, Code C an..3 N Not used 3055 Verantwortliche Stelle für die C an..3 N Not used Codepflege, Code C108 Text C C 4440 Freier Text M an..512 M an Freier Text C an..512 N Not used 4440 Freier Text C an..512 N Not used 4440 Freier Text C an..512 N Not used 4440 Freier Text C an..512 N Not used 3453 Sprachenname, Code C an..3 C an Textformat, Code C an..3 N Not used FTX+AAO APERAK Bookings, Version Seite: 20 von 23

21 UNT ( 1 ) M 1 0 Nachrichten-Endesegment UNT 0074 Number of segments in the M n..6 M n..6 message 0062 Message reference number M an..14 M an..14 UNT+No. of segments+message reference no.' APERAK Bookings, Version Seite: 21 von 23

22 UNE ( 1 ) C 1 0 Functional group trailer UNE 0060 Number of messages M n..6 M n Functional group reference M an..14 M an..14 number UNE+1+X' APERAK Bookings, Version Seite: 22 von 23

23 UNZ ( 1 ) M 1 0 Interchange trailer UNZ 0036 Interchange control count M n..6 M n Interchange control reference M an..14 M an..14 UNZ+1+X' APERAK Bookings, Version Seite: 23 von 23