direct-transport/integration-set

General

One IFCSUM message holds 1 consignment. We do not conslidate consignments into 1 IFCSUM message.
GID (package) information is taken from the handling units on consignment level.
For each handling unit found on consignment level, this message includes the dangerousGoods information from the handling units on shipment level that are packed into that handling unit.
The child handling units within an OVERPACK are not included in the message. The message only contains the consignment level handling units combined with the dangerous goods information taken from the shipment level handling units.
Identical handling units on consignment level are not consolidated but are included individually in the message.
Package types must be configured. In case a package type is submitted for which no translation can be found, the integration will return an error and no message will be send to the carrier.

Documentation

Example

UNA:+.? '
UNB+UNOC:3+0707387103026:14+4023083000008:14+20250911:1333+1732096429'
UNH+6100000227_09+IFCSUM:D:96A:UN:EAN001'
BGM+610+6100000227_09+5'
DTM+2:201908241415:203'
DTM+137:202509111333:203'
DTM+179:202509111333:203'
DTM+200:202504291036:203'
FTX+AAI+++LTL'
FTX+DEL+++15h a 17h?:15h le vendredi'
FTX+TCA+++30#MDIRECT:SERVICELEVEL'
CNT+10:1'
RFF+AAM:6100000227_09'
RFF+SRN:6100000227_09'
RFF+AAQ:6100000227_09'
TDT+20++30+31'
TSR+27'
NAD+CZ+0000++Movianto Kist DC+Ringstrasse +Kist++97270+DE'
CTA+IC+:Harry Styles'
COM+031635241627:TE'
COM+unknown@known.com:EM'
NAD+CN+0000++HENRY SCHEIN FRANCE SA+ZAC LA LIODERE +JOUE LES TOURS++37304+FR'
NAD+SF+C034++Movianto Kist DC+Ringstrasse +Kist++97270+DE'
NAD+BY+0000++Solventum Ireland Limited HQ+Fenian Street +Dublin++D02 H0V5+IE'
NAD+SE+0000++Selling Party:Office 2+Sell street 12+AACHEN++47677+DE'
NAD+CA+0000++DACHSER SE+ZAMILSTR11 +MUENCHEN++81677+DE'
CNI+1+6100000227_09'
CNT+7:1.206:KGM'
CNT+9:1'
CNT+11:1'
CNT+15:1.63911:MTQ'
TOD+6++CIP'
GID+1+1:CT'
PIA+5+200511443148943016'
MEA+WT+GW+KGM:0.303'
MEA+VOL++MTQ:1.2'
DIM+2+CMT:100:110:120'
DGS+ADR+3.1+4501+25.3CEL+2:4321::1234+TFC'
FTX+AAD+++technical name'
FTX+AAC+++MATERIAL=000000007100227343OUTER_PACKAGE_INFORMATION=FIBERBOARD BOX I'
FTX+AAC+++Flammable liquid, n.o.s.'
GID+2+1:EU'
PIA+5+200511443148943017'
MEA+WT+GW+KGM:0.903'
MEA+VOL++MTQ:0.43911'
DIM+2+CMT:210:17:123'
UNT+57+6100000227_09'
UNZ+1+1732096429'

Mapping

UNA segment

Example: UNA:+.? '
This segment is used to inform the receiver of the interchange that a set of service string characters which are different to the default characters are being used.

value	description	mapping
`:`	Component data element separator	Fixed `:`
`+`	Data element separator	Fixed `+`
`.`	Decimal mark	Fixed `.`
`?`	Release character	Fixed `?`

UNB segment

Example: UNB+UNOC:3+0707387103026:14+4023083000008:14+20250911:1333+1732096429'
This segment is used to envelope the interchange, as well as to identify both, the party to whom the interchange is sent and the party who has sent the interchange.

value	description	mapping
`UNOC`	Syntax identifier	Fixed `UNOC`
`:3`	Syntax version number	Fixed `3`
`0707387103026`	Interchange sender identification (GLN)	Configuration.iftmind96aSenderGln
`:14`	Identification code qualifier (14=GS1)	Fixed `14`
`4023083000008`	Interchange recipient identification (GLN)	Configuration.iftmind96aReceiverGln Can be configured per ship to country
`:14`	Identification code qualifier (14=GS1)	Fixed `14`
`20250911`	Creation date of the document in YYYYMMDD	System date at document creation
`:1333`	Creation time of the document in HHNN	System time at document creation
`1732096429`	Interchange control reference, unique reference identifying the interchange. Must be equal to reference in UNZ segment	Automatically generated random number

