Transport Assignment Direct Match
- ser_hcskb_api
Use Case
A forwarder wants to assign a transport directly to a carrier.
Description
The Direct Match assignment method allows a forwarder to assign a transport directly to one carrier on Transporeon.
The carrier is identified through the carrier creditor number, which the forwarder can freely choose.
This mode of transport assignment is generally based on a previous or frame price agreement with the carrier such as fixed charter.
In the default process the carrier is asked to accept the assignment. The forwarder can specify an acceptance deadline.
The carrier can decline the assignment
If the carrier declines the assignment of the transport or does not react within the given deadline, the forwarder can assign the transport to another carrier. To do so, use the same transport message with a new carrier creditor number. Transporeon will cancel the existing transport and create a new one, assigned to the new carrier. Alternatively, the forwarder can also use Spot or Auto Match
The forwarder can receive the carrier response (accept or decline) via the transport_assignment DTO. You receive a list of transport_assignment DTOs, generated upon actions on Transporeon platform after the last outbound pull/push
Visual Illustration
Steps and API References
Resources
POST /v2/transport_orders Pushes transport orders for asynchronous processing.
POST /v2/orders Pushes orders for asynchronous processing.
GET /v2/transport_assignments/pull Pulls all transport assignment results which were done since the last poll.
Transport Order DTOs (DTOs for Forwarders) are used to assign transports.
Relevant Fields from Transport Order
Attribute | Description | Type (Length) | Example | Mandatory |
|---|---|---|---|---|
number | Transport number, unique | CHAR(50)       | 123456 | True |
status | Transport status: NTO Â Â Direct Match | CHAR (3) | NTO | True |
carrier_creditor_number | Creditor number of an assigned carrier. It can be freely chosen by the forwarder (e.g. same as in the forwarder's TMS) During implementation, Transporeon will set-up the forwarder's creditor numbers on the platform. | CHAR(50) | CARRIER123 | True |
Relevant Fields from Order
Attribute | Description | Type (Length) | Example | Mandatory |
|---|---|---|---|---|
number | Order / Delivery number, unique | CHAR(50) | D123 | True |
status | N Â Â Create | CHAR(1) | N | True |
Â