- Who can: a member of a carrier’s brand. Reading needs no permission. Changes follow your role in the “Entities” group: “Create”, “Update” and “Delete” on trucks, trailers and drivers. Your account owner sets the roles.
- Where in Cargofy: Fleets
What it is
The assistant keeps your fleet in Cargofy from a chat: trucks, trailers and drivers, and which driver and trailer work with which truck. It also reads your trips: status, route, truck, driver and the times at each point. Trips are read only.
Important
Some changes reach other records or cannot be undone:
- Moving a driver or trailer to another truck takes it off the truck it was on.
- A deleted truck, trailer or driver cannot be restored.
Before such a step, write to the assistant: “Look up what exists, tell me what you will change and wait for my yes.”
What it can do
A truck from start to finish
A dispatcher’s conversation with the assistant and what Cargofy answers. The terms are in the Glossary. The tool table after the steps is for the assistant. Plates, IDs and trip numbers on this page are examples.
1. Add the fleet from a table
Add our fleet to Cargofy. Each row is one truck with its trailer and driver. Skip what already exists.
Truck VIN Type Body Capacity Trailer Driver Phone DEMO-FL-001 DEMOFLVIN00000001 tractor curtainsider 22 t DEMO-FL-T01 semi-trailer Demo: Taras 380000009951 DEMO-FL-002 DEMOFLVIN00000002 tractor reefer 20 t DEMO-FL-T02 semi-trailer Demo: Ostap 380000009952
The assistant looks up each plate and phone first, then creates the trailer, the driver and the truck linked to both. A curtainsider is “Tarpaulin” in Cargofy. The answer lists each truck with its driver and trailer plate.
2. Move a driver to another truck
Demo: Taras goes on DEMO-FL-002 from today.
Demo: Taras now drives DEMO-FL-002 at once. Demo: Ostap, who drove it, is left without a truck, and DEMO-FL-001 is left without a driver. A truck has one driver, and a driver has one truck.
3. Change a truck
DEMO-FL-001 now carries 24 t.
Cargofy changes only the capacity. The other fields stay as they were.
4. Find a vehicle
Which truck has VIN ending in 00000002? Find the trailer with T01 in the plate.
The assistant finds DEMO-FL-002 by part of the VIN and DEMO-FL-T01 by part of the plate, with the linked truck or trailer and driver.
5. Follow your trips
Which of our trips are in execution? Has the truck on CFY000000001 reached the pickup?
The assistant lists the trips in “Execution” with route, truck and driver. For one trip it reads each point: planned window, arrival and departure. An empty arrival means the truck has not been marked there yet.
6. Remove a trailer
We sold DEMO-FL-T02. Show it to me, then remove it.
The assistant shows the trailer and the truck it is on, then deletes it. DEMO-FL-002 is left without a trailer. A trailer, truck or driver with a trip in “Pre-Execution”, “Execution”, “Post-Execution” or “Archived” cannot be deleted.
| Step | Tool | What the assistant sends |
|---|---|---|
| 1 | entities-schema, entities-query, then entities-create | the schema of truck, trailer and driver; a lookup by plate and by phone; the trailer and the driver, then the truck with their IDs in trailer_id and driver_id |
| 2 | entities-update | on the truck DEMO-FL-002: driver_id with the driver’s ID |
| 3 | entities-update | on the truck: capacity. Add weight_id when the unit changes |
| 4 | entities-query | a filter with contains on vin of truck and on plate of trailer |
| 5 | entities-query, then entities-get | trip with a filter on status_id 5; then the trip by its number |
| 6 | entities-delete | trailer with its ID |
Add trucks, trailers and drivers
New driver: Demo: Ivan, phone 380000009953, email demo@example.com, license DEMO-FL-LIC1 valid until 2027-05-31. Put him on DEMO-FL-001.
Paste a table, a list or a message from your team. Give the capacity with its unit, such as “22 t”. Fields:
| Object | Fields |
|---|---|
| Truck | plate, VIN, type (“Cargo Van”, “Truck”, “Tractor”), body type, capacity with unit, length, width and height with unit, manufacture year, technical passport, your own code |
| Trailer | plate, VIN, type (“Trailer”, “Semi-trailer”, “Coupler”), body type, capacity with unit, length, width and height with unit, manufacture year, technical passport, your own code |
| Driver | first, last and middle name, phone, email, tax number, license number, license issued by, license valid until, birthday, your own code |
Cargofy stores a plate in capital Latin letters without spaces: “аа 0000 хх” becomes AA0000XX. Body types are the same 31 as on tenders, such as “Tarpaulin”, “Reefer”, “Isothermal”, “Flatbed” and “Box truck”; the assistant reads the full list from the schema. Without a unit, capacity and dimensions are saved in the units of your brand’s country: tonnes and meters in Ukraine. Cargofy shows a driver’s name as last name, then first name. Write phones as digits only, without “+”, spaces or brackets, for example 380000009953.
Say “skip what exists”: the assistant then looks each plate or phone up first and creates only what is missing.
Link drivers and trailers to trucks
Put trailer DEMO-FL-T01 on DEMO-FL-002. Take the driver off DEMO-FL-001.
A truck has one driver and one trailer. A driver and a trailer each work with one truck. A new link moves them:
- A driver put on another truck leaves the first truck without a driver.
- A truck that gets a new driver or trailer releases the one it had.
Cargofy moves the old link itself: the assistant sets only the new one. The link shows on all sides: the truck shows its driver and trailer plate, the driver and the trailer show the truck’s plate. The link takes the record’s ID, not the plate: the assistant looks the plate up first and finds the ID for you.
To take a driver or trailer off, ask for it through the truck: “Take the driver off DEMO-FL-001.” The assistant sets an empty value (null) on the truck.
Find vehicles and drivers
Find trucks with AA in the plate. Which semi-trailers were built after 2020? Find the driver with phone 380000009952.
| Object | You can ask by | Text search |
|---|---|---|
| Truck | plate (exact or part), VIN (exact or part), your own code, manufacture year (from, to, between), type, body type | plate, VIN, your own code |
| Trailer | plate (exact or part), VIN (exact or part), your own code, manufacture year, type, body type | plate, VIN |
| Driver | phone, email, your own code | phone, part of it |
“From” and “to” include the year itself: “built after 2020” is from 2021. Search by part of a plate or VIN ignores case. An exact plate, email or code must match letter case. Results come newest first; trucks and trailers can also be sorted by plate. Drivers cannot be found by name: ask by phone, email, your own code, or name the truck and the assistant reads its driver.
Update and remove
Change DEMO-FL-001: body type reefer, manufacture year 2020. Remove the driver with phone 380000009952.
The assistant changes only the fields you name. A capacity without a unit keeps the unit the truck had. To remove a driver, name their phone or the truck they drive. A deleted truck, trailer or driver drops its links: the truck stays without that driver or trailer.
Follow your trips
Show trips ordered this week. Which trips are in Post-Execution? What is on trip CFY000000001 and who drives it?
| You can ask by | How it works |
|---|---|
| Number | opens one trip, for example CFY000000001 |
| Status | one or several: “Pre-Execution”, “Execution”, “Post-Execution”, “Archived” |
| Order date | from, to or between. Sort by order date, newest or oldest first |
| Distance | from or to |
| Price | from or to |
A trip shows its status, route, distance, price, truck and trailer plates, driver, note and the shipments it carries, with their numbers and cargo. Each point shows the city, the type (“Pick-up”, “Drop-off”, “Checkpoint”), the planned window and the time the truck arrived and left. Times are in UTC: Kyiv time is UTC+2 in winter and UTC+3 in summer. Draft and canceled trips are not shown.
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.
| Term | Meaning | The assistant sees |
|---|---|---|
| Truck, trailer, driver | Your fleet records | the objects truck, trailer, driver |
| Trip | A carrier’s run with a truck, driver and points. Read only | the object trip |
| Schema | The fields of an object with the IDs of their values | entities-schema |
| ID | The record’s key for changes and links, not the plate | id of the record |
| Plate | Capital Latin letters, no spaces | plate |
| VIN | The vehicle’s VIN | vin |
| Your own code | Your number from your ERP or TMS | external_id |
| Truck type | What the truck is | type_id: 1 “Cargo Van”, 2 “Truck”, 3 “Tractor” |
| Trailer type | What the trailer is | type_id: 1 “Trailer”, 2 “Semi-trailer”, 3 “Coupler” |
| Body type | A curtainsider is “Tarpaulin” | body_type_id, for example 2 “Tarpaulin”, 3 “Reefer”, 1 “Box truck”, 10 “Flatbed”; the full list in entities-schema |
| Capacity | A number with a weight unit | capacity and weight_id: 1 “Kilogram”, 2 “Tonne”, 3 “Pound”, 4 “Short ton” |
| Dimensions | Numbers with a length unit | length, width, height and length_id: 1 “Metre”, 2 “Centimetre”, 3 “Foot”, 6 “Inch” |
| Driver on a truck | Set on the truck or on the driver; cleared only on the truck | driver_id on truck, truck_id on driver; read as driver on the truck and truck_plate on the driver |
| Trailer on a truck | Set on the truck or on the trailer; cleared only on the truck | trailer_id on truck, truck_id on trailer; read as trailer_plate on the truck and truck_plate on the trailer |
| Driver’s documents | License, its issuer and end date, tax number, birthday | legal_driver_license, legal_driver_license_issued_by, legal_driver_license_action_to, legal_tin, birthday |
| Trip number | Opens one trip, such as CFY000000001 | the same value is the trip’s id for entities-get |
| Trip status | Where the trip is | status_id: 4 “Pre-Execution”, 5 “Execution”, 6 “Post-Execution”, 8 “Archived” |
| Points | The route of the trip | waypoints with city, action, date_from, date_to, arrived_at, departed_at |
| Shipments on the trip | The tenders the trip carries | loads with public_id and name |
| Order date, price | When the trip was ordered, and its price | order_date_at, payment_price |
Limits
- Trips cannot be searched by truck, driver or city.
- The assistant cannot set loading types, equipment such as ADR or GPS, a driver’s languages or experience.
- Manufacturer and model cannot be set over MCP.