UNH segment

Example: UNH+6100000227_09+IFCSUM:D:96A:UN:EAN001'
Message header, a service segment starting and uniquely identifying a message. The message type code for the Instruction message is IFTMIN.

value	description	mapping
`6100000227_09`	Message reference number. Senders unique message reference.	reference
`IFCSUM`	Message type	Fixed `IFCSUM`
`:D`	Message version number	Fixed `D`
`:96A`	Message release number	Fixed `96A`
`:UN`	Controlling agency, coded	Fixed `UN`
`:EAN001`	Version control number	Fixed `EAN001`

BGM segment

Example: BGM+610+6100000227_09+9'
Beginning of message, a segment to indicate the beginning of a message and to transmit identifying number and type of the message.

value	description	mapping
`610`	Document name code (610=Forwarding Instructions)	Fixed `610`
`6100000227_09`	Document identifier, transport Instruction number assigned by the document sender.	reference
`9`	Message function code (9=Original). In playground environment `5` is used.	Fixed `5` or `9`

DTM segment

Example: DTM+2:201908241415:203'
Date/time/period, document/message date/time. Date/time when a document/message is issued.

value	description	mapping
`2`	Date or time or period function code qualifier `2`=Delivery date/time `63`=Delivery date/time latest `64`=Delivery date/time earliest `137`=document message creation date/time `179`=Booking date/time `200`=Pickup/collection date/time `234`=Collection date/time earliest `235`=Collection date/time latest	Fixed, see description
`:201908241415`	Date or time or period value	`2`=timeWindows.delivery.requested.start `63`=timeWindows.delivery.requested.end `64`=timeWindows.delivery.requested.start `137`=date.now (system date/time) `179`=date.now (system date/time) `200`=timeWindows.pickup.planned.start `234`=timeWindows.pickup.planned.start `235`=timeWindows.pickup.planned.end
`:203`	Date or time or period format code `102`=CCYYMMDD `203`=CCYYMMDDHHNN	Fixed, see description

FTX segment

Example: FTX+DEL+++15h a 17h?:15h le vendredi'
This segment is used to provide free form or coded text information related to the entire message.

value	description	mapping
`DEL`	Text subject code qualifier `DEL`=Delivery instructions `AAI`=Goods description `LOI`=Loading Instructions `HAN`=Handling Instructions `TCA`=Tarrif applied	Fixed, see description
`15h a 17h?:15h le vendredi`	Delivery instructions values. All instructions available are mapped.	`DEL`=instructions.carrierInstructions.delivery `AAI`=description `LOI`=instructions.carrierInstructions.collection `HAN`=instructions.carrierInstructions.transport `TCA`=serviceLevelReference

CNT segment (consignment)

Example: CNT+10:1'
This segment is used to provide message control information such as the total number of consignments in the consolidation, the total gross weight of the consolidated consignments.

value	description	mapping
`10`	Control total type code qualifier `10`=Total number of orders	Fixed `10`
`1`	Number of consignments contained in message	Fixed `1`. We send 1 message per consignment.

RFF segment

Example: RFF+AAQ:6100000227_09'
Reference, consignor’s reference number, reference number assigned by a consignor to a particular consignment for his own purposes or for those of the consignee.

value	description	mapping
`AAQ`	Reference code qualifier `CU`=Consignor’s reference number `AAM`=waybill number `SRN`=shipment reference number `BN`=Reference number assigned by the carrier (pre-advise reference) `AAQ`=Unit load device (e.g. container) identification number `SN`=Seal number `CMR`=road consignment note number	Fixed, see description
`:6100000227_09`	Reference value	`CU`=references.consignorAssigned `AAM`=trackingReference `SRN`=reference `BN`=references.freightForwarderAssigned `AAQ`=references.container `SN`=references.seal `CMR`=references.cmr

TDT segment

Example: TDT+20++30+31'
To specify the transport details such as mode of transport, means of transport, its conveyance reference number and the identification of the means of transport.

