Freight publication

Freight pub­li­ca­tions are used to inform poten­tial con­trac­tors that you have car­go (one or more ship­ments) avail­able for trans­port. Short def­i­n­i­tions of terms:
Freight – a trans­port job / car­go offer that includes ship­ment details such as route, dates, require­ments, and price.
Pub­li­ca­tion – the act of pub­lish­ing a freight offer, i.e. mak­ing it vis­i­ble on the plat­form or send­ing it to select­ed car­ri­ers for accep­tance or rejec­tion.

You can send the pub­li­ca­tion

  • direct­ly to per­sons — users on Trans.eu Plat­form,
  • to select­ed com­pa­nies,
  • using matched automa­tion rules pre­vi­ous­ly cre­at­ed at Plat­form
  • to pri­vate freight exchange
  • to Trans.eu Freight Exchange.

With a pub­li­ca­tion API requests (POST method), you can cre­ate a freight and pub­lish it at the same time. It is also pos­si­ble to cre­ate a freight with­out pub­lish­ing it using the same method. A freight only cre­at­ed can­not be pub­lished by API method, it can be pub­lished from the Trans.eu Plat­form. It is also pos­si­ble to pub­lish a pre­vi­ous­ly cre­at­ed freight using the PUT method, but it is nec­es­sary to enter all the freight para­me­ters again.
If a freight was not pub­lished, it is not vis­i­ble to oth­er Trans.eu users, even users from your own com­pa­ny.

For a freight to be suc­cess­ful­ly pub­lished it has to meet sev­er­al cri­te­ria:

  • the pub­lish para­me­ter must be set to true
  • if a freight is being pub­lished to select­ed com­pa­nies or direct per­sons, at least one of com­pa­ny or per­sons id’s must be valid
  • if freight is being pub­lished using automa­tion rules, at least one automa­tion rule cre­at­ed and active at Plat­form must be matched with freight pub­li­ca­tion details
  • all dates must be greater or equal today

The rules for cre­at­ing freight are described in Freight cre­ation.

Webhooks

When request­ing the freight pub­li­ca­tion, you can spec­i­fy the callback_url address to receive noti­fi­ca­tions about changes in the sta­tus of the cre­at­ed freight and changes in the sta­tus of the pub­li­ca­tion — see details and noti­fi­ca­tion list

Publication statuses

Val­ues ​​returned in the publication_status field

Pub­li­ca­tion sta­tusDescrip­tion
nullNo sta­tus for freight before pub­li­ca­tion
activeWhen the freight is being pub­lished
fin­ishedWhen pub­li­ca­tion has been com­plet­ed
offers_timeoutWhen the decision_date has passed and there are offers from car­ri­ers (the pub­li­ca­tion is not fin­ished yet)
waiting_for_publicationWhen publish_date in future was giv­en dur­ing pub­li­ca­tion request
Publication end reasons

Val­ues ​​returned in the end_reason field

End rea­sonDescrip­tion
accept­edAccep­tance of the car­ri­er’s offer
can­celedCan­cel­ing an ongo­ing pub­li­ca­tion
reject­edAll car­ri­ers’ offers were reject­ed
time­outFreight pub­li­ca­tion time has expired (after the last unload­ing date) and there were no offers from car­ri­ers
regulations_violatedThe deci­sion to can­cel the freight was made by Trans.eu
company_blockedThe pub­lish­ing com­pa­ny has been blocked on the Trans.eu Plat­form
company_removed_from_exchangeThe pub­lish­ing com­pa­ny has lost its autho­riza­tion to pub­lish on pri­vate exchange
fail­ureInter­nal sys­tem error
Dedicated Requests
Link to detailsShort descrip­tionRequest
Pub­li­ca­tion to Trans.eu Freight ExchangeAllows you to pub­lish a new freight on pub­lic exchange — Trans.eu Freight ExchangePOST /ex­t/freights-api/v1/freight-exchange
Pub­li­ca­tion to pri­vate exchangeAllows you to pub­lish a new freight on own pri­vate exchange.POST /ex­t/freights-api/v1/pri­vate-exchange
Pub­li­ca­tion to brand­ed pri­vate exchangeAllows you to pub­lish a new freight on brand­ed pri­vate exchanges to which you have accessPOST /ex­t/freights-api/v1/freight-cor­po­rate
Pub­li­ca­tion to mul­ti exchangesAllows you to pub­lish a new freight simul­ta­ne­ous­ly to many recip­i­ents at the same timePOST /ex­t/freights-api/v2/freights
Pub­li­ca­tion using automa­tion rulesAllows you to pub­lish a new freight using rules defined at Trans.eu Plat­formPOST /ex­t/freights-api/v1/freight-auto
Pub­li­ca­tion to select­ed part­nersAllows you to pub­lish a new freight to select­ed part­nersPOST /ex­t/freights-api/v1/freight-com­pa­nies
Pub­li­ca­tion direct­ly to per­sonsAllows you to pub­lish a new freight direct­ly to select­ed per­sonsPOST /ex­t/freights-api/v1/freight-employ­ees
Refresh pub­li­ca­tionAllows you to push active freight to top of the freight offers list on exchange with­out hav­ing to cre­ate a new freightPUT /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
Can­cel pub­li­ca­tionAllows you to can­cel active freight pub­li­ca­tionPOST /ext/freights-api/v1/cancelPublication/{freight-id}
Bulk can­cel pub­li­ca­tionsAllows you to can­cel more pub­li­ca­tions in one timePOST /ex­t/freights-api/v1/­cancelPub­li­ca­tion