Skip to main content

How to navigate the Header Details

The Header Details section is meant to assist you in editing the BAPLIE header information. A validation check is automatically performed upon loading this option under the Validation tab in the Function Menu, and any errors in the header details will be highlighted for your review.  

Header-Details-section.png

Navigating the Tab

Click on the Validation tab in the Function Menu on the left side of the screen and then select Header Details to display the BAPLIE header information in an easy to read format. BAPLIE Viewer Online automatically validates the header information in your uploaded file in accordance with the SMDG specification for BAPLIE. If the validation check fails for any reason, the errors will be highlighted in red and you will see a message at the top of the screen. 

Header-Details-Failed-Validation.png

Click into the header details throughout the page to view the errors and correct them. The arrows on the right side of the screen will expand or collapse each section containing more detailed information. 

Hover over the icon next to the field name for an explanation of the field requirements. 

Header-Details-Validation-Hover-Information.png

Editing Header Details

All fields on the Header Details screen can be edited. Use the text boxes and dropdown in each section to make changes to any fields necessary. Then click Save Changes in the Function Menu to save any edits made to the header information. The page will reload, and any errors that have been fixed will no longer appear in red. 

Header-Details-Edit-and-Save.png

Field Value Explanations

These fields are defined by the SMDG specification document (these are specifically for the current BAPLIE 2.2 specification)

  1. Interchange Header

Example: UNB + UNOA : 2 + RON + HAM + 200915 : 0858 + 0 + + + + +

    1. Syntax Identifier: this value is always UNOA
    2. Syntax Version: this value is always 2
    3. Sender Identification: name code of the sender of the message
    4. Recipient Identification: name code of the receiver of the message
    5. Date of Preparation: preparation date of the message
    6. Time of Preparation:  preparation time of the message
    7. Interchange Control Reference: a reference by the sender uniquely identifying the message. This must also be sent in the Interchange Trailer segment UNZ
    8. Recipients Reference Password:  not used
    9. Application Reference:  not used
    10. Processing Priority Code:  not used
    11. Acknowledgement Request:  not used
    12. Communications Agreement ID: code identifying the shipping line of the vessel (BIC or SCAC code), this code enables proper routing of the message by the recipient even if the sender is not the shipping line (ex: container terminal in previous port)

 

2.  Message Header

Example: UNH + 1 + BAPLIE : D : 95B : UN : SMDG22

  1. Message Reference: reference allocated by the sender, uniquely identifying the message, must also be transmitted in the Message Trailer segment UNT
  2. Message Type ID: the name of the UNSM or EDIFACT message, in this case BAPLIE
  3. Message Type Version #: the version number of the message, current value is “D”
  4. Message Type Release #: the release number of the message, current value is “95B”
  5. Controlling Agency: the code of the controlling agency, for this message use “UN”
  6. Association Assigned Code: the applicable SMDG user manual version number, use “SMDG22”. This enables the recipient to translate the message correctly even if older versions are in use

 

  1. Beginning of Message:

Example: BGM +     + 0 + 9

  1. Document Message Name: not used
  2. Document/Message #: reference allocated by the sender individually, taken from the application
  3. Message Function: code indicating the function of the message. Use 2 for add to previous message, 3 to delete from previous message, 4 to change previous message, 5 to replace previous message, 9 for original message and 22 for final message.

 

  1. Date / Time / Period

Example: DTM + 137 : 202009150858 : 201

  1. Date/Time/Period Qualifier Code: use 137 for document message date time
  2. Date/Time compiled: date or date/time of compiling message
  3. Format Qualifier Code: use 101 for YYMMDD, 210 for YYMMDDHHMM, 301 for YMMDDHHMMZZZ where ZZZ is time zone, ex: GMT

 

  1. Details of Transport

Example: TDT + 20 + 002W +     +     + BVO : 172 : 20 +     +     + H4318 : 103 : 11 : BVO DEMO SHIP :

  1. Transport Stage Qualifier: use code 20 for main carriage
  2. Conveyance Reference #: use discharge voyage number as assigned by the operating carrier or agent, the trade route can be included in the voyage number
  3. Mode Of Transport: not used
  4. Transport Means: not used
  5. Carrier ID: carrier name, coded – agreed or standard carrier alpha code (SCAC)
  6. Code List Qualifier: use code 172 for carrier code
  7. Code List Responsible Agency: use 20 for BIC(Bureaus International des Containeurs) 166 for US National Motor Freight Classification Association (SCAC) or ZZZ for mutually defined
  8. Transit Direction Coded: not used
  9. Excess Transportation Information: not used
  10. ID of Means of Transport ID: use vessel code Lloyds’ (IMO number), call sign or mutually agreed vessel code
  11. Code List Qualifier: use 103 for call sign directory, 146 for means of transport identification Lloyds code or IMO number, or ZZZ for mutually defined or IMO number
  12. Code List Responsible Agency: use 11 for Lloyds register of shipping when Lloyds code is used for vessel/barge identification or ZZZ for mutually defined
  13. ID of Means of Transport: vessel name, if required
  14. Nationality of Means of Transport: coded according to the UN Country Code ISO 3166

 

  1. Location Identification

Example: LOC + 5+DEHAM:139:6

  1. Place/Location Qualifier: use 5 for place of departure or 61 for next port of call
  2. Place/Location ID: location code of the actual place of departure, normally the sender of the message. If possible, un loc codes of 5 characters
  3. Code list qualifier: use 139 for port
  4. Code List Responsible Agency: use 112 for US, US Census Bureau, Schedule D for US Locations, Schedule K for foreign port locations or 6 for UN/ECE – United Nations – Economic Commission for Europe (UN LOC codes)
  5. Related Place/Location 1 ID: the ISO country code
  6. Code list qualifier: use 162 for country
  7. Code List Responsible Agency: use 5 for ISO
  8. Related Place/Location 2 ID: the state or province code, postal abbreviations
  9. Code list qualifier: use 163 for country sub entity, state or province

 

  1.  Date/Time/Period:

Example: DTM + 178 : 2009150858 : 201

  1. Date/Time/Period Qualifier Code: use “178” for actual date/time of arrival at senders port or “132” for estimated date or date/time of arrival at the next port of call or “133” for estimated date or date/time of departure at senders port or “136” for actual date/time of departure at senders port
  2. Date/Time: date or date/time in local time when means of transport has arrived or departed or is expected to depart at the senders port or is expected to arrive at the next port of call
  3. Format Qualifier Code: use “101” for YYMMDD or “201” for YYMMDDHHMM or “301” for YYMMDDHHMMZZZ where ZZZ equals time zone, example GMT

 

  1. Message Trailer

Example: UNT + 61558 + 1

  1. Number of Segments: number of segments in the message, including UNH and UNT segments but excluding UNA, UNB and UNZ segments
  2. Message Reference #: this reference must be identical to the reference in the UNH segment

 

  1. Interchange Trailer

Example: UNZ + 1 + 0

  1. Interchange Control Count: the number of messages in the interchange
  2. Interchange Control Reference: this reference must be identical to the reference in the UNB segment

 

 

Back to top