Brooklyn-Kiev Port LLC IT Department APERAK. Client Guide Release: D95B Version: 1.0

Transcription

1 Brooklyn-Kiev Port LL IT Department APERAK lient Guide Release: D95B Version: 1.0 Alexander V. Stolyarov, IO Ilya V. Kryukin, EDI Engineer Last Updated: Tuesday, 14 arch, 2017

2 Status : Release BKP IT Department Page 2 / 10 ONTENTS Segment Structure (in grey not sent)... 3 Specifications of APERAK D95B... 3 UNB segment: essage header... 4 UNH Segment: essage header... 5 BG Segment: Beginning of message... 6 DT Segment: Date/time/period... 6 SG_1. RFF Segment: Reference... 7 SG_2. NAD Segment: Name and address... 7 SG_3. ER Segment: Application error information (For APERAK rejected only)... 8 SG_3. FTX Segment: Free text (For APERAK rejected only)... 8 UNT Segment: essage trailer... 9 UNZ Segment: essage trailer... 9 APPENDIX APERAK Samples... 10

3 Status : Release BKP IT Department Page 3 / 10 Segment Structure (in grey not sent) UNH 1 () BG 1 () DT 9 () FTX 9 () NT 9 () Group 1 9 () RFF 1 () DT 9 () Group 2 9 () NAD 1 () TA 9 () O 9 () Group () ER 1 () FTX 1 () Group 4 1 () RFF 1 () FTX 9 () UNT 1 () Specifications of APERAK D95B This Specification is intended for business, technical and EDI personnel engaged in establishing an electronic connection with BKP for the purpose of exchanging container discharge/loading order transaction messages between BKP via BKP s version of EDIFAT APERAK (D95B).

4 Status : Release BKP IT Department Page 4 / 10 Pic. 1 How to read Segment Tables UNB segment: essage header To start, identify and specify an interchange Pos Segment / Repeat Repr. 010 S001 SYNTAX IDENTIFIER Syntax identifier a4 UNOA UN/EE level A 0002 Syntax version number an1 020 S002 INTERHANGE SENDER Interchange sender identification arrier EDI ID Trading Partner's Sender ID (A, ANL ) 0007 Identification code qualifier an Address for reverse routing an S003 INTERHANGE REIPIENT Interchange recipient identification arrier EDI ID Trading Partner's Recipient ID (Terminal EDI Id..) 0007 Identification code qualifier an Interchange recipient internal identification S004 DATE AND TIE OF PREPARATION Date Format YYDD 0019 Time UT (GT) Time The twenty-four hour clock system will be used to express time. Time will be expressed and transmitted by means of four figures, the first two denoting the hour past midnight and the last two the minutes past the hour. Examples : 12:45 a.m. is expressed as :00 noon is expressed as :45 p.m. is expressed as 2345 n8 n4

5 Status : Release BKP IT Department Page 5 / 10 12:00 midnight is expressed as :30 a.m. is expressed as :45 p.m. is expressed as :30 p.m. is expressed as Interchange control reference (unique for each OREOR) 1 an S005 REIPIENT'S REFERENE/PASSWORD DETAILS Recipient Reference/Password an Recipient Reference/Password qualifier an Application reference 1 an Processing priority code 1 a Acknowledgement request 1 n Interchange agreement identifier Test indicator 1 n1 Segment Example: UNB+UNOE:2+BKP+A G :2038+NBFILE460161' UNH Segment: essage header Pos Segment / Repeat Repr essage reference number (unique for each ODEO) 1 an S009 ESSAGE IDENTIFIER essage type APERAK ode identifying a type of message and assigned by its controlling agency APERAK an essage version number D 0054 essage release number 95B 0051 ontrolling agency, coded UN 0057 Association assigned code ITG12 Draft version/un/edifat Directory Release B UN/EFAT ITG12 spec an..2 an ode list directory version number an essage type sub-function identification an ommon access reference S010 STATUS OF THE TRANSFER Sequence of transfers n First and last transfer a1

