Picker Express

Descripción General

Por Dónde Empezar

Autenticación

Ciclo de Vida del Pedido

Qué es un Booking?

Ciclo de un Pedido Exitoso

Ciclos de Pedido No Exitoso

Estados del Pedido

API Reference

Stores

Webhooks

Pre-Booking

Bookings

Certificación

Glosario

API Suite Picker

Picker API Suite

Production

Sandbox

<p class="slate-p" placeholder="Type / for widgets">Bienvenido a la documentación de Picker Express API.</p><p class="slate-p" placeholder="Type / for widgets">Picker te permitirá conectar tus plataformas y/o comercios a distintos proveedores de delivery de la región en la que te encuentras. La integración con Picker a través de su API te ofrece las siguientes capacidades:</p><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Administración de <strong class="slate-bold">locales</strong>.</div></li><li class="slate-li"><div style="position:relative">Automatizar la creación de <strong class="slate-bold">pedidos </strong>desde tu plataforma.</div></li><li class="slate-li"><div style="position:relative">Realizar consultas de tarifas.</div></li><li class="slate-li"><div style="position:relative">Recibir en tiempo real las actualizaciones de tu <strong class="slate-bold">pedido</strong>.</div></li></ul><p class="slate-p" placeholder="Type / for widgets">La siguiente guía te permitirá saber los primeros pasos, buenas practicas y las referencias de la API que debes de tomar en cuenta en tu desarrollo.</p><p class="slate-p" placeholder="Type / for widgets"></p>

Bienvenido a la documentación de Picker Express API.

Picker te permitirá conectar tus plataformas y/o comercios a distintos proveedores de delivery de la región en la que te encuentras. La integración con Picker a través de su API te ofrece las siguientes capacidades:

La siguiente guía te permitirá saber los primeros pasos, buenas practicas y las referencias de la API que debes de tomar en cuenta en tu desarrollo.

