CONTRL Buchungen - DAKOSY Datenkommunikationssystem AG

Implementierungshandbuch „CONTRL Bookings“EDICONTRL BookingsImplementierungshandbuchVersion 1.0.1(Gültig ab 07. Januar 2014)Mattentwiete 220457 Hamburgwww.dakosy.dePhone: + 49 40 37003 - 0Fax: + 49 40 37003 - 370info@dakosy.deAlle Rechte, auch die der Übersetzung, des Nachdruckes oder der Vervielfältigung des Dokumentes oder Teilen daraus, vorbehalten. Kein Teil des Dokumentes darf ohneGenehmigung der DAKOSY AG reproduziert, unter Verwendung elektronischer Systeme verarbeitet, vervielfältigt und verbreitet werden.

DAKOSYDatenkommunikationssystem AGImplementierungshandbuch „CONTRL Bookings“ÄnderungsverzeichnisVersion Art der Änderung Geändert durch/ Datum Geprüft durch/Datum1.0.0 Ersterstellung M. Kramper, J. Diettrich 20.12.20131.0.1 DAKOSY-Referenznummer hinzugefügt (UNB) J. Diettrich06.01.2014A. Kunze06.01.2014ÄnderungsdienstDAKOSYDatenkommunikationssystem AGMattentwiete 220457 Hamburg1. Telefon: + 49 40 37003 - 02. Fax: + 49 40 37003 - 3703. E-Mail: info@dakosy.deVerwendete WerkzeugeNummer Verwendete WerkzeugeW1 Dieses Dokument wurde mit Textverarbeitungsprogramm MS Word 2010 erstellt.Haftung1. Trotz sorgfältiger Erarbeitung und Prüfung dieses Dokumentes können aus dem Inhaltkeine Haftungsansprüche gegenüber der DAKOSY AG abgeleitet werden!Version 1.0.1 Seite: 2 von 19

DAKOSYDatenkommunikationssystem AGImplementierungshandbuch „CONTRL Bookings“Inhaltsverzeichnis1. Erläuterungen zur Segmentdarstellung ................................................................. 42. Beschreibung der Nachrichtenstruktur ................................................................. 53. Nachrichtenaufbaudiagramm ................................................................................. 54. Segmentbeschreibung ............................................................................................... 8Version 1.0.1 Seite: 3 von 19

DAKOSYDatenkommunikationssystem AGImplementierungshandbuch „CONTRL Bookings“1. Erläuterungen zur SegmentdarstellungDie Segmente werden nach einem durchgängigen Schema dargestellt, z. B:Die erste (Haupt-)Spalte „EDIFACT“ beschreibt mit ihren drei Unterspalten die Struktur der verwendetenEDIFACT-Nachricht. Hierbei wird in der ersten Spalte die Bezeichnung/Nummer des jeweiligen Compositesoder Datenelements angegeben, in der zweiten Spalte die zugehörige Bedeutung beschrieben und in der drittenSpalte die Verwendung und das Format angegeben.Die zweite (Haupt-)Spalte „Anwendung“ beschreibt mit ihren drei Unterspalten, wie die jeweiligen Compositesund 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 einePflichtangabe (M = Mandatory) ist, dann wird das M in diese Spalte übernommen. In anderen Fällenkennzeichnet das R = Required ein aus B/L-Anwendungssicht erforderliches Pflichtfeld.• D (Depending)Die Dateneinheiten müssen gesendet werden, wenn bestimmte Bedingungen zutreffen, die entweder inder Spalte „Verwendung/Hinweise“ beschrieben werden oder sich aus dem Anwendungsfall ableitenlassen. So hat z.B. die Segmentgruppe 32 (Gefahrgutangaben) den Status „D“, weil deren Anwendungdavon 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 isteine 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ältwichtige Angaben zur Verwendung, wie z. B.: Codeangaben, hafenspezifische Regelungen oderFormateinschränkungen.Version 1.0.1 Seite: 4 von 19

