CargoSteps connection


Contents

Related pages


Notes

  • The implementation of the interface requires, amongst others, a conclusion of a contract between the forwarding company and CargoSteps.

  • Forwarding company and transport company must be registered with CargoSteps.
    The relation between you as the forwarding company and your transport company is established by means of an ID number.
    → The ID needs to be added to the address of the forwarding company, see CargoSteps setup

  • The login details provided by CargoSoft must be made available to CargoSoft for the deposit in the interface.

  • You can only transmit break bulk orders. Containers cannot be commissioned.

  • The interface is currently not able to separate clients and branches.
    Login details can only be stored once per company in the interface.

Technical requirements

  • An application server that is available within the network and that is accessible for CargoSteps via the internet.

We recommend setting up a subdomain (e.g.: http:\\webhook.cargosoft.de) and transfer the incoming traffic to this application server.

For safety reasons this webhook is secured by a basic authentification.

CargoSteps is currently not able to contact the webhook with a fixed IP address.

It is thus not possible to configure exceptions in the firewall so that CargoSteps may only access the webhook.

Send service order to the service provider

The shipment details are transmitted to the CargoSteps web application via the Services tab.

new_image2020-2-20_11-19-10-20240321-145656.png

Addresses can be pre-assigned in the service order.

If there is no preallocation for the automatic transfer of the goods description from the order, switch to the Goods tab and manually accept the goods description.

To send, select the context menu item Send service order on the Overview tab.

new_image2019-9-2_8-6-8-20240321-145709.png

EDI-Log tab

The EDI-Log tab shows whether the sending process (Direction O) on the part of the export interface has been successful.
Possible error messages are displayed on the Log sub tab.
The .xml send file is available on the Details sub tab.

Overview tab

If the interface was able to successfully process the send file, the column Verification on the Overview tab displays a green checkmark.
A red cross is displayed in the event of an error.

The response of the provider (here: CargoSteps) is displayed in the column Provider. 

The response of the service provider (transport ocmpany) is displayed in the column Service provider.

EDI-Status tab

Responses (status events) are also imported into the EDI-Status tab.

The driver can attach a delivery receipt as a photo when sending the status DELIVERED.

eFile tab

The delivery receipt is stored in the eFile of the service order.

The possible statuses are recorded upon configuration of the interface/upon first transmission.

If recorded in the Status events, status messages are also sent via e-mail.

You can also record a status type which creates a status (eastatus_t). 

After you have received a positive response from the service provider, the service order must NOT be sent again.

The functions in the context menu on the Overview tab

  • Release service order (to send an update)

  • Cancel service order

are not processed by the interface.

Â