- Who can: any member of the brand. Bidding is for carriers.
- Where in Cargofy: LoadHub
What it is
LoadHub is the board of loads. The assistant reads it, places your bid on a tender and withdraws it. It cannot book a load or send an offer by email.
The assistant sees the same loads your brand sees on LoadHub.
What it can do
Find a load and bid, from start to finish
A carrier dispatcher’s conversation with the assistant. Cities, dates and rates are examples. The terms are in the Glossary.
1. Find the loads
Which loads on LoadHub start in Odesa this week?
Answer: two loads Odesa → Kharkiv with pickup on November 18. The assistant matches the city in any spelling, “Odesa” or “Одеса”.
2. Compare the rates
Compare their rates.
The assistant ranks the loads with a rate from the lowest to the highest and names the loads without one. It does not convert currencies.
3. Narrow it down
Any loads from Kyiv to Lviv with a rate in UAH?
Answer: one load Kyiv → Lviv at 25,000 UAH, and the loads on that route without a rate.
4. Check what you did not see
Is that every load on the board?
Answer: the assistant asked for 50 loads and got 13, so you saw them all.
5. Bid
Bid 29,500 UAH on TFY000000001.
Answer: the bid is placed, 29,500 UAH. A price the tender’s rules do not allow comes back with the reason, for example “The bid must not exceed the starting price.”
6. Withdraw the bid
Withdraw our bid on TFY000000001.
Answer: the bid is withdrawn.
| Step | Tool | What the assistant sends |
|---|---|---|
| 1 | loadboard-list | limit 50 |
| 5 | loadboard-place-bid | load TFY000000001, price 29500, currency “UAH” |
| 6 | loadboard-retract-bid | load TFY000000001 |
Read the board and pick loads
Show me the newest loads on LoadHub. Which ones go to Poland and pick up after November 20?
The assistant reads up to 50 loads at once, the newest first, and picks the ones that match your city, pickup date, rate or currency. Fewer loads than it asked for means you saw them all. Each load has:
| What | How it comes |
|---|---|
| Origin and destination | As the load’s author wrote them: a city or a full street address, in Latin or Cyrillic |
| Pickup date | The start of the pickup window, in UTC: Kyiv time is 2 hours later in winter, 3 in summer. Ask the assistant to show your time |
| Rate and currency | Empty when no rate is set |
Bid on a tender
Bid 1,200 EUR on the Dnipro → Wrocław load.
Name the tender number (TFY…) or point to a load the assistant found on the board. The price is the total for the trip, in the tender’s currency; nothing is converted. When you name a currency, the assistant passes it as a check: a currency other than the tender’s is refused, and nothing is placed. Bidding again changes your price.
The bid follows the tender’s rules. A refusal comes with the reason to tell you, for example:
- “The bid must not exceed the starting price.”
- “Bids on this load are closed.”
- “No tender found for this number.”
Withdraw a bid
Withdraw our bid on TFY000000001.
The assistant withdraws your brand’s bid. A tender can close the window for withdrawing; then the answer says so.
Glossary
The words of this page and the names the assistant works with. You can paste this table into the chat so the assistant uses the same words.
| Term | Meaning | The assistant sees |
|---|---|---|
| LoadHub | The board of loads your brand sees | the tool loadboard-list; how many loads to read in limit, 1 to 50, 20 when not given |
| Load | One load on the board | an item of postings, with its ID public_id |
| Origin, destination | Where the load starts and ends | origin, destination |
| Pickup date | The start of the pickup window, in UTC | pickup_from |
| Rate | The price of the load | rate, with currency in lowercase: “uah”, “usd”, “eur” |
| Loads read | How many loads the assistant got, not how many are on the board | count |
| Bid | Your brand’s price for a tender, for the whole trip, in the tender’s currency | loadboard-place-bid: load (TFY… or public_id), price, currency as a check; the answer has ok and, on a refusal, reason |
| Withdraw | Take your bid back | loadboard-retract-bid with load |
Limits
- A load has no country, delivery date, end of the pickup window, distance, weight, body type or contact. The country is known only from the city name.
- The assistant cannot open a load by its ID or book a load.