DAKOSYDatenkommunikationssystem AGImplementierungshandbuch „CONTRL Bookings“2. Beschreibung der NachrichtenstrukturZähler Nr Bez St MaxWdh Ebene Inhalt0000 1 UNA C 1 0 Trennzeichen-Vorgabe0000 2 UNB M 1 0 Nutzdaten-Kopfsegment0000 3 UNG C 1 0 Gruppen-Kopfsegment0010 4 UNH M 1 0 Nachrichten-Kopfsegment0020 5 UCI M 1 0 Übertragungsdatei-Antwort0030 SG1 C 999999 1 UCM-SG20040 6 UCM M 1 1 Nachrichten-/Packet-Antwort0050 SG2 C 999 2 UCS-UCD0060 7 UCS M 1 2 Segment-Fehleranzeige0070 8 UCD C 99 3 Datenelement-Fehleranzeige0150 9 UNT M 1 0 Nachrichten-Endesegment0000 10 UNE C 1 0 Gruppen-Endesegment0000 11 UNZ M 1 0 Nutzdaten-Endesegment3. NachrichtenaufbaudiagrammVersion 1.0.1 Seite: 5 von 19

DAKOSYDatenkommunikationssystem AGImplementierungshandbuch „CONTRL Bookings“1Ebene 0UNAC 110000UNBM 120000UNGC 130000UNHM 140010UCIM 150020Ebene 1Ebene 2SG1C 9999990030UCMM 160040SG2C 9990050UCSM 170060Ebene 3UCDC 9980070Version 1.0.1 Seite: 6 von 19

DAKOSYDatenkommunikationssystem AGImplementierungshandbuch „CONTRL Bookings“1Ebene 0UNTM 190150UNEC 1100000UNZM 1110000Version 1.0.1 Seite: 7 von 19

DAKOSYDatenkommunikationssystem AGImplementierungshandbuch „CONTRL Bookings“4. SegmentbeschreibungZähler Nr Bez St MaxWdh Ebene Name0000 1 UNA ( 1 ) C 1 0 Trennzeichen-VorgabeStandardImplementationBez Name St Format St Format Anwendung / BemerkungUNAUNA1 Gruppendatenelement- M an1 M an1 :TrennzeichenUNA2 Datenelement-Trennzeichen M an1 M an1 +UNA3 Dezimalzeichen M an1 M an1 .UNA4 Freigabezeichen M an1 M an1 ?UNA5 Wiederholungs-Trennzeichen M an1 M an1 LeerzeichenUNA6 Segment-Endezeichen M an1 M an1 'Bemerkung:Es wird die Verwendung der im Beispiel gezeigten Trennzeichen empfohlen.Beispiel:UNA:+.? 'Version 1.0.1 Seite: 8 von 19

