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

DTO

Description

Directions

Documentation

OpenApi

XSD

Tour

Transport data

Outbound

Tour

GET /v1/transport

TransportToTour.xsd

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

DTO

Description

Directions

Documentation

OpenApi

XSD

Attachment (Outbound)

Attachment (File) metadata + data optional

Outbound

Attachment (CI, Outbound)

GET /v1/attachment

Attachment_out.xsd

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

DTO

Description

Directions

Documentation

OpenApi

XSD

Attachment (Inbound)

Attachment upload

Inbound

Attachment (CI, Inbound)

PUT /v1/attachment

Attachment_in.xsd

Delete Attachment

Delete attachments

Inbound

Delete Attachment (CI, Inbound)

POST /v1/attachment/delete

Delete_Attachment.xsd

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

DTO

Description

Directions

Documentation

OpenApi

XSD

Booking

Time slot management (industries and retail) booking

Outbound

Booking (TSMBooking2Carrier)

GET /v1/booking

TsmBookingToCarrierBooking.xsd

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

DTO

Description

Directions

Documentation

OpenApi

XSD

Attachment (Outbound)

Attachment (File) metadata + data optional

Outbound

Attachment (CI, Outbound)

GET /v1/attachment

Attachment_out.xsd

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

DTO

Description

Directions

Documentation

OpenApi

XSD

ProcessStatus

Event Management event

Inbound

ProcessStatus (CI, Inbound)

PUT /v1/status

TV_Request_PutStatus.xsd

ProcessStatus

Event Management Event

Outbound

ProcessStatus (CI, Outbound)

GET /v1/status

ProcessStatus.xsd

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

DTO

Description

Directions

Documentation

OpenApi

XSD

File

PDF file export

Outbound

File (CI, Outbound)

GET /v1/files

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

DTO

Description

Directions

Documentation

OpenApi

XSD

Tour

Transport data

Outbound

Tour

GET /v1/transport

TransportToTour.xsd

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

DTO

Description

Directions

Documentation

OpenApi

XSD

Offer

Place a Best Carrier offer

Inbound

Offer (CI, Inbound)

PUT /v1/offer

BC_Request_PlaceOffer.xsd

WithdrawOffer

Withdraw an Best Carrier offer

Inbound

Withdraw Offer

POST /v1/bc/withdraw

BC_Request_WithdrawOffer.xsd

DeclineOffer

Decline a offer transport

Inbound

Decline Offered Transport

POST /v1/bc/decline

DeclineTransport.xsd

Transport Acceptance

Transport acceptance includes the following processes:

  • Accepting no-touch order transports

  • Declining no-touch order transports

DTO

Description

Directions

Documentation

OpenApi

XSD

DTO

Description

Directions

Documentation

OpenApi

XSD

AcceptTransport

Accept a No-Touch Order

Inbound

Accept Transport

PUT /v1/nto/accept

NTO_Request_Accept.xsd

DeclineTransport

Decline a No-Touch Order

Inbound

Decline Transport

PUT /v1/nto/decline

DeclineTransport.xsd

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

DTO

Description

Directions

Documentation

OpenApi

XSD

ChangeRequest

Send a change request to the shipper

Inbound

Change Request

POST /v1/nto/change/request

ChangeRequest.xsd

DeleteChangeRequest

Cancel a change request

Inbound

Delete Change Request

POST /v1/nto/change/revoke

DeleteChangeRequest.xsd

ChangeRequestAccepted

Change request has been accepted by the shipper

Outbound

Change Request Accepted

GET /v1/nto/change/accepted

ChangeRequestAccepted.xsd

ChangeRequestDeclined

Change request has been declined by the shipper

Outbound

Change Request Declined

GET /v1/nto/change/declined

ChangeRequestDeclined.xsd

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

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

Tour (Cl, Inbound)

POST /v1/transport

DELETE /v1/transport/{shipperId}/{number}

Transport.xsd

CancelTransport.xsd

Delivery

Delivery details. This is the main document for deliveries. It contains all relevant information for a delivery.

Inbound

Shipment Confirmation (Cl, Inbound)

POST /v1/delivery

DELETE /v1/delivery/{shipperId}/{number}

TransportDelivery.xsd

Cancel Delivery.xsd

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

Shipment Confirmation (Cl, Outbound)

GET /v1/shipmentconfirmation

shipment_confirmation.xsd

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

DTO

Description

Directions

Documentation

OpenApi

XSD

PriceItem

Surcharge item

Outbound

Price Item (CI, Outbound)

GET /v1/priceitem

PriceItem.xsd

PriceItem

Surcharge item

Inbound

Price Item (CI, Inbound)

POST /v1/priceitem

PriceItem.xsd

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

DTO

Description

Directions

Documentation

OpenApi

XSD

ParameterUpdate

Incremental updates of Parameters

Inbound

Parameter Update

PUT /v1/parameter

ParameterUpdate.xsd

DeliveryItemUpdate

Incremental updates of Delivery Items

Inbound

Delivery Item Update

PUT /v1/deliveryitem

DeliveryItemUpdate.xsd

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

DTO

Description

Directions

Documentation

OpenApi

XSD

AcceptSettlement

Accept a Settlement

Inbound

Accept Settlement (CI, Inbound)

POST /v1/settlement/accept

AcceptSettlement.xsd

DeclineSettlement

Decline a Settlement

Inbound

Decline Settlement (CI, Inbound)

POST /v1/settlement/decline

DeclineSettlement.xsd

Settlement

Settlement data

Outbound

Settlement (CI, Outbound)

GET /v1/settlement

Settlement.xsd

See also