<p class="slate-p" placeholder="Type / for widgets">En esta página podrás ver cuales son los primeros pasos y que cosas se deben tener en cuenta antes de desarrollar la integración. Si tienes alguna duda acerca de algún concepto de nuestra plataforma, puedes visitar la página de <a href="https://app.theneo.io/pickerexpress/picker-api-suite/glosario" target="_self">Glosario</a> donde tendrás información mas detallada.</p><p class="slate-p" placeholder="Type / for widgets"></p><div  data-type="success" style="background-color:#DEFBE6;color:#00cb38"><div ><svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M7.77116 10.8968L5.72949 8.8551C5.60449 8.7301 5.45171 8.6676 5.27116 8.6676C5.0906 8.6676 4.93088 8.73705 4.79199 8.87594C4.6531 9.01482 4.58366 9.17455 4.58366 9.3551C4.58366 9.53566 4.6531 9.68844 4.79199 9.81344L7.33366 12.3551C7.45866 12.4801 7.60449 12.5426 7.77116 12.5426C7.93783 12.5426 8.08366 12.4801 8.20866 12.3551L13.2087 7.3551C13.3337 7.2301 13.3927 7.07732 13.3857 6.89677C13.3788 6.71621 13.3128 6.56344 13.1878 6.43844C13.0628 6.29955 12.9066 6.2301 12.7191 6.2301C12.5316 6.2301 12.3684 6.29955 12.2295 6.43844L7.77116 10.8968ZM9.00033 17.3343C7.81977 17.3343 6.72255 17.1225 5.70866 16.6989C4.69477 16.2752 3.81283 15.6884 3.06283 14.9384C2.31283 14.1884 1.72602 13.3065 1.30241 12.2926C0.878798 11.2787 0.666992 10.1815 0.666992 9.00094C0.666992 7.83427 0.878798 6.74399 1.30241 5.7301C1.72602 4.71621 2.31283 3.83427 3.06283 3.08427C3.81283 2.33427 4.69477 1.74399 5.70866 1.31344C6.72255 0.88288 7.81977 0.667603 9.00033 0.667603C10.167 0.667603 11.2573 0.88288 12.2712 1.31344C13.285 1.74399 14.167 2.33427 14.917 3.08427C15.667 3.83427 16.2573 4.71621 16.6878 5.7301C17.1184 6.74399 17.3337 7.83427 17.3337 9.00094C17.3337 10.1815 17.1184 11.2787 16.6878 12.2926C16.2573 13.3065 15.667 14.1884 14.917 14.9384C14.167 15.6884 13.285 16.2752 12.2712 16.6989C11.2573 17.1225 10.167 17.3343 9.00033 17.3343ZM9.00033 16.0843C11.0142 16.0843 12.6982 15.4072 14.0524 14.053C15.4066 12.6989 16.0837 11.0148 16.0837 9.00094C16.0837 6.98705 15.4066 5.30302 14.0524 3.94885C12.6982 2.59469 11.0142 1.9176 9.00033 1.9176C6.98644 1.9176 5.30241 2.59469 3.94824 3.94885C2.59408 5.30302 1.91699 6.98705 1.91699 9.00094C1.91699 11.0148 2.59408 12.6989 3.94824 14.053C5.30241 15.4072 6.98644 16.0843 9.00033 16.0843Z" fill="#06837A"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Ten en cuenta que para empezar a desarrollar tu integración con Picker, debes tener una <strong class="slate-bold">cuenta </strong>creada con nosotros; o en su defecto, haber contactado a ventas para que les pueda facilitar una cuenta de desarrollo. Para poder comunicarte con ellos, puedes seguir los pasos en nuestra pagina oficial <a href="https://www.pickerexpress.com/archived/precios/contactar-a-ventas" target="_blank">aquí</a>.</p></div></div><div  data-type="info" style="background-color:#eef1ff;color:#4a59af"><div ><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Una vez que tengas credenciales, ten en consideración que estas te permitirán acceder al dashboard. Estos son las url&apos;s del dashboard para producción y sandbox:</p><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Producción: <a href="https://dashboard.pickerexpress.com/" target="_blank">https://dashboard.pickerexpress.com/</a></div></li><li class="slate-li"><div style="position:relative">Sandbox: <a href="https://dev-dashboard.pickerexpress.com/" target="_blank">https://dev-dashboard.pickerexpress.com/</a></div></li></ul></div></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p" placeholder="Type / for widgets">Para entender un poco la lógica que maneja Picker, una cuenta se la denomina <strong class="slate-bold">Empresa</strong>. Cada <strong class="slate-bold">empresa </strong>puede tener N <strong class="slate-bold">locales </strong>(que pueden representar tiendas, restaurantes, puntos de despacho). Cada <strong class="slate-bold">local </strong>obligatoriamente debe estar referenciado con una <strong class="slate-bold">dirección </strong>y una <strong class="slate-bold">geolocalización </strong>(se las requiere al momento de crearlas). Por ejemplo: Si tu <strong class="slate-bold">empresa </strong>va a manejar 2 sucursales, deberás crear 2 <strong class="slate-bold">locales</strong>.</p><p class="slate-p" placeholder="Type / for widgets">Para poder identificar tu <strong class="slate-bold">empresa </strong>o <strong class="slate-bold">local</strong>, nuestra API utiliza dos tipos de keys:</p><ul class="slate-ul"><li class="slate-li"><div style="position:relative"><strong class="slate-bold">API Key de Local</strong>: Permite hacer operaciones sobre cada <strong class="slate-bold">local </strong>(actualizaciones) y permite realizar operaciones de pedidos (crear, consultar estado, consultar precio)</div></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">Master Key de Empresa</strong>: Permite consultar y hacer operaciones sobre mi <strong class="slate-bold">empresa</strong> (crear locales, consultar locales).</div></li></ul><div  data-type="warning" style="background-color:#FFF8E1;color:#f0b800"><div ><svg width="18" height="16" viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0.916637 15.5009C0.791637 15.5009 0.683998 15.4732 0.59372 15.4176C0.503443 15.362 0.430526 15.2857 0.37497 15.1884C0.319415 15.0912 0.288165 14.9905 0.28122 14.8864C0.274276 14.7822 0.305526 14.6745 0.37497 14.5634L8.4583 0.605103C8.52775 0.493991 8.60761 0.41413 8.69789 0.365519C8.78816 0.316908 8.88886 0.292603 8.99997 0.292603C9.11108 0.292603 9.21178 0.316908 9.30205 0.365519C9.39233 0.41413 9.47219 0.493991 9.54164 0.605103L17.625 14.5634C17.6944 14.6745 17.7257 14.7822 17.7187 14.8864C17.7118 14.9905 17.6805 15.0912 17.625 15.1884C17.5694 15.2857 17.4965 15.362 17.4062 15.4176C17.3159 15.4732 17.2083 15.5009 17.0833 15.5009H0.916637ZM1.99997 14.2509H16L8.99997 2.1676L1.99997 14.2509ZM9.0833 13.0634C9.26386 13.0634 9.41316 13.0044 9.53122 12.8864C9.64928 12.7683 9.7083 12.619 9.7083 12.4384C9.7083 12.2579 9.64928 12.1086 9.53122 11.9905C9.41316 11.8725 9.26386 11.8134 9.0833 11.8134C8.90275 11.8134 8.75344 11.8725 8.63539 11.9905C8.51733 12.1086 8.4583 12.2579 8.4583 12.4384C8.4583 12.619 8.51733 12.7683 8.63539 12.8864C8.75344 13.0044 8.90275 13.0634 9.0833 13.0634ZM9.0833 10.7509C9.26386 10.7509 9.41316 10.6919 9.53122 10.5739C9.64928 10.4558 9.7083 10.3065 9.7083 10.1259V6.70927C9.7083 6.52871 9.64928 6.37941 9.53122 6.26135C9.41316 6.1433 9.26386 6.08427 9.0833 6.08427C8.90275 6.08427 8.75344 6.1433 8.63539 6.26135C8.51733 6.37941 8.4583 6.52871 8.4583 6.70927V10.1259C8.4583 10.3065 8.51733 10.4558 8.63539 10.5739C8.75344 10.6919 8.90275 10.7509 9.0833 10.7509Z" fill="#F1C21B"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Bajo este criterio, al integrarte tendrás un api key por cada <strong class="slate-bold">local </strong>y un master key por tu <strong class="slate-bold">empresa </strong>creado. Por ejemplo: Si tienes un <strong class="slate-bold">empresa </strong>con 3 locales, básicamente tendrías 1 Master Key (representando tu <strong class="slate-bold">empresa</strong>) y 3 Api Keys (cada Api Key representando un <strong class="slate-bold">local</strong>).</p></div></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3">API KEY</h3><p class="slate-p" placeholder="Type / for widgets">Al tener acceso al dashboard podrás obtener los api keys de cada local que vayas creando en la opción de Locales.</p><p class="slate-p" placeholder="Type / for widgets"></p><div style="text-align:center"><img src="https://theneo-prod-public.s3.amazonaws.com/images-1700758898118.jpg" alt="" style="width:80%"/></div><p class="slate-p" placeholder="Type / for widgets">En la esquina superior derecha de cada local, podrás visualizar el api key del <strong class="slate-bold">local</strong>.</p><p class="slate-p" placeholder="Type / for widgets"></p><div style="text-align:center"><img src="https://theneo-prod-public.s3.amazonaws.com/images-1699845181054.jpg" alt="" style="width:20%"/></div><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h3 class="slate-h3">MASTER KEY</h3><p class="slate-p" placeholder="Type / for widgets">Para poder acceder al Master Key de tu tienda, debes ingresar a la opción de Configuraciones (representado por el engrane).</p><p class="slate-p" placeholder="Type / for widgets"></p><div style="text-align:center"><img src="https://theneo-prod-public.s3.amazonaws.com/images-1700759155673.jpg" alt="" style="width:90%"/></div><p class="slate-p" placeholder="Type / for widgets">En configuraciones, podrás encontrar el key de tu <strong class="slate-bold">empresa</strong>.</p><p class="slate-p" placeholder="Type / for widgets"></p><div style="text-align:center"><img src="https://theneo-prod-public.s3.amazonaws.com/images-1699846232912.jpg" alt="" style="width:40%"/></div><p class="slate-p" placeholder="Type / for widgets"></p>

