Geodis Freight Forwarding Benelux
General
The integatrion is based on on the Geodis SOAP API. For authentication the follwing information must be obtained from Geodis:
- username
- password
- globalId
The initial scope for this integration is AIR and OCEAN. As Geodis indicated that they also accept ROAD shipments the integration might be expanded after delivery of the AIR/OCEAN functionality. Full containers loads cannot be processed with this integration yet. To support this we first need to make sure this is supported in shipping and the data models.
Mapping
Port codes
Geodis only accepts unloccodes (e.g. NLAMS).
For transport mode == AIR
For this type of shipment the IATA code for the origin airport and the destination airport must be provided by the shipper. The IATA codes that are provided will be used together with a ISO A2 countrycode prefix to result in the unlocode. If not present, the shipment bookling will fail with a warning message.
For transport mode == OCEAN
For this type of shipment the unloccode for the origin port and the destination port must be provided by the shipper. If not present, the shipment bookling will fail with a warning message.
Service Codes
| Code | Description | Trigger |
|---|---|---|
| AF1 | AirFast Door to Door | airfast-d2d |
| AO1 | AirFlex AOG D2D | airflex-aog-d2d |
| AP1 | AirFlex Express D2D | airflex-xprs-d2d |
| AS1 | AirSave Door to Door | airsafe-d2d |
| AX1 | AirFlex Door to Door | airflex-d2d |
| CD1 | Courier Documents | not implemented |
| CE1 | Courier Economy | not implemented |
| CX1 | Courier Express | not implemented |
| CX2 | Courier Express 09:00 | not implemented |
| CX3 | Courier Express 12:00 | not implemented |
| RA1 | Rail Transport,Door to Door | not implemented |
| RF1 | Road Fast Door to Door | not implemented |
| RS1 | Road Save Door to Door | not implemented |
| RT1 | Road Door to Door | not implemented |
| SA1 | SeaAir Door to Door | sea-air-d2d |
| SB1 | LCL/ FCL Door to Door | not implemented |
| SF1 | FCL Door to Door | not implemented |
| SL1 | LCL Door to Door | lcl-d2d |
| SU9 | Sea Undefined Free Carrier D2D | not implemented |
| B2C | Courier B2C | not implemented |
Transport Modes
Transport modes adre not included in the request to Geodis, but the are used to validate the Service Types.
| Code | Trigger |
|---|---|
| DD | shipment.incoterms.scope = doorToDoor |
| DP | shipment.incoterms.scope = doorToPort |
| PD | shipment.incoterms.scope = portToDoor |
| PP | shipment.incoterms.scope = portToPort |
PackageType mapping
The carrier gateway package types are mapped to the Geodis packaging type based on keywords. (e.g. all package types containing “pallet” will be mapped to Geodis package type “RUILEURO”.)
Below an overview of the mapping logic. Please note that the order is important. The mapping will be done top to bottom.
| Transuniverse Package Code | Carrier gateway package type code contains: |
|---|---|
| BAG | bag, sack |
| BAL | bal |
| BBG | ibc |
| BND | bundle, spool |
| CAS | case |
| CRT | crate, chest, basket, coffin, container, trunk |
| DR | drum |
| ENV | envelope |
| JR | bottle, cylinder, bin, can, jar, jug, jerrycan, tank |
| OCT | pallet-octabin |
| PLT | pallet |
| REL | reel |
| RLL | roll, tube |
| SET | set |
| SKD | skid |
| TOT | tote |
| BOX | box |
| VR | bulk-solid-grains |
| WCA | case-wooden |
| CTN | not mapped |
| PR | not mapped |
| PCE | not mapped |
| PKG | not mapped |
| UNT | not mapped |
Incoterm codes
Geodis is using the same incoterm codes as Viya. These are only converted from lowercase to upper case.