Monday, 27 August 2012

Restow in BAPLIE file

Some days ago I received the following complaint from an EDI customer:
"However everytime we receive a departure BAPLIE from your Terminal, where we have performed restows, we always get the restowed units showing as loaded from your port which clashes with the restowed unit."
In the beginning, I thought to have messed up some mapping rules but after having a look at the config file I realised that, at my end, everything was set-up properly. 

Here is the EQD segment group concerning a unit restowed by my Terminal:

(...)
LOC+147+0250208::5'
MEA+WT++KGM:6960'
LOC+9+ITSAL' 
>> Place/port of loading
LOC+11+PTLEI'
>> Place/port of discharge
LOC+83+PTLEI'
>> Place of delivery (by on carriage)
LOC+76+ILHFA'
>> Original port of loading
RFF+BM:1'
EQD+CN+ABCD1234567+22G1+++5'
(...)

I guess that customer's EDI translator has some issues in handling OPOL (Original Port of Loading) in conjunction with POL (Port of Loading): of course that's not up to me and, at least once, I was happy to close the support request without changing anything ! 



Friday, 8 June 2012

Adding CR/LF to an EDIFACT message

Everybody who handles EDIFACT messages, at least once in his life, needs to have a closer look at the message/segment contents in order to figure out the reason of a mapping failure: well, it's a dirty job but someone got to do it...

Then things may get harder when message has no CR/LF breaks and your EDIFACT translator has not a built in tool  to make message readable: find out the error becomes a real nightmare !

Well, a reader of  this blog (off course smart people read smart blog :D) has created a web application with the following features: 
  1. Adding a CR/LF after every segment ends;
  2. Properly numerate every line/segment of the message. 
You can have a look at this new brand project here and maybe, in the future, the developer will also add some extra features, who knows... :)

I have also added the site in the Web Utilities section.

Thank you Nick for sharing your good job !

Tuesday, 5 June 2012

Standard Exchange Format (SEF)

A reader asked me further information about SEF files.

The Standard Exchange Format (SEF) is an open-standard, computer readable, text format that contains the schematic information of an  EDI document.  

Basically you can use
SEF files for:

  • Exchanging information about implementation guidelines with your trading partners;
  • Importing directly translation or mapping in your EDI software to ease implementation; 
  • Posting information via networks to mailboxes or electronic bulletin boards for mass dissemination of implementation guidelines. 

SEF is an open standard, which allows you to create and distribute your own SEF files without any permission or having to pay any royalty fees.

SEF files are editable either with a text editor or with a free tool, developed by EDIdEv, available here.

Here I have upload a MIG which explains the layout of  a SEF file.

Here you can find a sample of a SEF file.

Thursday, 31 May 2012

UNOA character set

When processing an incoming EDIFACT message each software determines the character set to use  from the UNB1 data element. No setting in the trading partner agreement is necessary.

In my EDI environment the most used character set is UNOA.

Here is basic rules for UNOA character set:

  • Allowed Characters:

Letters, upper case    A to Z 
Numerals               0 to 9 
Space character
Full stop              . 
Comma                  , 
Hyphen / minus sign    - 
Opening parentheses    ( 
Closing parentheses    ) 
Oblique stroke (slash) / 
Equals sign            = 

  • Reserved Characters:

Apostrophe             ' segment terminator 
Plus sign              + segment tag and data element separator 
Colon                  : component data element separator 
Question mark          ? release character *


* ?  immediately preceding one of the characters ‘ + : ? restores their normal meaning. E.g. 
10?+10=20 means 10+10=20. Question mark is represented by ??. 


Wednesday, 2 May 2012

Call sign and Lloyd's number

One of the most frequent error that I have to handle in my EDI environment, while processing incoming EDI transactions, relates to wrong Call Sign / Lloyd's Number stated into the TDT segment as c222.8213.

Here is some useful sites where you can check about vessels Call Sign, Lloyd's Number and other interesting stuff about ships/boats: 

Tuesday, 1 May 2012

MIG codes legend

When reading a MIG (Message Implementation Guide) you might be disoriented from some strange codes close to the segment description. Let's have a sample:

8077 EQUIPMENT SUPPLIER CODE  C   an..3 
1 Shipper supplied
2 Carrier supplied
5 Third party supplied

What's the meaning of 'C' and 'an..3' ?

I guess that this small legend will fix all your doubts ! :)

Status:
   
M= Mandatory
C= Conditional

Size:       
a= alpha character(s)
n= numeric character(s)
an= alphanumeric character(s)
..= size is variable, up to the maximum number indicated



Wednesday, 1 February 2012

Gross weight in EDI transmissions

Recently an EDI customer reported me an issue related to the weights stated into BAPLIE / COARRI of my production environment. 

I was a little bit surprised in discover a coarse translation error in MEA segment concerning c502.6313 (ie. measurement dimension): I used the qualifier G (ie. weight of goods including packing but excluding the carrier's equipment) in order to report the weight of the goods plus carrier's equipment. 

Checking on the ITIGG guidelines I found out the new qualifier EGW which is used in order to declare the gross weight including carrier's equipment.

Here below how the change affected my EDI transmissions: 
 
Carrier's COPRAR Loading:

(...)
EQD+CN+ABCD1234567+45R1:102:5++2+5'
RFF+BN:ORDER-1' 
TMD+3' 
LOC+9+ITSAL:139:6+:BER:ZZZ:SALERNO CONTAINER TERMINAL'
LOC+11+CAMTR:139:6' 
LOC+7+CATOR:139:6' 
MEA+AAE+T+KGM:4550' 
MEA+AAE+G+KGM:22730' 
TMP+2+012:CEL' 
(...)


Terminal's COARRI Loading: 
(...) 
EQD+CN+ABCD1234567+45R1:102:5++2+5'
RFF+BN:ORDER-1'
TMD+3'
DTM+203:201201221233:203'
LOC+11+CAMTR:139:6'
LOC+7+CATOR::6'
LOC+147+340708::6'
MEA+AAE+T+KGM:4550'
MEA+AAE+EGW+KGM:27280'
TMP+2+12.0:CEL'
(...)
 
Terminal's BAPLIE departure: 
(...)
LOC+147+0340708::5' 
MEA+WT++KGM:27280'
TMP+2+012:CEL'
LOC+6+ITSAL'
LOC+12+CAMTR'
LOC+83+CATOR'
RFF+BM:1'
EQD+CN+ABCD 1234567+45R1+++5'
NAD+CA+XXX:172:20'
(...)