En esta página podrás ver cuales son los primeros pasos y que cosas se deben tener en cuenta antes de desarrollar la integración. Si tienes alguna duda acerca de algún concepto de nuestra plataforma, puedes visitar la página de 

 donde tendrás información mas detallada.

Para entender un poco la lógica que maneja Picker, una cuenta se la denomina 

(que pueden representar tiendas, restaurantes, puntos de despacho). Cada 

obligatoriamente debe estar referenciado con una 

(se las requiere al momento de crearlas). Por ejemplo: Si tu 

va a manejar 2 sucursales, deberás crear 2 

Al tener acceso al dashboard podrás obtener los api keys de cada local que vayas creando en la opción de Locales.

En la esquina superior derecha de cada local, podrás visualizar el api key del 

Para poder acceder al Master Key de tu tienda, debes ingresar a la opción de Configuraciones (representado por el engrane).

En configuraciones, podrás encontrar el key de tu 

<p class="slate-p" placeholder="Type / for widgets">La autenticación que maneja Picker API para cada enpoint es una autenticación de tipo Bearer; y usar como key el api key de tu <strong class="slate-bold">local </strong>o el master key de tu <strong class="slate-bold">empresa</strong> de acuerdo al endpoint que estes usando.</p><h3 class="slate-h3"><strong class="slate-bold">Con Api Key</strong></h3><pre class="slate-CodeBlockElement slate-code_block"><div contenteditable="false"><div ><span aria-live="polite" aria-atomic="false" aria-relevant="additions text" ></span><div ><div ><div >Select...</div><div ><div  style="display:inline-block"><input type="text" autoCapitalize="none" autoComplete="off" autoCorrect="off" id="react-select-4-input" spellcheck="false" tabindex="0" value="" aria-autocomplete="list" style="box-sizing:content-box;width:1px;label:input;background:0;border:0;font-size:inherit;opacity:1;outline:0;padding:0;color:inherit"/><div style="position:absolute;top:0;left:0;visibility:hidden;height:0;overflow:scroll;white-space:pre"></div></div></div></div><div ><span ></span><div  aria-hidden="true"><svg height="20" width="20" viewBox="0 0 20 20" aria-hidden="true" focusable="false" ><path d="M4.516 7.548c0.436-0.446 1.043-0.481 1.576 0l3.908 3.747 3.908-3.747c0.533-0.481 1.141-0.446 1.574 0 0.436 0.445 0.408 1.197 0 1.615-0.406 0.418-4.695 4.502-4.695 4.502-0.217 0.223-0.502 0.335-0.787 0.335s-0.57-0.112-0.789-0.335c0 0-4.287-4.084-4.695-4.502s-0.436-1.17 0-1.615z"></path></svg></div></div></div></div></div><code class="language-bash keep-markup drop-tokens"><div class="slate-code_line">curl --location &apos;https://dev-api.pickerexpress.com/api/createBooking&apos; \</div><div class="slate-code_line">--header &apos;content-language: en&apos; \</div><div class="slate-code_line">--header &apos;Content-Type: application/json&apos; \</div><div class="slate-code_line">--header &apos;Authorization: Bearer {{apiKey}}&apos; \</div></code></pre><h3 class="slate-h3">Con Master Key</h3><pre class="slate-CodeBlockElement slate-code_block"><div contenteditable="false"><div ><span aria-live="polite" aria-atomic="false" aria-relevant="additions text" ></span><div ><div ><div >Select...</div><div ><div  style="display:inline-block"><input type="text" autoCapitalize="none" autoComplete="off" autoCorrect="off" id="react-select-5-input" spellcheck="false" tabindex="0" value="" aria-autocomplete="list" style="box-sizing:content-box;width:1px;label:input;background:0;border:0;font-size:inherit;opacity:1;outline:0;padding:0;color:inherit"/><div style="position:absolute;top:0;left:0;visibility:hidden;height:0;overflow:scroll;white-space:pre"></div></div></div></div><div ><span ></span><div  aria-hidden="true"><svg height="20" width="20" viewBox="0 0 20 20" aria-hidden="true" focusable="false" ><path d="M4.516 7.548c0.436-0.446 1.043-0.481 1.576 0l3.908 3.747 3.908-3.747c0.533-0.481 1.141-0.446 1.574 0 0.436 0.445 0.408 1.197 0 1.615-0.406 0.418-4.695 4.502-4.695 4.502-0.217 0.223-0.502 0.335-0.787 0.335s-0.57-0.112-0.789-0.335c0 0-4.287-4.084-4.695-4.502s-0.436-1.17 0-1.615z"></path></svg></div></div></div></div></div><code class="language-bash keep-markup drop-tokens"><div class="slate-code_line">curl --location &apos;https://dev-api.pickerexpress.com/api/createStore&apos; \</div><div class="slate-code_line">--header &apos;content-language: en&apos; \</div><div class="slate-code_line">--header &apos;Content-Type: application/json&apos; \</div><div class="slate-code_line">--header &apos;Authorization: Bearer {{masterKey}}&apos; \</div></code></pre><p class="slate-p" placeholder="Type / for widgets"></p>

