UBL Guidelines for Mapping IFTM UN/EDIFACT Messages Version 1.0

A Transport Contract can be used for describing insurance related to consignments. For other insurances use Document Reference.

Currently the Charge Codes and Charge Types do not enough details to automatically create a freight invoice

Date elements are followed by an optional sister element for Times. For simplicity these are not included but can be assumed. Many Dates also allow an optional Period description as well.

All Date and Time formats should follow the W3C Schema data type for date and time.

Following the ebXML Core Component Technical Specification all Code type have attributes to describe the listID and the listAgencyID (if required).

Following the ebXML Core Component Technical Specification all Identifier types have attributes to describe the schemeID, schemeAgencyID (if required).

Following the ebXML Core Component Technical Specification all Measurement types have an attribute for unitCode (if required).

Following the ebXML Core Component Technical Specification all Amount types have an attribute for currencyID.

Following the principles of the ebXML Core Component Technical Specification qualifier terms are generally used in the names of elements. As such list of qualifiers for elements are not required.

The exceptions are where there is a controlled and fixed set of possible qualifiers.

For historical reasons there are some cases where a hybrid approach has been taken. Elements have qualified names and also a sister element that is unqualified and may be qualified by a code list.

These are noted when they occur in the mapping.

UBL has been designed as a transactional data description language and as such does not require formatting facets (such as fixed field lengths).

Values within text element may contain XML Control statements to support formatted on the text by suitably enabled applications.

Many UBL textual elements allow multiple occurrences. This is reserved for use where the same information may be required in different languages. These are not designed to convey different pieces of information ­ such as different paragraphs or lines.

In XML documents the number of children for a parent can be derived because of the requirement for being well formed XML. Ending delimiters mean children cannot be dropped so integrity controls such as control totals are redundant.

UBL documents are independent of the message exchange protocol of documents. Several common protocols are used to convert the document header and footer information (eg. UNH-UNT). These protocols define the messaging elements they require (i.e. the equivalent of the UNH-UNT structures).

In UBL 2.1 the Forwarding Instruction lacks the ability to define what the distribution of the original and copies of Bills of Lading should be. This is to be included in the next release.

BGM+340:::SI_LINK+6907611:1.28+9 
DTM+137:200802211544:203 
TSR+30+2 
FTX+AAI+++FREE TEXT 
CNT+7:21704:KGM 
CNT+11:20 
CNT+16:1 
LOC+57+BEZEE::6:ZEEBRUGGE 
LOC+73+SEGOT::6 
DTM+95:20080227:102 
RFF+FF:Forwarder's Reference 
RFF+BN:Booking Number 
RFF+SI:SID 
CPI+4++P 
TDT+20+046E+1++NYKS:172+++:::MOL INTEGRITY 
LOC+7+PHMNS::6 
LOC+9+BEZEE::6 
LOC+11+PHMNS::6 
LOC+88+BEZEE::6 
NAD+CA+NYKS:160:87++N Y K (NIPPON YUSEN KAISHA) 
DOC+706+:26++3 
DOC+707+:26++5 
NAD+FW+808053:160:ZZZ++Stora Enso Logistics AB+Box 2556:Sydatlanten 17:
                                                 SE-40317 Goeteborg:Sweden 
NAD+CN+++FIL-ANCHOR PAPER CO INC+434436 RIVERSIDE STREET:NAVOTAS,METRO
                                                 MANILA:MANILA:PHILIPPINES 
NAD+CZ+++STORA ENSO FORS AB+SE-774 89 FORS:SWEDEN 
NAD+NI+++FIL-ANCHOR PAPER CO INC+434436 RIVERSIDE STREET:NAVOTAS,METRO
                                                 MANILA:MANILA:PHILIPPINES 
GID+1+20:RL::6:REELS 
FTX+AAA+++FREE TEXT 
MEA+AAE+WT+KGM:21704 
PCI++FIL-ANCHOR:MANILA:MADE IN SWEDEN:F3PH-886186 001:F3PH-886187
                                                       001:F3PH-886188 001 