DAKOSYDatenkommunikationssystem AGZähler Nr Bez St MaxWdh Ebene NameImplementierungshandbuch „CONTRL Bookings“0000 2 UNB ( 1 ) M 1 0 Nutzdaten-KopfsegmentStandardImplementationBez Name St Format St Format Anwendung / BemerkungUNBS001 Syntax-Bezeichner M M0001 Syntax-Kennung M a4 M a4 UNOC UN/ECE-Zeichensatz C0002 Syntax-Versionsnummer M an1 M an1 3 Version 30080 Versionsnummer desC an..6 N Not usedService-Codeverzeichnis0133 Zeichencodierung, codiert C an..3 N Not usedS002 Absender derMMÜbertragungsdatei0004 Absenderbezeichnung für M an..35 M an..35 DAKOSY (+DAKOS)Übertragungsdatei0007 Teilnehmerbezeichnung, C an..4 N Not usedQualifier0008 Interne Absenderbezeichnung C an..35 N Not usedfür Übertragungsdatei0042 Untergeordnete, interne C an..35 N Not usedAbsenderbezeichnung fürÜbertragungsdateiS003 Empfänger derÜbertragungsdateiMM0010 Empfängerbezeichnung fürÜbertragungsdateiM an..35 M an..35 Es wird die Verwendung des eigenen DAKOSY-Teilnehmercodes empfohlen. Es können aber auch andereBezeichnungen verwendet werden, diese sind mit DAKOSYabzustimmen.Teilnehmer-Code0007 Teilnehmerbezeichnung, C an..4 N Not usedQualifier0014 Interne Empfängerbezeichnung C an..35 N Not usedfür Übertragungsdatei0046 Untergeordnete, interne C an..35 N Not usedEmpfängerbezeichnung fürÜbertragungsdateiS004 Datum und Uhrzeit der MMErstellung0017 Datum der Erstellung M n8 M n8 Format: JJMMTT0019 Uhrzeit der Erstellung M n4 M n4 Die Zeitangabe wird in UTC (GMT) erwartet.0020 Datenaustauschreferenz M an..14 M an..14 Die Referenz muss eindeutig vergeben werden.S005 Referenz/Passwort des CCEmpfängers0022 Referenz oder Passwort des M an..14 N Not usedEmpfängers0025 Referenz oder Passwort des C an2 N Not usedEmpfängers, Qualifier0026 Anwendungsreferenz C an..14 C an..14 DAKOSY-Referenznummer0029 Verarbeitungspriorität, Code C a1 N Not used0031 Bestätigungsanforderung C n1 N Not used0032 Austauschvereinbarungskennu C an..35 N Not usedng0035 Test-Kennzeichen C n1 C n1 1 Allgemeiner TestNur für Testübertragungen anzugeben.Bemerkung:Beispiel:UNB+UNOC:3+DAKOSY+Participant code+00130922:1257+X++DAKOSY Reference++++1'Version 1.0.1 Seite: 9 von 19

DAKOSYDatenkommunikationssystem AGZähler Nr Bez St MaxWdh Ebene NameImplementierungshandbuch „CONTRL Bookings“0000 3 UNG ( 1 ) C 1 0 Gruppen-KopfsegmentStandardImplementationBez Name St Format St Format Anwendung / BemerkungUNG0038 Nachrichtengruppen-C an..6 C an..6KennzeichnungS006 Anwendungsbezeichnung des CCAbsenders0040 Absenderbezeichnung desVorgangsM an..35 M an..35 In diesem Datenelement wird die Teilnehmerbezeichnungdes Absenders angegeben.0007 Teilnehmerbezeichnung, C an..4 N Not usedQualifierS007 Anwendungsbezeichnung des CCEmpfängers0044 Empfängerbezeichnung desVorgangsM an..35 M an..35 In diesem Element wird die Teilnehmerbezeichnung desEmpfängers angegeben.0007 Teilnehmerbezeichnung, C an..4 N Not usedQualifierS004 Datum und Uhrzeit der CCErstellung0017 Datum der Erstellung M n8 M n8 Format: JJMMTT0019 Uhrzeit der Erstellung M n4 M n4 Die Referenz muss eindeutig vergeben werden.0048 Gruppen-Referenznummer M an..14 M an..140051 Verwaltende Organisation, C an..3 C an..3 UN UN/CEFACTcodiertS008 Version des Nachrichtentyps C C0052 Versionsnummer desM an..3 M an..3 D Entwurfs-VersionNachrichtentyps0054 Freigabenummer desM an..3 M an..3 00B Ausgabe 2000-BNachrichtentyps0057 Anwendungscode derC an..6 N Not usedZuständigen Organisation0058 Anwendungspasswort C an..14 N Not usedBemerkung:Das UNG-Segment eröffnet eine Nachrichtengruppe "UNG/UNE". Die Nachrichtengruppe wird bei der Übertragung vonBuchungsdaten über das DAKOSY Hafenkommunikationssystem für die Adressierung des Empfängers benötigt. EineNachrichtengruppe "UNG/UNE" kann eine oder mehrere Buchungsnachrichten für den im UNG angegebenen Empfänger enthalten.Beispiel:UNG+CONTRL+Sender+Recipient+20130922:1325+UNG-Reference+UN+D:00B'Version 1.0.1 Seite: 10 von 19

