Overview Interfaces
Â
Assigned Transports Interface
Transports
Transport data are exported
After assignment (Best Carrier)
After acceptance (No-Touch Order)
On any relevant change1 after the transport has been assigned or accepted
1 Relevant change is defined as a change of any field mapped in the export format, except system timestamps and fields associated with control flow logic not representing changes of actual contents.
In addition to the Transporeon standard data formats and API servers, we also support exporting data in Soloplan format.
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
Tour | Transport data | Outbound |
File name pattern for outbound files:
#{yyyyMMddHHmmss}_#{Customer Number}_[#{Shipper Id}_]#{Transporeon Id}_#{Transport Number of Shipper}_#{Event Qualifier}_#{Sequence Number}.xml
Note, the {Shipper Id} part is optional. It can be enabled on request.
Attachments
The Assigned Transports Interface also includes the export of attachments (files). Usually we only export metadata, but also the export of the actual files can be enabled.
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
Attachment (Outbound) | Attachment (File) metadata + data optional | Outbound |
File name pattern for outbound files:
#{yyyyMMddHHmmss}_#{Customer Number}_[#{Shipper Id}_]#{Transporeon Id}_#{Transport Number of Shipper}_#{Event Qualifier}_#{Sequence Number}.xml
Note, the {Shipper Id} part is optional. It can be enabled on request.
Attachment Upload Interface
The Attachment upload interfaces includes attachments (files) upload on transport level and delivery level to the Transporeon Platform.
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
Attachment (Inbound) | Attachment upload | Inbound | |||
Delete Attachment | Delete attachments | Inbound |
Booked Time Slots Interface
An export is generated by Transporeon whenever one of the below listed events for a booking occurs. A qualifier that specifies the event is included in the Transporeon standard XML export file. See DTO description for further details.
Events:
A booking has been created by the carrier (booking.created)
A booking has been updated by the shipper or carrier (booking.modified)
A booking has been cancelled by the shipper or carrier (booking.cancelled)
A reservation has been created
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
Booking | Time slot management (industries and retail) booking | Outbound |
File name pattern for outbound files:
#{yyyyMMddHHmmss}_#{Customer Number}_[#{Shipper Id}_]#{Booking number}_#{Transporeon Id}_#{Transport Number of Shipper}_#{Event Qualifier}_#{Sequence Number}.xml
Note, the {Shipper Id} part is optional. It can be enabled on request.
Attachments
The Booked Time Slots Interface also includes the export of attachments (files). Usually we only export metadata, but also the export of the actual files can be enabled.
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
Attachment (Outbound) | Attachment (File) metadata + data optional | Outbound |
File name pattern for outbound files:
#{yyyyMMddHHmmss}_#{Customer Number}_[#{Shipper Id}_]#{Transporeon Id}_#{Transport Number of Shipper}_#{Event Qualifier}_#{Sequence Number}.xml
Note, the {Shipper Id} part is optional. It can be enabled on request.
Event Management Interface
Event Management Interface includes sending event management data on transport level and delivery level to the Transporeon Platform.
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
ProcessStatus | Event Management event | Inbound | |||
ProcessStatus | Event Management Event | Outbound |
Loading Commission Printout Interface
This interface provides exports of the loading commission of assigned transports from Transporeon-Web for carriers in PDF format.
An export file is generated by Transporeon whenever one of the below listed events occurs.
Events:
A transport has been assigned to the carrier by the shipper
A transport has been accepted by the carrier
A transport has been modified by the shipper
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
File | PDF file export | Outbound | n/a |
File name pattern for outbound files:
#{yyyyMMddHHmmss}_#{Transporeon Id}_#{Transport Number of Shipper}_#{Event Qualifier}_#{Customer Number of Shipper}_#{Sequence Number}.pdf
Offer Placement and Transport Acceptance Interface
Transports
You receive transports for the following purposes:
Best-Carrier transports for offer placement
No-Touch-Order transports for acceptance
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
Tour | Transport data | Outbound |
File name pattern for outbound files:
#{yyyyMMddHHmmss}_#{Customer Number}_[#{Shipper Id}_]#{Transporeon Id}_#{Transport Number of Shipper}_#{Event Qualifier}_#{Sequence Number}.xml
Note, the {Shipper Id} part is optional. It can be enabled on request.
Offer Placement
Offer placement includes the following processes:
Placing offers
Withdrawing offers
Declining offers
Placing a change request
Cancelling a change request
Getting change request acceptance
Getting change request decline
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
Offer | Place a Best Carrier offer | Inbound | |||
WithdrawOffer | Withdraw an Best Carrier offer | Inbound | |||
DeclineOffer | Decline a offer transport | Inbound |
Transport Acceptance
Transport acceptance includes the following processes:
Accepting no-touch order transports
Declining no-touch order transports
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
AcceptTransport | Accept a No-Touch Order | Inbound | |||
DeclineTransport | Decline a No-Touch Order | Inbound |
Change Requests
With this DTO you can request certain changes for transports or deliveries / orders.
The shipper can then either accept or decline your change requests.
Afterwards you will receive feedback about their decision.
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
ChangeRequest | Send a change request to the shipper | Inbound | |||
DeleteChangeRequest | Cancel a change request | Inbound | |||
ChangeRequestAccepted | Change request has been accepted by the shipper | Outbound | |||
ChangeRequestDeclined | Change request has been declined by the shipper | Outbound |
File name pattern for outbound files:
#{yyyyMMddHHmmss}_#{Customer Number}_[#{Shipper Id}_]#{Transporeon Id}_#{Transport Number of Shipper}_#{Event Qualifier}_#{Sequence Number}.xml
Note, the {Shipper Id} part is optional. It can be enabled on request.
Creation of Shipments
This interface provides the possibility to create shipments for a shipper. Depending on individual business processes, the shipper can accept or decline such shipments.
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
Transport | Transport details. This is the main document for transports. It contains all relevant information for a transport. It also contains a list of deliveries. | Inbound | |||
Delivery | Delivery details. This is the main document for deliveries. It contains all relevant information for a delivery. | Inbound | |||
Shipment Confirmation | Confirmations by the shipper for shipments that have been created in the carrier system and sent to the shipper. It also provides the generated Transporeon IDs (Identifiers) of the Transport and Delivery objects, which are needed for subsequent API calls. | Outbound |
Surcharge Interface
Surcharge interface provides the following functionalities:
Request surcharges
Receive data for surcharge requests that have been accepted or declined by the shipper.
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
PriceItem | Surcharge item | Outbound | |||
PriceItem | Surcharge item | Inbound |
File name pattern for outbound files:
#{yyyyMMddHHmmss}_#{Customer Number}_[#{Shipper Id}_]#{Transporeon Id}_#{Event Qualifier}_#{Sequence Number}.xml
Note, the {Shipper Id} part is optional. It can be enabled on request.
Transport Data Editing Interface
This interface provides
Editing transport, delivery / order and delivery / order item parameters, which are allowed and requested to edit by shipper
The parameters which can be updated are defined by the shipper. Editable parameters are marked accordingly within the Assigned Transports interface. For more details please refer to Assigned transports interface documentation.
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
ParameterUpdate | Incremental updates of Parameters | Inbound | |||
DeliveryItemUpdate | Incremental updates of Delivery Items | Inbound |
Settlements
Settlements includes the following processes:
Accepting an existing settlement
Declining an existing settlement
Displaying a list of settlements
DTO | Description | Directions | Documentation | OpenApi | XSD |
---|---|---|---|---|---|
AcceptSettlement | Accept a Settlement | Inbound | |||
DeclineSettlement | Decline a Settlement | Inbound | |||
Settlement | Settlement data | Outbound |