EQD+CN+NYKU5973119+45G0 
SEL+332531

 <cbc:ProfileID>9</cbc:ProfileID>
 <cbc:ID>6907611</cbc:ID>
 <cbc:IssueDate>2008-02-21</cbc:IssueDate>
 <cbc:IssueTime>15:44:00.0Z</cbc:IssueTime>
 <cbc:Name>SI_LINK</cbc:Name>
 <cac:Shipment>
  <cbc:ID>6907611</cbc:ID>
  <cac:Consignment>
   <cbc:ID>6907611</cbc:ID>
   <cbc:GrossWeightMeasure unitCode="KGM">21704</cbc:GrossWeightMeasure>
   <cbc:Information>FREE TEXT</cbc:Information>
   <cbc:TotalTransportHandlingUnitQuantity
                                >1</cbc:TotalTransportHandlingUnitQuantity>
   <cbc:TotalPackagesQuantity>20</cbc:TotalPackagesQuantity>
   <cac:ConsigneeParty>
    <cac:PartyName>
     <cbc:Name>FIL-ANCHOR PAPER CO INC</cbc:Name>
    </cac:PartyName>
    <cac:PhysicalLocation>
     <cac:Address>
      <cbc:StreetName>RIVERSIDE STREET</cbc:StreetName>
      <cbc:BuildingNumber>434436</cbc:BuildingNumber>
      <cbc:CityName>NAVOTAS</cbc:CityName>
      <cbc:CountrySubentity>METRO MANILA</cbc:CountrySubentity>
      <cac:Country>
       <cbc:Name>Philippines</cbc:Name>
      </cac:Country>
     </cac:Address>
    </cac:PhysicalLocation>
   </cac:ConsigneeParty>
   <cac:ConsignorParty>
    <cac:PartyName>
     <cbc:Name>STORA ENSO FORS AB</cbc:Name>
    </cac:PartyName>
    <cac:PhysicalLocation>
     <cac:Address>
      <cbc:CityName>FORS</cbc:CityName>
      <cbc:PostalZone>SE-774 89</cbc:PostalZone>
      <cac:Country>
       <cbc:Name>Sweden</cbc:Name>
      </cac:Country>
     </cac:Address>
    </cac:PhysicalLocation>
   </cac:ConsignorParty>
   <cac:FreightForwarderParty>
    <cac:PartyIdentification>
     <cbc:ID schemeID="160" schemeAgencyID="ZZ">808053</cbc:ID>
    </cac:PartyIdentification>
    <cac:PartyName>
     <cbc:Name>Stora Enso Logistics AB</cbc:Name>
    </cac:PartyName>
    <cac:PhysicalLocation>
     <cac:Address>
      <cbc:Postbox>Box 2556</cbc:Postbox>
      <cbc:CityName>Goeteborg</cbc:CityName>
      <cbc:PostalZone>SE-40317</cbc:PostalZone>
      <cbc:CountrySubentity>Sydatlanten</cbc:CountrySubentity>
      <cbc:CountrySubentityCode>17</cbc:CountrySubentityCode>
      <cac:Country>
       <cbc:Name>Sweden</cbc:Name>
      </cac:Country>
     </cac:Address>
    </cac:PhysicalLocation>
   </cac:FreightForwarderParty>
   <cac:NotifyParty>
    <cac:PartyName>
     <cbc:Name>FIL-ANCHOR PAPER CO INC</cbc:Name>
    </cac:PartyName>
    <cac:PhysicalLocation>
     <cac:Address>
      <cbc:StreetName>RIVERSIDE STREET</cbc:StreetName>
      <cbc:BuildingNumber>434436</cbc:BuildingNumber>
      <cbc:CityName>NAVOTAS</cbc:CityName>
      <cbc:CountrySubentity>METRO MANILA</cbc:CountrySubentity>
      <cac:Country>
       <cbc:Name>Philippines</cbc:Name>
      </cac:Country>
     </cac:Address>
    </cac:PhysicalLocation>
   </cac:NotifyParty>
   <cac:TransportEvent>
    <cbc:IdentificationID>Payment</cbc:IdentificationID>
    <cac:Location>
     <cbc:ID schemeAgencyID="6">BEZEE</cbc:ID>
     <cbc:Description>ZEEBRUGGE</cbc:Description>
    </cac:Location>
   </cac:TransportEvent>
   <cac:TransportEvent>
    <cbc:IdentificationID>Bill of Lading Release</cbc:IdentificationID>
    <cbc:OccurrenceDate>2008-02-27</cbc:OccurrenceDate>
	<cac:Location>
     <cbc:ID schemeAgencyID="6">SEGOT</cbc:ID>
    </cac:Location>
   </cac:TransportEvent>
   <cac:OriginalDespatchTransportationService>
    <cbc:TransportServiceCode/>
    <cbc:TransportationServiceDescription/>
   </cac:OriginalDespatchTransportationService>
   <cac:FreightAllowanceCharge>
    <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
    <cbc:AllowanceChargeReasonCode>4</cbc:AllowanceChargeReasonCode>
    <cbc:PrepaidIndicator>true</cbc:PrepaidIndicator>
    <cbc:Amount currencyID="USD">0.0</cbc:Amount>
   </cac:FreightAllowanceCharge>
  </cac:Consignment>
  <cac:GoodsItem>
   <cbc:ID>1</cbc:ID>
   <cbc:Description>FREE TEXT</cbc:Description>
   <cbc:GrossWeightMeasure unitCode="KGM">21704</cbc:GrossWeightMeasure>
   <cbc:Quantity unitCode="RL">20</cbc:Quantity>
   <cac:ContainingPackage>
    <cbc:PackagingTypeCode listAgencyID="6">RL</cbc:PackagingTypeCode>
    <cbc:PackingMaterial>REELS</cbc:PackingMaterial>
   </cac:ContainingPackage>
  </cac:GoodsItem>
  <cac:ShipmentStage>
   <cbc:ID>20</cbc:ID>
   <cbc:TransportModeCode>1</cbc:TransportModeCode>
   <cbc:TransportMeansTypeCode>3</cbc:TransportMeansTypeCode>
   <cac:CarrierParty>
    <cac:PartyIdentification>
     <cbc:ID schemeID="172">NYKS</cbc:ID>
    </cac:PartyIdentification>
   </cac:CarrierParty>
   <cac:CarrierParty>
    <cac:PartyIdentification>
     <cbc:ID schemeID="160" schemeAgencyID="87">NYKS</cbc:ID>
    </cac:PartyIdentification>
    <cac:PartyName>
     <cbc:Name>N Y K (NIPPON YUSEN KAISHA)</cbc:Name>
    </cac:PartyName>
   </cac:CarrierParty>
   <cac:TransportMeans>
    <cbc:JourneyID>046E</cbc:JourneyID>
    <cac:MaritimeTransport>
     <cbc:VesselName>MOL INTEGRITY</cbc:VesselName>
    </cac:MaritimeTransport>
   </cac:TransportMeans>
   <cac:LoadingPortLocation>
    <cbc:ID schemeAgencyID="6">BEZEE</cbc:ID>
   </cac:LoadingPortLocation>
   <cac:DischargeTransportEvent>
    <cac:Location>
     <cbc:ID schemeAgencyID="6">PHMNS</cbc:ID>
    </cac:Location>
   </cac:DischargeTransportEvent>
   <cac:DeliveryTransportEvent>
    <cac:Location>
     <cbc:ID schemeAgencyID="6">PHMNS</cbc:ID>
    </cac:Location>
   </cac:DeliveryTransportEvent>
   <cac:ReceiptTransportEvent>
    <cac:Location>
     <cbc:ID schemeAgencyID="6">BEZEE</cbc:ID>
    </cac:Location>
   </cac:ReceiptTransportEvent>
  </cac:ShipmentStage>
  <cac:TransportHandlingUnit>
   <cbc:ShippingMarks>FIL-ANCHOR : MANILA : MADE IN SWEDEN : F3PH-886186
                001 : F3PH-886187 001 : F3PH-886188 001</cbc:ShippingMarks>
   <cac:TransportEquipment>
    <cbc:ID>NYKU5973119</cbc:ID>
    <cbc:TransportEquipmentTypeCode>CN</cbc:TransportEquipmentTypeCode>
    <cbc:SizeTypeCode>45G0</cbc:SizeTypeCode>
    <cac:TransportEquipmentSeal>
     <cbc:ID>332531</cbc:ID>
    </cac:TransportEquipmentSeal>
   </cac:TransportEquipment>
  </cac:TransportHandlingUnit>
 </cac:Shipment>
 <cac:DocumentReference>
  <cbc:ID>6907611</cbc:ID>
  <cbc:DocumentTypeCode>340</cbc:DocumentTypeCode>
  <cbc:DocumentStatusCode>1.28</cbc:DocumentStatusCode>
 </cac:DocumentReference>
 <cac:DocumentReference>
  <cbc:ID>Forwarder's Reference</cbc:ID>
  <cbc:DocumentTypeCode>FF</cbc:DocumentTypeCode>
 </cac:DocumentReference>
