{"id":2488,"date":"2026-04-12T13:29:00","date_gmt":"2026-04-12T13:29:00","guid":{"rendered":"https:\/\/developers.maplink.global\/error-messages-planning\/"},"modified":"2025-08-05T13:41:01","modified_gmt":"2025-08-05T13:41:01","slug":"error-messages-planning","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/en\/error-messages-planning\/","title":{"rendered":"Error messages – Planning"},"content":{"rendered":"\n

Validation Errors<\/h2>\n\n\n\n

The following error messages may be returned due to omitted or incorrectly entered parameters. The error code returned by the API will be 400 (Bad Request)<\/code>, and the returned JSON will have the following structure:<\/p>\n\n\n\n

{\n    \"logId\": \"5e8f64f0-0ece-4e26-84c3-7ff889eff092\",\n    \"message\": \"Validation failed\",\n    \"errors\": [\n        \"sites may not be empty\",\n        \"operations[0].customerSite reference not found\",\n        \"operations[1].customerSite reference not found\"\n    ]\n}<\/pre>\n\n\n\n
The table below shows the validations applied to each entity and the error message returned:<\/p>\n\n\n\n
Parameter<\/strong><\/strong><\/strong><\/strong><\/td>Validations<\/strong><\/td>Error Messages<\/strong><\/td><\/tr>
sites<\/td>notEmpty<\/td>may not be empty<\/td><\/tr>
depots<\/td>notEmpty<\/td>may not be empty<\/td><\/tr>
operations<\/td>notEmpty<\/td>may not be empty<\/td><\/tr>
vehicleTypes<\/td>notEmpty<\/td>may not be empty<\/td><\/tr>
vehicles<\/td>notEmpty<\/td>may not be empty<\/td><\/tr>
products<\/td>notEmpty<\/td>may not be empty<\/td><\/tr>
legislationProfiles<\/td>notEmpty<\/td>may not be empty<\/td><\/tr>
logisticConstraints<\/td>notEmpty<\/td>may not be empty<\/td><\/tr>
optimizationProfile<\/td>notBlank<\/td>is mandatory<\/td><\/tr>
optimizationProfile<\/td>invalid profile<\/td>optimizationProfile {name} not found<\/td><\/tr>
tripsProfile<\/td>notBlank<\/td>is mandatory<\/td><\/tr>
startDate<\/td>notNull<\/td>is mandatory<\/td><\/tr><\/tbody><\/table>
Validation rules table for main entities<\/figcaption><\/figure>\n\n\n\n
The tables below show the validations applied for each specific entity:<\/p>\n\n\n\n
operations<\/strong><\/td><\/tr>
Parameter<\/strong><\/strong><\/strong><\/strong><\/strong><\/td>Validations<\/strong><\/td>Error Messages<\/strong><\/td><\/tr>
id<\/td>notBlank, unique<\/td>is mandatory, already exists<\/td><\/tr>
weight<\/td>notNull, notNegative<\/td>is mandatory, may not be negative<\/td><\/tr>
volume<\/td>notNull, notNegative<\/td>is mandatory, may not be negative<\/td><\/tr>
product<\/td>notBlank, validReference<\/td>is mandatory, reference not found<\/td><\/tr>
type<\/td>notBlank, isContainedIn<\/td>is mandatory, does not have a valid value. Allowed values: [COLLECTION, DELIVERY]<\/td><\/tr>
priority<\/td>notNegative<\/td>may not be negative<\/td><\/tr>
depotSite<\/td>notBlank, validReference<\/td>is mandatory, reference not found<\/td><\/tr>
customerSite<\/td>notBlank, validReference<\/td>is mandatory, reference not found<\/td><\/tr>
customerTimeWindows<\/td>notEmpty<\/td>may not be empty<\/td><\/tr><\/tbody><\/table>
Validation rules table for the operations parameter<\/figcaption><\/figure>\n\n\n\n
vehicles<\/strong><\/td><\/tr>
Parameter<\/strong><\/strong><\/strong><\/strong><\/strong><\/td>Validations<\/strong><\/td>Error Messages<\/strong><\/td><\/tr>
name<\/td>notBlank, unique<\/td>is mandatory, already exists<\/td><\/tr>
vehicleType<\/td>notBlank, validReference<\/td>is mandatory, reference not found<\/td><\/tr>
legislationProfile<\/td>notBlank, validReference<\/td>is mandatory, reference not found<\/td><\/tr>
availablePeriods<\/td>notEmpty<\/td>may not be empty<\/td><\/tr>
priority<\/td>notNegative<\/td>may not be negative<\/td><\/tr><\/tbody><\/table>
Validation rules table for the vehicles parameter<\/figcaption><\/figure>\n\n\n\n
vehicleTypes<\/strong><\/td><\/tr>
Parameter<\/strong><\/strong><\/strong><\/strong><\/strong><\/td>Validations<\/strong><\/td>Error Messages<\/strong><\/td><\/tr>
name<\/td>notNull, unique<\/td>is mandatory, already exists<\/td><\/tr>
maxWeight<\/td>notNull, notNegative<\/td>is mandatory, may not be negative<\/td><\/tr>
maxVolume<\/td>notNull, notNegative<\/td>is mandatory, may not be negative<\/td><\/tr>
size<\/td>notNegative<\/td>may not be negative<\/td><\/tr>
maxSitesNumber<\/td>notNegative<\/td>may not be negative<\/td><\/tr>
compartmentsAccessMode<\/td>notNull, isContainedIn<\/td>is mandatory, does not have a valid value. Allowed values: [ALL_COMPARTMENTS, REAR_ACCESS]<\/td><\/tr>
trip.calculationMode<\/td>notNull<\/td>is mandatory<\/td><\/tr>
trip.toll.vehicleType<\/td>notNull<\/td>is mandatory<\/td><\/tr><\/tbody><\/table>
Validation rules table for the vehicleTypes parameter<\/figcaption><\/figure>\n\n\n\n
sites<\/strong> and depots<\/strong><\/td><\/tr>
Parameter<\/strong><\/strong><\/strong><\/strong><\/strong><\/td>Validations<\/strong><\/td>Error Messages<\/strong><\/td><\/tr>
name<\/td>notBlank, unique<\/td>is mandatory, already exists<\/td><\/tr>
coordinates<\/td>notNull<\/td>is mandatory<\/td><\/tr>
coordinates.latitude<\/td>notNull, range(-90, 90)<\/td>is mandatory, must be between -90 and 90<\/td><\/tr>
coordinates.longitude<\/td>notNull, range(-180, 180)<\/td>is mandatory, must be between -180 and 180<\/td><\/tr>
logisticConstraints<\/td>notBlank, validReference<\/td>is mandatory, reference not found<\/td><\/tr><\/tbody><\/table>
Validation rules table for the sites and depots parameter<\/figcaption><\/figure>\n\n\n\n
legislationProfile<\/strong><\/td><\/tr>
Parameter<\/strong><\/strong><\/strong><\/strong><\/strong><\/td>Validations<\/strong><\/td>Error Messages<\/strong><\/td><\/tr>
name<\/td>notBlank, unique<\/td>is mandatory, already exists<\/td><\/tr>
maxContinuousDrivingTime<\/td>greaterThanZero<\/td>must be greater than zero<\/td><\/tr>
drivingPauseDuration<\/td>greaterThanZero<\/td>must be greater than zero<\/td><\/tr>
maxContinuousWorkingTime<\/td>greaterThanZero<\/td>must be greater than zero<\/td><\/tr>
workingPauseDuration<\/td>greaterThanZero<\/td>must be greater than zero<\/td><\/tr><\/tbody><\/table>
Validation rules table for the legislationProfile parameter<\/figcaption><\/figure>\n\n\n\n
callback<\/strong><\/td><\/tr>
Parameter<\/strong><\/strong><\/strong><\/strong><\/strong><\/td>Validations<\/strong><\/td>Error Messages<\/strong><\/td><\/tr>
url<\/td>notNull<\/td>is mandatory<\/td><\/tr>
url<\/td>Invalid url<\/td>does not have a valid value. Example of allowed values: http:\/\/www.foo.br, https:\/\/www.foo.br, http:\/\/www.foo.br\/bar<\/td><\/tr><\/tbody><\/table>
Validation rules table for the callback parameter<\/figcaption><\/figure>\n\n\n\n
The validations below apply to the time windows described in the parameters vehicles[n].availablePeriods<\/code>, operations[n].customerTimeWindows<\/code> and operations[n].depotTimeWindows<\/code>:<\/p>\n\n\n\n
timeWindow<\/strong><\/td><\/tr>
Parameter<\/strong><\/strong><\/strong><\/strong><\/strong><\/td>Validations<\/strong><\/td>Error Messages<\/strong><\/td><\/tr>
start<\/td>notNull<\/td>is mandatory<\/td><\/tr>
end<\/td>notNull<\/td>is mandatory<\/td><\/tr>
start, end<\/td>start < end<\/td>must have the start less than to the end<\/td><\/tr>
start, end<\/td>start != end<\/td>must not start the same as the end<\/td><\/tr>
end<\/td>end < startDate<\/td>must have at least one timeWindow with end after problem\u2019s startDate<\/td><\/tr><\/tbody><\/table>
Table of validation rules for parameters related to the time window.<\/figcaption><\/figure>\n\n\n\n
Processing errors<\/h2>\n\n\n\n
The following error messages may be returned when querying the request processing status through the endpoints https:\/\/api.maplink.global\/planning\/v1\/events?jobId={{planningId}}<\/a> and https:\/\/api.maplink.global\/planning\/v1\/jobs\/{{planningId}}<\/a>.<\/p>\n\n\n\n
The error message follows the following structure:<\/p>\n\n\n\n
{\n        \"id\": \"688d267a74be5d22a1ac9002\",\n        \"jobId\": \"688d26787766ef668397ff50\",\n        \"type\": \"ERROR\",\n        \"description\": \"{'logId':'db496388-c45a-4902-af42-0971578cbb38','errors':[{'code':'TECHNICAL_ERROR','description':'global.maplink.matrixinprocessor.exception.ProcessException: [ProcessError(code=INVALID_SITE_POSITION, description=Some sites have not been positionned, detail=[Cliente1])]'}]}\",\n        \"createdAt\": 1754080890262\n    }<\/pre>\n\n\n\n
The event returns with the type<\/code> equal to ERROR<\/code> and the following messages can be returned in description<\/code>:<\/p>\n\n\n\n
Error Message<\/strong><\/td>Cause<\/strong><\/td><\/tr>
{\u2018logId\u2019:\u2019{{logId}}<\/strong>\u2018,\u2019errors\u2019:
[{\u2018code\u2019:\u2019TECHNICAL_ERROR\u2019,\u2019description\u2019:\u2019Not possible to create route between sites {{siteId}}<\/strong> and {{siteId}}<\/strong>\u2018}]}<\/td>		No path could be found between the two points. The point may be misplaced or there may be no path at all, such as a point on a dead-end, one-way street.<\/td><\/tr>
Error in process MRS: Cannot find point {{latitude}}<\/strong>,{{longitude}}<\/strong><\/td>The location of the provided coordinates could not be found. It could be that some coordinates are invalid, falling into the ocean, for example.<\/td><\/tr><\/tbody><\/table>
Table of processing error messages<\/figcaption><\/figure>\n\n\n\n
Example of a route with an error message:<\/p>\n\n\n\n
[\n    {\n        \"id\": \"688d29735e59ee6e88b67adb\",\n        \"jobId\": \"688d29737766ef668397ff52\",\n        \"type\": \"STATUS_CHANGE\",\n        \"description\": \"ENQUEUED\",\n        \"createdAt\": 1754081651310\n    },\n    {\n        \"id\": \"688d297374be5d22a1ac900b\",\n        \"jobId\": \"688d29737766ef668397ff52\",\n        \"type\": \"STATUS_CHANGE\",\n        \"description\": \"CONVERT_TO_MATRIX\",\n        \"createdAt\": 1754081651314\n    },\n    {\n        \"id\": \"688d29735e59ee6e88b67adc\",\n        \"jobId\": \"688d29737766ef668397ff52\",\n        \"type\": \"PERCENT_CHANGE\",\n        \"description\": \"1\",\n        \"createdAt\": 1754081651317\n    },\n    {\n        \"id\": \"688d297308fc0e441d9e9d23\",\n        \"jobId\": \"688d29737766ef668397ff52\",\n        \"type\": \"STATUS_CHANGE\",\n        \"description\": \"PROCESSING\",\n        \"createdAt\": 1754081651339\n    },\n    {\n        \"id\": \"688d29745e59ee6e88b67add\",\n        \"jobId\": \"688d29737766ef668397ff52\",\n        \"type\": \"ERROR\",\n        \"description\": \"{'logId':'e687f91b-e4ce-4cbf-b6c5-8e304e281617','errors':[{'code':'TECHNICAL_ERROR','description':Not possible to create route between sites OP-1 and OP-2'}]},\n        \"createdAt\": 1754081652037\n    }\n]<\/pre>\n","protected":false},"excerpt":{"rendered":"
Validation Errors The following error messages may be returned due to omitted or incorrectly entered parameters. The error code returned by the API will be 400 (Bad Request), and the returned JSON will have the following structure: The table below shows the validations applied to each entity and the error message returned: Parameter Validations Error […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[160],"tags":[],"class_list":["post-2488","post","type-post","status-publish","format-standard","hentry","category-planning-en"],"acf":[],"_links":{"self":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts\/2488","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/comments?post=2488"}],"version-history":[{"count":3,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts\/2488\/revisions"}],"predecessor-version":[{"id":3524,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts\/2488\/revisions\/3524"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/media?parent=2488"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/categories?post=2488"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/tags?post=2488"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}