Price offer negotiation

The API enables nego­ti­a­tion of the terms of car­riage for a pub­lished freight. Nego­ti­at­ing par­ties can agree on the price for the order and, in the case of mul­ti-freight ship­ments, the quan­ti­ty of goods to be trans­port­ed.

Negotiation flow and available actions

1. Nego­ti­a­tions are ini­ti­at­ed by a car­ri­er inter­est­ed in a freight offer (the nego­ti­a­tion par­tic­i­pant). The par­tic­i­pant selects one of the con­tact per­sons assigned to the freight (the nego­ti­a­tion own­er) and sub­mits a pro­posed offer price.
   Cur­rent­ly, car­ri­ers can nego­ti­ate via API only direct offers, part­ners offers, and fixed-route offers. Nego­ti­at­ing exchange offers is avail­able to car­ri­ers only on the Trans.eu Plat­form.
   
2. The user des­ig­nat­ed for nego­ti­a­tion on the publisher’s side (the nego­ti­a­tion own­er) can accept the offer, pro­pose a new offer price, reject the carrier’s offer or end the nego­ti­a­tion with the car­ri­er.
   Before the nego­ti­a­tion own­er takes any action, the nego­ti­a­tion par­tic­i­pant may with­draw their offer.
   
3. If the nego­ti­a­tion own­er pro­pos­es a new price, the nego­ti­a­tion par­tic­i­pant can accept the offer, pro­pose a new offer price, reject the owner’s offer or end the nego­ti­a­tion with this user.
   Before the nego­ti­a­tion par­tic­i­pant responds to the new offer, the nego­ti­a­tion own­er may with­draw their offer.
   
4. If the nego­ti­a­tion par­tic­i­pant accepts the nego­ti­a­tion owner’s offer, the nego­ti­a­tion is final­ized and the terms are con­firmed only after the nego­ti­a­tion own­er also accepts the participant’s accep­tance.
   In the case of “Buy Now” pub­li­ca­tions, the nego­ti­a­tion par­tic­i­pant can only accept the offered price or end the nego­ti­a­tion. Accep­tance of the offer is final, and no con­fir­ma­tion from the nego­ti­a­tion own­er is required.
   
5. If one par­ty rejects the offer, the oth­er par­ty may restart the nego­ti­a­tion by sub­mit­ting a new price offer.
   
6. End­ing the nego­ti­a­tion by either par­ty pre­vents both sides from restart­ing the nego­ti­a­tion for the giv­en freight (pub­li­ca­tion).
   
7. A nego­ti­a­tion han­dled by the nego­ti­a­tion own­er may be tak­en over by anoth­er employ­ee of the same com­pa­ny, pro­vid­ed they have the appro­pri­ate per­mis­sions. This oper­a­tion is typ­i­cal­ly used when the nego­ti­a­tion own­er is unavail­able and the nego­ti­a­tion needs to be com­plet­ed.

Negotiation endpoints for negotiation owner

A nego­ti­a­tion own­er can retrieve the list of nego­ti­a­tions for a select­ed freight using the Get freight offer list end­point, which pro­vides infor­ma­tion such as the offer ID, nego­ti­a­tion sta­tus and the cur­rent nego­ti­at­ed price.

By pro­vid­ing the offer ID in the Get freight offer details end­point, the user can obtain detailed infor­ma­tion about a spe­cif­ic nego­ti­a­tion, includ­ing the con­tact details of the nego­ti­a­tion par­tic­i­pant and the his­to­ry of actions per­formed by both par­ties.

Using the same offer ID and the cur­rent nego­ti­a­tion step (“ver­sion num­ber”) returned by one of the above end­points, the user can per­form a nego­ti­a­tion action avail­able for the cur­rent nego­ti­a­tion action type — all end­points are list­ed in the table below.

Negotiation requests dedicated to the negotiation owner

Negotiations endpoints for negotiations participant

Once the nego­ti­a­tions starts, the par­tic­i­pat­ing user can obtain detailed infor­ma­tion about the nego­ti­at­ed freight, the offer ID and the cur­rent price offer request­ing Get freight pro­pos­al end­point.

Using the offer ID and the cur­rent nego­ti­a­tion step (“ver­sion num­ber”) returned by the above end­point, the user can per­form a nego­ti­a­tion action avail­able for the cur­rent “stage” and “sta­tus” val­ues — all end­points are list­ed in the table below.

Negotiation requests dedicated to the negotiation participant