General
- The message does not contain information on package level. Only package totals are transmitted.
- The message does not support dangerous goods.
- In case forwarding agent is applicable (a
DIAA
addresset is specified in handling instructions), the ultimate address is used as dropOff address. - The message only supports logisticEventTypeCode
SERVICE_PROVIDER_DELIVERY_DATE
.CUSTOMER_REQUESTED_DELIVERY_DATE
is not supported. - Some fields (pickUpParty, dropOffParty) are not GS1 mandatory, but are marked mandatory in the mapping document. These fields are mandatory from a process point of view.
Documentation
Example Message
<?xml version="1.0"?><transport_capacity_booking:transportCapacityBookingMessage xmlns:sh="http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:transport_capacity_booking="urn:gs1:ecom:transport_capacity_booking:xsd:3"> <sh:StandardBusinessDocumentHeader> <sh:HeaderVersion>1.0</sh:HeaderVersion> <sh:Sender> <sh:Identifier Authority="GS1">46438839390302</sh:Identifier> </sh:Sender> <sh:Receiver> <sh:Identifier Authority="GS1">1425261772</sh:Identifier> </sh:Receiver> <sh:DocumentIdentification> <sh:Standard>GS1</sh:Standard> <sh:TypeVersion>3.0</sh:TypeVersion> <sh:InstanceIdentifier>TCB_MSG-main_tracking_number-20250625_061533663</sh:InstanceIdentifier> <sh:Type>transport_capacity_booking</sh:Type> <sh:CreationDateAndTime>2025-06-25T06:15:33.664+00:00</sh:CreationDateAndTime> </sh:DocumentIdentification> </sh:StandardBusinessDocumentHeader> <transportCapacityBooking> <creationDateTime>2025-06-25T06:15:33.665+00:00</creationDateTime> <documentStatusCode>ORIGINAL</documentStatusCode> <documentActionCode>ADD</documentActionCode> <transportCapacityBookingIdentification> <entityIdentification>main_tracking_number</entityIdentification> </transportCapacityBookingIdentification> <transportServiceCategoryCode>NO_INFO</transportServiceCategoryCode> <transportServiceConditionTypeCode>DIRECT</transportServiceConditionTypeCode> <logisticServicesBuyer> <additionalPartyIdentification additionalPartyIdentificationTypeCode="BUYER_ASSIGNED_IDENTIFIER_FOR_A_PARTY">3M</additionalPartyIdentification> </logisticServicesBuyer> <logisticServicesSeller> <additionalPartyIdentification additionalPartyIdentificationTypeCode="BUYER_ASSIGNED_IDENTIFIER_FOR_A_PARTY">FRE</additionalPartyIdentification> </logisticServicesSeller> <pickUpParty> <additionalPartyIdentification additionalPartyIdentificationTypeCode="BUYER_ASSIGNED_IDENTIFIER_FOR_A_PARTY">C034</additionalPartyIdentification> <address> <city>City in Poland</city> <countryCode>PL</countryCode> <name>Collection Company name</name> <postalCode>41-000</postalCode> <streetAddressOne>ROZDZIENSKIEGO 12</streetAddressOne> </address> </pickUpParty> <dropOffParty> <address> <city>City in Poland</city> <countryCode>PL</countryCode> <name>Receiver Company name</name> <postalCode>26-000</postalCode> <streetAddressOne>UL. WIERZBICKA</streetAddressOne> </address> </dropOffParty> <plannedPickUp> <logisticEventDateTime> <date>2025-06-26</date> <time>14:15:22.000+00:00</time> </logisticEventDateTime> </plannedPickUp> <plannedDropOff> <logisticEventTypeCode>SERVICE_PROVIDER_DELIVERY_DATE</logisticEventTypeCode> <logisticEventDateTime> <date>2025-06-27</date> <time>11:15:00.000+00:00</time> </logisticEventDateTime> </plannedDropOff> <transportReference> <entityIdentification>8091818992|99999999</entityIdentification> <transportReferenceTypeCode>SRN</transportReferenceTypeCode> </transportReference> <transportReference> <entityIdentification>4010000108006134370825</entityIdentification> <transportReferenceTypeCode>BN</transportReferenceTypeCode> </transportReference> <transportReference> <entityIdentification>4010000108006134370825</entityIdentification> <transportReferenceTypeCode>AES</transportReferenceTypeCode> </transportReference> <transportReference> <entityIdentification>4010000108006134370825</entityIdentification> <transportReferenceTypeCode>AAM</transportReferenceTypeCode> </transportReference> <transportReference> <entityIdentification>ROOT_SSCC_1</entityIdentification> <transportReferenceTypeCode>SSC</transportReferenceTypeCode> </transportReference> <transportReference> <entityIdentification>059025961363267999</entityIdentification> <transportReferenceTypeCode>SSC</transportReferenceTypeCode> </transportReference> <deliveryTerms> <incotermsCode>CIP</incotermsCode> </deliveryTerms> <handlingInstruction> <handlingInstructionText languageCode="EN">TR02|packinglist is included</handlingInstructionText> </handlingInstruction> <handlingInstruction> <handlingInstructionText languageCode="EN">LD12 | delivery until 1200</handlingInstructionText> </handlingInstruction> <handlingInstruction> <handlingInstructionText languageCode="EN">LD10 | Anlieferung bis 10Uhr</handlingInstructionText> </handlingInstruction> <handlingInstruction> <handlingInstructionText languageCode="EN">DDWB | MO-FR 8.00-16.00</handlingInstructionText> </handlingInstruction> <handlingInstruction> <handlingInstructionText languageCode="EN">DASC | Dabrowa (allow split shipments)</handlingInstructionText> </handlingInstruction> <handlingInstruction> <handlingInstructionText languageCode="EN">DDFD | Liefertermin fix:21.02.2024</handlingInstructionText> </handlingInstruction> <handlingInstruction> <handlingInstructionText languageCode="EN">DDAD | Avis an versand@at-industrieservice.at</handlingInstructionText> </handlingInstruction> <handlingInstruction> <handlingInstructionText languageCode="EN">DUTL | use lorry with tail-lift</handlingInstructionText> </handlingInstruction> <handlingInstruction> <handlingInstructionText languageCode="EN">TDNS | Do not stack plts</handlingInstructionText> </handlingInstruction> <handlingInstruction> <handlingInstructionText languageCode="EN">DDEA | www.transporeon.com/login</handlingInstructionText> </handlingInstruction> <handlingInstruction> <handlingInstructionText languageCode="EN">DIAA | address</handlingInstructionText> </handlingInstruction> <transportCapacityBookingSpaceRequirements> <transportCargoCharacteristics> <cargoTypeCode>11</cargoTypeCode> <cargoTypeDescription languageCode="EN">LTL</cargoTypeDescription> <totalGrossVolume measurementUnitCode="CM3">17000000</totalGrossVolume> <totalGrossWeight measurementUnitCode="KG">500</totalGrossWeight> <totalPackageQuantity>3</totalPackageQuantity> </transportCargoCharacteristics> <packageTotal> <packageTypeCode>PE</packageTypeCode> <totalPackageQuantity>3</totalPackageQuantity> <totalGrossVolume measurementUnitCode="CM3">17000000</totalGrossVolume> <totalGrossWeight measurementUnitCode="KG">500</totalGrossWeight> </packageTotal> <includedTransportMeans> <transportMeansType>31</transportMeansType><transportMeansID>NOINFO</transportMeansID> </includedTransportMeans> </transportCapacityBookingSpaceRequirements> <transportCapacityBookingTransportMovement> <transportModeCode>30</transportModeCode> <routeID>C034-</routeID> <plannedDeparture> <logisticEventDateTime> <date>2025-06-26</date> <time>14:15:22.000+00:00</time> </logisticEventDateTime> </plannedDeparture> <plannedArrival> <logisticEventTypeCode>SERVICE_PROVIDER_DELIVERY_DATE</logisticEventTypeCode> <logisticEventDateTime> <date>2025-06-27</date> <time>11:15:00.000+00:00</time> </logisticEventDateTime> </plannedArrival> </transportCapacityBookingTransportMovement> </transportCapacityBooking></transport_capacity_booking:transportCapacityBookingMessage>
Mapping
GS1-TI Field | Description | Mandatory | Example value | Viya Field |
---|---|---|---|---|
transportCapacityBookingMessage .StandardBusinessDocumentHeader.HeaderVersion | Version number of the SBDH standard used. | Y | 1.0 | not mapped |
transportCapacityBookingMessage .StandardBusinessDocumentHeader.Sender.Identifier | A unique identification key for the Sender party. Typically a GLN number. | Y | 8712345000004 | addresses.sender.references.gln if empty, from configuration. |
transportCapacityBookingMessage .StandardBusinessDocumentHeader.Receiver.Identifier | A unique identification key for the sending or receiving party. Typically a GLN number. | Y | 8712345000004 | receiver identifier from configuration |
transportCapacityBookingMessage .StandardBusinessDocumentHeader.DocumentIdentification.Standard | The name of the document standard contained in the payload | Y | GS1 | not mapped |
transportCapacityBookingMessage .StandardBusinessDocumentHeader.DocumentIdentification.TypeVersion | Version information of the document included in the payload of SBDH. | Y | 3.0 | not mapped |
transportCapacityBookingMessage .StandardBusinessDocumentHeader.DocumentIdentification.InstanceIdentifier | Description which contains reference information which uniquely identifies this instance of the Standard Business Document (SBD) | Y | TCB_MSG-06000003_6134370825-9-20241126_101601306 | filename without file extension. TCB_MSG-[carrier reference]-[date in format YYYYMMDD_HHNNSSMMM] |
transportCapacityBookingMessage .StandardBusinessDocumentHeader.DocumentIdentification.Type | This element identifies the type of the document. | Y | transport_capacity_booking | not mapped |
transportCapacityBookingMessage .StandardBusinessDocumentHeader.DocumentIdentification.CreationDateAndTime | Date and time of the SBDH document creation. | Y | 2024-11-26T10:16:01.306+00:00 | date in format YYYY-MM-DD:HH:NN:SS.MMM+[Time Zone] |
transportCapacityBookingMessage .transportCapacityBooking.creationDateTime | Date and time of the document creation. | Y | 2024-11-26T10:16:01.306+00:00 | date in format YYYY-MM-DD:HH:NN:SS.MMM+[Time Zone] |
transportCapacityBookingMessage .transportCapacityBooking.documentStatusCode | Indicates if the document is a copy or an original. | Y | ORIGINAL | not mapped |
transportCapacityBookingMessage .transportCapacityBooking.documentActionCode | Code specifying the action to be taken in the system of the recipient using the information in the document. | N | ADD | not mapped |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingIdentification.entityIdentification | The unique identifier of the piece of information, such as the object id or the document id. | Y | 4010000108006134370825 | trackingReference if empty requestedTrackingReference if empty reference |
transportCapacityBookingMessage .transportCapacityBooking.transportServiceCategoryCode | Code specifying the type of transport service that will be provided. For example: Courier service. | Y | 30 | modeOfTransport 10 = ocean 30 = road 40 = air |
transportCapacityBookingMessage .transportCapacityBooking.transportServiceConditionTypeCode | Code specifying the type of contractual conditions applicable to these transport terms. | N | 100 | serviceLevelReference value translated against GS1 service level codes if no translation found, untranslated serviceLevelReference is mapped |
transportCapacityBookingMessage .transportCapacityBooking.logisticServicesBuyer.additionalPartyIdentification | A party that purchases logistics services from another party. Identification of a party by use of a code other than the Global Location Number. | Y | SOLVENTUM | configuration.senderCompanyName If empty, addresses.collection.references.gln |
transportCapacityBookingMessage .transportCapacityBooking.logisticServicesSeller.additionalPartyIdentification | A party that provides logistics services to another party. Identification of a party by use of a code other than the Global Location Number. | Y | FRE | configuration.carrierCode |
transportCapacityBookingMessage .transportCapacityBooking.pickUpParty.additionalPartyIdentification | Identification of a party by use of a code other than the Global Location Number. | Y | C034 | addresses.collection.references.consignorAssigned |
transportCapacityBookingMessage .transportCapacityBooking.pickUpParty.address.city | Text specifying the name of the city. | Y | Amsterdam | addresses.collection.city |
transportCapacityBookingMessage .transportCapacityBooking.pickUpParty.address.countryCode | Code that identifies a county. | Y | NL | addresses.collection.countryCode |
transportCapacityBookingMessage .transportCapacityBooking.pickUpParty.address.name | The name of the party expressed in text. | Y | Fake business | addresses.collection.companyName |
transportCapacityBookingMessage .transportCapacityBooking.pickUpParty.address.postalCode | Text specifying the postal code for an address. | Y | 4111AA | addresses.collection.postCode |
transportCapacityBookingMessage .transportCapacityBooking.pickUpParty.address.streetAddressOne | The first free form line of an address. | Y | Bakerstraat 21A | addresses.collection.addressLine1 |
transportCapacityBookingMessage .transportCapacityBooking.dropOffParty.address.city | Text specifying the name of the city. | Y | Amsterdam | addresses.receiver.city if forwarding agent is applicable : addresses.ultimate.city |
transportCapacityBookingMessage .transportCapacityBooking.dropOffParty.address.countryCode | Code that identifies a county. | Y | NL | addresses.receiver.countryCode if forwarding agent is applicable : addresses.ultimate.countryCode |
transportCapacityBookingMessage .transportCapacityBooking.dropOffParty.address.name | The name of the party expressed in text. | Y | Fake business | addresses.receiver.companyName if forwarding agent is applicable : addresses.ultimate.companyName |
transportCapacityBookingMessage .transportCapacityBooking.dropOffParty.address.postalCode | Text specifying the postal code for an address. | Y | 4111AA | addresses.receiver.postCode if forwarding agent is applicable : addresses.ultimate.postCode |
transportCapacityBookingMessage .transportCapacityBooking.dropOffParty.address.streetAddressOne | The first free form line of an address. | Y | Bakerstraat 21A | addresses.receiver.addressLine1 if forwarding agent is applicable : addresses.ultimate.addressLine1 |
transportCapacityBookingMessage .transportCapacityBooking.plannedPickUp.logisticEventDateTime.date | The date on which the logistic event occurs. | N | 2024-05-09 | timeWindows.pickup.planned.start in YYYY-MM-DD |
transportCapacityBookingMessage .transportCapacityBooking.plannedPickUp.logisticEventDateTime.time | The time on which the logistic event occurs. | N | 15:50:40.000+00:00 | timeWindows.pickup.planned.start in HH:NN:SS.MMM+[timezone] |
transportCapacityBookingMessage .transportCapacityBooking.plannedDropOff.logisticEventTypeCode | Information about the allowed code values for this code can be found in the GS1 Global Data Dictionary | N | SERVICE_PROVIDER_DELIVERY_DATE | not mapped |
transportCapacityBookingMessage .transportCapacityBooking.plannedDropOff.logisticEventDateTime.date | The date on which the logistic event occurs. | N | 2024-05-09 | timeWindows.delivery.planned.start in YYYY-MM-DD |
transportCapacityBookingMessage .transportCapacityBooking.plannedDropOff.logisticEventDateTime.time | The time on which the logistic event occurs. | N | 15:50:40.000+00:00 | timeWindows.delivery.planned.start in HH:NN:SS.MMM+[timezone] |
transportCapacityBookingMessage .transportCapacityBooking.transportReference transportReferenceTypeCode SRN | References to the commercial transaction or to transport or legal documents related to the consignment. | N | 40236092869904416 | In case addresses.receiver.references.consignorAssigned is 4 chars we map consignment.reference else the shipment.references.sapDelivery from all contained shipments seperated by pipe |
transportCapacityBookingMessage .transportCapacityBooking.transportReference transportReferenceTypeCode BN / AES / AAM | References to the commercial transaction or to transport or legal documents related to the consignment. | N | 4010000108006134370825 | reference |
transportCapacityBookingMessage .transportCapacityBooking.transportReference transportReferenceTypeCode SSC | References to the commercial transaction or to transport or legal documents related to the consignment. | N | 059025961363267226 | One entry for each handlingUnit on consignment level handlingUnit.reference |
transportCapacityBookingMessage .transportCapacityBooking.deliveryTerms.incotermsCode | Code specifying the incoterms. Incoterms is an abbreviation for International Commercial Terms. | N | CIP | incoterms.incoterm translated against GS1 incoterm codes |
transportCapacityBookingMessage .transportCapacityBooking.handlingInstructions | Instruction on the way to treat the goods during transport and storage. | N | allow split shipments | instructions.carrierInstructions.collection instructions.carrierInstructions.transport instructions.carrierInstructions.delivery Each instruction in seperate hanlingInstruction |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingSpaceRequirements .transportCargoCharacteristics.cargoTypeCode | Code specifying the classification of a type of cargo for example hazardous cargo. | Y | 11 | if consignment contains 1 or more dangerous goods packages, 11 else 12 |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingSpaceRequirements .transportCargoCharacteristics.cargoTypeDescription | Free text specifying the classification of a type of cargo. | N | Full trcuk load, no stop | description only send when description has value. |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingSpaceRequirements .transportCargoCharacteristics.totalGrossVolume | A measure of the volume, normally calculated by multiplying the maximum length, width, and height of the packaged goods. | N | 98592 | sum of all handlingUnit volumes on consignment level. handlingUnit.width * handlingUnit.height * handlingUnit.length |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingSpaceRequirements .transportCargoCharacteristics.totalGrossWeight | A measure of the mass of the goods including the weight of transport packaging, and potentially the weight of any transport equipment. | N | 123 | sum of all handlingUnit weights on consignment level. |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingSpaceRequirements .packageTotal.packageTypeCode | The code specifying the type of logistics package. | Y | Box | In case the consignment holds one or more pallets (handlingUnits.packageType.code contains pallet ) we map pallet else box |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingSpaceRequirements .packageTotal.totalPackageQuantity | The total number of units of this package type. | Y | 98592 | count of all handlingUnit volumes on consignment level. |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingSpaceRequirements .packageTotal.totalGrossVolume | A measure of the volume, normally calculated by multiplying the maximum length, width, and height of the packaged goods. | N | 98592 | sum of all handlingUnit volumes on consignment level. handlingUnit.width * handlingUnit.height * handlingUnit.length |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingSpaceRequirements .packageTotal.totalGrossWeight | A measure of the mass of the goods including the weight of transport packaging, and potentially the weight of any transport equipment. | N | 123 | sum of all handlingUnit weights on consignment level. |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingSpaceRequirements.includedTransportMeans.transportMeansType | Code specifying the type of vehicle, aircraft, vessel or other device used for the transport of goods. | Y | 10E | if addresses.receiver.references.consignorAssigned is 4 chars 10E else 31 |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingSpaceRequirements.includedTransportMeans.transportMeansID | The unique identifier of a particular means of transport. E.g. A license plate number or vessel id. | N | AA33BB | references.licensePlate |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingTransportMovement .transportModeCode | Code specifying the transportation mode used for this transport movement. | Y | 30 | modeOfTransport 10 = ocean 30 = road 40 = air |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingTransportMovement .routeID | Unique identifier of the standard route that will be used for this transport movement. | N | C013-B12 | addresses.collection.references.consignorAssigned - addresses.receiver.references.consignorAssigned |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingTransportMovement .plannedDeparture.logisticEventDateTime.date | The date on which the logistic event occurs. | Y | 2024-05-09 | timeWindows.pickup.planned.start in YYYY-MM-DD |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingTransportMovement .plannedDeparture.logisticEventDateTime.time | The time on which the logistic event occurs. | Y | 15:50:40.000+00:00 | timeWindows.pickup.planned.start in HH:NN:SS.MMM+[timezone] |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingTransportMovement .plannedArrival.logisticEventTypeCode | Code specifying the type of logistic event. Example: Customs clearance. | N | SERVICE_PROVIDER_DELIVERY_DATE | not mapped |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingTransportMovement .plannedArrival.logisticEventDateTime.date | The date on which the logistic event occurs. | Y | 2024-05-09 | timeWindows.delivery.planned.start in YYYY-MM-DD |
transportCapacityBookingMessage .transportCapacityBooking.transportCapacityBookingTransportMovement .plannedArrival.logisticEventDateTime.time | The time on which the logistic event occurs. | Y | 15:50:40.000+00:00 | timeWindows.delivery.planned.start in HH:NN:SS.MMM+[timezone] |