Builder error messages, explained
Last updated: October 23, 2026
Every message Builder shows, what it means and what to do. Start with the first table: these can appear on any TMS. Then find your TMS below.
Before you build again after an error, check your TMS: some errors happen after the load is already created, and building again makes a duplicate.
Any TMS
| Message | What it means | What to do |
|---|---|---|
| Invalid fields: (then a list of fields) | Required fields are empty or in the wrong format. Drumkit opens those sections. | Fill in each field listed and click Build Load again. |
| Some fields are invalid. | Same, without a list. | Click Expand all and look for fields marked in red. |
| Transport type is required. Select the equipment, then create the load. | The equipment is empty. | Pick the equipment (on some forms it's called Transport Type or Equipment Type) and build again. |
| Error building load. / Failed to create load. / Error creating load. Please try again. | Your TMS didn't accept the load and didn't give a reason Drumkit can show. | Check whether the load exists in your TMS. If not, check the customer and stops, try again, and if it still fails send the email and a screenshot to support@drumkit.ai. |
| Error while fetching customer list. | Drumkit couldn't load your customers from the TMS. | Click refresh on the customer field or reopen the sidebar. If it keeps happening, your TMS connection may need attention: tell your Drumkit admin. |
| Error creating location. | Your TMS didn't accept the new location. | Check the address, or pick an existing location. |
| Location name is required / Street address is required / City is required / State is required / Zip code is required | The new-location form is missing a field. | Fill it in and click Save Location. |
| Please provide at least a pickup and a consignee. | A stop is missing. | Fill in both the pickup and the delivery. |
| Submit Another Load? | You already built a load from this form. | Click Cancel unless you want a second load. |
| Error updating load. / Load ID is required for updates. | An update to a built load didn't go through. | Reopen the load from the Active view and try again. |
3G TMS
| Message | What to do |
|---|---|
| Missing required reference numbers: (name), for example an SO number | The customer requires that reference in 3G. Fill it in under Customer and build again. |
| (Stop) location (ID) is missing a time zone in 3G. Set the time zone on that location, then create the order again. | Set the time zone on that location in 3G, then build again. |
| 3G could not find a time zone for the origin (or destination) location. | Same: set the time zone in 3G. |
| ... its city and state (...) do not match ZIP ... | Fix the address and time zone on the location in 3G. |
| Error creating location. (when a contact is already on another location) | Pick the existing location, or create it without that contact. |
| Must enter an item | Add at least one item. |
| Temperature is required for refrigerated equipment | Enter the temperature in Specs. |
PLS 3.0
| Message | What to do |
|---|---|
| The origin pickup window starts in the past | Set the pickup time to a time in the future and build again. |
| Saving failed - please contact support | Check PLS 3.0 in case it saved, then send the email to support@drumkit.ai. |
| Latest pickup (or delivery) time must be on or after the earliest time. | Fix the stop's times. |
| At least one complete commodity is required. | Complete one item in Items. |
Revenova
| Message | What to do |
|---|---|
| (Load) was created successfully. A customer quote could not be created because the customer account is not currently in a quotable state in Revenova. | The load is built. The customer Account is on credit hold, not approved, or under review. Check the Account, or follow your usual escalation if you need a quote. |
| Locations could not be created / Some locations could not be created | Complete the address and try again. If one stop's location was created, select it rather than creating it again. |
MercuryGate
| Message | What to do |
|---|---|
| The first stop must be a pickup. / The last stop must be a drop. | Fix the stop order in Route. |
| At least one commodity with description, pieces and weight is required. | Complete one commodity in Specs. |
| Total miles are required for Rate Per Mile. Set complete pickup and delivery locations. | Finish both addresses, or use a flat line haul. |
| Enter a valid US state or Canadian province code (e.g. FL, ON). | Use the 2-letter code. |
Other TMSs
| TMS | Message | What to do |
|---|---|---|
| Aljex | Please provide at least a pickup and a dropoff (2 stops). | Fill in both stops. |
| McLeod | Missing weight / Required for weight-based rate | Enter the weight, or change the rating units. |
| Turvo | Location is required for each stop. | Pick or create a location for every stop. |
| GlobalTranz | Please add at least one shipment item. / Please select a customer. | Add an item; pick the customer before creating a location. |
| Stark | An error saying a customer is required | Stark needs a matched shipper on every load, and the Stark form doesn't let you pick one. Build this load in Stark directly, and send us the email so we can fix the match. |
Still stuck?
Check your TMS first, so you know whether the load was created. Then email support@drumkit.ai with:
- The tender email, forwarded
- A screenshot of the error
- The load number, if the load was created
FAQs
It errored, but the load is in my TMS. What happened?
Some TMSs (Revenova is one) set a few fields a moment after creating the load. If that step fails, you see an error even though the load exists. Check the load, fill in anything missing, and send us the load number so we can see what tripped it.
My TMS was down or slow.
If your TMS doesn't answer, the build fails with a general error. Wait a minute, check the load wasn't created, and try again.
Related