DAKOSYDatenkommunikationssystem AGZähler Nr Bez St MaxWdh Ebene NameImplementierungshandbuch „CONTRL Bookings“0010 4 UNH ( 1 ) M 1 0 Nachrichten-KopfsegmentStandardImplementationBez Name St Format St Format Anwendung / BemerkungUNH0062 Nachrichten-Referenznummer M an..14 M an..14 Die Referenz muss eindeutig vergeben werden.S009 Nachrichtenkennung M M0065 Nachrichtentyp-Kennung M an..6 M an..6 CONTRL Syntax- und Servicebericht0052 Versionsnummer desM an..3 M an..3 D Entwurfs-VersionNachrichtentyps0054 Freigabenummer desM an..3 M an..3 00B Ausgabe 2000-BNachrichtentyps0051 Verwaltende Organisation, M an..3 M an..3 UN UN/CEFACTcodiert0057 Anwendungscode derC an..6 N Not usedZuständigen Organisation0110 Versionsnummer desC an..6 N Not usedCodelisten-Verzeichnis0113 Unterfunktion desC an..6 N Not usedNachrichtentyps, Identifikation0068 Allgemeine Zuordnungs- C an..35 N Not usedReferenzS010 Status der Übermittlung C N0070 Übermittlungsfolgenummer M n..2 N Not used0073 Erste und letzte Übermittlung C a1 N Not usedS016 Nachrichtensubset,CNIdentifikation0115 Nachrichtensubset,M an..14 N Not usedIdentifikation0116 Versionsnummer desC an..3 N Not usedNachrichtensubsets0118 Freigabenummer desC an..3 N Not usedNachrichtensubsets0051 Verwaltende Organisation, C an..3 N Not usedcodiertS017 Nachrichten-CNAnwendungshandbuch,Identifikation0121 Nachrichten-M an..14 N Not usedAnwendungshandbuch,Identifikation0122 Versionsnummer desC an..3 N Not usedNachrichten-Anwendungshandbuches0124 Freigabenummer desC an..3 N Not usedNachrichten-Anwendungshandbuches0051 Verwaltende Organisation, C an..3 N Not usedcodiertS018 Szenariokennung C N0127 Szenariokennung M an..14 N Not used0128 Versionsnummer desC an..3 N Not usedSzenarios0130 Freigabenummer desC an..3 N Not usedSzenarios0051 Verwaltende Organisation,codiertC an..3 N Not usedBemerkung:Beispiel:UNH+UNH-Reference+CONTRL:D:00B:UN'Version 1.0.1 Seite: 11 von 19

DAKOSYDatenkommunikationssystem AGZähler Nr Bez St MaxWdh Ebene NameImplementierungshandbuch „CONTRL Bookings“0020 5 UCI ( 1 ) M 1 0 Übertragungsdatei-AntwortStandardImplementationBez Name St Format St Format Anwendung / BemerkungUCI0020 Datenaustauschreferenz M an..14 M an..14S002 Absender derMMÜbertragungsdatei0004 Absenderbezeichnung für M an..35 M an..35 Code des TeilnehmersÜbertragungsdatei0007 Teilnehmerbezeichnung, C an..4 N Not usedQualifier0008 Interne Absenderbezeichnung C an..35 N Not usedfür Übertragungsdatei0042 Untergeordnete, interne C an..35 N Not usedAbsenderbezeichnung fürÜbertragungsdateiS003 Empfänger derMMÜbertragungsdatei0010 Empfängerbezeichnung für M an..35 M an..35 DAKOSYÜbertragungsdatei0007 Teilnehmerbezeichnung, C an..4 N Not usedQualifier0014 Interne Empfängerbezeichnung C an..35 N Not usedfür Übertragungsdatei0046 Untergeordnete, interne C an..35 N Not usedEmpfängerbezeichnung fürÜbertragungsdatei0083 Aktion, codiert M an..3 M an..3 4 Diese Ebene und alle tieferen Ebenenzurückgewiesen7 Diese Ebene ist bestätigt; die nächsttiefereEbene ist bestätigt, wenn8 Übertragungsdatei empfangen0085 Syntax-Fehler, codiert C an..3 C an..3 1 Zeichensatz nicht unterstützt0135 Service-Segment-Bezeichner, C an..3 N Not usedcodiertS011 Datenelement-Identifikation C C0098 Segmentposition desM n..3 M n..3fehlerhaften Datenelements0104 DE-Gruppenposition des C n..3 C n..3fehlerhaftenGruppendatenelements0136 Fehlerhaftes Auftreten eines C n..6 C n..6Datenelements0534 Sicherheits-Referenznummer C an..14 N Not used0138 Position des Sicherheits-SegmentsC n..6 N Not usedBemerkung:Beispiel:UCI+X+Participant code+DAKOSY+4+7++9:9:9'Version 1.0.1 Seite: 12 von 19

