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 class="slate-p" placeholder="Type / for widgets">Todo <strong class="slate-bold">pedido </strong>creado en la plataforma de Picker es determinado por un estado. El estado de un <strong class="slate-bold">pedido </strong>es una parte importante del ciclo de vida del mismo. Estos estados pueden indicar si el <strong class="slate-bold">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, para que el cliente tenga muy claro lo que significa cada estado.</p><p class="slate-p" placeholder="Type / for widgets"></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 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>

Sections