- Who can: a member of a shipper’s brand, your company’s account in Cargofy.
- Reading needs no extra permission.
- Adding a carrier needs “Create” and changing or confirming one needs “Update” on “Carrier network” in the “Entities” group of your role.
- Adding a bid needs “Add a carrier bid”.
- Where in Cargofy: Carrier Network
What it is
Your carrier network is the list of carriers your brand works with. Each carrier in it is “Received” or “Confirmed”:
- “Received”: invited, or added without “we already work with them”; not confirmed by you yet. It cannot bid on your tenders.
- “Confirmed”: confirmed by you. You can record its bids.
A carrier gets a Cargofy account when it accepts your invitation, outside the assistant.
The assistant invites new carriers, adds the ones you already work with, confirms them, finds a carrier by your code, email or phone, and gives the carrier’s ID to a bid. Reviewing the carrier packet, the documents a carrier sends to join, happens in Cargofy, outside the assistant.
Important
Before a step below, write to the assistant: “Tell me what you will do and wait for my yes.” Otherwise it acts at once.
An invitation always comes with an email. To add a carrier without an email, say “we already work with them, don’t email them”.
These steps email the carrier at once:
- “Add” or “invite”: Cargofy sends an invitation to join your network.
- “We already work with them” or “confirm” without “don’t email them”: Cargofy sends an email saying that you added them.
These steps cannot be undone:
- A confirmation cannot be taken back.
- A “Received” carrier added again with “we already work with them” is confirmed, unless you also say “don’t change them”.
What it can do
A carrier from invitation to bid
A dispatcher’s conversation with the assistant and Cargofy’s real answers. Names, codes and emails are examples. The terms are in the Glossary; the tool table after the steps is for the assistant.
1. Invite a new carrier
Invite Demo: CN Road LLC to our network: demo+cn10@example.com, our code DEMO-CN-10.
Cargofy adds the carrier as “Received” and emails them an invitation.
2. Check the carrier
Is DEMO-CN-10 confirmed yet?
The assistant finds the carrier by your code and answers: “Received”, no account yet.
3. Confirm the carrier
We signed DEMO-CN-10. Confirm them, no email.
The carrier moves to “Confirmed”, and Cargofy emails nothing.
4. Add a carrier you already work with
Add Demo: CN Fast LLC to our network: demo+cn11@example.com, +380 00 000 9911, our code DEMO-CN-11. We already work with them, don’t email them.
Cargofy adds the carrier as “Confirmed” at once, without an invitation and without an email.
5. Add the same carrier again
Add Demo: CN Fast LLC: demo+cn11@example.com, contact Demo: Olena.
Cargofy finds the carrier already in your network and creates no second one. The answer says what changed: the contact’s first name, which was empty.
6. Get the carrier for a bid
Which carriers are confirmed in our network?
The assistant lists the confirmed carriers with their rating and ID, newest first. A bid takes this ID, see Use a carrier in a tender.
| Step | Tool | What the assistant sends |
|---|---|---|
| 1 | entities-create | object company: company, email, external_id, without approved |
| 2 | entities-query | a filter on external_id; the answer has status_id 1 and registered false |
| 3 | entities-update | the record id from step 2 with approved: true, notify: false |
| 4 | entities-create | company, email, phone, external_id, approved: true, notify: false |
| 5 | entities-create | email, first_name; the answer has matched_existing: true, changed_fields: ["first_name"] |
| 6 | carriers-list | limit when you need more than 20 |
Invite or add a carrier
Add Demo: CN North LLC, demo+cn12@example.com, Demo: Andrii Koval, tax number 12345678, our code DEMO-CN-12. Don’t invite them, we already work with them, and don’t email them.
A carrier needs an email or a phone. Optional: company, first and last name, country, tax number and your own code. The country defaults to your brand’s country.
How you phrase it decides the status and the email the carrier gets:
| You say | Status | Email to the carrier |
|---|---|---|
| “Invite” or nothing about it | “Received” | an invitation to join your network |
| “We already work with them” | “Confirmed” | that you added them, with how to sign in |
| “We already work with them, don’t email them” | “Confirmed” | no email |
| “Confirm them” about a “Received” carrier | “Confirmed” | that you added them |
| “Confirm them, no email” | “Confirmed” | no email |
An invitation goes out once, when the carrier is added: adding it again does not resend it.
When the carrier is already in your network
When the carrier is already in your network, Cargofy returns it, creates no second one and invites nobody. To avoid a duplicate, give your own code or the carrier’s email. Check the name and email of the carrier in the answer.
A “Received” carrier found this way is confirmed when you say “we already work with them”, unless you also say “don’t change them”.
What happens to a carrier Cargofy finds:
| You say | What happens |
|---|---|
| “Skip them” or “don’t change them” | Nothing, a confirmation included |
| Nothing (the default) | Cargofy fills only the fields that are empty on the carrier it found: an email you send does not replace the one it has. To replace it, ask to change the carrier’s email, see Change a carrier’s contacts |
| “Update them with the new values” | Cargofy replaces the carrier’s fields with every value you send. An empty value never erases |
Add a list
Add these carriers from our sheet. Skip the ones we already have, and don’t change them.
Say whether to invite the carriers or add them as ones you already work with, and whether to email them: with nothing said, every new row gets an invitation email. Try one row first. Every row needs an email or a phone. A refused row does not stop the others.
Confirm an invited carrier
Confirm Demo: CN Road LLC in our network, without an email.
The assistant finds the carrier and confirms it. Name the carrier by your code when you can: company names can repeat.
Change a carrier’s contacts
Change the email of DEMO-CN-12 to demo+cn12b@example.com.
The assistant changes company, email, phone, first and last name, country or your code. The tax number is set only when the carrier is added.
Find a carrier
Find our carriers with phone +380 00 000 9911.
Which carriers did we invite that have not joined yet?
The assistant searches your network by company, email or phone, or filters it by your code, email, phone, country or status. Phones come back as digits only (380000009911); the assistant searches by those digits.
The answer shows each carrier’s status, whether it has a Cargofy account and its rating:
| Status and account | What it means |
|---|---|
| “Received”, no account | Invited or added, has not joined yet |
| “Received”, has an account | Joined, waits for your confirmation |
| “Confirmed” | In your network |
carriers-list lists confirmed carriers, and separately the carriers whose carrier packet you rejected, with your message.
For “Received” carriers, or more than 50 confirmed ones, the assistant uses entities-query with a status filter.
Use a carrier in a tender
Demo: CN Fast LLC called: 30,000 UAH for TFY000000001. Add their bid.
Adding a bid needs the action “Add a carrier bid” in your role. The assistant adds the bid to the tender with entities-run-operation: object shipment, the tender number, operation add-bid, carrier_id and price. The price is a number in the tender’s currency: 30,000 UAH on a UAH tender is 30000.
The carrier ID is catalog_id in carriers-list, the same value as the record id in entities-query.
The carrier must be “Confirmed”, and the tender open for bids, see Freight Procurement.
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 |
|---|---|---|
| Carrier network | Your brand’s carriers, “Received” and “Confirmed”; only “Confirmed” ones can bid | the object company, labeled “Carrier network” |
| Carrier ID | The ID of a carrier in your network, used in a bid | the record id in entities-query, catalog_id in carriers-list, carrier_id in a bid |
| Status | “Received” or “Confirmed” | status_id: 1 “Received”, 2 “Confirmed” |
| Has an account | The carrier has a Cargofy account | registered; the account ID is brand_id (brand_public_id in carriers-list) |
| Rating | The carrier’s rating in Cargofy | rating in carriers-list and entities-query; empty until the carrier has an account |
| Invite | Add a carrier and email them an invitation | entities-create without approved |
| We already work with them | Add or confirm a carrier without an invitation | approved: true |
| Don’t email them | No email that you added the carrier | notify: false, with approved: true |
| Your own code | Your number for the carrier from your ERP or TMS | external_id |
| Tax number | The carrier’s tax or registration number. Set only when the carrier is added | legal_number |
| Company, contact | The carrier’s company and contact person | company, first_name, last_name |
| Name | Set by Cargofy from the carrier’s account or contact details | name |
| Already in the network | The add found an existing carrier | matched_existing |
| What to do with an existing carrier | Keep it, fill only empty fields, or update it | on_existing: keep, fill_empty (default), update |
| Changed | The fields an add changed on an existing carrier | changed_fields; status_id when the add confirmed it |
| Carrier packet | The documents a carrier sends you to join your network | rejected ones in rejected in carriers-list, with decline_message |
Limits
- The network belongs to a shipper’s brand: in a carrier’s brand the assistant has no carrier network.
- Carriers cannot be sorted:
carriers-listshows the newest first, 20 by default, up to 50;entities-queryreturns up to 100 per page.