value	description	mapping
`20`	Transport stage code qualifier	Fixed `20`=Main-carriage transport
`30`	Mode of transport	Fixed `30`=Road
`31`	Transport means	Fixed `31`=Truck

TSR segment

Example: TSR+27'
Transport service requirements. To specify the contract and carriage conditions and service and priority requirements for the transport.

value	description	mapping
`27`	Service requirement code	serviceLevelReference translated using custom packages from configuration. In case serviceLevelReference contains `#` only the part on the right is mapped

NAD+CZ segment

Example: NAD+CZ+0000++Movianto Kist DC:Second floor+Ringstrasse +Kist++97270+DE'
Name and address. Consignee, party to which goods are consigned.

value	description	mapping
`CZ`	Address code qualifier (CN=Consignor)	Fixed `CZ`
`0000`	Party identifier (GLN)	addresses.sender.references.consignorAssigned
`Movianto Kist DC`	Party name	addresses.sender.companyName
`:Second floor`	Additional address information	addresses.sender.addressLine2
`Ringstrasse`	Street and number	addresses.sender.addressLine1
`Kist`	City name	addresses.sender.city
`97270`	Postal identification code	addresses.sender.postCode
`DE`	Country name code	addresses.sender.countryCode

NAD+CN segment

Example: NAD+CN+0000++HENRY SCHEIN FRANCE SA:door 2+ZAC LA LIODERE +JOUE LES TOURS++37304+FR'
Name and address. Consignee, party to which goods are consigned.

value	description	mapping
`CN`	Address code qualifier (CN=Consignee)	Fixed `CN`
`0000`	Party identifier (GLN)	addresses.receiver.references.consignorAssigned
`HENRY SCHEIN FRANCE SA`	Party name	addresses.receiver.companyName
`:door 2`	Additional address information	addresses.receiver.addressLine2
`ZAC LA LIODERE`	Street and number	addresses.receiver.addressLine1
`JOUE LES TOURS`	City name	addresses.receiver.city
`37304`	Postal identification code	addresses.receiver.postCode
`FR`	Country name code	addresses.receiver.countryCode

NAD+SF segment

Example: NAD+SF+C034++Movianto Kist DC:Building 2+Ringstrasse +Kist++97270+DE'
Identification of the party from where goods will be or have been shipped.

value	description	mapping
`SF`	Address code qualifier (SF=Loading Point)	Fixed `SF`
`C034`	Party identifier	addresses.collection.references.consignorAssigned
`Movianto Kist DC`	Party name	addresses.collection.companyName
`:Building 2`	Additional address information	addresses.collection.addressLine2
`Ringstrasse`	Street and number	addresses.collection.addressLine1
`Kist`	City name	addresses.collection.city
`97270`	Postal identification code	addresses.collection.postCode
`DE`	Country name code	addresses.collection.countryCode

NAD+BY segment

Example: NAD+BY+0000++Solventum Ireland Limited HQ:Office building 34+Fenian Street +Dublin++D02 H0V5+IE'
Party to whom merchandise and/or service is sold.

value	description	mapping
`BY`	Address code qualifier (BY=Buyer)	Fixed `BY`
`0000`	Party identifier (GLN)	addresses.transportBuyer.references.consignorAssigned
`Solventum Ireland Limited HQ`	Party name	addresses.transportBuyer.companyName
`:Office building 34`	Additional address information	addresses.transportBuyer.addressLine2
`Fenian Street`	Street and number	addresses.transportBuyer.addressLine1
`Dublin`	City name	addresses.transportBuyer.city
`D02 H0V5`	Postal identification code	addresses.transportBuyer.postCode
`IE`	Country name code	addresses.transportBuyer.countryCode

NAD+SE segment

Example: NAD+SE+0000++Selling Party:Office 2+Sell street 12+AACHEN++47677+DE'
(3346) Party selling merchandise to a buyer.

value	description	mapping
`SE`	Address code qualifier (SE=Seller)	Fixed `SE`
`0000`	Party identifier (GLN)	addresses.transportSeller.references.consignorAssigned
`Selling Party`	Party name	addresses.transportSeller.companyName
`:Office 2`	Additional address information	addresses.transportSeller.addressLine2
`Sell street 12`	Street and number	addresses.transportSeller.addressLine1
`AACHEN`	City name	addresses.transportSeller.city
`47677`	Postal identification code	addresses.transportSeller.postCode
`DE`	Country name code	addresses.transportSeller.countryCode