La autenticación que maneja Picker API para cada enpoint es una autenticación de tipo Bearer; y usar como key el api key de tu 

 de acuerdo al endpoint que estes usando.

<p>Todo <strong>pedido </strong>creado en la plataforma de Picker es determinado por un estado. El estado de un <strong>pedido </strong>es una parte importante del ciclo de vida del mismo. Estos estados pueden indicar si el <strong>pedido </strong>esta terminado, cancelado o aun en proceso. Es importante que en la integración que se vaya a desarrollar se mapeen todos los estados posibles, pa</p>

creado en la plataforma de Picker es determinado por un estado. El estado de un 

es una parte importante del ciclo de vida del mismo. Estos estados pueden indicar si el 

esta terminado, cancelado o aun en proceso. Es importante que en la integración que se vaya a desarrollar se mapeen todos los estados posibles, para que el cliente tenga muy claro lo que significa cada estado.

<p class="slate-p" placeholder="Type / for widgets">En este apartado podrás encontrar todos los endpoints expuestos en nuestra API Suite. Este apartado estará dividido en cada una de las entidades a las que tendrás acceso en este API:</p><ul class="slate-ul"><li class="slate-li"><div style="position:relative"><a href="https://app.theneo.io/pickerexpress/picker-api-suite/api-reference/stores" target="_self">Stores</a></div></li><li class="slate-li"><div style="position:relative"><a href="https://app.theneo.io/pickerexpress/picker-api-suite/api-reference/webhooks" target="_self">Webhooks</a></div></li><li class="slate-li"><div style="position:relative"><a href="https://app.theneo.io/pickerexpress/picker-api-suite/api-reference/bookings" target="_self">Bookings</a></div></li></ul><p class="slate-p" placeholder="Type / for widgets"></p><div  data-type="info" style="background-color:#eef1ff;color:#4a59af"><div ><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Ten muy en cuenta las URLs que estés usando para tus endpoint. En la parte derecha de esta página, tendrás el direccionamiento a cada uno de los ambientes que tenemos.</p></div></div><p class="slate-p" placeholder="Type / for widgets"></p>

En este apartado podrás encontrar todos los endpoints expuestos en nuestra API Suite. Este apartado estará dividido en cada una de las entidades a las que tendrás acceso en este API:

<p>En este apartado podrás encontrar los endpoints usados para la administración de los locales de tu <strong>empresa</strong>. Podrás encontrar los endpoints de:</p><ul><li><div><a href="https://app.theneo.io/pickerexpress/picker-api-suite/api-reference/stores/create-store" target="_self">Create Store</a></div></li><li><div></div></li></ul>

En este apartado podrás encontrar los endpoints usados para la administración de los locales de tu 

<p class="slate-p" placeholder="Type / for widgets">En este apartado encontraras los endpoints a utilizar para el manejo de webhooks. Podrás encontrar los endpoints de:</p><ul class="slate-ul"><li class="slate-li"><div style="position:relative"><a href="https://app.theneo.io/pickerexpress/picker-api-suite/api-reference/webhooks/get-webhooks" target="_self">Get Webhooks</a></div></li><li class="slate-li"><div style="position:relative"><a href="https://app.theneo.io/pickerexpress/picker-api-suite/api-reference/webhooks/add-webhook" target="_self">Add Webhooks</a></div></li></ul><p class="slate-p" placeholder="Type / for widgets">Así mismo, podrás encontrar los detalles de los payloads que se envian a los webhooks registrados según cada evento. Los eventos que se devuelven en los webhooks son:</p><ul class="slate-ul"><li class="slate-li"><div style="position:relative"><a href="https://app.theneo.io/pickerexpress/picker-api-suite/api-reference/webhooks/driver-assign" target="_self">Driver Assigned</a></div></li><li class="slate-li"><div style="position:relative"><a href="https://app.theneo.io/pickerexpress/picker-api-suite/api-reference/webhooks/update-booking-status-1" target="_self">Update Booking Status</a></div></li></ul><p class="slate-p" placeholder="Type / for widgets"></p><div  data-type="info" style="background-color:#eef1ff;color:#4a59af"><div ><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Para todos los endpoints de webhooks, necesitas como autorización el api key del local</p></div></div><div  data-type="info" style="background-color:#eef1ff;color:#4a59af"><div ><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Si necesitas mas información acerca de los estados que llegan en los webhooks, puedes visitar la pagina de <a href="https://app.theneo.io/pickerexpress/picker-api-suite/ciclo-de-vida-del-pedido/estados-del-pedido" target="_self">Estados del Pedido</a>.</p></div></div><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

En este apartado encontraras los endpoints a utilizar para el manejo de webhooks. Podrás encontrar los endpoints de:

Así mismo, podrás encontrar los detalles de los payloads que se envian a los webhooks registrados según cada evento. Los eventos que se devuelven en los webhooks son:

<p class="slate-p" placeholder="Type / for widgets">El endpoint de Get Webhooks te permitirá consultar los webhooks configurados en el local. Te retornará todas las urls configuradas a los respectivos eventos del booking. Como esta configuración es por local, deberás utilizar Api Key.</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

El endpoint de Get Webhooks te permitirá consultar los webhooks configurados en el local. Te retornará todas las urls configuradas a los respectivos eventos del booking. Como esta configuración es por local, deberás utilizar Api Key.

Get Webhooks

Token de autenticación tipo Bearer. Se debe usar Api Key

Authorization

Listado de Webhooks configurados por local

200 - OK

401 - Unauthorized

403 - Forbidden

