{"id":2424,"date":"2023-12-22T22:01:42","date_gmt":"2023-12-22T22:01:42","guid":{"rendered":"https:\/\/developers.maplink.global\/generar-un-enlace-de-seguimiento\/"},"modified":"2024-02-26T13:27:49","modified_gmt":"2024-02-26T13:27:49","slug":"generar-un-enlace-de-seguimiento","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/es\/generar-un-enlace-de-seguimiento\/","title":{"rendered":"Generar un enlace de seguimiento"},"content":{"rendered":"\n<ul class=\"wp-block-list\">\n<li><a href=\"#criando\">Crear un pedido y generar el enlace de seguimiento<\/a><\/li>\n\n\n\n<li><a href=\"#pagina\">P\u00e1gina de seguimiento<\/a><\/li>\n\n\n\n<li><a href=\"#consulta\">Consultar pedido<\/a><\/li>\n\n\n\n<li><a href=\"#exclusao\" data-type=\"internal\" data-id=\"#exclusao\">Borrar orden<\/a><\/li>\n<\/ul>\n\n<p>Para generar un enlace de seguimiento es necesario realizar una solicitud a la API utilizando el m\u00e9todo <strong>POST<\/strong><em> <\/em>al siguiente endpoint:<\/p>\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/tracking\/v1\/orders\">https:\/\/api.maplink.global\/tracking\/v1\/orders<\/a> &#8211; <strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-luminous-vivid-amber-color\">POST<\/mark><\/strong><\/li>\n<\/ul>\n\n<h2 class=\"wp-block-heading\" id=\"criando\">Crear un pedido y generar el enlace de seguimiento<\/h2>\n\n<h3 class=\"wp-block-heading\"><strong>Par\u00e1metros obligatorios<\/strong><\/h3>\n\n<ul class=\"wp-block-list\">\n<li><code>description<\/code>  &#8211; Descripci\u00f3n.<\/li>\n\n\n\n<li><code>status<\/code>  &#8211; Objeto con datos sobre el estado del pedido.\n<ul class=\"wp-block-list\">\n<li><code>value<\/code>  &#8211; Valores posibles: [<code>\"PREPARING\", \"ON_THE_WAY\", \"DONE\", \"NOT_DONE\", \"CANCELLED\"<\/code>].<\/li>\n\n\n\n<li><code>label<\/code>  &#8211; Texto personalizado que se mostrar\u00e1 en la p\u00e1gina de seguimiento.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>destination<\/code>  &#8211; Objeto que contiene los datos de la ubicaci\u00f3n de destino.\n<ul class=\"wp-block-list\">\n<li><code>road<\/code>  &#8211; (Opcional) Nombre de la calle de destino.<\/li>\n\n\n\n<li><code>number<\/code>  &#8211; (Opcional) N\u00famero del destino.<\/li>\n\n\n\n<li><code>city<\/code>  &#8211; (Opcional) Ciudad de destino.<\/li>\n\n\n\n<li><code>zipCode<\/code>  &#8211; (Opcional) C\u00f3digo postal del destino.<\/li>\n\n\n\n<li><code>state<\/code>  &#8211; (Opcional) Objeto que contiene datos sobre el estado de la ubicaci\u00f3n de destino.\n<ul class=\"wp-block-list\">\n<li><code>code<\/code>  &#8211; Siglas del Estado.<\/li>\n\n\n\n<li><code>name<\/code>  &#8211; Nombre del Estado.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>mainLocation<\/code>  &#8211; Objeto que contiene las coordenadas del destino.\n<ul class=\"wp-block-list\">\n<li><code>lat<\/code>  &#8211; Coordenada de latitud en grados decimales.<\/li>\n\n\n\n<li><code>lon<\/code>  &#8211; Coordenada de latitud en grados decimales.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n<h3 class=\"wp-block-heading\"><strong><em>Ejemplo con par\u00e1metros obligatorios<\/em><\/strong><\/h3>\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=\"\">{\n    \"description\": \"Product Test\",\n    \"status\": {\n        \"value\": \"PREPARING\",\n        \"label\": \"Estamos preparando o seu pedido\"\n    },\n    \"destination\": {\n        \"mainLocation\": {\n            \"lat\": -22.72725697031394,\n            \"lon\": -47.636846753567944\n        }\n    }\n}<\/pre>\n\n<h3 class=\"wp-block-heading\"><strong>Par\u00e1metros opcionales<\/strong><\/h3>\n\n<ul class=\"wp-block-list\">\n<li><code>companyName<\/code>  &#8211; Nombre de la empresa.<\/li>\n\n\n\n<li><code>number<\/code>  &#8211; N\u00famero de pedido.<\/li>\n\n\n\n<li><code>theme<\/code>  &#8211; Tema que se utilizar\u00e1 para personalizar la p\u00e1gina de seguimiento. Si no, se aplicar\u00e1 el tema de <em>white-label<\/em>.<\/li>\n\n\n\n<li><code>estimatedArrival<\/code>  &#8211; Entrega estimada. Formato: <code>\"yyyy-MM-ddTHH:mm:ss\"<\/code>. Ejemplo:  <code>\"2022-11-22T10:00:00\"<\/code><\/li>\n\n\n\n<li><code>totalValue<\/code>  &#8211; Objeto que contiene el valor total del pedido.\n<ul class=\"wp-block-list\">\n<li><code>value<\/code>  &#8211; N\u00famero entero que representa el valor total del pedido.<\/li>\n\n\n\n<li><code>currency<\/code>  &#8211; Tipo de moneda. Para Real, utilice BRL<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>origin<\/code>  &#8211; Objeto que contiene los datos del lugar de origen.\n<ul class=\"wp-block-list\">\n<li><code>road<\/code>  &#8211; (Opcional) Nombre de la calle del lugar de origen.<\/li>\n\n\n\n<li><code>number<\/code>  &#8211; (Opcional) N\u00famero del lugar de origen.<\/li>\n\n\n\n<li><code>city<\/code>  &#8211; (Opcional) Ciudad del lugar de origen.<\/li>\n\n\n\n<li><code>zipCode<\/code>  &#8211; (Opcional) C\u00f3digo postal del lugar de origen.<\/li>\n\n\n\n<li><code>state<\/code>  &#8211; (Opcional) Objeto que contiene datos sobre el lugar de origen.\n<ul class=\"wp-block-list\">\n<li><code>code<\/code>  &#8211; Siglas del Estado.<\/li>\n\n\n\n<li><code>name<\/code>  &#8211; Nombre del Estado.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>mainLocation<\/code>  &#8211; Objeto que contiene las coordenadas del lugar de origen.\n<ul class=\"wp-block-list\">\n<li><code>lat<\/code>  &#8211; Coordenada de latitud en grados decimales.<\/li>\n\n\n\n<li><code>lon<\/code>  &#8211; Coordenada de latitud en grados decimales.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>driver<\/code>  &#8211; Objeto que contiene los datos del conductor\n<ul class=\"wp-block-list\">\n<li><code>name<\/code>  &#8211; (Opcional) Nombre del conductor<\/li>\n\n\n\n<li><code>image<\/code>  &#8211; (Opcional) URL de la foto del conductor que se mostrar\u00e1 en el sitio web<\/li>\n\n\n\n<li><code>currentLocation<\/code>  &#8211; Objeto con las coordenadas iniciales del conductor.\n<ul class=\"wp-block-list\">\n<li><code>lat<\/code>  &#8211; Coordenada de latitud en grados decimales.<\/li>\n\n\n\n<li><code>lon<\/code>  &#8211; Coordenada de longitud en grados decimales.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><\/p>\n<cite><strong>Nota: <\/strong>Si el estado del pedido es <code>ON_THE_WAY<\/code>, el par\u00e1metro <code>driver<\/code> se convierte en obligatorio.<\/cite><\/blockquote>\n\n<p><\/p>\n\n<h3 class=\"wp-block-heading\"><strong><em>Ejemplo con par\u00e1metros opcionales<\/em><\/strong><\/h3>\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=\"\">{\n  \"number\": \"1232132132143438\",\n  \"description\": \"Product Test\",\n  \"estimatedArrival\": \"2022-11-22T10:00:00\",\n  \"companyName\": \"Maplink\",\n  \"totalValue\": {\n    \"value\": 23.12,\n    \"currency\": \"BRL\"\n  },\n  \"status\": {\n    \"value\": \"ON_THE_WAY\",\n    \"label\": \"Pedido em tr\u00e2nsito\"\n  },\n  \"origin\": {\n    \"road\": \"Alameda Campinas\",\n    \"number\": \"579\",\n    \"city\": \"S\u00e3o Paulo\",\n    \"zipCode\": \"01419001\",\n    \"state\": {\n      \"code\": \"SP\",\n      \"name\": \"S\u00e3o Paulo\"\n    },\n    \"mainLocation\": {\n      \"lat\": -22.7342864,\n      \"lon\": -47.6480644\n    }\n  },\n  \"destination\": {\n    \"road\": \"R. Menina Rosana\",\n    \"number\": \"70\",\n    \"city\": \"Itaja\u00ed\",\n    \"zipCode\": \"88304250\",\n    \"state\": {\n      \"code\": \"SC\",\n      \"name\": \"Santa Catarina\"\n    },\n    \"mainLocation\": {\n      \"lat\": -22.72725697031394,\n      \"lon\": -47.636846753567944\n    }\n  },\n  \"driver\": {\n    \"name\": \"Maplink BR\",\n    \"image\": \"https:\/\/example.com\",\n    \"currentLocation\": {\n      \"lat\": -23.564515,\n      \"lon\": -46.652681\n    }\n  },\n  \"theme\": \"DEFAULT\"\n}<\/pre>\n\n<h3 class=\"wp-block-heading\">Ejemplo de respuesta<\/h3>\n\n<p>La respuesta tendr\u00e1 la siguiente estructura:<\/p>\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=\"\">{\n    \"id\": \"63a1b72fd2b7520ade692253\",\n    \"url\": \"https:\/\/tracking.maplink.global\/eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjIjoicUJQRVJzWXBHdUJwOWtzeEExRUduY0lZbFZNOFVMZWUiLCJpZCI6IjYzYTFiNzJmZDJiNzUyMGFkZTY5MjI1MyIsImlhdCI6MTY3MTU0MjU3NX0.NzncB9t_1ShqnlbbS3O3gGt8E0_rloxKrMrmVDwcnQU\"\n}<\/pre>\n\n<p>D\u00f3nde:<\/p>\n\n<ul class=\"wp-block-list\">\n<li><code>id<\/code>  &#8211; ID de referencia de la orden;<\/li>\n\n\n\n<li><code>url<\/code>  &#8211; Enlace a la p\u00e1gina de seguimiento.<\/li>\n<\/ul>\n\n<h2 class=\"wp-block-heading\" id=\"pagina\"><strong>P\u00e1gina de seguimiento<\/strong><\/h2>\n\n<p>La plantilla de p\u00e1gina de seguimiento de <em>white-label<\/em> se puede ver a continuaci\u00f3n:<\/p>\n\n<p class=\"has-text-align-center\"><img loading=\"lazy\" decoding=\"async\" width=\"648\" height=\"312\" src=\"https:\/\/lh7-us.googleusercontent.com\/2zYOmYIWhYG3ua5GFM0f3QlgVoDYbHoI6vcn3JB2wxwQIdtMA9LB90y77bIUYBHJvhQllbs-G_Xc4k8TcaJq_HZeNkhJ7Hx5f_Hb18SdsCtaG39L2s8IUuN854Uy32V4UUIY3-oPcNOfrZdQmVvSNws\"\/><\/p>\n\n<h2 class=\"wp-block-heading\" id=\"consulta\"><strong>Consultar pedido<\/strong><\/h2>\n\n<p>Para consultar el pedido, basta con enviar una solicitud con el m\u00e9todo <strong>GET<\/strong> al siguiente endpoint: <a href=\"https:\/\/api.maplink.global\/tracking\/v1\/orders\/%7B%7BtrackingId%7D%7D\">https:\/\/api.maplink.global\/tracking\/v1\/orders\/<strong>{{trackingId}}<\/strong><\/a><\/p>\n\n<p>Donde el t\u00e9rmino <code>{{trackingId}}<\/code> debe ser sustituido por el ID de la solicitud a consultar.<\/p>\n\n<p>Los pedidos y los enlaces de seguimiento pueden consultarse durante un <strong>periodo de 7 d\u00edas<\/strong>.<\/p>\n\n<h2 class=\"wp-block-heading\" id=\"exclusao\"><strong>Borrar orden<\/strong><\/h2>\n\n<p>Para eliminar un pedido, basta con enviar una solicitud con el m\u00e9todo <strong>DELETE <\/strong>al siguiente endpoint:<\/p>\n\n<p><a href=\"https:\/\/api.maplink.global\/tracking\/v1\/orders\/%7B%7BtrackingId%7D%7D\">https:\/\/api.maplink.global\/tracking\/v1\/orders\/<strong>{{trackingId}}<\/strong><\/a><\/p>\n\n<p>Donde el t\u00e9rmino <code>{{trackingId}}<\/code> debe ser sustituido por el ID de la orden a eliminar.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Para generar un enlace de seguimiento es necesario realizar una solicitud a la API utilizando el m\u00e9todo POST al siguiente endpoint: Crear un pedido y generar el enlace de seguimiento Par\u00e1metros obligatorios Ejemplo con par\u00e1metros obligatorios Par\u00e1metros opcionales Nota: Si el estado del pedido es ON_THE_WAY, el par\u00e1metro driver se convierte en obligatorio. Ejemplo con [&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":[158],"tags":[],"class_list":["post-2424","post","type-post","status-publish","format-standard","hentry","category-tracking-es"],"acf":[],"_links":{"self":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/2424","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/comments?post=2424"}],"version-history":[{"count":7,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/2424\/revisions"}],"predecessor-version":[{"id":2431,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/2424\/revisions\/2431"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/media?parent=2424"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/categories?post=2424"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/tags?post=2424"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}