Freight publications are used to inform potential contractors that you have cargo (one or more shipments) available for transport. Short definitions of terms:
Freight – a transport job / cargo offer that includes shipment details such as route, dates, requirements, and price.
Publication – the act of publishing a freight offer, i.e. making it visible on the platform or sending it to selected carriers for acceptance or rejection.
You can send the publication
- directly to persons — users on Trans.eu Platform,
- to selected companies,
- using matched automation rules previously created at Platform
- to private freight exchange
- to Trans.eu Freight Exchange.
With a publication API requests (POST method), you can create a freight and publish it at the same time. It is also possible to create a freight without publishing it using the same method. A freight only created cannot be published by API method, it can be published from the Trans.eu Platform. It is also possible to publish a previously created freight using the PUT method, but it is necessary to enter all the freight parameters again.
If a freight was not published, it is not visible to other Trans.eu users, even users from your own company.
For a freight to be successfully published it has to meet several criteria:
- the publish parameter must be set to
true - if a freight is being published to selected companies or direct persons, at least one of company or persons id’s must be valid
- if freight is being published using automation rules, at least one automation rule created and active at Platform must be matched with freight publication details
- all dates must be greater or equal today
The rules for creating freight are described in Freight creation.
Webhooks
When requesting the freight publication, you can specify the callback_url address to receive notifications about changes in the status of the created freight and changes in the status of the publication — see details and notification list
Publication statuses
Values returned in the publication_status field
| Publication status | Description |
| null | No status for freight before publication |
| active | When the freight is being published |
| finished | When publication has been completed |
| offers_timeout | When the decision_date has passed and there are offers from carriers (the publication is not finished yet) |
| waiting_for_publication | When publish_date in future was given during publication request |
Publication end reasons
Values returned in the end_reason field
| End reason | Description |
| accepted | Acceptance of the carrier’s offer |
| canceled | Canceling an ongoing publication |
| rejected | All carriers’ offers were rejected |
| timeout | Freight publication time has expired (after the last unloading date) and there were no offers from carriers |
| regulations_violated | The decision to cancel the freight was made by Trans.eu |
| company_blocked | The publishing company has been blocked on the Trans.eu Platform |
| company_removed_from_exchange | The publishing company has lost its authorization to publish on private exchange |
| failure | Internal system error |
Dedicated Requests
| Link to details | Short description | Request |
| Publication to Trans.eu Freight Exchange | Allows you to publish a new freight on public exchange — Trans.eu Freight Exchange | POST /ext/freights-api/v1/freight-exchange |
| Publication to private exchange | Allows you to publish a new freight on own private exchange. | POST /ext/freights-api/v1/private-exchange |
| Publication to branded private exchange | Allows you to publish a new freight on branded private exchanges to which you have access | POST /ext/freights-api/v1/freight-corporate |
| Publication to multi exchanges | Allows you to publish a new freight simultaneously to many recipients at the same time | POST /ext/freights-api/v2/freights |
| Publication using automation rules | Allows you to publish a new freight using rules defined at Trans.eu Platform | POST /ext/freights-api/v1/freight-auto |
| Publication to selected partners | Allows you to publish a new freight to selected partners | POST /ext/freights-api/v1/freight-companies |
| Publication directly to persons | Allows you to publish a new freight directly to selected persons | POST /ext/freights-api/v1/freight-employees |
| Refresh publication | Allows you to push active freight to top of the freight offers list on exchange without having to create a new freight | PUT /ext/freights-api/v1/freights/{freight-id}/refresh_publication PUT /ext/corporate-exchange-api/v1/corporate-exchange/{freight-id}/refresh-publication PUT /ext/private-exchange-api/v1/exchange/{freight-id}/refresh-publication |
| Cancel publication | Allows you to cancel active freight publication | POST /ext/freights-api/v1/cancelPublication/{freight-id} |
| Bulk cancel publications | Allows you to cancel more publications in one time | POST /ext/freights-api/v1/cancelPublication |