Time Slot Management
- ser_hcskb_api
Â
Process
If a shipper customer uses Time Slot Management module, available time slots for a particular transport are visible for the executing carriers. Carriers optimize their vehicles usage by booking the best available slots.
In case Time slot management is used in combination with Transport execution, the slot booking process starts from creation of a transport.
The flow is as follows:
Open bookings can be created automatically with a transport assignment, see Automatic Open Booking section but they are not mandatory in the process.
If the customer chose to use the functionality, station address information and ramps should be mapped to the locations and gates as a setting in advance. Please, get in touch with Transporeon project team. Time slots can be individually defined on a daily and hourly basis within this locations and gates in Transporeon UI.
Standalone Process
Time slot management can also be used without transport assignment.
For TSM standalone case, open bookings may be created by dedicated import messages or by sending transports to us. Please see the following sub-chapters for more details about both options.
Direct Import of Open Bookings
This is the most direct option to create open bookings. The objects are pushed from your system to us.
Resources
Description | Documentation | OpenApi |
|---|---|---|
Open Bookings | POST /v2/open_bookings |
Open Booking based on Transport Object
You may choose to create open bookings based on the transport object event even though Transport Execution module is not in use. In this case, customer sends transports to Transporeon platform, Transporeon creates open bookings based on the received transports. The transports are not saved.
A possible usage scenario for this mode of operation is that Transport Execution may be introduced at a later stage. This way there are no additional efforts for implementation required.
Open bookings are created for the loading station automatically as soon a transport is received. If the transport contains deliveries with different station addresses or gates (ramp), several bookings will be created.
It is also possible to set up automatic creation of open bookings for unloading stations instead of loading ones or for both types of stations. Please contact the responsible project manager for setting it up.
Please check additional details in section Transport Creation.
Receiving Bookings
When an assigned carrier books a time slot, a booking object is created. Shipper customer can receive all created, changed and deleted bookings. It includes also changes to the booking dispatch status entries, made by an executing carrier or the shipper’s operator in Transporeon UI.
Resources
Description | Documentation | OpenApi |
|---|---|---|
Bookings | GET /v2/bookings/pull |
Dispatch Status
Dispatch status indicate the current status of a booking in the work flow it is representing. Examples would be the truck has been arrived, it is being loaded or it has left the yard. This is displayed in the front-end applications with color codes.
Shipper standard interface includes the possibility to send dispatch status to our system.
Resources
Description | Documentation | OpenApi |
|---|---|---|
Dispatch Status | POST /v2/dispatch_statuses |
Quantity Contracts
Shipper Standard Interface also supports Quantity Contract feature of time slot management.
Resources
Description | Documentation | OpenApi |
|---|---|---|
Quantity Contract | POST /v2/quantity_contracts |
Â