<cac:DocumentReference>
  <cbc:ID>Booking Number</cbc:ID>
  <cbc:DocumentTypeCode>BN</cbc:DocumentTypeCode>
 </cac:DocumentReference>
<cac:DocumentReference>
  <cbc:ID>SID</cbc:ID>
  <cbc:DocumentTypeCode>SI</cbc:DocumentTypeCode>
 </cac:DocumentReference>

BGM+610+6332177135+9'
DTM+137:20120915:102'
DTM+234:201209151000:203'
TSR++3+3'
TSR++52'23
FTX+SIC+++Pickup instructions'
FTX+BLR+++Delivery instructions on document'
FTX+CLR+++Delivery instructions'
CNT+11:1:PCE'
CNT+7:100:KGM'
RFF+AAS:6332177135'
RFF+CU:Senders reference'
CPI+++P'
TDT+20++3'
LOC+5+20211:16::Malm\'f6'
LOC+8+37047:16::Karlskrona'
NAD+CZ+12345678::87++Test Sender Company AB+Bjur\'f6gatan 15+Malm\
                                                              'f6++20211+SE'
NAD+PW+++Test Pickup Company AB+Asp\'f6gatan 2+Malm\'f6++20212+SE'
NAD+CN+++Test Consignee AB+Testgatan 1+Karlskrona++37147+SE'
NAD+DP+++Test Delivery AB+Testgatan 2+Ronneby++37230+SE'
NAD+NI+++Test Notify Company AB+Testgatan 2+Ronneby++37230+SE'
CTA+IC+:Anders Andersson'
COM+070123456+TE'
GID+1+1:Z01'
RNG+1+CEL:10:25' 
FTX+AAA+++Elektronik'
MEA+WT+G+KGM:100'
PCI+18+373323991863119097'
PCI+24+Artikel no 12345'
DGS+ADR+1.1+1010'
FTX+AAD+++TEST'
EQD+EFP'
EQN+1'