DAKOSYDatenkommunikationssystem AGZähler Nr Bez St MaxWdh Ebene NameImplementierungshandbuch „CONTRL Bookings“0030 SG1 ( 1 ) C 999999 1 UCM-SG20040 6 UCM ( 1 ) M 1 1 Nachrichten-/Packet-AntwortStandardImplementationBez Name St Format St Format Anwendung / BemerkungUCM0062 Nachrichten-Referenznummer C an..14 C an..14S009 Nachrichtenkennung C C0065 Nachrichtentyp-Kennung M an..6 M an..60052 Versionsnummer desM an..3 M an..3Nachrichtentyps0054 Freigabenummer desM an..3 M an..3Nachrichtentyps0051 Verwaltende Organisation, M an..3 M an..3codiert0057 Anwendungscode derC an..6 C an..6Zuständigen Organisation0110 Versionsnummer desC an..6 N Not usedCodelisten-Verzeichnis0113 Unterfunktion desC an..6 N Not usedNachrichtentyps, Identifikation0083 Aktion, codiert M an..3 M an..3 4 Diese Ebene und alle tieferen Ebenenzurückgewiesen7 Diese Ebene ist bestätigt; die nächsttiefereEbene ist bestätigt, wenn0085 Syntax-Fehler, codiert C an..3 C an..3 2 Syntax-Version oder -ebene nicht unterstützt7 Empfänger der Übertragungsdatei ist nichtder tatsächliche Empfänger12 Ungültiger Wert13 Fehlt14 Wert nicht an dieser Position unterstützt15 Nicht unterstützt an dieser Position16 Zu viele Bestandteile17 Keine Vereinbarung18 Nicht spezifizierter Fehler20 Zeichen ungültig als Service-Zeichen21 Ungültige(s) Zeichen22 Ungültige(s) Service-Zeichen23 Unbekannter Absender derÜbertragungsdatei24 Zu alt25 Test-Kennzeichen nicht unterstützt26 Duplikat gefunden28 Referenzen stimmen nicht überein29 Kontrollzähler entspricht nicht der Anzahlempfangener Fälle30 Gruppen und Nachrichten/Packete gemischt32 Tiefere Ebene leer33 Ungültiges Auftreten außerhalb einerNachricht, eines Packets oder ein35 Zu viele Wiederholungen36 Zu viele Segmentgruppen-Wiederholungen37 Ungültige Zeichenart39 Datenelement zu lang40 Datenelement zu kurz44 Trailing separator45 Character set not supported46 Envelope functionalty not supported0135 Service-Segment-Bezeichner, C an..3 C an..3codiertS011 Datenelement-Identifikation C C0098 Segmentposition desfehlerhaften DatenelementsM n..3 R n..3Version 1.0.1 Seite: 13 von 19