<p class="slate-p" placeholder="Type / for widgets">El endpoint de Add Webhook te permitirá agregar webhooks a los eventos que afectan un booking. Los eventos que pueden registrarse con una url para su respuesta son:</p><ul class="slate-ul"><li class="slate-li"><div style="position:relative"><a href="https://app.theneo.io/pickerexpress/picker-api-suite/api-reference/webhooks/driver-assign" target="_self">DRIVER_ASSIGNED</a>: Cuando un conductor es asignado a un pedido.</div></li><li class="slate-li"><div style="position:relative"><a href="https://app.theneo.io/pickerexpress/picker-api-suite/api-reference/webhooks/update-booking-status-1" target="_self">UPDATE_BOOKING_STATUS</a>: Cuando un pedido cambia de estado.</div></li></ul><p class="slate-p" placeholder="Type / for widgets">Cuando cualquiera de estos eventos se dispara en nuestra plataforma, automáticamente enviamos un POST a la url registrada para el evento con el payload respectivo (Los payloads enviados por evento, los puedes revisar en páginas posteriores).</p><p class="slate-p" placeholder="Type / for widgets"></p><div  data-type="info" style="background-color:#eef1ff;color:#4a59af"><div ><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Ten en cuenta que los webhooks son configurados por local.</p></div></div><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

El endpoint de Add Webhook te permitirá agregar webhooks a los eventos que afectan un booking. Los eventos que pueden registrarse con una url para su respuesta son:

Cuando cualquiera de estos eventos se dispara en nuestra plataforma, automáticamente enviamos un POST a la url registrada para el evento con el payload respectivo (Los payloads enviados por evento, los puedes revisar en páginas posteriores).

Add Webhook

Indicates the specific event that will trigger the webhook. The webhook will be activated when this type of event occurs.

type

Endpoint to receive the payload of the webhook. It is the destination where the POST request will be sent.

Content-Type

data

400 - Bad request

<p class="slate-p" placeholder="Type / for widgets">El evento de DRIVER_ASSIGNED se enviará al webhook registrado en el local cada vez que se asigne un nuevo conductor a un pedido. Este evento puede enviarse desde 1 hasta varias veces durante un pedido. Esto puede pasar en los siguientes escenarios:</p><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Se asigna un conductor al pedido.</div></li><li class="slate-li"><div style="position:relative">Se reasigna un nuevo conductor a un pedido que ya tenía un conductor.</div></li><li class="slate-li"><div style="position:relative">Se hace una nueva búsqueda a un pedido que ya tiene conductor asignado. Previo a esto, se elimina al conductor del pedido y este último se devuelve al estado READY_FOR_PICKUP.</div></li></ul><p class="slate-p" placeholder="Type / for widgets">Cabe recalcar que si a un pedido se le asigna un conductor, automáticamente se lo pasará al estado ACCEPTED. </p><p class="slate-p" placeholder="Type / for widgets"></p><div  data-type="info" style="background-color:#eef1ff;color:#4a59af"><div ><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Es recomendable de que si se va hacer tracking del pedido, debes tener guardado el id del booking para poder hacerle match al momento de que llegue el webhook en tu integración.</p></div></div><div  data-type="error" style="background-color:#FFF1F1;color:#ff3030"><div ><svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M9.08366 9.9801C9.25033 9.9801 9.39269 9.92107 9.51074 9.80302C9.6288 9.68496 9.68783 9.53566 9.68783 9.3551V5.31344C9.68783 5.14677 9.62533 5.00441 9.50033 4.88635C9.37533 4.7683 9.22949 4.70927 9.06283 4.70927C8.88227 4.70927 8.73296 4.7683 8.61491 4.88635C8.49685 5.00441 8.43783 5.15371 8.43783 5.33427V9.37594C8.43783 9.5426 8.50033 9.68496 8.62533 9.80302C8.75033 9.92107 8.9031 9.9801 9.08366 9.9801ZM9.00033 13.1676C9.19477 13.1676 9.35796 13.1016 9.48991 12.9697C9.62185 12.8377 9.68783 12.6745 9.68783 12.4801C9.68783 12.2857 9.62185 12.1225 9.48991 11.9905C9.35796 11.8586 9.19477 11.7926 9.00033 11.7926C8.80588 11.7926 8.64269 11.8586 8.51074 11.9905C8.3788 12.1225 8.31283 12.2857 8.31283 12.4801C8.31283 12.6745 8.3788 12.8377 8.51074 12.9697C8.64269 13.1016 8.80588 13.1676 9.00033 13.1676ZM9.00033 17.3343C7.81977 17.3343 6.72255 17.1225 5.70866 16.6989C4.69477 16.2752 3.81283 15.6884 3.06283 14.9384C2.31283 14.1884 1.72602 13.3065 1.30241 12.2926C0.878798 11.2787 0.666992 10.1815 0.666992 9.00094C0.666992 7.83427 0.878798 6.74399 1.30241 5.7301C1.72602 4.71621 2.31283 3.83427 3.06283 3.08427C3.81283 2.33427 4.69477 1.74399 5.70866 1.31344C6.72255 0.88288 7.81977 0.667603 9.00033 0.667603C10.167 0.667603 11.2573 0.88288 12.2712 1.31344C13.285 1.74399 14.167 2.33427 14.917 3.08427C15.667 3.83427 16.2573 4.71621 16.6878 5.7301C17.1184 6.74399 17.3337 7.83427 17.3337 9.00094C17.3337 10.1815 17.1184 11.2787 16.6878 12.2926C16.2573 13.3065 15.667 14.1884 14.917 14.9384C14.167 15.6884 13.285 16.2752 12.2712 16.6989C11.2573 17.1225 10.167 17.3343 9.00033 17.3343ZM9.00033 16.0843C10.9448 16.0843 12.6114 15.3898 14.0003 14.0009C15.3892 12.612 16.0837 10.9454 16.0837 9.00094C16.0837 7.05649 15.3892 5.38982 14.0003 4.00094C12.6114 2.61205 10.9448 1.9176 9.00033 1.9176C7.05588 1.9176 5.38921 2.61205 4.00033 4.00094C2.61144 5.38982 1.91699 7.05649 1.91699 9.00094C1.91699 10.9454 2.61144 12.612 4.00033 14.0009C5.38921 15.3898 7.05588 16.0843 9.00033 16.0843Z" fill="#E90005"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Si el llamado al webhook registrado falla, se harán hasta 2 intentos nuevos de llamada con un intervalo de 30 segundos.</p></div></div><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

