Transport Assignment Spot Match
- ser_hcskb_api
Use Case
A forwarder wants to requests spot offers for a particular transport from all carriers of their network.
Description
Assignment Request
The Spot Match assignment method allows a forwarder to publish a transport to a group of carriers and ask for their offers. The forwarder can then select one offer.
This mode of transport assignment is usually used for Spot business.
The forwarder can define a reference price as guideline for the carriers. The forwarder must choose the currency in which they want to receive bids in. The forwarder can set an offer deadline.
When carriers provide offers, they can set an acceptance deadline.
As soon as the forwarder accepted one offer, the transport is assigned to this carrier at the freight rate provided in the offer. All other bidding carriers see the transport as “Not received”.
The forwarder can receive the carrier offers via offer DTO, either for a particular transport or all offer DTOs generated upon actions on Transporeon platform after the last outbound pull/push
When you have selected the best offer, send accept_offer DTO to Transporeon
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.
POST /v2/accept_offer Pushes accepting offers for asynchronous processing.
GET /v2/offers Returns all offers of a transport
GET /v2/offers/pull Pulls all offers which were created, modified or withdrawn since the last poll.
Transport Order DTOs (DTOs for Forwarders) are used to publish transports.
Relevant Fields from Transport Order
Attribute | Description | Type (Length) | Example | Mandatory |
|---|---|---|---|---|
number | Transport number, unique | CHAR(50) | 123456 | True |
status | Transport status: BC (Spot Match) | CHAR (3) | BC | True |
carrier_creditor_number | Must be empty | CHAR(50) |
| False |
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 |
Accept_offer DTO
When you have selected the best offer, send accept_offer DTO to Transporeon.