DAKOSYDatenkommunikationssystem AG0104 DE-Gruppenposition des C n..3 O n..3fehlerhaftenGruppendatenelements0136 Fehlerhaftes Auftreten eines C n..6 O n..6Datenelements0800 Packet-Referenznummer C an..35 N Not usedS020 Referenz-Identifikation C N0813 Referenz, Qualifier M an..3 N Not used0802 Referenz-M an..35 N Not usedIdentifikationsnummer0534 Sicherheits-Referenznummer C an..14 N Not used0138 Position des Sicherheits-SegmentsC n..6 N Not usedBemerkung:Beispiel:UCM+X+CONTRL:1:1:AA:X+4+2+UCD+::9'Implementierungshandbuch „CONTRL Bookings“Version 1.0.1 Seite: 14 von 19

DAKOSYDatenkommunikationssystem AGZähler Nr Bez St MaxWdh Ebene NameImplementierungshandbuch „CONTRL Bookings“0030 SG1 ( 1 ) C 999999 1 UCM-SG20050 SG2 ( 1 ) C 999 2 UCS-UCD0060 7 UCS ( 1 ) M 1 2 Segment-FehleranzeigeStandardImplementationBez Name St Format St Format Anwendung / BemerkungUCS0096 Segmentposition in der M n..6 M n..6Nachricht0085 Syntax-Fehler, codiert C an..3 C an..3Bemerkung:Beispiel:UCS+X+X'Version 1.0.1 Seite: 15 von 19

DAKOSYDatenkommunikationssystem AGZähler Nr Bez St MaxWdh Ebene NameImplementierungshandbuch „CONTRL Bookings“0030 SG1 ( 1 ) C 999999 1 UCM-SG20050 SG2 ( 1 ) C 999 2 UCS-UCD0070 8 UCD ( 1 ) C 99 3 Datenelement-FehleranzeigeStandardImplementationBez Name St Format St Format Anwendung / BemerkungUCD0085 Syntax-Fehler, codiert M an..3 M an..3S011 Datenelement-Identifikation M M0098 Segmentposition desM n..3 M n..3fehlerhaften Datenelements0104 DE-Gruppenposition des C n..3 C n..3fehlerhaftenGruppendatenelements0136 Fehlerhaftes Auftreten einesDatenelementsC n..6 C n..6Bemerkung:Beispiel:UCD+X+X:X:9'Version 1.0.1 Seite: 16 von 19

DAKOSYDatenkommunikationssystem AGZähler Nr Bez St MaxWdh Ebene NameImplementierungshandbuch „CONTRL Bookings“0150 9 UNT ( 1 ) M 1 0 Nachrichten-EndesegmentStandardImplementationBez Name St Format St Format Anwendung / BemerkungUNT0074 Anzahl der Segmente in einer M n..10 M n..10Nachricht0062 Nachrichten-Referenznummer M an..14 M an..14Bemerkung:Beispiel:UNT+X+X'Version 1.0.1 Seite: 17 von 19

DAKOSYDatenkommunikationssystem AGZähler Nr Bez St MaxWdh Ebene NameImplementierungshandbuch „CONTRL Bookings“0000 10 UNE ( 1 ) C 1 0 Gruppen-EndesegmentStandardImplementationBez Name St Format St Format Anwendung / BemerkungUNE0060 Gruppenzähler M n..6 M n..60048 Gruppen-Referenznummer M an..14 M an..14Bemerkung:Beispiel:UNE+1+X'Version 1.0.1 Seite: 18 von 19

DAKOSYDatenkommunikationssystem AGZähler Nr Bez St MaxWdh Ebene NameImplementierungshandbuch „CONTRL Bookings“0000 11 UNZ ( 1 ) M 1 0 Nutzdaten-EndesegmentStandardImplementationBez Name St Format St Format Anwendung / BemerkungUNZ0036 Datenaustauschzähler M n..6 M n..60020 Datenaustauschreferenz M an..14 M an..14Bemerkung:Beispiel:UNZ+1+X'Version 1.0.1 Seite: 19 von 19