- Who can: a member of a shipper’s brand. Each action follows your role in the “Entities” group: “Create” and “Update” on shipments, and the actions “Add a carrier bid” and “Finish bidding”.
- Where in Cargofy: Freight Procurement
What it is
The assistant prepares and runs your tenders from a chat. A tender in Cargofy is a shipment: a route, cargo and the rules carriers bid by.
What it can do
A tender from start to finish
A dispatcher’s conversation with the assistant and Cargofy’s real answers. The terms are in the Glossary. The tools behind each step are in the table at the end. Tender numbers on this page are examples.
1. Create the tender
Create a tender from Kyiv to Lviv, Ukraine: pickup the day after tomorrow 07:00–15:00 UTC, delivery a day later 12:00–20:00 UTC, 20 t of building materials, curtainsider, currency UAH. Open it to all carriers, starting price 32,000 UAH, only bids lower than the starting price.
Cargofy saves a draft: TFY000000001, “Draft”, Kyiv - Lviv, 603 km, “Tarpaulin”. A curtainsider is “Tarpaulin” in Cargofy. Auction length and bid step come from your brand’s tender settings.
2. Change the route
Add customs clearance in Chop at 18:00 UTC on the pickup day, between Kyiv and Lviv.
Cargofy recalculates the distance: Kyiv → Chop → Lviv is 1,214 km.
Steps 3 and 4 need a tender in “Matching”, see Limits.
3. Add a bid
Demo: Carrier LLC called: 30,000 UAH for TFY000000001. Add their bid.
The carrier must be confirmed in your network, see Carrier Network. The assistant confirms that the bid is added. A bid of 35,000 UAH, above the starting price, is refused with “The bid must not exceed the starting price.”
4. Close bidding
Close bidding on TFY000000001.
The tender moves to “Awarding”. You can close bidding before the auction length runs out.
5. Follow up
Which of our tenders are in Awarding?
The assistant lists them with number, route and status. With many tenders it shows the newest and the total: narrow the question by creation date or your own code.
| Step | Tool | What the assistant sends |
|---|---|---|
| 1 | entities-schema, then entities-create | shipment with country_id, route, cargo, body type, currency and auction rules. The schema gives the IDs of body types, auction types and bid rules |
| 2 | entities-update | the whole route in order: city, type, date and coordinates (lat, lng) of every point from the last answer |
| 3 | carriers-list, then entities-run-operation | add-bid with carrier_id (the catalog_id from carriers-list) and price as a number |
| 4 | entities-run-operation | finish-bidding |
| 5 | entities-query | a filter on status_id with the status number from the schema: “Awarding” is 3 |
Prepare a tender
Describe the tender in one message. Name the country: a tender needs one. The assistant fills the fields from your message. Fields you skip come from your brand’s tender settings first; the defaults below apply only where the brand has none. The assistant’s answer names the values it took from your settings.
Defaults:
| Setting | Default |
|---|---|
| Who can bid | “Open to your carrier network” |
| Auction length | 120 minutes |
| Bid rules | “Any bids allowed” |
| Bid step | no step |
| Time window of a point | 8 hours from the start time. For dates, see Set and change the route |
| Currency | your brand’s currency |
| Cargo | one item named “General freight” |
| Truck body | “Conestoga” |
| Starting price | not set. Name it when you choose “Only bids lower than the starting bid allowed” |
| “Automatically choose the winner when tender time expires” | off |
You can also set:
| What you set | Values |
|---|---|
| Load | FTL or LTL; size by unit or total |
| Truck | “Cargo Van”, “Truck” or “Tractor” |
| Body type | “Tarpaulin”, “Reefer”, “Isothermal”, “Flatbed”, “Box truck” and 25 more: the assistant reads the full list from the schema. The body type goes into the truck body field |
| Currency | a currency code, for example UAH, EUR or USD |
| Your own code | the number from your ERP or TMS |
| Note | free text |
Cargofy calculates the distance, in the unit of the tender’s country: kilometers or miles. The assistant answers with the saved draft, so you see what was set: check the route and the distance in the answer.
Set the auction rules
Open it to all carriers, 120 minutes, starting price 32,000 UAH, only bids lower than the starting price, step 500 UAH. Allow Book Now at 28,000 UAH.
| What you set | Values |
|---|---|
| Who can bid | “Open to all carriers”, “Open to your carrier network” or “Invitation-only” |
| Auction length | in minutes, from 30 to 1,440 |
| Starting price | in the tender currency |
| Bid rules | “Any bids allowed”, “Only bids lower than the starting bid allowed”, “Only bids lower than the current bid allowed” |
| Bid step | in the tender currency. With “Only bids lower than the current bid allowed”, a new bid must be at least one step below the lowest bid. The step applies only to this rule |
| “Book Now” | on or off, with its price |
| “Automatically choose the winner when tender time expires” | on or off. See Close bidding |
Describe the cargo
Cargo: 20 pallets of frozen fish, 800 kg each, 1.2 × 0.8 × 1.5 m, declared value 400,000 UAH; 10 boxes of ice packs, 50 kg each.
The cargo is a list of items with name, count, weight, dimensions and declared value. Weight is in kilograms: the assistant turns 20 t into 20,000 kg. Give dimensions in meters. Cargofy calculates total weight and volume per item: 20 pallets × 800 kg is 16,000 kg; 1.44 m³ each, 28.8 m³ in total.
Important
A cargo change replaces the whole list. Items you leave out are removed.
With size by unit, give length, width and height. With size total, give the total volume. A change of other fields keeps the cargo as it is.
Set and change the route
The route is a list of points in order. Point types: pickup, delivery, customs clearance (“Customs post”), customs crossing (“Customs registration”) and detour (“Checkpoint”). A point in the middle without a type becomes a “Checkpoint”.
Each point needs a city. For a street address, give it with the city, the region and the postal code. Check the distance in the answer. The country is the tender’s unless you name another. Coordinates are optional. Addresses come back as Cargofy stores them, with the country in the local language, for example “Kyiv, Україна”.
Times are in UTC. Give every point its time, and name the window when you have one, for example “pickup 07:00–15:00 UTC”: the assistant then sends exactly that window. A point without one gets a default date: tomorrow 09:00 UTC for the first point, a day later for each next one. A date without a time starts at 00:00 UTC.
Move the delivery in Lviv to 15:00–23:00 UTC.
Give the whole window: the start and the end.
The assistant sends the whole route in order: the city, type, date and coordinates (lat, lng) of every point from the last answer. Cargofy recalculates the distance: check it in the answer. A change keeps the fields you do not name, such as the note and your own code.
Find tenders
Show tenders in Matching. Find the tender with our code DEMO-ERP-1001. Which tenders were created this week? Which tenders created this week are in Pre-Execution?
| You can ask by | How it works |
|---|---|
| Number | full number, case-sensitive, or part of it |
| Your own code | full code, case-sensitive, or part of it |
| Status | one or several: “Draft”, “Matching”, “Awarding”, “Pre-Execution”, “Execution”, “Post-Execution”, “Canceled”, “Archived” |
| Creation date | from, to or between |
| Final price | from, to, or both |
| Distance | from or to |
Text search covers the number and your own code. Results are sorted by creation date, newest or oldest first. The answer gives the total. When it is small, the assistant shows all of them; when it is large, it shows the newest and you narrow the question by date, status or your own code. See How it works for pages and exporting to a file.
Add a bid a carrier gave you
Demo: Carrier LLC offered 29,500 UAH for TFY000000001 by email. Record it.
The tender must be in “Matching”, and the carrier confirmed in your network, see Carrier Network. The price is a number in the tender currency. A new bid from the same carrier replaces its earlier one.
Cargofy checks the bid against the tender’s rules and refuses it with a reason:
- “The bid must not exceed the starting price.” — the rule is “Only bids lower than the starting bid allowed”.
- “The bid is above the maximum allowed for this tender. Allowed maximum: …” — the rule is “Only bids lower than the current bid allowed”.
- “The carrier is not in this shipper's network.”
- “The carrier is not confirmed in this shipper's network.” — the carrier is still “Received”.
- “The carrier is neither invited to this tender nor confirmed in this shipper's network.”
- “Tender is not open for bids.” — the tender is a draft or bidding is closed.
Close bidding
Bidding on TFY000000001 is over. Close it.
- With bids, the tender moves to “Awarding”.
- With “Automatically choose the winner when tender time expires” on, the lowest bid wins at once and the tender moves to “Pre-Execution”. If that bid is above the starting price, the tender is canceled.
- With no bids, your brand’s tender rule decides. By default the tender is canceled. If your brand republishes tenders without bids, a copy appears in “Matching”.
When the auction length runs out, Cargofy closes bidding the same way. After that, Cargofy refuses new bids and a second close with “Tender is not open for bids.”
Follow tenders after the award
Which of our tenders are in execution now?
The answer shows each tender’s status and final price. Without a final price, the tender has no winner yet. In a shipper’s brand the assistant sees no trips: it follows a tender by its status and final price, not by where the truck is.
Automate around tenders
Workflows start on tender events, such as “Tender created”, “Tender published”, “Bid received”, “Bidding ended”, “Bidding ended without a winner”, “Winner selected” and “Tender cancelled”. Ask the assistant for the full list and for the workflows that ran on a tender. It can also create a follow-up task for a person or a Digital Worker.
Glossary
The words of this page, what they mean in Cargofy and the name the assistant works with. Paste this table into the chat or add it to your assistant’s project knowledge: the assistant then reads your words the same way Cargofy does.
| Term | Meaning | The assistant sees |
|---|---|---|
| Tender | A shipment that carriers bid on, with a number such as TFY000000001 | the object shipment |
| Schema | The tender’s fields with the IDs of their values | entities-schema |
| Status | Where the tender is | status_id: 1 “Draft”, 2 “Matching”, 3 “Awarding”, 4 “Pre-Execution”, 5 “Execution”, 6 “Post-Execution”, 7 “Canceled”, 8 “Archived” |
| “Draft” | A saved tender that carriers do not see. Changes are accepted only in this status | status_id 1 |
| “Matching” | The tender is published and takes bids. The assistant cannot publish | status_id 2 |
| “Awarding” | Bidding is closed, the tender waits for a winner. The assistant cannot choose the winner | status_id 3 |
| Who can bid | Which carriers see the tender | auction_type_id: 1 “Open to all carriers”, 2 “Open to your carrier network”, 3 “Invitation-only” |
| Auction length | How long the tender takes bids, in minutes | auction_time |
| Starting price | The price bidding starts from, in the tender currency | auction_price |
| Bid rules | Which prices the tender accepts | tender_allowed_bid_type_id: 1 “Any bids allowed”, 2 “Only bids lower than the starting bid allowed”, 3 “Only bids lower than the current bid allowed” |
| Bid step | How much lower than the lowest bid a new bid must be, with rule 3 | tender_bid_step |
| “Book Now” | A price at which a carrier takes the tender at once | is_enable_book_now, book_now_price |
| Automatic winner | “Automatically choose the winner when tender time expires” | is_enabled_best_option_auto_select |
| Bid | A carrier’s price for the tender. A new bid from the same carrier replaces its earlier one | the operation add-bid |
| Carrier | A carrier confirmed in your network, see Carrier Network | catalog_id from carriers-list, sent as carrier_id |
| Close bidding | Ends the auction. When the auction length runs out, Cargofy closes it the same way | the operation finish-bidding |
| Final price | The winner’s price, once the tender has a winner | payment_price |
| Your own code | Your number from your ERP or TMS | external_id |
| Pickup, delivery | The first and the last point of the route | pickup, dropoff |
| Customs clearance, customs crossing, detour | Points between pickup and delivery: “Customs post”, “Customs registration”, “Checkpoint” | customs_clearance, customs_crossing, detour |
| Truck body | The body type; a curtainsider is “Tarpaulin” | truck_body_id |
Limits
- The assistant cannot publish a tender: it takes bids and closes bidding only on a tender already in “Matching”.
- You can change a tender only while it is a “Draft”.
- The final price filter has no currency: the assistant checks the currency of each tender in the answer.
- Tenders cannot be searched by pickup or delivery date.
- There is no temperature field: put the temperature for a reefer in the note.
- Give a creation date range with times, for example up to 2026-11-22 23:59 UTC.