Dachser
Dachser supports various message formats for ordering and tracking shipments. After working with Dachser for years using edifact, we have choosen to continue with their XML messages as that is the most modern format we found in their portfolio. This document describes the XML message format for ordering & manifesting shipments.
Shipping label
A dachser specific shipping label is generated per handling unit
- size: 100x150mm
- Barcode: Per handling unit, SSCC number
XML file
For ordering we optionally sent the forwardingOrder per shipment to Dachser. At manifesting we sent the forwarding order for all shipments in the manifest to Dachser.
Both ordering and manifesting trigger simular message, the only difference is that ordering will additionally provide segment: PreliminaryShipment\Action=5 to indicate it is a tranportAdvice.
Address sets
Following address sets are communicated with Dachser:
| Dachser Address Code | Description | Address-set used |
|---|---|---|
| CZ | Consignor | addresses.sender |
| CN | Consignee | addresses.receiver |
| LP | Collection Address | If addresses.collection <> addresses.sender set CollectionAddress |
| IM | Importer | addresses.importerOfRecord |
| UC | Final delivery address | addresses.ultimate |
| FW | Forwarder | Dachser partner ID and GLN. Provided by Dachser |
| CB | Customs agent | addresses.broker |
| DA | Cover address consignor. Final consignee not to be notified of the actual sender. | Not implemented |
| RE | Deviating freight payer | addresses.thirdParty |
| WB | COD beneficiary | Not implemented |
Incoterms
Dachser uses specific codes for incoterms. ShipitSmarter incoterms taken from https://www.shiphub.co/incoterms-2020/.
| Dachser Delivery Condition | Description | Trigger |
|---|---|---|
| 011 | Ex-Works | Incoterm = EXW |
| 031 | Free delivered | Incoterm = DDPNot-Crossing-EU-borders |
| 031 | Free delivered, delivered at place | Incoterm = DAPNot-Crossing-EU-borders |
| 031 | Free delivered, delivered at terminal | Incoterm = DPUNot-Crossing-EU-borders |
| 035 | Ex works including delivery against invoice | Not implemented |
| 041 | Free border; uncleared excluding duty & tax | Not implemented |
| 081 | Free delivered; uncleared excluding duty & tax | Incoterm = DAPEU-Cross-Border |
| 082 | Free delivered; cleared excluding duty & tax | Not implemented |
| 083 | Free delivered; cleared including duty, excluding tax | Incoterm = DDPserviceOptions.splitDuty.Instructions.InstructionList.splitDutiesFromVat = trueEU-Cross-Border |
| 084 | Free delivered; cleared including duty & tax | Incoterm = DDPEU-Cross-Border |
| 995 | Service goods, insured; only by arrangement with the consolidator | Not implemented |
| 999 | Without charge; only by arrangement with the consolidator | Not implemented |
- Not-Crossing-EU-borders: indicates both collection and receiver address reside within the EU.
- EU-Cross-Border: indicates that collection or receiver address reside outside the EU.
If a Not implemented code is desired: You can configure these based on the incoterms in the onboarding page of the Dachser integration. If a desired combination is not possible, please contact us.
Service Levels
| Dachser Service Code | Service Name | Description | Trigger |
|---|---|---|---|
| Z | targospeed | Delivery on next working day | serviceLevelReference = SPEED |
| S | targospeed 10 | Delivery on next working day by 10:00 | serviceLevelReference = SPEED10 |
| E | targospeed 12 | Delivery on next working day by 12:00 | serviceLevelReference = SPEED12 |
| X | targospeed plus | Delivery on next working day. (only after consultation with responsible DACHSER-branch) | serviceLevelReference = SPEEDPLUS |
| V | targofix | Delivery on a given date. | serviceLevelReference = FIXDAY |
| R | targofix 10 | Delivery on a given date by 10:00. | serviceLevelReference = FIX1000 |
| W | targofix 12 | Delivery on a given date by 12:00. | serviceLevelReference = FIX1200 |
| Y | targoflex | Delivery within the scope of standard transit time (generally within 2 working days) | serviceLevelReference = FLEX |
| A | targo on-site | Delivery “free kerb side” beside the truck at the consignee exclusively for free house terms. A delivery appointment has to be agreed with the consignee. The required contact information have to be specified within the corresponding fields (according to the data format). | serviceLevelReference = ONSITENote if EU-Cross-Border, only incoterm 084 is allowed |
| B | targo on-site plus | Delivery in 1-man-handling “free delivered to maximum one customer specified unloading point” at the consignee. A delivery appointment has to be agreed with the consignee. The required contact information have to be specified within the corresponding fields (according to the data format). | serviceLevelReference = ONSITEPLUS |
| N | classicline | Delivery wthin the scope of transit time beyond the limits of the entargo countries. | serviceLevelReference = CLASSIC |
The following Service Levels are exclusively used by Dachser food division
| Dachser Service Code | Service Name | Description | Trigger |
|---|---|---|---|
| E | vengospeed | Transit times according to km distance radii around the outbound terminal (DACHSER branch office or partner). Germany-wide 24 h (exception Stavenhagen). | serviceLevelReference = VENGO |
| S | vengospeed 11 | Delivery within the vengospeed transit times by 11:00 a.m. | serviceLevelReference = VENGO11 |
| N | vengoflex | ”Basic product for Europe. Valid for the countries: D, A, CH, H, LUX, B und NL. Delivery within the scope of standard transit times.” | serviceLevelReference = VENGOFLEXShipFrom country DE, AU, CH, HU, LU , BE or NL |
| K | vengoflex | Valid for remaining European countries (not listed under N). Delivery within the scope of standard transit times | serviceLevelReference = VENGOFLEXShipFrom country not included in N |
| Q | vengofix | Delivery on a defined date (without exact time of the day – at least two upcoming working days). The required delivery appointment has to be specified in the corresponding fields (according to the data format). On non-national public holidays, a separate agreement with the responsible outbound terminal (DACHSER branch office or partner) is required. | serviceLevelReference = VENGOFIX |
| X | vengospeed plus | For specific requirements (Saturday deliveries, extra tours, Sunday and holiday deliveries). This product demands a bilateral agreement with the outbound terminal (DACHSER branch office or partner) in advance. | serviceLevelReference = VENGOPLUS |
| I | weekend service | Collection of goods on Saturday, delivery within the vengospeed transit times. Valid for the countries: D, A, B, NL, LUX, DK, PL. Only after prior advice and bilateral agreement with the outbound terminal (DACHSER branch office or partner). Not valid for collection orders. | serviceLevelReference = WEEKEND |
| L | weekend service 11 | Collection of goods on Saturday, delivery within the vengospeed transit times by 11:00 am. Only valid in Germany. Only after prior advice and bilateral agreement with the outbound terminal (DACHSER branch office or partner). Not valid for collection orders. | serviceLevelReference = WEEKEND11 |
Services (Text Types)
Overview of implemented special services for Dachser
| Dachser Text Type | Description | Trigger |
|---|---|---|
| AC | Phone delivery notification (AC). A manual call by the short distance driver, approximately 1 hour before the delivery (e.g: Mrs Meier / Tel: 015200000012) | serviceOptions.preAdviceDelivery.useDriverPhone == true |
| AG | Authorized delivery (issued by the consignor) - Use only in consultation with the responsible DACHSER branch - The use of the text type “AG” is not permitted for shipments with customs goods, dangerous goods and in the Food Logistics business unit | serviceOptions.signatureForDelivery == noSignatureRequired |
| AP | Automated booking-in by SMS/email (name and mobile number or mail address of the contact person) | serviceOptions.appointmentForDelivery |
| AS | Notification by SMS/email (e.g: notification by SMS to tel. mobile number 015200000012 is required). | serviceOptions.preAdviceDelivery.useSms== true |
| AT | Phone delivery booking. Personal phone booking (e.g.: Mrs. Meier, Tel: 015200000012) | Not implemented (use Text Type AP) |
| CB | Automated collection booking (e.g.: Book with Mrs. Meier by mail before collection, E-Mail: meier@booking.com) | instructions.carrierInstructions.collection populated |
| CN | Automated collection notification (e.g.: Notify Mrs. Meier before collection, E-Mail: meier@notify.com) | Not supported |
| GE | Dangerous goods (e.g. : Subject to small amount regulations) | dangerous goods items populated in handlingUnit |
| GS | Dangerous goods special information. In case of special regulations additional information in the transport document. Detailed information in the ADR of the respective national language. Just for road shipments in europe | Not implemented |
| RE | Invoice text (text which appears on the later freight invoice) | Dachser Invoice Text in onboarding configuration populated |
| SE | Text content has to be always “Secured” when this text type is used. It identifies a consignment which is transported by the rules of the air security act. | Not implemented |
| SI | Miscellaneous information (e.g.: Pallets not stackable) | instructions.carrierInstructions.transport populated |
| WA | Goods description; Used only by arrangement with the responsible DACHSER-branch | Not implemented |
| WN | C.O.D.; Used only by arrangement with DACHSER IT-centre | Not implemented |
| ZU | Delivery advice (e.g.: Approach with trailer not possible or Goods-receiving-times) | instructions.carrierInstructions.delivery populated |
**For TailLiftRequired use serviceOptions.liftGate.delivery = true
**For ConsigneeCollectionIndicator use serviceOptions.holdForPickup = true
References supported
Dachser provides a placeholder for additional references in the AdditionalReference section of the XML message. The following references are available.
| Dachser reference | Description | Trigger |
|---|---|---|
| 003 | The delivery note number | references.sapDelivery populated |
| 004 | Customized reference | Dachser Custom Reference in onboarding configuration populated |
| 007 | The order number of the consignee | references.customerPurchaseOrder populated |
| 010 | MRN (Movement Reference Number) | references.customsClearanceNumber populated |
| 040 | Storing position reference | Not implemented |
| 046 | Invoice separation criterion | Not implemented |
| 060 | Daily price | Not implemented |
| 070 | Project Code | Not implemented |
| 071 | Process Code | Not implemented |
| 075 | Eircode (represents the postal code system in Ireland) | Not implemented |
| 312 | EKÁER number (only for transports related to Hungary) | Not implemented |
| ITP | IT provider recognition | shipmentCode |
Package Types
Below Dachser package types are supported and can be provided using field handlingUnits.packageTypeCode.
Note Dachser requested us to use code EW for Block Pallet, Euro Pallet and Half Pallet.
| Dachser Id | Dachser name | packageTypeCode |
|---|---|---|
| EW | Block pallet | pallet-100x120-euro |
| VE | Quarter Euro pallet | pallet-60x40-euro |
| HE | Half Euro pallet | pallet-80x60-euro |
| EW | Euro pallet | pallet-80x120-euro |
| EW | Half pallet | pallet-80x60 |
| EU | Pallet undefined | pallet |
| EW | One way pallet non stackable | pallet-oneway |
| BX | Box | box |
| KI | Case | case |
| FL | Botle | bottle* |
| F | Barrel | barrel* |
| DR | Drum | drum* |
| C0 | Chep industrial Pallet 1,2x1m | pallet-100x120-chep |
| C2 | Half Chep Pallet | pallet-60x80-chep |
| C3 | Quarter Chep Pallet | pallet-40x60-chep |
| C1 | Chep Pallet | pallet-80x120-chep |
| B | Bundle | bundle* |
| CR | Crate | crate* |
| E | Pail | pail |
| IB | IBC container | ibc* |
| KA | Can | can* |
| KI | Case | case* |
| KN | Jerri can | jerri* |
| PA | Roll | roll |
| S | Sack | sack |
| TR | Drum | drum* |
| BB | Big bag | bag-flexi |
| AR | Frame | frame |
| TY | Tray | tray* |
| UP | Unpacked | unpacked |
| KK | Plastic Jerri can | jerrican-plastic |
| KH | Customer sterile pallet | pallet-synthentic* |
| ZK | Customs envelope | envelope |
Note: The * indicates that any packageTypeCode that starts with that value is mapped to the Dachser package type.
If you want a different package type mapping or map one of the other available Dachser codes: configure the mapping overwrite in the onboarding configuration.
Tempatures
Temperatures are currently not supported.
ShipitSmarter temperature ranges do not match Dachser temperature ranges.
Field serviceOptions.equipmentTemperature.
| ShipitSmarter temperature code | Description |
|---|---|
| AMBIENT | Temperature range 15,0 °C - 25,0 °C |
| COOLED | Temperature range 2,0 °C - 8,0 °C |
| FROZEN | Temperature range -18,0 °C |
| Dachser temperature code | Description |
|---|---|
| 1 | Temperature range 2,0 °C - 4,0 °C |
| 2 | Temperature range 4,1 °C - 7,0 °C |
| 3 | Temperature range 12,0 °C - 18,0 °C |
| 4 | Room temperature |
Message notes
- ShipitSmarter does not consolidate identic handlingUnits into 1 ShipmentLine. We create 1 ShipmentLine per handlingUnit.