Create Copy of Shipper Transport
- ser_hcskb_api
Use Case
A forwarder received a transport from a Transporeon Shipper via the Carrier Interface. The forwarder wants to create a transport in Freight Matching which remains in sync with the shipper transport, and then publish or assign it to carriers.
Description
Forwarders see the transports from their Transporeon shippers in the Freight Matching GUI in "All transport". If they click on "Copy to To do", Freight Matching creates a copy of the original transport. The relationship is stored in the so-called forwarding chain:
Updates of the transport data of the shipper transport (e.g. address change) are propagated automatically to the copy transport
Sensitive information such as transport price between shipper and forwarder, and forwarder and carrier are not. Shippers also don't know who the carrier is and vice-versa.
Visibility information provided by the carrier is automatically propagated back to the shipper.
If a forwarder uses the Transporeon Carrier API to receive the assigned transport in their Transport Management System, they can use this endpoint to directly create a copy of this transport on Transporeon. The transport number must be the same as in the transport from the shipper. This way Transporeon identifies that the two transports are related and creates the forwarding chain.
In the same API call the forwarder can specify how the transport should be published (as Spot or Auto Match) or assigned as Direct Match.
Please note: This endpoint uses different enums in the field status compared to Transport Assignment Direct Match, Transport Assignment Spot Match and Transport Assignment Auto Match
Steps and API References
Resources
POST /v2/freight_matching_forwardings Forward and publish/assign a transport
Relevant Fields from Transport Order
Attribute | Description | Type (Length) | Example | Mandatory |
|---|---|---|---|---|
number | Transport number, must be the same as in the transport from the shipper | CHAR(50) | 123456 | True |
status | Assignment mode, possible values: DIRECTMATCH, SPOTMATCH, AUTOMATCH | String | SPOTMATCH | True |
carrier_creditor_number | Creditor number of an assigned carrier. Must be filled for Direct Match. Must be empty for Auto and Spot Match | CHAR(50) | CARRIER123 | False |
scheduling_unit | scheduling unit. If scheduling unit is not provided, “Standard” scheduling unit is used. | CHAR(100) | Ulm | False |
deadline | A deadline to accept a transport or place an offer. Considered the for Direct, Spot and Auto assignment method | CHAR(25) | 2021-1118T11:30:00+ 03 | False |
price | Transport price. Mandatory for Auto Match | FLOAT | 299.99 | False |
currency | Currency of the transport price Mandatory for Auto Match and must be one of the currencies listed in the Autonomous Procurement Price DTO. | CHAR(3) | EUR | False |
vehicle | Vehicle type, required for the transport Mandatory for Auto Match and must be one of the vehicles listed in the Autonomous Procurement Order details DTO. | CHAR(50) | Jumbo | False |
comment | Comment for transport | CHAR(3000) | My transport comment | False |