El evento de DRIVER_ASSIGNED se enviará al webhook registrado en el local cada vez que se asigne un nuevo conductor a un pedido. Este evento puede enviarse desde 1 hasta varias veces durante un pedido. Esto puede pasar en los siguientes escenarios:

Cabe recalcar que si a un pedido se le asigna un conductor, automáticamente se lo pasará al estado ACCEPTED. 

Driver Assigned

driverName

driverImage

driverEmail

driverMobile

bookingID

bookingNumericId

deliveryProvider

<p class="slate-p" placeholder="Type / for widgets">El evento de UPDATE_BOOKING_STATUS se enviará a los webhooks registrados cada vez que un pedido cambie de estado. Por cada cambio de estado que sufra un pedido, se ejecutará un POST hacia el webhook registrado para este evento en el local.</p><p class="slate-p" placeholder="Type / for widgets">Cuando existe una cancelación de un pedido, el payload puede incluir la razón por la cual se canceló el pedido.</p><p class="slate-p" placeholder="Type / for widgets"></p><div  data-type="info" style="background-color:#eef1ff;color:#4a59af"><div ><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Es recomendable de que si se va hacer tracking del pedido, debes tener guardado el id del booking para poder hacerle match al momento de que llegue el webhook en tu integración.</p></div></div><div  data-type="warning" style="background-color:#FFF8E1;color:#f0b800"><div ><svg width="18" height="16" viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0.916637 15.5009C0.791637 15.5009 0.683998 15.4732 0.59372 15.4176C0.503443 15.362 0.430526 15.2857 0.37497 15.1884C0.319415 15.0912 0.288165 14.9905 0.28122 14.8864C0.274276 14.7822 0.305526 14.6745 0.37497 14.5634L8.4583 0.605103C8.52775 0.493991 8.60761 0.41413 8.69789 0.365519C8.78816 0.316908 8.88886 0.292603 8.99997 0.292603C9.11108 0.292603 9.21178 0.316908 9.30205 0.365519C9.39233 0.41413 9.47219 0.493991 9.54164 0.605103L17.625 14.5634C17.6944 14.6745 17.7257 14.7822 17.7187 14.8864C17.7118 14.9905 17.6805 15.0912 17.625 15.1884C17.5694 15.2857 17.4965 15.362 17.4062 15.4176C17.3159 15.4732 17.2083 15.5009 17.0833 15.5009H0.916637ZM1.99997 14.2509H16L8.99997 2.1676L1.99997 14.2509ZM9.0833 13.0634C9.26386 13.0634 9.41316 13.0044 9.53122 12.8864C9.64928 12.7683 9.7083 12.619 9.7083 12.4384C9.7083 12.2579 9.64928 12.1086 9.53122 11.9905C9.41316 11.8725 9.26386 11.8134 9.0833 11.8134C8.90275 11.8134 8.75344 11.8725 8.63539 11.9905C8.51733 12.1086 8.4583 12.2579 8.4583 12.4384C8.4583 12.619 8.51733 12.7683 8.63539 12.8864C8.75344 13.0044 8.90275 13.0634 9.0833 13.0634ZM9.0833 10.7509C9.26386 10.7509 9.41316 10.6919 9.53122 10.5739C9.64928 10.4558 9.7083 10.3065 9.7083 10.1259V6.70927C9.7083 6.52871 9.64928 6.37941 9.53122 6.26135C9.41316 6.1433 9.26386 6.08427 9.0833 6.08427C8.90275 6.08427 8.75344 6.1433 8.63539 6.26135C8.51733 6.37941 8.4583 6.52871 8.4583 6.70927V10.1259C8.4583 10.3065 8.51733 10.4558 8.63539 10.5739C8.75344 10.6919 8.90275 10.7509 9.0833 10.7509Z" fill="#F1C21B"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Si tu Workspace o Empresa tiene activado la funcionalidad de Prueba de Entrega, a partir del estado WAY_TO_DELIVER, se te enviará el campo <em class="slate-italic">validationCode</em>. El contenido de este campo deberá ser proveído al cliente para poder completar la entrega (el conductor solicitará este código).</p></div></div><div  data-type="error" style="background-color:#FFF1F1;color:#ff3030"><div ><svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M9.08366 9.9801C9.25033 9.9801 9.39269 9.92107 9.51074 9.80302C9.6288 9.68496 9.68783 9.53566 9.68783 9.3551V5.31344C9.68783 5.14677 9.62533 5.00441 9.50033 4.88635C9.37533 4.7683 9.22949 4.70927 9.06283 4.70927C8.88227 4.70927 8.73296 4.7683 8.61491 4.88635C8.49685 5.00441 8.43783 5.15371 8.43783 5.33427V9.37594C8.43783 9.5426 8.50033 9.68496 8.62533 9.80302C8.75033 9.92107 8.9031 9.9801 9.08366 9.9801ZM9.00033 13.1676C9.19477 13.1676 9.35796 13.1016 9.48991 12.9697C9.62185 12.8377 9.68783 12.6745 9.68783 12.4801C9.68783 12.2857 9.62185 12.1225 9.48991 11.9905C9.35796 11.8586 9.19477 11.7926 9.00033 11.7926C8.80588 11.7926 8.64269 11.8586 8.51074 11.9905C8.3788 12.1225 8.31283 12.2857 8.31283 12.4801C8.31283 12.6745 8.3788 12.8377 8.51074 12.9697C8.64269 13.1016 8.80588 13.1676 9.00033 13.1676ZM9.00033 17.3343C7.81977 17.3343 6.72255 17.1225 5.70866 16.6989C4.69477 16.2752 3.81283 15.6884 3.06283 14.9384C2.31283 14.1884 1.72602 13.3065 1.30241 12.2926C0.878798 11.2787 0.666992 10.1815 0.666992 9.00094C0.666992 7.83427 0.878798 6.74399 1.30241 5.7301C1.72602 4.71621 2.31283 3.83427 3.06283 3.08427C3.81283 2.33427 4.69477 1.74399 5.70866 1.31344C6.72255 0.88288 7.81977 0.667603 9.00033 0.667603C10.167 0.667603 11.2573 0.88288 12.2712 1.31344C13.285 1.74399 14.167 2.33427 14.917 3.08427C15.667 3.83427 16.2573 4.71621 16.6878 5.7301C17.1184 6.74399 17.3337 7.83427 17.3337 9.00094C17.3337 10.1815 17.1184 11.2787 16.6878 12.2926C16.2573 13.3065 15.667 14.1884 14.917 14.9384C14.167 15.6884 13.285 16.2752 12.2712 16.6989C11.2573 17.1225 10.167 17.3343 9.00033 17.3343ZM9.00033 16.0843C10.9448 16.0843 12.6114 15.3898 14.0003 14.0009C15.3892 12.612 16.0837 10.9454 16.0837 9.00094C16.0837 7.05649 15.3892 5.38982 14.0003 4.00094C12.6114 2.61205 10.9448 1.9176 9.00033 1.9176C7.05588 1.9176 5.38921 2.61205 4.00033 4.00094C2.61144 5.38982 1.91699 7.05649 1.91699 9.00094C1.91699 10.9454 2.61144 12.612 4.00033 14.0009C5.38921 15.3898 7.05588 16.0843 9.00033 16.0843Z" fill="#E90005"></path></svg></div><div ><p class="slate-p" placeholder="Type / for widgets">Si el llamado al webhook registrado falla, se harán hasta 2 intentos nuevos de llamada con un intervalo de 30 segundos.</p></div></div><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

