Common causes of load and carrier validation errors.
Common Errors for Loads
Zip Code
- Error Message: Zip code for an itinerary doesn’t exist in geoset.
- Description: The zip code supplied for any of the stops in the itinerary does not exist in the geoset.
Appointment Open Time
- Error Message: Appointment open time is in the past.
- Description: The first stop in the itinerary has an open time that occurs in the past; that is, the
open_time
is less than the currentdate_time
.
Appointment Close Time
- Error Message: Appointment close time is in the past.
- Description: The first stop in the itinerary has a close time that occurs in the past; that is, the
close_time
is less than the currentdate_time
.
Banned Commodity
- Error Message: Banned Commodity.
- Description: The commodity is in the list of commodities that we have banned or do not allow; for example, Ghost Load.
Max Expiration Time
- Error Message: Field validation for 'ExpiredAt' failed on the 'max_expired_at' tag.
- Description: The
expired_at
timestamp is greater than the 28 days from the currentdate_time
.
Origin Open Time
- Error Message: Field validation for 'OriginOpenTime' failed on the 'open_time_lt' tag.
- Description: The first stop (origin) in the itinerary has an
open_time
that is greater than:- its
close_time
- the last stop’s (destination's)
open_time
- its
Destination Open Time
- Error Message: Field validation for 'DestinationOpenTime' failed on the 'open_time_lt' tag.
- Description: The last stop (destination) in the itinerary has an
open_time
greater than itsclose_time
.
Duplicate Load Reference
- Error Message: Duplicate load reference.
- Description: This load reference already exists. Load reference is a unique identifier.
Load Weight
- Error Message: Key: 'Load.Weight' Error:Field validation for 'Weight' failed on the 'gt' tag.
- Description: The load weight supplied is less than or equal to 0.
Update Not Applied to Load
- Error Message: After requesting updates for a load, no values have changed.
- Description: Updates are made using field masks to map the changing data. Field masks specify the subset of fields that should be modified by the update operation. If the field mask is missing a value, no update is applied. You can learn about field masks in detail in our reference article about updating a load.
Trailer Length
- Error Message: "Key: 'Load.TrailerLength' Error:Field validation for 'TrailerLength' failed on the 'lte' tag".
- Description: Motive imposes an allowed limit for trailer length. Trailer length must be less than or equal to 2147483647.
Phone
- Error Message: "Key: 'Load.ExtraAttrs.Contact.Phone' Error:Field validation for 'Phone' failed on the 'phone' tag".
- Description: Supply a phone number that consists of a country code followed by an area code and a local number. In the U.S., this is a 10-digit number. Supply numbers only, without special characters.
Common Validation Errors for Carriers
Carrier Identifier
If Carrier ID Missing or Incorrect
- Error Message: Invalid identifier type/value.
- Description: The identifier type in the request payload is either missing or incorrect. In your call, you must provide either the USDOT or the MC/MX/FF number. Refer to Step 2. Create a freight partner carrier. to learn more.
If Carrier ID Does Not Exist
- Error Message: "Key: 'FreightPartnerCarrier.Identifier' Error:Field validation for 'Identifier' failed on the 'required' tag".
- Description: The value supplied as identifier type (MC/MX/FF or USDOT) in the request payload does not exist.
Carrier Status
- Error Message: "Unknown value "\"STATUS_ALOWED\"" for enum keeptruckin.proto.freight.services.loadboard.Carrier.Status".
- Description: The carrier
status
field has a value other thanallowed
orblocked
(the only two accepted values). Refer to Step 2. Create a freight partner carrier. to learn more.
Reserved Carrier
- Error Message: Reserved carrier cannot be created, deleted or updated.
- Description: Motive has a reserved carrier whose identifier is
DUMSLB1
; this identifier cannot be used for any API calls.