Places your brand’s bid on a tender: the total for the trip, in the tender’s currency.
- Changes data: yes
- Who can use it: Any member of the brand. Bids are for carriers.
What it is for
- Bid on a tender you found on LoadHub or got an invitation to. See LoadHub.
Example prompts
- “Bid 29,500 UAH on TFY000000001.”
- “Offer 1,200 EUR on the Dnipro → Wrocław load.”
Good to know
loadtakes the tender number (TFY…) or thepublic_idof a load fromloadboard-list. The answer names the tender number.priceis the total for the trip in the tender’s currency. Nothing is converted.currencyis a check, not a choice: pass the currency the user named with the amount, or null when they named none. A currency other than the tender’s is refused, and nothing is placed.- Bidding again on the same tender changes your price.
- A refusal comes back as
ok: falsewith areasonto tell the user. Amounts in it are in the tender’s currency.
Reference
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
load | string | yes | Tender number (TFY…) or the load’s public_id. |
price | number | yes | The total for the trip, in the tender’s currency. |
currency | string or null | yes | The currency the user named with the amount, such as UAH, EUR or USD; null when they named none. |
Returns
ok, and on success load (the tender number), price and currency (the tender’s currency). On a refusal: ok: false, reason and, when known, currency.
Errors
Refusals come in reason, for example:
- “The bid must not exceed the starting price.”
- “The user named EUR, but bids on this tender are in UAH only. Nothing was placed. Ask for the total trip amount in UAH.”
- “Bids on this load are closed.”
- “No tender found for this number.”