NAD+CA segment

Example: NAD+CA+0000++DACHSER SE:Office building 34+ZAMILSTR11 +MUENCHEN++81677+DE'
(3126) Party undertaking or arranging transport of goods between named points.

value	description	mapping
`CA`	Address code qualifier (CA=Carrier)	Fixed `CA`
`0000`	Party identifier (GLN)	addresses.carrier.references.consignorAssigned
`DACHSER SE`	Party name	addresses.carrier.companyName
`:Office building 34`	Additional address information	addresses.carrier.addressLine2
`ZAMILSTR11`	Street and number	addresses.carrier.addressLine1
`MUENCHEN`	City name	addresses.carrier.city
`D81677`	Postal identification code	addresses.carrier.postCode
`DE`	Country name code	addresses.carrier.countryCode

CTA segment

Example: CTA+IC+:Harry Styles'
Contact information. Added per NAD segment. Only available when contact name is provided

value	description	mapping
`IC`	Contact function code (IC=Information contact)	Fixed `IC`
`Harry Styles`	Information contact name	contactName from applicable addressset (PW, CN, CZ)

COM segment

Example: COM+031635241627:TE' and/or COM+unknown@known.com:EM'
This segment identifies the communications number and type of communications for the person or department identified in the previous CTA segment. Added per NAD segment. Only available when contact name and phone (or email) is provided.

value	description	mapping
`unknown@known.com`	Contact information	`TE` = contactPhone from applicable addressset (PW, CN, CZ) `EM` = contactEmail from applicable addressset (PW, CN, CZ)
`TE`	Communication address code qualifier (TE=Telephone)	contactPhone from applicable addressset (PW, CN, CZ)
`EM`	Communication address code qualifier (EM=Electronic mail)	contactEmail from applicable addressset (PW, CN, CZ)

CNI segment

Example: CNI+1+6100000227_09'
To identify one consignment. This reference will be the one used in the IFTSTA in order to refer to this consignment.

value	description	mapping
`1`	Consolidation item number	Fixed `1` since we communicate only 1 consignment in a IFCSUM message
`6100000227_09`	Consignor shipment reference number	trackingReference

CNT segment (package totals)

Example: CNT+7:1.206:KGM'
Control total

value	description	mapping
`7`	Control total type code qualifier	`7`=Total gross weight `9`=Total numbers of pallets `11`=Total number of packages `15`=Total volume
`1.026`	Value	Totals taken from consignment handlingUnits
`:KGM`	Measurement unit code	`KGM`=kilogram `MTQ`=Cibic meters

TOD segment

Example: TOD+6++CIP'
Terms of delivery or transport, a segment to specify the applicable terms of delivery.

value	description	mapping
`2`	Delivery or transport terms function code (2=Despatch condition)	Fixed `2`
`CIP`	Delivery condition	incoterms.incoterm

GID segment

Example: GID+1+1:CT'
Goods item details, a segment to identify a goods item for which transport is undertaken.

value	description	mapping
`1`	Goods item number	Sequence. Counter increaes by 1 for each handling unit
`1`	Package count	Count of the handlingUnits. Always `1` since we do not consolidate identical handling units
`CT`	Package type	`CT`=Carton `EU`=Pallet

PIA segment

Example: PIA+5+200511443148943016'
Additional product id, specify additional or substitutional item identification codes

value	description	mapping
`5`	Product id. Function qualifier	Fixed `5` (Product identification for SSCC)
`200511443148943016`	Item Number Identification	hanlingUnit.reference

MEA+WT segment

Example: MEA+WT+GW+KGM:0.303'
Measurements, weight of the handling unit.

value	description	mapping
`WT`	Measured purpose code qualifier (WT=Weight)	Fixed `WT`
`GW`	Measured attribute code (GW=Gross weight)	Fixed `GW`
`KGM`	Measurement unit code (KGM=Kilograms)	Fixed `KGM`
`0.303`	Weight value	handlingUnit.weight

MEA+VOL segment

Example: MEA+VOL++MTQ:1.2'
Measurements, volume of the handling unit.