El evento de UPDATE_BOOKING_STATUS se enviará a los webhooks registrados cada vez que un pedido cambie de estado. Por cada cambio de estado que sufra un pedido, se ejecutará un POST hacia el webhook registrado para este evento en el local.

Cuando existe una cancelación de un pedido, el payload puede incluir la razón por la cual se canceló el pedido.

Update Booking Status

statusText

currentStatus

cancelReason

Código de entrega. Debe ser proveída al cliente para poder completar la entrega

validationCode

Un Pre-booking es denominada a una plantilla con datos preliminares de un pedido sin los datos del punto final de entrega. Para poder convertirlo en un booking, es necesario que se pueda ingresar la dirección de entrega mediante una url que es retornado al momento de crear o consultar un pre-booking. Una vez ingresada la dirección final, el booking se crea y se inicia automáticamente la búsqueda de un conductor.

En este apartado podrás encontrar todos los endpoints utilizados para poder crear un pre-booking:

<p>En este apartado encontrarás todos los endpoints relacionados a los pedidos o bookings. Podras encontrar desde consultas de precios, creación de bookings, consultas y cancelaciones. Los endpoints que puedes encontrar en esta sección son:</p><ul><li><div><a href="https://app.theneo.io/pickerexpress/picker-api-suite/api-reference/bookings/pre-checkout" target="_self">Pre Checkout</a></div></li></ul>

En este apartado encontrarás todos los endpoints relacionados a los pedidos o bookings. Podras encontrar desde consultas de precios, creación de bookings, consultas y cancelaciones. Los endpoints que puedes encontrar en esta sección son:

<p class="slate-p" placeholder="Type / for widgets">Previo a la salida a producción, <strong class="slate-bold">es imperativo </strong>que se coordine una reunión para poder certificar tu integración con Picker. Dentro de esta certificación se van a revisar los siguientes puntos, dependiendo de las funcionalidades que tengas integradas:</p><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Bookings:</div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Pre Checkout</div></li><li class="slate-li"><div style="position:relative">Create Booking</div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Datos correctos y concretos del cliente</div></li><li class="slate-li"><div style="position:relative">Valores a cobrar</div></li><li class="slate-li"><div style="position:relative">Uso correcto de métodos de pago</div></li><li class="slate-li"><div style="position:relative">Uso de cook time (Opcional)</div></li></ul></li><li class="slate-li"><div style="position:relative">Cancel Booking (Opcional)</div></li></ul></li><li class="slate-li"><div style="position:relative">Webhooks</div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Registro de Webhooks</div></li><li class="slate-li"><div style="position:relative">Interpretación de estados en su sistema</div></li></ul></li><li class="slate-li"><div style="position:relative">Stores</div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Create Store</div></li><li class="slate-li"><div style="position:relative">Get Store (Opcional)</div></li></ul></li><li class="slate-li"><div style="position:relative">Pre Booking</div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Create Pre Booking</div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Datos del cliente y del negocio sea correcto</div></li><li class="slate-li"><div style="position:relative">Flujo de envió de link para confirmar dirección</div></li></ul></li><li class="slate-li"><div style="position:relative">Cancel Pre Booking (Opcional)</div></li></ul></li><li class="slate-li"><div style="position:relative">Interacción con Usuario Final</div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Visualización de Estados</div></li><li class="slate-li"><div style="position:relative">Visualización de datos de pedido</div></li><li class="slate-li"><div style="position:relative">Visualización de Tracking de Picker</div></li></ul></li></ul><p class="slate-p" placeholder="Type / for widgets">Para acordar una reunión de certificación, se la puede agendar mediante <a href="https://calendly.com/gustavo-119/reunion" target="_self">este link.</a></p><p class="slate-p" placeholder="Type / for widgets"></p>

