{"id":2506,"date":"2023-12-12T17:33:00","date_gmt":"2023-12-12T17:33:00","guid":{"rendered":"https:\/\/developers.maplink.global\/list-of-parameters-planning\/"},"modified":"2026-02-04T17:34:29","modified_gmt":"2026-02-04T17:34:29","slug":"list-of-parameters-planning","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/en\/list-of-parameters-planning\/","title":{"rendered":"List of parameters"},"content":{"rendered":"\n<p>Mandatory parameters are denoted with &#8220;<strong>*<\/strong>&#8220;, the others are optional.\nThe list of parameters is described separately by the groups they belong to: <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"#startDate\">startDate*<\/a><\/li>\n\n\n\n<li><a href=\"#depots\" data-type=\"internal\" data-id=\"#depots\">depots*<\/a><\/li>\n\n\n\n<li><a href=\"#logisticConstraints\" data-type=\"internal\" data-id=\"#logisticConstraints\">logisticConstraints*<\/a><\/li>\n\n\n\n<li><a href=\"#vehicleTypes\" data-type=\"internal\" data-id=\"#vehicleTypes\">vehicleTypes*<\/a><\/li>\n\n\n\n<li><a href=\"#vehicles\">vehicles*<\/a><\/li>\n\n\n\n<li><a href=\"#products\" data-type=\"internal\" data-id=\"#products\">products*<\/a><\/li>\n\n\n\n<li><a href=\"#legislationProfiles\" data-type=\"internal\" data-id=\"#legislationProfiles\">legislationProfiles*<\/a><\/li>\n\n\n\n<li><a href=\"#sites\">sites*<\/a><\/li>\n\n\n\n<li><a href=\"#operations\" data-type=\"internal\" data-id=\"#operations\">operations*<\/a><\/li>\n\n\n\n<li><a href=\"#logisticZones\">logisticZones<\/a><\/li>\n\n\n\n<li><a href=\"#callback\">callback<\/a><\/li>\n\n\n\n<li><a href=\"#optimizationProfile\">optimizationProfile*<\/a><\/li>\n\n\n\n<li><a href=\"#tripsProfile\" data-type=\"internal\" data-id=\"#tripsProfile\">tripsProfile*<\/a><\/li>\n\n\n\n<li><a href=\"#trip\" data-type=\"internal\" data-id=\"#trip\">trip<\/a><\/li>\n\n\n\n<li><a href=\"#linearThreshold\" data-type=\"internal\" data-id=\"#linearThreshold\">linearThreshold<\/a><\/li>\n\n\n\n<li><a href=\"#calculationMode\">calculationMode<\/a><\/li>\n\n\n\n<li><a href=\"#restrictionZones\">restrictionZones<\/a><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"startDate\">startDate<\/h2>\n\n\n\n<p>The parameter <code>startDate<\/code><strong> <\/strong> indicates the <strong>start date and time<\/strong> to be considered for every calculation of the logistical problem.  <\/p>\n\n\n\n<p>It is a mandatory parameter and must be in the <em>timestamp<\/em> format. Example:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"startDate\": 1583492400000<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"depots\">depots*<\/h2>\n\n\n\n<p>The parameter  <code>depots<\/code><strong> <\/strong>is an <strong>array of objects<\/strong>, where each object represents a warehouse or distribution center. It could also be a physical store from where the product will be delivered.<\/p>\n\n\n\n<p>The<em> depots <\/em>will be referenced in the operations as the origin of the product for delivery, or as the destination if it is a collection operation.<\/p>\n\n\n\n<p>In the request, you can define one or more <em>depots <\/em>to handle the operations.  <\/p>\n\n\n\n<p>Below are the parameters available in depots:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>name<\/code>  &#8211; Single text of the deposit name. Used to refer to <em>Operations <\/em>and identify it in the result.<\/li>\n\n\n\n<li><code>coordinates<\/code>  &#8211; Geographical coordinates in decimal degrees of latitude and longitude:\n<ul class=\"wp-block-list\">\n<li><code>latitude<\/code>  &#8211; Numerical value in decimal degrees. It should be between -90.0 and 90.0. Example: -23.6987.<\/li>\n\n\n\n<li><code>longitude<\/code>  &#8211; Numerical value in decimal degrees. It should be between -180.0 and 180.0. Example: -45.7347.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>logisticConstraints<\/code> &#8211; Text with reference to the name of <a href=\"#logisticConstraint\" data-type=\"internal\" data-id=\"#logisticConstraint\"><code>logisticConstraint<\/code><\/a>.<\/li>\n\n\n\n<li><code>logisticZones<\/code>  &#8211; (Optional) Array with the names of the logistics zones to which the <em>depot<\/em> belongs. They must be unique and must have the same name declared on <a href=\"#logisticZones\"><code>logisticZones<\/code>.<\/a><\/li>\n<\/ul>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"depots\": [\n        {\n            \"name\": \"MG - BELO HORIZONTE DEP\u00d3SITO\",\n            \"coordinates\": {\n                \"latitude\": -19.9251768,\n                \"longitude\": -43.9509008\n            },\n            \"logisticConstraints\": \"DEFAULT\",\n            \"logisticZones\": [\"bh\"]\n        },\n        {\n            \"name\": \"BH - Loja 1\",\n            \"coordinates\": {\n                \"latitude\": -19.8849981,\n                \"longitude\": -44.0089124\n            },\n            \"logisticConstraints\": \"DEFAULT\",\n            \"logisticZones\": [\"bh\"]\n        }\n]<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"logisticConstraints\">logisticConstraints*<\/h2>\n\n\n\n<p>The parameter <code>logisticConstraints<\/code><strong> <\/strong> is an <strong>array of objects<\/strong>, where each object will represent a group of <strong>logistics rules<\/strong> to be considered in planning and optimization, such as loading and unloading times, for example.<\/p>\n\n\n\n<p>Each logistical rule must be associated with the <em>depots <\/em>or <em>sites<\/em> to which it applies.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>name<\/code> &#8211; Text of the logistics rule name. Used to reference in <em><a href=\"#depots\" data-type=\"internal\" data-id=\"#depots\">depots<\/a> <\/em>and <em><a href=\"#sites\">sites<\/a><\/em>.<\/li>\n\n\n\n<li><code>siteLoadingFixedTime<\/code> &#8211; (Optional) Integer with fixed charging time in seconds. For <code>DELIVERY<\/code> type operations, this time will be added to the <code>LOADING<\/code> activity and for <code>COLLECTION<\/code> type operations this time will be added to the <code>COLLECTION<\/code> activity.<\/li>\n\n\n\n<li><code>siteUnloadingFixedTime<\/code> &#8211; (Optional) Integer with fixed unloading time in seconds. For <code>DELIVERY<\/code> type operations, this time will be added in the <code>DELIVERY<\/code> activity and for <code>COLLECTION<\/code> type operations this time will be added in the <code>UNLOADING<\/code> activity.<\/li>\n\n\n\n<li><code>loadingMaxSize<\/code>&nbsp;\u2013 (Optional) Integer number with the maximum vehicle size allowed to load on site. Used for points where there is restricted access for large vehicles, for example. The vehicle size is defined in the&nbsp;parameter <code>size<\/code> in&nbsp;<a href=\"#vehicleTypes\"><em>vehicleTypes<\/em><\/a>.<\/li>\n\n\n\n<li><code>unloadingMaxSize<\/code>&nbsp;\u2013 (Optional) Integer number with the maximum vehicle size allowed to unload on site. Used for points where there is restricted access for large vehicles, for example. The vehicle size is defined in the&nbsp;parameter <code>size<\/code> in&nbsp;<a href=\"#vehicleTypes\"><em>vehicleTypes<\/em><\/a>.<\/li>\n\n\n\n<li><code>unloadingPositionInRoute<\/code> &#8211; (Optional) Position on the route for unloading<em>. <\/em>Possible values: <strong>[<code>INDIFFERENT, FIRST, LAST, ALONE<\/code>]<\/strong>.\n<ul class=\"wp-block-list\">\n<li>Example 1: If a <em>site <\/em>has the rule of <code>\"unloadingPositionInRoute\": \"FIRST\"<\/code>, this site&#8217;s operation will be executed first on the route to make the delivery.<\/li>\n\n\n\n<li>Example 2: If a <em>site <\/em>has the rule of <code>\"unloadingPositionInRoute\"\": \"LAST\"<\/code>, this site&#8217;s operation will run last on the route to make the delivery.<\/li>\n\n\n\n<li>Example 3: If a <em>site <\/em>has the rule of <code>\"unloadingPositionInRoute\"\": \"ALONE\"<\/code>, the operation of this site will be carried out alone, with an exclusive route to carry out the delivery.<\/li>\n\n\n\n<li>Example 4: If a <em>site <\/em>has the rule of <code>\"unloadingPositionInRoute\"\": \"INDIFFERENT\"<\/code>, this site&#8217;s operation will be executed at any position on the delivery route.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>loadingPositionInRoute<\/code> &#8211; (Optional) Position on the route for loading<em>.<\/em> Possible values: <strong>[<code>INDIFFERENT, FIRST, LAST, ALONE<\/code>].<\/strong><\/li>\n<\/ul>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"logisticConstraints\": [\n        {\n            \"name\": \"Regras-Depot\",\n            \"siteLoadingFixedTime\": 1200,\n            \"loadingMaxSize\": 30\n        },\n        {\n            \"name\": \"Regras-Entrega-R\u00e1pida\",\n            \"siteUnloadingFixedTime\": 300,\n            \"unloadingPositionInRoute\": \"FIRST\",\n            \"unloadingMaxSize\": 30\n        }\n],<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"vehicleTypes\">vehicleTypes*<\/h2>\n\n\n\n<p>The parameter  <code>vehicleTypes<\/code><strong> <\/strong>is an <strong>array of objects<\/strong>, where each object represents a <strong>type of vehicle<\/strong>. Vehicle types are the characteristics of the vehicles that will be used in the planning, such as weight and volume supported, for example.<\/p>\n\n\n\n<p>API will check the capacity of the vehicles to distribute the weights and volumes of the products in each operation for the best logistical optimization.<\/p>\n\n\n\n<p><strong>Mandatory parameters<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>name<\/code>  &#8211; Single text with vehicle type. Used to be referenced in  <code><a href=\"#vehicles\" data-type=\"internal\" data-id=\"#vehicles\">vehicles<\/a><\/code><em>.<\/em><\/li>\n\n\n\n<li><code>maxVolume<\/code>  &#8211; Numeric value (double) with the maximum volume supported by the vehicle<em>.<\/em><\/li>\n\n\n\n<li><code>maxWeight<\/code>  &#8211; Numeric value (double) with the maximum weight supported by the vehicle<em>.<\/em><\/li>\n\n\n\n<li><code>size<\/code>  &#8211; Numeric value (integer) with the size of the vehicle<em>.<br><\/em><\/li>\n<\/ul>\n\n\n\n<p><strong><em>Example with mandatory parameters<\/em><\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"vehicleTypes\": [\n        {\n            \"name\": \"VUC\",\n            \"maxVolume\": 20,\n            \"maxWeight\": 1200,\n            \"size\": 1\n        },\n        {\n            \"name\": \"3\/4\",\n            \"maxVolume\": 30,\n            \"maxWeight\": 1500,\n            \"size\": 1\n        }\n],\n<\/pre>\n\n\n\n<p><strong>Optional parameters<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>characteristics<\/code> &#8211; Array of <em>strings<\/em> that defines the vehicle\u2019s characteristics. This information is used to validate compatibility between operations and vehicles. For example, if an operation includes <code>\"Refrigerated\"<\/code> in <code>characteristics<\/code>, only vehicles that also have <code>\"Refrigerated\"<\/code> in their characteristics will be able to service it.<\/li>\n\n\n\n<li><code>maxSitesNumber<\/code>  &#8211; Integer with the maximum number of <em>sites <\/em>the vehicle will visit per route.<\/li>\n\n\n\n<li><code>minAvaibleCapacityForCollection<\/code> &#8211; Integer between 0 and 100 indicating the minimum percentage of available capacity the vehicle must have to begin collection activities. For example, if it is 0, collections can be made at any time during the route. If it is 100, collections will only be made when the vehicle is completely empty. The default value is 100.<\/li>\n\n\n\n<li><code>compartmentsAccessMode<\/code>  &#8211; Text with how to access the vehicle&#8217;s load compartment. Allowed values:\n<ul class=\"wp-block-list\">\n<li> <strong><code>ALL_COMPARTMENTS<\/code><\/strong>  &#8211; Indicates possible access to all compartments;<\/li>\n\n\n\n<li><strong> <code>REAR_ACCESS<\/code><\/strong>  &#8211; Access to the rear compartment of the vehicle only;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>compartmentConfigurations<\/code>  &#8211; Array with the characteristics of the cargo compartment.\n<ul class=\"wp-block-list\">\n<li><code>name<\/code> &#8211; (Mandatory) Single text with the name of the compartment;<\/li>\n\n\n\n<li><code>loadingRule<\/code>  &#8211; (Mandatory) Integer with the rule considered for loading the compartment. Possible values:\n<ul class=\"wp-block-list\">\n<li><strong><code>NONE<\/code> &#8211;<\/strong> No defined rule;<\/li>\n\n\n\n<li><strong><code>IDENTICAL_PACKAGINGS<\/code> &#8211;<\/strong> Compartment will only accept products from the same package;<\/li>\n\n\n\n<li><strong><code>SINGLE_OPERATION<\/code> <\/strong>&#8211; The compartment can only be used for one operation per route;<\/li>\n\n\n\n<li><strong><code>IDENTICAL_PRODUCTS<\/code> &#8211;<\/strong> Compartment will only accept one type of product;;<\/li>\n\n\n\n<li><strong><code>IDENTICAL_SITE_PRODUCTS<\/code> <\/strong>&#8211; Compartment will only accept one type of product and it must be from the same <em>site<\/em>;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>maximumCapacity<\/code> &#8211; (Mandatory) Decimal number with the maximum capacity of the compartment.<\/li>\n\n\n\n<li><code>increment<\/code> &#8211; Decimal number with compartment capacity increment.<\/li>\n\n\n\n<li><code>allowedPackagings<\/code>  &#8211; Array with the names of the packages allowed to be loaded into the compartment. It must be unique in one type of compartment.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>trip<\/code>  &#8211; This indicates that in addition to sorting the logistics points, the route must also be returned. All parameters accepted by the <strong><a href=\"https:\/\/developers.maplink.global\/construindo-requisicoes-para-a-trip-api\/\" data-type=\"post\" data-id=\"1074\">Trip API<\/a> <\/strong>are accepted here.<\/li>\n<\/ul>\n\n\n\n<p><strong><em>Example with optional parameters<\/em><\/strong><\/p>\n\n\n\n<p>This example shows how to describe the characteristics of two different vehicles: the first a motorcycle <code>\"Moto\"<\/code> and the second a car <code>\"<code>Car<\/code>\"<\/code>. The <code>\"Moto\"<\/code> has a smaller load capacity, but can only carry packages named <code>\"Resistent_cargo\"<\/code>. <code>\"Car\"<\/code> has a larger load capacity, but can only carry packages named <code>\"Fragile_cargo\"<\/code>.<\/p>\n\n\n\n<p>This way we can detail what kind of package\/product one vehicle can carry and the other cannot.<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"vehicleTypes\": [\n    {\n        \"name\": \"Moto\",\n        \"maxWeight\": 100,\n        \"maxVolume\": 50,\n        \"size\": 30,\n        \"maxSitesNumber\": 24,\n        \"minAvaibleCapacityForCollection\": 0,\n        \"characteristics\": [\"Electric\"],\n        \"compartmentsAccessMode\": \"REAR_ACCESS\",\n        \"compartmentConfigurations\": [\n            {\n                \"name\": \"compartimentMoto\",\n                \"compartments\": [\n                    {\n                        \"name\": \"trunk\",\n                        \"maximumCapacity\": 1000,\n                        \"loadingRule\": \"NONE\",\n                        \"allowedPackagings\": [\n                            \"Resistent_cargo\"\n                        ]\n                    }\n                ]\n            }\n        ],\n        \"trip\": {\n            \"calculationMode\": \"THE_FASTEST\",\n            \"toll\": {\n                \"vehicleType\": \"MOTORCYCLE\"\n            }\n        }\n    },\n    {\n        \"name\": \"Car\",\n        \"maxWeight\": 400,\n        \"maxVolume\": 100,\n        \"size\": 30,\n        \"maxSitesNumber\": 24,\n        \"minAvaibleCapacityForCollection\": 0, \n        \"characteristics\": [\"Electric\",\"Air conditioning\"],\n        \"compartmentsAccessMode\": \"REAR_ACCESS\",\n        \"compartmentConfigurations\": [\n            {\n                \"name\": \"compartimentCar\",\n                \"compartments\": [\n                    {\n                        \"name\": \"trunk\",\n                        \"maximumCapacity\": 1000,\n                        \"loadingRule\": \"NONE\",\n                        \"allowedPackagings\": [\n                            \"Fragile_cargo\"\n                        ]\n                    }\n                ]\n            }\n        ],\n        \"trip\": {\n            \"calculationMode\": \"THE_FASTEST\",\n            \"toll\": {\n                \"vehicleType\": \"MOTORCYCLE\"\n            }\n        }\n    }\n],<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"vehicles\">vehicles*<\/h2>\n\n\n\n<p>The parameter <code>vehicles<\/code><strong> <\/strong> is an <strong>array of objects<\/strong>, where each object will represent a <strong>vehicle available<\/strong> to carry out operations activities, which make up the fleet to meet logistics planning<em>.<\/em><\/p>\n\n\n\n<p>For each object on <code>vehicles<\/code><strong> <\/strong> , the place of origin and return will be defined, as well as the time available to carry out the operations.<\/p>\n\n\n\n<p><strong>Mandatory parameters<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>name<\/code>  &#8211; Single text with the name of the vehicle. Used to be referenced in  <a href=\"#operations\"><code>operations<\/code><\/a>  and to identify the vehicle that will run the route.<\/li>\n\n\n\n<li><code>vehicleType<\/code> &#8211; Text with the declared vehicle type in <a href=\"#vehicleTypes\"><code>vehicleTypes<\/code><\/a>.<\/li>\n\n\n\n<li><code>legislationProfile<\/code> &#8211; Text with the profile of legislation, declared in <a href=\"#legislationProfiles\"><code>legislationProfiles<\/code><\/a>.<\/li>\n\n\n\n<li><code>availablePeriods<\/code>  &#8211; Describes the characteristics of the vehicle driver&#8217;s available working hours. There are mandatory and optional parameters. The mandatory ones are:\n<ul class=\"wp-block-list\">\n<li><code>start<\/code>  &#8211; Start time of the working day. <em>Timestamp <\/em>format in milliseconds. Example: <code>1511901826456<\/code>.<\/li>\n\n\n\n<li><code>end<\/code>  &#8211; End time of the working day. <em>Timestamp <\/em>format in milliseconds. Example:  <code>1511904661038<\/code><em>.<\/em><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p><strong><em>Example with mandatory parameters<\/em><\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"vehicles\": [\n    {\n        \"name\": \"VUC_1\",\n        \"vehicleType\": \"VUC\",\n        \"legislationProfile\": \"DEFAULT\",\n        \"availablePeriods\": [\n            {\n                \"timeWindow\": {\n                    \"start\": 1513753200000,\n                    \"end\": 1513796400000\n                }\n            }\n        ]\n    }\n\n\n],<\/pre>\n\n\n\n<p><strong>Optional parameters<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>availablePeriods<\/code>  &#8211; Describes the characteristics of the vehicle driver&#8217;s available working hours. The optional parameters are:\n<ul class=\"wp-block-list\">\n<li><code>departureSite<\/code>  &#8211; Text with the vehicle&#8217;s starting point at the beginning of the route. If not declared, the Planning API will decide the start <em>depot <\/em>.<\/li>\n\n\n\n<li><code>arrivalSite<\/code>  &#8211; Text with the vehicle&#8217;s return location at the end of the route. If not declared, the Planning API will decide on the last <em>site of <\/em>the last operation to finalize the route.<\/li>\n\n\n\n<li><code>maxRoutesNumber<\/code>  &#8211; Integer with the number of maximum routes for the available period. For example, if <code>\"maxRoutesNumber\": 1<\/code>, the vehicle will perform all operations on the same route.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>logisticZones<\/code>  &#8211; Array with the names of the logistics zones in which the vehicle can carry out operations. They must be unique and have the same name declared in  <a href=\"#logisticZones\" data-type=\"internal\" data-id=\"#logisticZones\"><code>logisticZones<\/code><\/a>.<\/li>\n\n\n\n<li><code>priority<\/code>&nbsp;\u2013 Integer number indicating the vehicle&#8217;s priority level, in decreasing order. Vehicles with a priority equal to 1 will be used first, while higher values \u200b\u200bwill be used in sequence, and vehicles without the informed priority will be used last.<\/li>\n<\/ul>\n\n\n\n<p><strong><em>Example with optional parameters<\/em><\/strong><\/p>\n\n\n\n<p>This example shows two products of the same type that are associated with different packages. We can use the parameter <code>packagings<\/code> to later associate it with the type of vehicle that will transport the product.<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"vehicles\": [\n    {\n        \"name\": \"154\",\n        \"vehicleType\": \"Moto\",\n        \"legislationProfile\": \"DEFAULT\",\n        \"priority\": 1,\n        \"availablePeriods\": [\n            {\n                \"timeWindow\": {\n                    \"start\": 1611057600000,\n                    \"end\": 1611082800000\n                },\n                \"departureSite\": \"maam2\",\n                \"arrivalSite\": \"maam2\",\n                \"maxRoutesNumber\": 1\n            }\n        ]\n        \"logisticZones\": [\"CE - ZONA LESTE\",\"CE - ZONA SUL\"]\n    },\n    {\n        \"name\": \"150\",\n        \"vehicleType\": \"Carro\",\n        \"legislationProfile\": \"DEFAULT\",\n        \"priority\": 1,\n        \"availablePeriods\": [\n            {\n                \"timeWindow\": {\n                    \"start\": 1611057600000,\n                    \"end\": 1611082800000\n                },\n                \"departureSite\": \"fkebvlkbvgrvg\",\n                \"arrivalSite\": \"ufwevidevgre\",\n                \"maxRoutesNumber\": 1\n            }\n        ],\n        \"logisticZones\": [\"CE - ZONA NORTE\",\"CE - ZONA OESTE\"]\n    }\n]<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"products\">products*<\/h2>\n\n\n\n<p>The parameter  <code>products<\/code><strong> <\/strong>is an <strong>array of objects<\/strong>, where each object represents a <strong>product <\/strong>to be transported by the vehicles. Each product must be associated with an operation.<\/p>\n\n\n\n<p>It is also possible to define <em>packages<\/em>, or <em>packagings<\/em>, to associate products with a specific type of vehicle.<\/p>\n\n\n\n<p>Below are the parameters available at <code>products<\/code>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>name<\/code>  &#8211; Single text with the product name. Used to be referenced at <code><a href=\"#operations\" data-type=\"internal\" data-id=\"#operations\">operations<\/a><\/code>.<\/li>\n\n\n\n<li><code>type<\/code>  &#8211; (Optional) Text describing the type of product. Used to identify groups and categories.<\/li>\n\n\n\n<li><code>packagings<\/code>  &#8211; (Optional) Array with the names of the packages associated with the product.  <\/li>\n<\/ul>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<p>This example shows two products of the same type that are associated with different packages. We can use the parameter <code>packagings<\/code> to later associate it with the type of vehicle that will transport the product.<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"products\": [\n        {\n            \"name\": \"Vidro\",\n            \"type\": \"Bebidas\",\n            \"packagings\": [\"Fragile_cargo\"]\n        },\n        {\n            \"name\": \"Lata\",\n            \"type\": \"Bebidas\",\n            \"packagings\": [\"Resistent_cargo\"]\n        }\n]<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"legislationProfiles\">legislationProfiles*<\/h2>\n\n\n\n<p>The parameter  <code>legislationProfiles<\/code><strong> <\/strong>is an <strong>array of objects<\/strong>, where each object represents a <strong>legislation profile<\/strong>. Each legislation profile will define the characteristics of the driver&#8217;s working day, such as continuous driving time and time for lunch breaks<em>.<\/em><\/p>\n\n\n\n<p>One or more legislation profiles can be created according to the characteristics of the operation, for example, for journeys lasting more than one day.<\/p>\n\n\n\n<p>They are referenced at <code><a href=\"#vehicles\">vehicles<\/a><\/code> to define which profile applies to the vehicle\/driver.<\/p>\n\n\n\n<p>Below is the list of parameters available in legislationProfiles:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>name<\/code>  &#8211; Single text with the name of the legislation profile. Used to be referenced in vehicles.<\/li>\n\n\n\n<li><code>maxContinuousDrivingTime<\/code>  &#8211; (Optional) Integer with the maximum time in seconds of continuous driving.<\/li>\n\n\n\n<li><code>drivingPauseDuration<\/code>  &#8211; (Optional) Integer with the time in seconds of pause for steering. Applies once the sum of <code>maxContinuousDrivingTime<\/code> has been reached. It can be used to create lunch or rest breaks. The result is presented as an activity called <code>\"PAUSE\"<\/code>.<\/li>\n\n\n\n<li><code>maxContinuousWorkingTime<\/code>  &#8211; (Optional) Integer with the maximum continuous working time in seconds. WorkingTime is considered to be all the time spent on the activities of <code>\"LOADING\"<\/code>; <code>\"DRIVING\"<\/code>; <code>\"DELIVERY\"<\/code>; <code>\"COLLECTION\"<\/code>; <code>\"WAITING\"<\/code>.<\/li>\n\n\n\n<li><code>workingPauseDuration<\/code>  &#8211; (Optional) Integer with the time in seconds that the job is paused. The following activities are considered work: <code>\"LOADING\"<\/code>; <code>\"DRIVING\"<\/code>; <code>\"DELIVERY\"<\/code>; <code>\"COLLECTION\"<\/code>; <code>\"WAITING\"<\/code>. This parameter is used for multi-day journeys where the time the driver will rest at the end of the work shift is applied.<\/li>\n<\/ul>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<p>The example below shows a legislation profile for multi-day trips.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The value of 3 hours and 45 minutes of continuous driving is set at <code>maxContinuousDrivingTime<\/code>.<\/li>\n\n\n\n<li>At <code>drivingPauseDuration<\/code> 1 hour is set for the lunch break.<\/li>\n\n\n\n<li>At <code>maxContinuousWorkingTime<\/code> an 8-hour work shift is defined.<\/li>\n\n\n\n<li>At <code>workingPauseDuration<\/code> you can take 15 hours off to start work the next day.<\/li>\n<\/ul>\n\n\n\n<p>Thus, the driver will work the hours of driving and deliveries, take a 1-hour lunch break, continue deliveries in the afternoon and when he has worked a total of 8 hours, he will rest for 15 hours to start the new journey the next day.<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"legislationProfiles\": [\n    {\n        \"name\": \"perfil\",\n        \"maxContinuousDrivingTime\": 13500,\n        \"drivingPauseDuration\": 3600,\n        \"maxContinuousWorkingTime\": 28800,\n        \"workingPauseDuration\": 54000\n    }\n]<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"sites\">sites*<\/h2>\n\n\n\n<p>The parameter <code>sites<\/code> is an <strong>array of objects<\/strong>, where each object represents a <strong>location where a delivery or collection operation is to be carried out<\/strong>. They must be referenced in operations, to associate the location with the operation.<\/p>\n\n\n\n<p>They can also be referenced at <code><a href=\"#vehicles\">vehicles<\/a><\/code> to define the driver&#8217;s place of departure and return.<\/p>\n\n\n\n<p>Each object on <code>sites<\/code> can also be associated with a logistics rule to define, for example, the time taken to load and unload on site.<\/p>\n\n\n\n<p>Below are the parameters available on <code>sites<\/code>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>name<\/code>  &#8211; Unique site name text. Used to reference in <em>operations <\/em>and identify in the result.<\/li>\n\n\n\n<li><code>coordinates<\/code>  &#8211; Geographical coordinates in decimal degrees of latitude and longitude:\n<ul class=\"wp-block-list\">\n<li><code>latitude<\/code>  &#8211; Numerical value in decimal degrees. It should be between -90.0 and 90.0. Example: -23.6987.<\/li>\n\n\n\n<li><code>longitude<\/code>  &#8211; Numerical value in decimal degrees. It should be between -180.0 and 180.0. Example: -45.7347.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>logisticConstraints<\/code>  &#8211; Text with reference to the name of <a href=\"#logisticConstraints\">\n  <code>logisticConstraint<\/code>\n<\/a>.<\/li>\n\n\n\n<li><code>logisticZones<\/code>  &#8211; (Optional) Array with the names of the logistics zones to which the <em>site <\/em>belongs. They must be unique and have the same name declared in  <a href=\"#logisticZones\"><code>logisticZones<\/code><\/a><\/li>\n<\/ul>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"sites\": [\n    {\n        \"name\": \"204498250\",\n        \"coordinates\": {\n            \"latitude\": -26.2186024,\n            \"longitude\": -48.6656953\n        },\n        \"logisticConstraints\": \"DEFAULT\",\n        \"logisticZones\": [\"joinville\"]           \n    },\n    {\n        \"name\": \"616188578\",\n        \"coordinates\": {\n            \"latitude\": -26.2408157,\n            \"longitude\": -49.3971109\n        },\n        \"logisticConstraints\": \"DEFAULT\",\n        \"logisticZones\": [\"sbs\"]  \n    }\n] <\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"operations\">operations*<\/h2>\n\n\n\n<p>The parameter <code>operations<\/code><strong> <\/strong> is an <strong>array of objects<\/strong>, where each object will represent an<strong> operation to be solved in logistics planning. <\/strong>Each object will contain the characteristics of the operation, such as the type (delivery or collection), customer time slot, weight and volume of the delivery, among others.<\/p>\n\n\n\n<p>It is recommended to have a maximum of 200 operations per request for better API performance.<\/p>\n\n\n\n<p><strong>Mandatory parameters<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>customerSite<\/code>  &#8211; Text with the name of the <em>site<\/em>, location of the operation.<\/li>\n\n\n\n<li><code>customerTimeWindows<\/code>  &#8211; Time window in which the customer can receive the operation:\n<ul class=\"wp-block-list\">\n<li><code>start<\/code>  &#8211; Start time at which the client is active in the operation. <em>Timestamp <\/em>format in milliseconds: <code>1511901826456<\/code>.<\/li>\n\n\n\n<li><code>end<\/code>  &#8211; End time that the client is active in the operation. <em>Timestamp <\/em>format in milliseconds:  <code>1511904661038<\/code><em>.<\/em><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>depotSite<\/code>  &#8211; Origin <em>warehouse<\/em> for the operation<em>. <\/em>Used to identify from which <em>warehouse<\/em> the product will be loaded onto the vehicle until delivery. In the case of a collection operation, the <em>warehouse <\/em>where the product will be unloaded.<\/li>\n\n\n\n<li><code>id<\/code>  &#8211; Unique text with the operation identifier.<\/li>\n\n\n\n<li><code>product<\/code>  &#8211; Single text with the product name. It must be stated at <code><a href=\"#products\">products<\/a><\/code>.<\/li>\n\n\n\n<li><code>type<\/code>  &#8211; Type of operation, product delivery or product collection. It must be one of the following types: <strong>[<code>COLLECTION, DELIVERY<\/code>].<\/strong><\/li>\n\n\n\n<li><code>volume<\/code>  &#8211; Decimal number with the volume of the product that will be delivered\/collected in the operation. It is important that it is in the same unit as it was used in  <code><a href=\"#vehicleTypes\">vehicleTypes<\/a><\/code><em>. <\/em>For example, cubic meters.<\/li>\n\n\n\n<li><code>weight<\/code>  &#8211; Decimal number with the weight of the product that will be delivered\/collected in the operation. It is important that it is in the same unit as it was used at <code><a href=\"#vehicleTypes\">vehicleTypes<\/a><\/code>. For example, kilograms.<\/li>\n<\/ul>\n\n\n\n<p><strong><em>Example with mandatory parameters<\/em><\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"operations\": [\n    {\n        \"customerSite\": \"MERCADO02GLICERIO\",\n        \"depotSite\": \"DEPOSITO01\",\n        \"type\": \"DELIVERY\",\n        \"customerTimeWindows\": [\n            {\n                \"end\": 1583506800000,\n                \"start\": 1583499600000\n            }\n        ],\n        \"id\": \"NUMORDEM30\",\n        \"product\": \"HD_DIVERSOS\",\n        \"volume\": 1,\n        \"weight\": 0.15\n    },\n    {\n        \"customerSite\": \"MERCADO10SCAETANO\",\n        \"depotSite\": \"DEPOSITO01\",\n        \"type\": \"DELIVERY\",\n        \"customerTimeWindows\": [\n            {\n                \"end\": 1583528400000,\n                \"start\": 1583492400000\n            }\n        ],\n        \"id\": \"NUMORDEM27\",\n        \"product\": \"HD_DIVERSOS\",\n        \"volume\": 1,\n        \"weight\": 0.15\n    }\n]<\/pre>\n\n\n\n<p><strong>Optional parameters<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>customerHandlingDuration<\/code> &#8211; Integer with the time in seconds that will be spent at the client to carry out the operation<em>. <\/em>For <code>DELIVERY<\/code> type operations, this time will be added to the <code>DELIVERY<\/code> activity and for <code>COLLECTION<\/code> type operations, this time will be added to the <code>COLLECTION<\/code> activity.<\/li>\n\n\n\n<li><code>depotHandlingDuration<\/code> &#8211; Integer with the time in seconds that will be spent in the <em>depot <\/em>to carry out the operation<em>. <\/em>For <code>DELIVERY<\/code> type operations, this time will be added in the <code>LOADING<\/code> activity and for <code>COLLECTION<\/code> type operations this time will be added in the <code>UNLOADING<\/code> activity.<\/li>\n\n\n\n<li><code>depotTimeWindows<\/code>  &#8211; Time window of the warehouse in which the operation is to take place. For example, if it is an operation with the activity of <code>\"DELIVERY\"<\/code>, the product will be loaded onto the vehicle inside the warehouse at this time interval (in the API response, the activity will appear as  <code>\"LOADING\"<\/code><em>)<\/em>. If it is an operation with activity from <code>\"COLLECTION\"<\/code>, the product will arrive in the warehouse at this time interval (in the API response, the activity will appear as <code>\"UNLOADING\"<\/code>):\n<ul class=\"wp-block-list\">\n<li><code>start<\/code>  &#8211; Start time of the operation on <code>depot<\/code>. <em>Timestamp <\/em>format in milliseconds: <code>1511901826456<\/code>.<\/li>\n\n\n\n<li><code>end<\/code>  &#8211; End time  <code>depot<\/code><em> <\/em>acts in the operation. <em>Timestamp <\/em>format in milliseconds: <code>1511904661038<\/code>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>group<\/code>  &#8211; Text with the operations group. Used to group operations from the same location manually. Operations that have the same value will be executed together. For example, operations in different stores in the same shopping center.<\/li>\n\n\n\n<li><code>preAllocatedVehicleName<\/code>  &#8211; Text with the name of the vehicle that will carry out the operation in a predefined way. The Planning API will then allocate this associated vehicle to place the operation on its route. Use this parameter for examples in which a favorite driver must serve a customer or a specific vehicle needs to perform the operation.<\/li>\n\n\n\n<li><code>priority<\/code>  &#8211; Integer of the operation&#8217;s priority. Used to define priority in the load, not in the delivery sequence. The priority scale can be ascending or descending depending on the  <a href=\"#optimizationProfile\"><code>optimizationProfile<\/code><\/a><em> <\/em>used<em>.<\/em><\/li>\n\n\n\n<li><code>characteristics<\/code> &#8211; Array of <em>strings<\/em> that defines the characteristics a vehicle must have to handle this operation. This information is used to validate compatibility between operations and vehicles. For example, if the operation has <code>\"Refrigerated\"<\/code> in <code>characteristics<\/code>, only vehicles that also have <code>\"Refrigerated\"<\/code> in their characteristics will be able to service it.<\/li>\n\n\n\n<li><code>quantity<\/code>  &#8211; Decimal number with the operation quantity. For description only, it does not interfere with how the operation is processed.<\/li>\n<\/ul>\n\n\n\n<p><strong><em>Example with optional parameters<\/em><\/strong><\/p>\n\n\n\n<p>This example shows 2 delivery operations to be carried out between 10:00 and 12:00 (<code>customerTimeWindows<\/code>). The operation on <code>MERCADO01MOOCA<\/code> has <code>depotTimeWindows<\/code> set to load at the depot between 11:00 and 12:00 with a duration of 10 minutes (<code>depotHandlingDuration<\/code>).<\/p>\n\n\n\n<p>Due to this characteristic, the truck will only leave the warehouse at 11:10 to carry out the two operations and will have until 12:00 to carry out the two operations.<\/p>\n\n\n\n<p>Both operations are from the same <code>\"group\": \"A\"<\/code> and will be served by <code>\"preAllocatedVehicleName\": \"VUC01\"<\/code>.<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"operations\": [\n    {\n        \"customerSite\": \"MERCADO01MOOCA\",\n        \"depotSite\": \"DEPOSITO01\",\n        \"preAllocatedVehicleName\": \"VUC01\",\n        \"characteristics\":[\"Refrigerated\"],\n        \"priority\": 20,\n        \"type\": \"DELIVERY\",\n        \"customerTimeWindows\": [\n            {\n                \"start\": 1583499600000,\n                \"end\": 1583506800000\n            }\n        ],\n        \"depotTimeWindows\": [\n            {\n                \"start\": 1583503200000,\n                \"end\": 1583506800000\n            }\n        ],\n        \"depotHandlingDuration\": 600,\n        \"id\": \"NUMORDEM25\",\n        \"product\": \"HD_DIVERSOS\",\n        \"volume\": 12,\n        \"weight\": 1,\n        \"quantity\": 10,\n        \"group\": \"A\"\n    },\n    {\n        \"customerSite\": \"MERCADO02GLICERIO\",\n        \"depotSite\": \"DEPOSITO01\",\n        \"preAllocatedVehicleName\": \"VUC01\",\n        \"characteristics\":[\"Refrigerated\"],\n        \"type\": \"DELIVERY\",\n        \"customerTimeWindows\": [\n            {\n                \"start\": 1583499600000,\n                \"end\": 1583506800000\n            }\n        ],\n        \"customerHandlingDuration\": 300,\n        \"id\": \"NUMORDEM30\",\n        \"product\": \"HD_DIVERSOS\",\n        \"volume\": 1,\n        \"weight\": 0.15,\n        \"group\": \"A\"\n    }\n],<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"logisticZones\">logisticZones<\/h2>\n\n\n\n<p>The parameter <code>logisticZones<\/code><strong> <\/strong> is an <strong>array of objects<\/strong>, where each object represents a<strong> logistics zone <\/strong>that can be associated with depots, sites and vehicles to define the relationship between them.<\/p>\n\n\n\n<p>For example, if you define a logistics zone for a vehicle, it will only serve the <em>sites <\/em>that belong to the same logistics zone.<\/p>\n\n\n\n<p>Below are the parameters available in logisticZones:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>name<\/code>  &#8211; Text of the name of the logistics zone. Used for referencing in  <a href=\"#depots\" data-type=\"internal\" data-id=\"#depots\"><code>depots<\/code><\/a><em>,  <\/em><code><a href=\"#vehicles\">vehicles<\/a><\/code><em> <\/em>e  <a href=\"#sites\" data-type=\"internal\" data-id=\"#sites\"><code>sites<\/code><\/a><em>.<\/em><\/li>\n\n\n\n<li><code>zonePriority<\/code>&#8211; Zone priority. It will influence which logistics zone is served first. Possible values: <strong>[<code>PRIORITARY, SECUNDARY<\/code>]<\/strong><\/li>\n<\/ul>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"logisticZones\": [\n        {\n            \"name\": \"blumenau\",\n            \"zonePriority\": \"PRIORITARY\"\n        },\n        {\n            \"name\": \"jaragua\",\n            \"zonePriority\": \"PRIORITARY\"\n        },\n        {\n            \"name\": \"joinville\",\n            \"zonePriority\": \"PRIORITARY\"\n        }\n    ]<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"callback\">callback<\/h2>\n\n\n\n<p>The parameter <code>callback<\/code><strong> <\/strong> is an object that contains the <em>webhook <\/em>data that will be used to receive the problem calculation events.<\/p>\n\n\n\n<p>This way you don&#8217;t have to check the status of the problem to see if it has been processed. The API will notify the <em>webhook <\/em>when the solution is available for consultation.<\/p>\n\n\n\n<p>The following parameters are required:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>url<\/code>  &#8211; URL with the address that will receive the <em>callback<\/em>.<\/li>\n\n\n\n<li><code>user<\/code>  &#8211; (Optional) Text with the user name if the endpoint requires authentication<em>.<\/em><\/li>\n\n\n\n<li><code>password<\/code>  &#8211; (Optional) Password text if the endpoint requires authentication.<\/li>\n<\/ul>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"callback\": {\n    \"password\": \"nome_usuario\",\n    \"url\": \"https:\/\/enqkbfcos3dhgchuikd.webhook.net\",\n    \"user\": \"senha\"\n},<\/pre>\n\n\n\n<p>For more details, see: <a href=\"https:\/\/developers.maplink.global\/en\/how-to-receive-the-current-status-of-the-problem-via-webhook\/\" data-type=\"post\" data-id=\"1037\">How to receive the current problem status via webhook?<\/a><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"optimizationProfile\">optimizationProfile*<\/h2>\n\n\n\n<p>The parameter  <code>optimizationProfile<\/code><strong> <\/strong>indicates which optimization profile the Planning API will use to process the data. Each optimization profile has <strong>characteristics that will be considered to optimize the logistics problem<\/strong>, and each profile is suitable for a specific scenario.<\/p>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"optimizationProfile\": \"BRAZIL46\"<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Optimization profiles available<\/strong><\/h3>\n\n\n\n<p><strong>BRAZIL37<\/strong>: Profile for large problems, distributing routes between vehicles instead of creating more than one route per vehicle. The allocation of vehicles with greater capacity begins.<\/p>\n\n\n\n<p><strong>BRAZIL46<\/strong>: Profile for smaller problems, initial construction with more than 10 locations per route and handling of several different service windows.<\/p>\n\n\n\n<p><strong>BRAZIL_AVG_LOAD_RATE<\/strong>: This profile is used for <strong>multiple vehicle routing problems<\/strong> (VRP) and has the characteristic of meeting the priorities of the operations and with the valuation criteria that highlight the average load capacity in volume\/weight for the vehicles.<\/p>\n\n\n\n<p><strong>BRAZIL_VRP_PICKUP<\/strong>: Profile used for <strong>multiple vehicle routing problem<\/strong> (VRP). For cases where routes need to be carried out, allowing products to be collected from the <em>warehouse <\/em>and from other stores during the route to make deliveries. Useful in cases of <em lang=\"es-EN\">last mile<\/em> use, where the vehicle will depart from the distribution center and collect from stores along the way.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"tripsProfile\">tripsProfile*<\/h2>\n\n\n\n<p><code>tripsProfile<\/code>  is a mandatory parameter in the Planning API request so that the logistics planning calculation takes into account the characteristics of circulation on the road system that will influence routing.<\/p>\n\n\n\n<p>Possible values:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>MAPLINKBR<\/code>&nbsp;\u2013 The distance calculation will be made considering the routes, but only for routes located in Brazil.<\/li>\n\n\n\n<li><code>MAPLINK<\/code> \u2013 The distance calculation will be made considering the routes, but only for routes located in Latin America.<\/li>\n\n\n\n<li><code>FAST<\/code> \u2013 The distance calculation will be done considering the roads, however points above a mileage limit will be calculated linearly. This limit is configured by the parameter <code>linearThreshold<\/code>.<\/li>\n\n\n\n<li><code>LINEAR<\/code> \u2013 The calculation will be done in a completely linear way. Processing is significantly faster, but accuracy is lost. Recommended only for problems with points that are distant from each other.<\/li>\n<\/ul>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"tripsProfile\": \"MAPLINK\"<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"linearThreshold\">linearThreshold<\/h2>\n\n\n\n<p>Numeric value. Used in conjunction with&nbsp;<code>\"tripsProfile\": \"FAST\"<\/code>. Indicates the distance limit, in kilometers, so that distance calculations can be made considering roads, rather than linearly.<\/p>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"linearThreshold\": 500<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"trip\">trip<\/h2>\n\n\n\n<p>The parameter <strong><code>trip<\/code> <\/strong>is an <strong>object <\/strong>and indicates that in addition to sorting the logistics points,<strong>the coordinates that make up the route should also be returned<\/strong>. All parameters accepted by the <strong><a href=\"https:\/\/developers.maplink.global\/lista-de-parametros-trip\/\" data-type=\"post\" data-id=\"1076\">Trip API<\/a> <\/strong>are accepted here.<br>If the parameter has already been declared in <a href=\"#vehicleTypes\"><code>vehicleTypes<\/code><\/a>, the parameters defined there for each type of vehicle will be taken into account.<\/p>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"trip\": {\n    \"calculationMode\": \"THE_FASTEST\",\n    \"crossedBorders\": {\n        \"level\": \"CITY\"\n    },\n    \"toll\": {\n        \"vehicleType\": \"TRUCK_WITH_TWO_DOUBLE_AXLES\"\n    }\n}<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"calculationMode\">calculationMode<\/h2>\n\n\n\n<p>The parameter  <code>calculationMode<\/code><strong> <\/strong>indicates the calculation method to be used for route planning. There are two options available:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>THE_FASTEST<\/code>  &#8211; Returns planning to the fastest route. (Higher average speed)<\/li>\n\n\n\n<li><code>THE_SHORTEST<\/code>  &#8211; Returns the planning to the route with the lowest mileage.<\/li>\n<\/ul>\n\n\n\n<p>If the parameter is not entered, the value <code>THE_FASTEST<\/code> will be taken into account.<\/p>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"calculationMode\": \"THE_FASTEST\",<\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"restrictionZones\">restrictionZones<\/h2>\n\n\n\n<p>The parameter <code>restrictionZones<\/code> is an <strong>array <\/strong>containing the <strong>constraint areas to be considered when solving the logistics problem<\/strong>.<\/p>\n\n\n\n<p>The restriction areas must be previously registered via the <a href=\"https:\/\/developers.maplink.global\/construindo-requisicoes-para-restriction-zone-api\/\" data-type=\"post\" data-id=\"1321\">Restriction Zones API<\/a> and used as an argument in the parameter <code>restrictionZones<\/code>. So the routes will divert away from these areas.<\/p>\n\n\n\n<p>If there is a stopping point within the restriction area, the Planning API will serve the stopping point via the path with the least overlap with the restriction area.<\/p>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\"restrictionZones\": [\n        \"SP_BR381_90_km_Alt_Esq_5_3_Cen_5_45_Dir_5_6\",\n        \"SP_BR381_87_km_Alt_Esq_6_7_Cen_6_7_Dir_6_7\"\n]<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Mandatory parameters are denoted with &#8220;*&#8220;, the others are optional. The list of parameters is described separately by the groups they belong to: startDate The parameter startDate indicates the start date and time to be considered for every calculation of the logistical problem. It is a mandatory parameter and must be in the timestamp format. [&hellip;]<\/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-2506","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\/2506","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=2506"}],"version-history":[{"count":26,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts\/2506\/revisions"}],"predecessor-version":[{"id":3657,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts\/2506\/revisions\/3657"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/media?parent=2506"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/categories?post=2506"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/tags?post=2506"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}