6 Status : Release BKP IT Department Page 6 / 10 Segment Example: UNH+NBFILE ODEO:D:95B:UN:SDG10' BG Segment: Beginning of message Pos Segment / Repeat Repr DOUENT/ESSAGE NAE Document name code 23 Status information 1131 ode list qualifier an ode list responsible agency, coded 1000 Document name an DOUENT/ESSAGE IDENTIFIATION Document/message number (unique for each OREOR) To identify a document. an Version identifier an Revision number an essage function code Response type, coded Not accepted Accepted without amendment AP RE Accepted Rejected 1373 Document status, coded Langage name code 1 Segment Example: BG AP' BG RE' DT Segment: Date/time/period 1 Pos Segment / Repeat Repr DATE/TIE/PERIOD Date/time/period qualifier 132 Processing date/time 2380 Date/time/period Date/time/period format qualifier 203 YYDDHH Segment Example: DT+9: :203'

7 Status : Release BKP IT Department Page 7 / 10 SG_1. RFF Segment: Reference Pos Segment / Repeat Repr REFERENE Reference function code qualifier AW Booking reference number 1154 Reference identifier an Document line identifier an Reference version identifier an Revision number an..6 Segment Example: RFF+AW:1004_OREOR_BG_Segment' SG_2. NAD Segment: Name and address Pos Segment / Rep Repr Party function code qualifier 1 S R essage Sender essage Recipient PARTY IDENTIFIATION DETAILS Party identifier Lineode 1131 ode list qualifier 160 Party identification 3055 ode list responsible agency code 20 BI NAE AND ADDRESS Name and address line Name and address line Name and address line Name and address line Name and address line PARTY NAE Party name an Party name an Party name an Party name an Party name an Party name format code STREET Street and number/p.o. box Street and number/p.o. box Street and number/p.o. box Street and number/p.o. box ity name OUNTRY SUB-ENTITY DETAILS 1 5 an..17

8 Status : Release BKP IT Department Page 8 / ountry sub-entity name code an ode list qualifier an ode list responsible agency code 3228 ountry sub-entity name an Postal identification code 1 an ountry name code In some business cases specification of the country in which ascertainment of weight has taken place is required. 1 Segment Example: NAD+S+BKP' NAD+R+A G' SG_3. ER Segment: Application error information (For APERAK rejected only) Pos Segment / Repeat Repr APPLIATION ERROR DETAIL Application error identification an ode list qualifier 3055 ode list responsible agency code Segment Example: ER+NE NAJJ' SG_3. FTX Segment: Free text (For APERAK rejected only) Pos Segment / Repeat Repr Text subject qualifier GEN Entire transaction set Text function, coded TEXT REFERENE Free text, coded 1131 ode list qualifier 3055 ode list responsible agency, coded TEXT LITERAL Free text an Free text an Free text an Free text an Free text an Language, coded 1 Segment Example: FTX+GEN+++NE NAJJDEN AKKREDITOVANNYJJ EHKSPEDITOR DLJA INN?' ?''

9 Status : Release BKP IT Department Page 9 / 10 UNT Segment: essage trailer Pos Segment / Repeat Repr NUBER OF SEGENTS IN A ESSAGE 1 n..6 ESSAGE REFERENE NUBER an..14 (Should match 0062 in the UNH) Segment Example: UNT+16+1' UNZ Segment: essage trailer Pos Segment / Repeat Repr INTERHANGE ONTROL OUNT 1 n..10 INTERHANGE ONTROL REFERENE an..14 (Should match 0020 in the UNB) Segment Example: UNZ+1+ NBFILE460313'

10 Status : Release BKP IT Department Page 10 / 10 APPENDIX APERAK Samples APERAK Accepted: UNA:+.? ' UNB+UNOE:2+BKP+A G : ' UNH+RB A0+APERAK:D:95B:UN:SDG20' BG AP' DT+9: :203' RFF+AW:1004_OREOR_BG_Segment' NAD+S+BKP' NAD+R+A G' UNT+7+RB A0' UNZ ' APERAK Rejected: UNA:+.? ' UNB+UNOE:2+BKP+A G : ' UNH+RB A0+APERAK:D:95B:UN:SDG20' BG RE' DT+9: :203' RFF+AW:1004_OREOR_BG_Segment' NAD+S+BKP' NAD+R+A G' ER+NE NAJJ' FTX+GEN+++NE NAJJDEN AKKREDITOVANNYJJ EHKSPEDITOR DLJA INN?' ?'' UNT+9+RB A0' UNZ '