que se coordine una reunión para poder certificar tu integración con Picker. Dentro de esta certificación se van a revisar los siguientes puntos, dependiendo de las funcionalidades que tengas integradas:

Para acordar una reunión de certificación, se la puede agendar mediante 

<ul class="slate-ul"><li class="slate-li"><div style="position:relative"><strong class="slate-bold">¿Es necesario usar el endpoint de pre-checkout para usar el API?</strong></div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">No es imperativo usar el endpoint de pre-checkout; sin embargo lo recomendamos para que puedas saber con anterioridad el precio de un pedido antes de crearlo.</div></li></ul></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">¿Para que me sirve el Dashboard?</strong></div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">El Dashboard de Picker es una herramienta visual donde podrás:</div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Visualizar, administrar y crear pedidos.</div></li><li class="slate-li"><div style="position:relative">Visualizar y administrar tus locales.</div></li><li class="slate-li"><div style="position:relative">Manejar tus configuraciones generales.</div></li><li class="slate-li"><div style="position:relative">Consultar los keys para la integración.</div></li></ul></li></ul></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">¿En que escenario debo enviar CASH o CARD en paymentMethod al crear un booking?</strong></div><ul class="slate-ul"><li class="slate-li"><div style="position:relative"><em class="slate-italic">CASH</em>: Cuando el pedido requiere un pago contra entrega en efectivo.</div></li><li class="slate-li"><div style="position:relative"><em class="slate-italic">CARD</em>: Cuando unicamente requieres que el conductor recoja el pedido y lo entregue en sitio. Esto funciona si de tu lado de la integración ya estas realizando el cobro al cliente (Por transferencia, pasarela de pagos, etc).</div></li></ul></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">¿Qué valor debo ingresar en el campo orderAmount?</strong></div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Nosotros recomendamos fuertemente que se coloque el valor en bruto del pedido (sin delivery fee, descuentos u otros rubros), inclusive si el pedido tiene como método de pago CASH. Esto es necesario para la auditoría de los proveedores en el caso que suceda alguna incidencia con el pedido en curso.</div></li></ul></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">Acabo de crear mi pedido, pero no esta buscando en ningún proveedor. ¿Qué me esta haciendo falta?</strong></div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Es muy probable que tu pedido tenga cooktime y este en estado ON_HOLD. Cuando un pedido se inicia con cooktime, tiene un tiempo de espera hasta antes de iniciar una búsqueda en los proveedores. Para iniciar una búsqueda, hay las siguientes opciones:</div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Esperar que se cumpla el tiempo de espera</div></li><li class="slate-li"><div style="position:relative">Iniciar la búsqueda manualmente mediante la opción de Iniciar Búsqueda en el menu del pedido en Dashboard</div></li><li class="slate-li"><div style="position:relative">Usar endpoint de Start Search.</div></li></ul></li></ul></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">Me aparece que mi workspace esta suspendido. ¿Qué debo hacer?</strong></div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Si tu empresa esta suspendida, puedes contactar a soporte mediante la opción de chat que existe en Dashboard para conocer mas del asunto.</div></li></ul></li></ul><p class="slate-p" placeholder="Type / for widgets"></p>

<ul class="slate-ul"><li class="slate-li"><div style="position:relative"><strong class="slate-bold">Empresa: </strong>Espacio de trabajo que representa la empresa o marca, el cual puede tener 1 o mas locales asociados. Tiene un master key único, el cual es utilizado para las operaciones vía API. También es conocido como Workspace en algunas nomenclaturas.</div></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">Local: </strong>Es la representación de un comercio/local/restaurante/punto de despacho en la plataforma de Picker. Cada local tiene un identificativo único (Api Key); y tiene asociado una dirección y una geolocalización necesarias para la operación.</div></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">Master Key: </strong>Es el identificador único de cada empresa. Es obligatorio usarlo en cada operación vía API que requiere la identificación del empresa. Ejemplo: En el endpoint Create Store, es necesario para poder indicar a que empresa se debe asociar la tienda recién creada.</div></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">Api Key: </strong>Es el identificador único de cada tienda. Es obligatorio usarlo en las operaciones vía API en que se requiere la identificación del local. Ejemplo: En el endpoint Create Booking, es necesario para poder identificar la tienda a donde el conductor tiene que recoger el pedido.</div></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">Booking: </strong>Es la representación del pedido como tal en la plataforma de Picker. Cada booking o pedido tiene un identificador único interno (id), público (bookingNumericId) y un estado (statusText). Este ultimo campo representa en que estado del proceso se encuentra el pedido.</div></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">Orden: </strong>Es la representación de cada llamado a un proveedor. Cuando un booking se crea, este llama a todos los proveedores que tiene activado el local; cada uno de estos llamados es una orden. Un booking puede tener de N ordenes de acuerdo al número de proveedores que puede atenderlo.</div></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">Dashboard: </strong>Es la plataforma visual de Picker. Desde esta web se podrán administrar y configurar la empresa como sus locales. Para acceder al dashboard de producción haz click <a href="https://dashboard.pickerexpress.com/" target="_self">aquí</a>.</div></li><li class="slate-li"><div style="position:relative"><strong class="slate-bold">Restart Search: </strong>Se lo conoce también como una rebúsqueda. Sucede cuando un pedido ya con conductor ejecuta una nueva busqueda de conductor en cada proveedor debido a que el conductor asignado no puede cumplir con el pedido antes de llegar al local. Restart Search se puede disparar en estos escenarios:</div><ul class="slate-ul"><li class="slate-li"><div style="position:relative">Proveedor cancela pedido antes de llegar al local</div></li><li class="slate-li"><div style="position:relative">Proveedor desasigna un conductor antes de llegar al local</div></li><li class="slate-li"><div style="position:relative">Soporte lo ejecuta manualmente en el caso que exista alguna novedad con el conductor del pedido</div></li></ul></li></ul><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>