value	description	mapping
`VOL`	Measured purpose code qualifier (VOL=Volume)	Fixed `VOL`
`MTQ`	Measurement unit code (MTQ=Cubic meters)	Fixed `MTQ`
`:1.2`	Volume value	Volume per handlingUnit: handlingUnit.length * handlingUnit.width * handlingUnit.height / 1000000 Note the message converts from cubic centimeter to cubic meter

DIM segment

Example: DIM+2+CMT:100:110:120'
Dimensions

value	description	mapping
`2`	Dimension type code qualifier	Fixed `2`=Package dimension
`CMT`	Measurement unit code	Fixed `CMT`=centimeter
`:100`	Length dimension value	handlingUnit.length
`:110`	Width dimension value	handlingUnit.width
`:120`	Height dimension value	handlingUnit.height

DGS segment

Example: DGS+ADR+3.1+4501+25.3CEL+2:4321::1234+TFC'
Dangerous goods

value	description	mapping
`ADR`	Dangerous goods regulations code `ICA` = Regulations covering the international transportation of dangerous goods issued by the International Air Transport Association and the International Civil Aviation Organization. `ADR` = European agreement on the international carriage of dangerous goods on road `IMD` = Regulations regarding the transportation of dangerous goods on ocean-going vessels issued by the International Maritime Organization. `CFR` = United States federal regulations issued by the US Department of transportation covering the domestic transportation of dangerous goods by truck, rail, water and air.	handlingUnits.goodsItems.dangerousGoods.regulation
`3.1`	Dangerous goods class	handlingUnits.goodsItems.dangerousGoods.class
`4501`	United Nations Dangerous Goods (UNDG) identifier (UN number) Value is transmitted without the prefix ‘UN’	handlingUnits.goodsItems.dangerousGoods.unNumber
`25.3CEL`	Dangerous goods flashpoint value	handlingUnits.goodsItems.dangerousGoods.flashPoint
`2`	Packing group, packaging danger level code	handlingUnits.goodsItems.dangerousGoods.packingGroup
`:4321`	EMS number	handlingUnits.goodsItems.dangerousGoods.emsNumber
`::1234`	Transport emergency card identifier	handlingUnits.goodsItems.dangerousGoods.tremCardNumber
`TFC`	Dangerous goods classification code	handlingUnits.goodsItems.dangerousGoods.classificationCode

FTX AAD segment (per dg handling unit)

Example: FTX+AAD+++technical name'
Dangerous goods, technical name

value	description	mapping
`AAD`	Text subject code qualifier	Fixed `AAD`= Dangerous goods, technical name
`technical name`	Free text	handlingUnits.goodsItems.dangerousGoods.technicalName Segment repeats in case larger than 70 chars.

FTX AAC segment (per dg handling unit)

Example: FTX+AAC+++MATERIAL=000000007100227343OUTER_PACKAGE_INFORMATION=FIBERBOARD BOX I'
Dangerous goods additional information

value	description	mapping
`AAC`	Text subject code qualifier	Fixed `AAC`= Dangerous goods additional information
`MATERIAL=000000007100227343OUTER_PACKAGE_INFORMATION=FIBERBOARD BOX I`	Free text	handlingUnits.goodsItems.dangerousGoods.properShippingName Segment repeats in case larger than 70 chars.

FTX ADW segment (per dg handling unit)

Example: FTX+ADW+++EQ'
Characteristics of goods. Description of the characteristics of goods in addition to the description of the goods

value	description	mapping
`ADW`	Text subject code qualifier	Fixed `ADW`= Characteristics of goods
`EQ`	Free text	`LQ` if handlingUnits.goodsItems.dangerousGoods.type=`limitedQuantity` `EQ` if handlingUnits.goodsItems.dangerousGoods.type=`exceptedQuantity`

UNT segment

Example: UNT+33+6100000227_09'
Message trailer, used for verifying message correctness and completeness.

value	description	mapping
`33`	Number of segments in a message	Fixed `33`
`6100000227_09`	Message reference number. The message reference number detailed here should equal the one specified in the UNH segment.	reference

UNZ segment

Example: UNZ+1+1732096429'
This segment is used to provide the trailer of an interchange. This segment is a mandatory UN/EDIFACT segment. It must always be the last segment in the message.

value	description	mapping
`1`	Interchange control count.Number of messages or functional groups within an interchange. Always 1. We send 1 file per message.	Fixed `1`
`1732096429`	Interchange control reference. Identical to reference in UNB segment.	Automatically generated random number