<cbc:ID>6332177135</cbc:ID>
<cbc:IssueDate>2012-09-15</cbc:IssueDate>
<cac:Shipment>
	<cbc:ID>6332177135</cbc:ID>
	<cbc:ShippingPriorityLevelCode>3</cbc:ShippingPriorityLevelCode>
	<cac:Consignment>
		<cbc:ID>6332177135</cbc:ID>
		<cbc:GrossWeightMeasure unitCode="KGM">100</cbc:GrossWeightMeasure>
		<cbc:Remarks>Delivery instructions on document</cbc:Remarks>
		<cbc:CarrierServiceInstructions
		                    >Pickup instructions</cbc:CarrierServiceInstructions>
		<cbc:HandlingInstructions>Delivery instructions</cbc:HandlingInstructions>
		<cbc:TotalGoodsItemQuantity>1</cbc:TotalGoodsItemQuantity>
		<cac:ConsigneeParty>
			<cac:PartyName>
				<cbc:Name>Test Consignee AB</cbc:Name>
			</cac:PartyName>
			<cac:PhysicalLocation>
				<cac:Address>
					<cbc:StreetName>Testgatan</cbc:StreetName>
					<cbc:BuildingNumber>1</cbc:BuildingNumber>
					<cbc:CityName>Karlskrona</cbc:CityName>
					<cbc:PostalZone>37147</cbc:PostalZone>
					<cac:Country>
						<cbc:IdentificationCode>SE</cbc:IdentificationCode>
					</cac:Country>
				</cac:Address>
			</cac:PhysicalLocation>
		</cac:ConsigneeParty>
		<cac:ConsignorParty>
			<cac:PartyIdentification>
				<cbc:ID schemeAgencyID="87">12345678</cbc:ID>
			</cac:PartyIdentification>
			<cac:PartyName>
				<cbc:Name>Test Sender Company AB</cbc:Name>
			</cac:PartyName>
			<cac:PhysicalLocation>
				<cac:Address>
					<cbc:StreetName>Bjurögatan</cbc:StreetName>
					<cbc:BuildingNumber>15</cbc:BuildingNumber>
					<cbc:CityName>Malmö</cbc:CityName>
					<cbc:PostalZone>20211</cbc:PostalZone>
					<cac:Country>
						<cbc:IdentificationCode>SE</cbc:IdentificationCode>
					</cac:Country>
				</cac:Address>
			</cac:PhysicalLocation>
		</cac:ConsignorParty>
		<cac:NotifyParty>
			<cac:PartyName>
				<cbc:Name>Test Notify Company AB</cbc:Name>
			</cac:PartyName>
			<cac:PhysicalLocation>
				<cac:Address>
					<cbc:StreetName>Testgatan</cbc:StreetName>
					<cbc:BuildingNumber>3</cbc:BuildingNumber>
					<cbc:CityName>Ronneby</cbc:CityName>
					<cbc:PostalZone>37230</cbc:PostalZone>
					<cac:Country>
						<cbc:IdentificationCode>SE</cbc:IdentificationCode>
					</cac:Country>
				</cac:Address>
			</cac:PhysicalLocation>
		</cac:NotifyParty>
		<cac:OriginalDespatchParty>
			<cac:PartyName>
				<cbc:Name>Test Pickup Company AB</cbc:Name>
			</cac:PartyName>
			<cac:PhysicalLocation>
				<cac:Address>
					<cbc:StreetName>Aspögatan</cbc:StreetName>
					<cbc:BuildingNumber>2</cbc:BuildingNumber>
					<cbc:CityName>Malmö</cbc:CityName>
					<cbc:PostalZone>20222</cbc:PostalZone>
					<cac:Country>
						<cbc:IdentificationCode>SE</cbc:IdentificationCode>
					</cac:Country>
				</cac:Address>
			</cac:PhysicalLocation>
		</cac:OriginalDespatchParty>
		<cac:FinalDeliveryParty>
			<cac:PartyName>
				<cbc:Name>Test Delivery AB</cbc:Name>
			</cac:PartyName>
			<cac:PhysicalLocation>
				<cac:Address>
					<cbc:StreetName>Testgatan</cbc:StreetName>
					<cbc:BuildingNumber>2</cbc:BuildingNumber>
					<cbc:CityName>Ronneby</cbc:CityName>
					<cbc:PostalZone>37230</cbc:PostalZone>
					<cac:Country>
						<cbc:IdentificationCode>SE</cbc:IdentificationCode>
					</cac:Country>
				</cac:Address>
			</cac:PhysicalLocation>
		</cac:FinalDeliveryParty>
		<cac:OriginalDespatchTransportationService>
			<cbc:TransportServiceCode listAgencyID="23">3</cbc:TransportServiceCode>
		</cac:OriginalDespatchTransportationService>
		<cac:FreightAllowanceCharge>
			<cbc:ChargeIndicator>true</cbc:ChargeIndicator>
			<cbc:PrepaidIndicator>true</cbc:PrepaidIndicator>
			<cbc:Amount currencyID="SEK">0.00</cbc:Amount>
		</cac:FreightAllowanceCharge>
	</cac:Consignment>
	<cac:GoodsItem>
		<cbc:ID>1</cbc:ID>
		<cbc:Description>Elektronik</cbc:Description>
		<cbc:GrossWeightMeasure unitCode="KGM">100</cbc:GrossWeightMeasure>
		<cbc:Quantity>1</cbc:Quantity>
		<cac:Item>
			<cac:HazardousItem>
				<cbc:UNDGCode>1010</cbc:UNDGCode>
				<cbc:TechnicalName>TEST</cbc:TechnicalName>
				<cbc:HazardClassID>1.1</cbc:HazardClassID>
				<cac:HazardousGoodsTransit>
					<cbc:HazardousRegulationCode>ADR</cbc:HazardousRegulationCode>
				</cac:HazardousGoodsTransit>
			</cac:HazardousItem>
		</cac:Item>
		<cac:ContainingPackage>
			<cbc:PackagingTypeCode>Z01</cbc:PackagingTypeCode>
		</cac:ContainingPackage>
		<cac:MinimumTemperature>
			<cbc:AttributeID>1</cbc:AttributeID>
			<cbc:Measure unitCode="CEL">10</cbc:Measure>
		</cac:MinimumTemperature>
		<cac:MaximumTemperature>
			<cbc:AttributeID>1</cbc:AttributeID>
			<cbc:Measure unitCode="CEL">25</cbc:Measure>
		</cac:MaximumTemperature>
	</cac:GoodsItem>
	<cac:ShipmentStage>
		<cbc:ID>20</cbc:ID>
		<cbc:TransportMeansTypeCode>3</cbc:TransportMeansTypeCode>
		<cac:AvailabilityTransportEvent>
			<cbc:OccurrenceDate>2008-02-27</cbc:OccurrenceDate>
		</cac:AvailabilityTransportEvent>
		<cac:ActualDepartureTransportEvent>
			<cac:Location>
				<cbc:ID>20211</cbc:ID>
				<cbc:LocationTypeCode>16</cbc:LocationTypeCode>
				<cbc:Name>Malmö</cbc:Name>
			</cac:Location>
		</cac:ActualDepartureTransportEvent>
		<cac:ActualArrivalTransportEvent>
			<cac:Location>
				<cbc:ID>37047</cbc:ID>
				<cbc:LocationTypeCode>16</cbc:LocationTypeCode>
				<cbc:Name>Karlskrona</cbc:Name>
			</cac:Location>
		</cac:ActualArrivalTransportEvent>
	</cac:ShipmentStage>
	<cac:TransportHandlingUnit>
		<cbc:ID>18</cbc:ID>
		<cbc:ShippingMarks>373323991863119097</cbc:ShippingMarks>
		<cac:TransportEquipment>
			<cbc:TransportEquipmentTypeCode>EFP</cbc:TransportEquipmentTypeCode>
		</cac:TransportEquipment>
	</cac:TransportHandlingUnit>
	<cac:TransportHandlingUnit>
		<cbc:ID>24</cbc:ID>
		<cbc:ShippingMarks>Artikel no 12345</cbc:ShippingMarks>
	</cac:TransportHandlingUnit>
</cac:Shipment>
<cac:DocumentReference>
	<cbc:ID>6332177135</cbc:ID>
	<cbc:DocumentTypeCode>610</cbc:DocumentTypeCode>
	<cbc:DocumentStatusCode>9</cbc:DocumentStatusCode>
	<cbc:DocumentDescription/>
	<cac:IssuerParty>
		<cac:Person>
			<cbc:FirstName>Anders</cbc:FirstName>
			<cbc:FamilyName>Andersson</cbc:FamilyName>
			<cac:Contact>
				<cbc:Telephone>070123456</cbc:Telephone>
			</cac:Contact>
		</cac:Person>
	</cac:IssuerParty>
</cac:DocumentReference>
<cac:DocumentReference>
	<cbc:ID>6332177135</cbc:ID>
	<cbc:DocumentTypeCode>AAS</cbc:DocumentTypeCode>
</cac:DocumentReference>
<cac:DocumentReference>
	<cbc:ID>Senders reference</cbc:ID>
	<cbc:DocumentTypeCode>CU</cbc:DocumentTypeCode>
</cac:DocumentReference>