RTV Transport Creation
- ser_hcskb_api
Use Case
A forwarder wants to create and assign transports for RTV (Real-time Visibility) standalone.
What is Real Time Visibility?
Transporeon offers different solutions to increase transparency of transports for all participants – shipper, logistic provider, carrier driver and recipient.
Transporeon receives real-time data from driver’s cabins. Using Transporeon Visibility with connected telematics systems, the drivers can manually or automatically inform all involved participants about the status change and estimated time of arrival.
Transporeon Visibility calculates ETA based on the provided statuses and stations’ geolocations. Statuses and ETA data are visible in a user-friendly web browser application or can be transferred via the interface back
Description
The Direct Match assignment method is used: It 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 |
Transport_assignment DTO
Attribute | Description | Type (Length) | Example | |
|---|---|---|---|---|
carrier_creditor_number | Carrier creditor number | CHAR(50) | CARRIER01 | |
currency | Currency of the transport price | CHAR(3) | EUR | |
decline_reason_qualifier | Identifier of the transport decline reason for Direct Match | CHAR(100) | transport.declined | |
link | Link to the transport in Transport Execution module, Transporeon UI. Login and password are required to see the transport. | CHAR(100) | ||
number | Transport number | CHAR(50) | ABC123 | |
price | Transport price | FLOAT Â Â Â Â Â Â Â Â Â Â Â | 299.99 | |
status | Indicates if the transport has been accepted by the carrier | CHAR(20) | ACCEPTED | |
timestamp | Timestamp (UTC+offset) | CHAR(29) | 2021-12-19T14:16:28.000+01:00 | |
transport_id | Internal transport identifier | INTEGER64 | 669627623 | |
type | Assignment type | CHAR(3) | NTO | |
Â