General
- Dangerous goods is not included in the IFTMIN D96A.
- Package details on shipment/consigment level are not transmitted. The message only supports totals for pallets (EWP) and non-pallet (PAK) handling units.
- Overpacks are not supported.
- Custom service levels for carriers are supported. Translation can be configured when setting up the carrier.
- Default service levels for domestic and non-domestic shipments are supported. Defaults can be defined when setting up the carrier.
Documentation
-
unece.org: https://unece.org/fileadmin/DAM/trade/untdid/d96a/trmd/iftmin_c.htm
-
gs1: https://www.gs1.org/sites/default/files/docs/eancom/ean02s4/part2/iftmin/toc.htm
Example
UNA:+.? 'UNB+UNOA:2+233222332+0008897789:14+20250625:0747+1750837623'UNH+4010000108006134370825+IFTMIN:D:96A:UN:FI'BGM+610+4010000108006134370825+5'DTM+137:20250625:102'TSR+++DIR'FTX+DEL+++AAAA|Test'FTX+DEL+++TR02|packinglist is included#LD12 | delivery until 1200#LD10 | Anliefe'FTX+DEL+++DDWB | MO-FR 8.00-16.00#DASC | Dabrowa (allow split shipments)#DDFD | 'FTX+TRA+++handle with care'FTX+HAN+++Y'TOD+2++CIP'RFF+CU:4010000108006134370825'RFF+CUA:40236092869904416'RFF+AAM:2K029373'RFF+BN:67584847'NAD+CN+0000000000000++Company name+Street name+City++26-000+PL'NAD+PW+C034++Company name+Street name+City++41-000+PL'NAD+CZ+4001895000003++Company name+KÜHLHAUSSTRASSE 22+City++4100+CH'NAD+AL+++0006500053'GID+1+2:EWP:21'FTX+AAA++++FFA-10292'MEA+WT+G+KGM:400'MEA+VOL+AAW+MTQ:16'PCI+3+8091818992:99999999'PCI+33E'GIN+BJ+Pallet 1'PCI+3+8091818992:99999999'PCI+33E'GIN+BJ+Pallet 2'GID+2+1:PAK:21'FTX+AAA++++FFA-10292'MEA+WT+G+KGM:100'MEA+VOL+AAW+MTQ:1'PCI+3+8091818992:99999999'PCI+33E'GIN+BJ+099925961363267226'UNT+34+4010000108006134370825'UNZ+1+1750837623'
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+UNOA:2+233222332+0008897789:14+20241120:1051+1732099864'
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 |
---|---|---|
UNOA | Syntax identifier | Fixed UNOA |
:2 | Syntax version number | Fixed 2 |
233222332 | Interchange sender identification (GLN) | Configuration.iftmind96aSenderGln |
0008897789 | Interchange recipient identification (GLN) | Configuration.iftmind96aReceiverGln Can be configured per ship to country |
:14 | Identification code qualifier (14=GS1) | Fixed 14 |
20241120 | Creation date of the document in YYYYMMDD | System date at document creation |
:1051 | Creation time of the document in HHNN | System time at document creation |
1732099864 | Interchange control reference, unique reference identifying the interchange. Must be equal to reference in UNZ segment | Automatically generated random number |
UNH segment
Example: UNH+6100192+IFTMIN:D:96A:UN:FI'
Message header, a service segment starting and uniquely identifying a message. The message type code for the Instruction message is IFTMIN.
value | description | mapping |
---|---|---|
6100192 | Message reference number. Senders unique message reference. | reference |
IFTMIN | Message type | Fixed IFTMIN |
:D | Message version number | Fixed D |
:96A | Message release number | Fixed 96A |
:UN | Controlling agency, coded | Fixed UN |
:FI | Version control number | Fixed FI |
BGM segment
Example: BGM+610+4010000108006134370825+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=Forawrding Instructions) | Fixed 610 |
4010000108006134370825 | 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+137:20241122:102'
Date/time/period, document/message date/time. Date/time when a document/message is issued.
value | description | mapping |
---|---|---|
137 | Date or time or period function code qualifier (137=document message creation date/time) | Fixed 137 |
:202411200941 | Date or time or period value | System date/time at document creation in CYYMMDDHHMM |
:203 | Date or time or period format code (102=CCYYMMDD) | Fixed 203 |
TSR segment
Example: TSR+++DIR'
To specify the contract and carriage conditions and service and priority requirements for the transport.
value | description | mapping |
---|---|---|
DIR | Service requirement code | serviceLevelReference translated using custom packages from configuration. In case serviceLevelReference contains # only the part on the right is mapped |
FTX+DEL segment
Example: FTX+DEL+++DASC | Dabrowa (allow split shipments)'
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) | Fixed DEL |
DASC | Dabrowa (allow split shipments) | Delivery instructions values. Note collection, transport and delivery instructions are mapped if available. Each will have its own FTX+DEL segment. | instructions.carrierInstructions.collection instructions.carrierInstructions.transport instructions.carrierInstructions.delivery |
FTX+TRA segment
Example: FTX+TRA+++handle with care'
This segment is used to provide free form or coded text information related to the entire message.
value | description | mapping |
---|---|---|
TRA | Text subject code qualifier (TRA=Transportation information) | Fixed TRA |
handle with care | Transportation information values. Element is only added in case the consignment contains dangerous goods. Value is hardcoded handle with care . | Fixed handle with care |
FTX+HAN segment
Example: FTX+HAN+++Y'
This segment is used to provide free form or coded text information related to the entire message.
value | description | mapping |
---|---|---|
HAN | Text subject code qualifier (HAN=Handling instructions) | Fixed HAN |
Y | Transportation information values. Element is only added in case the consignment contains dangerous goods. Value is hardcoded Y . | Fixed Y |
TOD segment
Example: TOD+2++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 |
RFF+CU segment
Example: RFF+CU:6100192'
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 |
---|---|---|
CU | Reference code qualifier (CU=Consignor’s reference number) | Fixed CU |
:6100192 | Reference value | reference |
RFF+CUA segment
Example: RFF+CUA:6100192'
Reference, consignor’s reference number of first shipment, reference number assigned by a consignor to a particular shipment for his own purposes or for those of the consignee.
value | description | mapping |
---|---|---|
CUA | Reference code qualifier. This is not an official edifact qualifier. | Fixed CUA |
:6100192 | It is used for transmitting the first shipment number in the consignment | shipment.reference (first) |
RFF+AAM segment
Example: RFF+AAM:2K029373'
Reference number assigned to a waybill. Use this reference to refer to this consignment when sending tracking information to Viya.
value | description | mapping |
---|---|---|
AAM | Reference code qualifier. (AAM=Reference number assigned to a waybill) | Fixed AAM |
:2K029373 | Reference number assigned to the consignment. Use his reference for tracking to refer to this consignment | trackingReference |
RFF+BN segment
Example: RFF+BN:67584847'
Reference number assigned by the carrier (pre-advise reference). Use this reference when pre-booking applies.
value | description | mapping |
---|---|---|
BN | Reference code qualifier. (BN=Reference number assigned by the carrier) | Fixed BN |
:2K029373 | Reference number assigned by the carrier at pre-booking | references.freightForwarderAssigned |
NAD+CN segment
Example: NAD+CN+0000000000000++ELNEX NOWAK DARIUSZ JOZEF:Second floor+Street 3+RADOM++11-111+PL'
Name and address. Consignee, party to which goods are consigned.
value | description | mapping |
---|---|---|
CN | Address code qualifier (CN=Consignee) | Fixed CN |
0000000000000 | Party identifier (GLN) | addresses.receiver.references.consignorAssigned |
ELNEX NOWAK DARIUSZ JOZEF | Party name | addresses.receiver.companyName |
:Second floor | Additional address information | addresses.receiver.addressLine2 |
Street 3 | Street and number | addresses.receiver.addressLine1 |
RADOM | City name | addresses.receiver.city |
11-111 | Postal identification code | addresses.receiver.postCode |
PL | Country name code | addresses.receiver.countryCode |
NAD+PW segment
Example: NAD+PW+C034++PL DABROWA GORNICZA HUB:BUILDING 2+Street 12+DABROWA GORNICZA++11-111+PL'
Name and address. Despatch party, party where goods are collected or taken over by the carrier (i.e. if other than consignor).
value | description | mapping |
---|---|---|
PW | Address code qualifier (PW=Despatch Party) | Fixed PW |
C034 | Party identifier | addresses.collection.references.consignorAssigned |
PL DABROWA GORNICZA HUB | Party name | addresses.collection.companyName |
:BUILDING 2 | Additional address information | addresses.collection.addressLine2 |
Street 12 | Street and number | addresses.collection.addressLine1 |
DABROWA GORNICZA | City name | addresses.collection.city |
11-111 | Postal identification code | addresses.collection.postCode |
PL | Country name code | addresses.collection.countryCode |
NAD+CZ segment
Example: NAD+CZ+4001895000011++EMEA COE HEADQUARTERS:Office building 34+Street 2+Langenthal++1111+CH'
Name and address. Consignor, party which, by contract with a carrier, consigns or sends goods with the carrier, or has them conveyed by him. Synonym: shipper, sender.
value | description | mapping |
---|---|---|
CZ | Address code qualifier (CN=Consignor) | Fixed CZ |
4001895000011 | Party identifier (GLN) | addresses.transportBuyer.references.consignorAssigned |
EMEA COE HEADQUARTERS | Party name | addresses.transportBuyer.companyName |
:Office building 34 | Additional address information | addresses.transportBuyer.addressLine2 |
Street 2 | Street and number | addresses.transportBuyer.addressLine1 |
Langenthal | City name | addresses.transportBuyer.city |
1111 | Postal identification code | addresses.transportBuyer.postCode |
CH | Country name code | addresses.transportBuyer.countryCode |
NAD+AL segment
Example: NAD+AL+++0006500053'
Name and address. Carrier code.
value | description | mapping |
---|---|---|
AL | Address code qualifier (AL=Not an official edifact code) | Fixed AL |
0006500053 | Carrier code | carrierReference |
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'
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) |
GID segment
Example: GID+1+5:EWP:21'
Goods item details, a segment to identify a goods item for which transport is undertaken.
Segment is transmitted seperately for pallets (EWP
) and non-pallets (PAK
).
value | description | mapping |
---|---|---|
1 | Package identifier | Fixed 1 for pallets |
5 | Package count | Count of the handlingUnits with packageType.code containing ‘pallet’ Note, your handlingUnit will only be identified as a pallet if your packageType.code contains ‘pallet’. |
EWP | Package type | Fixed EWP for pallets |
21 | Package type description code | Fixed 21 |
Example: GID+2+1:PAK:21'
value | description | mapping |
---|---|---|
2 | Package identifier | Fixed 1 if no pallets on consignment Fixed 2 if consignment contains pallets |
1 | Package count | Count number of handlingUnits on the consignment other than pallet. |
PAK | Package type | Fixed PAK for non-pallets |
21 | Package type description code | Fixed 21 |
FTX+AAA segment
Example: FTX+AAA+++25242422'
This segment is used to provide free form or coded text information related to the entire message.
value | description | mapping |
---|---|---|
AAA | Text subject code qualifier (AAA=Goods description) | Fixed AAA |
25242422 | A reference assigned by the freight forwarder to uniquely identify the consignment. Will be repeated per GID segment. | If references.freightForwarderAssigned holds value references.freightForwarderAssigned, else hardcoded ‘Documents’ |
MEA+WT segment
Example: MEA+WT+G+KGM:79'
Measurements, weight of the handling unit.
Segment is repeated twice, for EWP
and PAK
.
This results in totals for pallet and non-pallet handling units.
value | description | mapping |
---|---|---|
WT | Measured purpose code qualifier (WT=Weight) | Fixed WT |
G | Measured attribute code (GW=Gross weight) | Fixed G |
KGM | Measurement unit code (KGM=Kilograms) | Fixed KGM |
79 | Weight value | Sum of all handlingUnit.weight per package type (pallet versus non-pallet) |
MEA+VOL segment
Example: MEA+VOL+AAW+MTQ:0.049296'
Measurements, volume of the handling unit.
Segment is repeated twice, for EWP
and PAK
.
This results in totals for pallet and non-pallet handling units.
value | description | mapping |
---|---|---|
VOL | Measured purpose code qualifier (VOL=Volume) | Fixed VOL |
AAW | Measured attribute code (AAW=Gross volume) | Fixed AAW |
MTQ | Measurement unit code (MTQ=Cubic meters) | Fixed MTQ |
0.049296 | Volume value | Sum of all handlingUnit volumes per package type (pallet versus non-pallet) Volume per handlingUnit: handlingUnit.length * handlingUnit.width * handlingUnit.height / 1000000 Note the message converts from cubic centimeter to cubic meter |
PCI+3 segment
Example: PCI+3+40236092869904416:0236092869904417:0236092869904418'
This segment is used to specify markings and labels which have been marked on the packaging of the current goods item.
value | description | mapping |
---|---|---|
3 | Marking instructions code (3=Mark customer’s references, packaging should be marked with customer’s references) | Fixed 3 |
40236092869904416:0236092869904417:0236092869904418 | String of all shipment sap references contained in the consignment seperated by : | All shipment.references.sapDelivery concatenated to one string seperated by : . |
PCI+33E segment
Example: PCI+33E'
This segment is used to specify markings and labels which have been marked on the packaging of the current goods item.
value | description | mapping |
---|---|---|
33E | Indicates ‘Marked with serial shipping container code’ Indication that the serial shipping container code has been marked on a package Note: code is marked for deletion by GS1. Will be replaced by 33 in the future | Fixed 33E |
GIN segment
Example: GIN+BJ+059025961363267233'
Goods identity number, reference / SSCC of the handling unit.
value | description | mapping |
---|---|---|
BJ | Object identification code qualifier (AW=Serial shipping container code(sscc)) | Fixed BJ |
059025961363267233 | Serial shipping container code(sscc) | handlingUnit.reference |
UNT segment
Example: UNT+33+6100192'
Message trailer, used for verifying message correctness and completeness.
value | description | mapping |
---|---|---|
33 | Number of segments in a message | Fixed 33 |
6100192 | 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 |