Picker API Suite

## Sections
• [Descripción General](https://app.theneo.io/pickerexpress/picker-api-suite/descripcion-general.md): 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: Administración de locales . Automatizar la creación de envíos inmediatos o en ruta desde tu plataforma. Realizar consultas de tarifas. Recibir en tiempo real las actualizaciones de tu pedido . Consultar las guías de las rutas. 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.
• [Por Donde Empezar](https://app.theneo.io/pickerexpress/picker-api-suite/por-donde-empezar.md): 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 Glosario donde tendrás información mas detallada. Ten en cuenta que para empezar a desarrollar tu integración con Picker, debes tener una cuenta 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 aquí . Una vez que tengas credenciales, ten en consideración que estas te permitirán acceder al dashboard. Estos son las url's del dashboard para producción y sandbox: Producción: https://dashboard.pickerexpress.com/ Sandbox: https://dev-dashboard.pickerexpress.com/ Para entender un poco la lógica que maneja Picker, una cuenta se la denomina Empresa . Cada empresa puede tener N locales (que pueden representar tiendas, restaurantes, puntos de despacho). Cada local obligatoriamente debe estar referenciado con una dirección y una geolocalización (se las requiere al momento de crearlas). Por ejemplo: Si tu empresa va a manejar 2 sucursales, deberás crear 2 locales . Para poder identificar tu empresa o local , nuestra API utiliza dos tipos de keys: API Key de Local : Permite hacer operaciones sobre cada local (actualizaciones) y permite realizar operaciones de pedidos (crear, consultar estado, consultar precio) Master Key de Empresa : Permite consultar y hacer operaciones sobre mi empresa (crear locales, consultar locales). Bajo este criterio, al integrarte tendrás un api key por cada local y un master key por tu empresa creado. Por ejemplo: Si tienes un empresa con 3 locales, básicamente tendrías 1 Master Key (representando tu empresa ) y 3 Api Keys (cada Api Key representando un local ). API KEY Al tener acceso al dashboard podrás obtener los api keys de cada local que vayas creando en la opción de Locales. En el menú contextual de cada local, existirá la opción de “Copiar API Key”. Al hacer click en esta opción, se copiará el api key de tu local en tu computador. MASTER KEY 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 empresa .
• [Autenticación](https://app.theneo.io/pickerexpress/picker-api-suite/autenticacion.md): 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 local o el master key de tu empresa de acuerdo al endpoint que estes usando. Con Api Key Bash curl --location 'https://external-api.pickerexpress.com/api/createBooking' \ --header 'content-language: en' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {{apiKey}}' Con Master Key Bash curl --location 'https://external-api.pickerexpress.com/api/createStore' \ --header 'content-language: en' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {{masterKey}}' \
• [Envio inmediato o en ruta?](https://app.theneo.io/pickerexpress/picker-api-suite/debo-crear-un-pedido-o-un-express-delivery.md): Antes de integrarte a Picker API, tienes que saber diferenciar entre un booking (envío inmediato) o un express delivery (envio en ruta). Para eso te explicamos a continuación las características de cada uno. Booking (Envío Inmediato) Son entregas que deben atenderse enseguida (bajo demanda) Una vez que se crea un booking, este enseguida busca un conductor para ser atendido de manera rápida. Esta más orientado hacia restaurantes y comida (por su modelo bajo demanda y entrega rápida). El booking no requiere de una ruta (agrupación de otras entregas) para realizarse. Tiempos de entrega de booking son cortos (entre 30 a 40 minutos) En el caso de utilizar bookings, deberas usar los endpoints del apartado Bookings Delivery (Envío en ruta) Son entregas que pueden entregarse en el transcurso del día. Pueden entregarse en una ruta en conjunto con otros deliveries (envio en ruta) Una vez creado un delivery, se espera un tiempo determinado para agruparse con otros en una ruta y posteriormente ejecutarla. Esta mas orientado hacia retail y entregas programadas. Un delivery debe agruparse en una ruta para poder gestionarse (inclusive si esa ruta contiene un solo delivery). Tiempos de entrega mas largos (entre 2 y 3 horas) En el caso de utilizar delivery, deberas usar los endpoint del apartado Express Delivery.
• [Ciclo de Vida de un Booking](https://app.theneo.io/pickerexpress/picker-api-suite/ciclo-de-vida-de-un-booking.md): Todo booking creado en la plataforma de Picker es determinado por un estado. El estado de un pedido es una parte importante del ciclo de vida del mismo. Estos estados pueden indicar si el pedido 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.
  • [Que es un Booking?](https://app.theneo.io/pickerexpress/picker-api-suite/ciclo-de-vida-de-un-booking/que-es-un-booking.md): Un booking es la representación o entidad de un pedido dentro de la plataforma de Picker. Cada booking o pedido va a tener los siguientes elementos: Local : Es la representación del negocio/restaurante en Picker. Representa el punto de despacho con una dirección y una geolocalización . Cliente : Es el consumidor final del pedido . Representa un punto de entrega con una dirección y una geolocalización . Estado : Representa la fase en que esta el pedido actualmente. Conductor : Es la representación de la persona que se encargará de entregar el pedido al cliente. Contiene datos como número de teléfono para poder contactarse. Proveedor : Nombre del proveedor que atiende el pedido . Método de Pago : Indicará si este pedido requiere un pago contra entrega o no. Órdenes : Son todos los llamados que hace Picker hacia cada uno de los proveedores durante un pedido . Si un pedido al crearse no tiene respuesta de ningún proveedor o no hay proveedores que puedan atender sus pedidos, el pedido se guarda con el estado PROVIDER_NOT_FOUND Flujo de un pedido Pedido se crea en Picker vía Dashboard o API. Los datos de entrada determinarán que proveedores podrán atender el pedido . Ejemplo: Si el pedido es en efectivo , solo va a ser atendido por proveedores que pueden recibir el efectivo. Picker, de acuerdo a los parámetros del pedido y la configuración de proveedores que tiene el local , crea las ordenes en los proveedores. Los proveedores procesan el pedido y confirman si pueden atender el pedido o no. Si no pueden atender el pedido, su respectiva orden se anula. Cuando un proveedor asigna un conductor para el pedido, las órdenes en los demás proveedores automáticamente se cancelan. El proveedor que esta asignado al pedido será el encargado de operarlo con su conductor. De aquí en adelante el proveedor me indicará los estados del pedido .
  • [Ciclo de un Pedido Exitoso](https://app.theneo.io/pickerexpress/picker-api-suite/ciclo-de-vida-de-un-booking/ciclo-de-un-pedido-exitoso.md): Es extremadamente recomendable que antes de crear un pedido , consultes el endpoint de Pre Checkout para conocer el costo del pedido; y con el puedas ofrecerle un precio al cliente acorde al costo de nuestros servicios. Al crear un pedido mediante el endpoint de Create Booking, el primer estado con el que va a nacer el pedido dependerá si manejas o no tiempo de preparación (en el API es representado por el campo cookTime ). Este cookTime puede ser configurado a nivel de local , empresa o puede ser enviado individualmente por cada pedido. A partir de esto, puede suceder lo siguiente: Con cookTime Si el pedido contiene cookTime, este nace con el estado ON_HOLD. Una vez cumplido el tiempo de preparación, pasa automáticamente a READY_FOR_PICKUP Sin cookTime Si el pedido no tiene cookTime o es 0, este nace con el estado READY_FOR_PICKUP y realiza la búsqueda de conductores enseguida. Una vez que el pedido este en READY_FOR_PICKUP , el ciclo de vida de un pedido exitoso es muy lineal: 1 Ready For Pickup Cuando el pedido esta en READY_FOR_PICKUP , esta buscando un conductor ideal para tu pedido. 2 Accepted Cuando es aceptado por un conductor de alguna flota o proveedor, pasa al estado ACCEPTED 3 Arrived At Pickup De ACCEPTED , pasa a ARRIVED_AT_PICKUP una vez que el conductor indica que ha llegado al local. 4 Way To Deliver De ARRIVED_AT_PICKUP pasa a WAY_TO_DELIVER si el conductor indica que ya abandono el local y va al punto de entrega En este estado puede llegar el código de entrega de un pedido 5 Arrived At Delivery El pedido pasa a ARRIVED_AT_DELIVERY si el conductor indica que ya esta donde el cliente y esta presto a terminar el pedido 6 Completed El pedido termina con el estado COMPLETED cuando el conductor entrega satisfactoriamente el pedido Todas las actualizaciones de estado van a llegar por medio del webhook de UPDATE_BOOKING_STATUS . Únicamente el estado de ACCEPTED llega por medio del webhook de DRIVER_ASSIGNED ya que trae consigo los datos del conductor.
  • [Ciclos de Pedido No Exitoso](https://app.theneo.io/pickerexpress/picker-api-suite/ciclo-de-vida-de-un-booking/ciclos-de-pedido-no-exitoso.md): Un pedido en proceso puede sufrir cancelaciones o retornos de todo tipo. Desde escenarios en que el local no requiere ya un motorizado, o cancelaciones desde el proveedor. Los escenarios de cancelación son los siguientes: Cancelado por Negocio En este escenario, un pedido es creado exitosamente. Pero durante el transcurso del pedido el negocio desea cancelarlo (puede ser vía API o via Dashboard). Cuando esto sucede, el pedido se guarda bajo el estado de CANCELLED_BY_BUSINESS . Esta cancelación puede efectuarse mientras el pedido este en: ON_HOLD READY_FOR_PICKUP ACCEPTED ARRIVED_AT_PICKUP En los 2 últimos estados (ACCEPTED y ARRIVED_AT_PICKUP), esta cancelación incurre en un costo del 50% del delivery. Cancelado Por Admin este escenario, durante el ciclo de un pedido si este esta en un estado superior a ARRIVED_AT_PICKUP, el local no podrá cancelar el pedido . Para poder cancelarlo, el usuario deberá consultar a soporte para proceder con la cancelación. En este flujo, el estado con el que se guarda el pedido es CANCELLED_BY_ADMIN . Cancelado por Proveedor Existen ocasiones en que el proveedor, ya teniendo el pedido en curso, no puede despachar o terminar el pedido . En estos escenarios, el proveedor cancela el pedido y se guarda con el estado CANCELLED_BY_DELIVERY_PROVIDER. Provider Not Found Este estado se dispara al momento en que se crea un pedido , pero ningún proveedor esta disponible para poder atender tu pedido. Para entender como se registra este estado, seguimos el siguiente flujo: Se crea un pedido en la plataforma de Picker (via API o Dashboard). Picker intenta solicitar a los proveedores activos del local si pueden efectuar la orden. Si al menos un proveedor accede a atender la orden, se efectúa la búsqueda . Si ningún proveedor puede atender el pedido, se da por finalizado el pedido y se lo guarda con el estado PROVIDER_NOT_FOUND. La disponibilidad de un proveedor va a depender distintos criterios: El método de pago del pedido (algunos proveedores no manejan el pago contra entrega o efectivo). La ubicación de entrega esta fuera de la cobertura de los proveedores. Proveedores no pueden atender el pedido por alta demanda en sus respectivas plataformas. Tienes que tomar en cuenta que la búsqueda de un conductor únicamente se la realizará con los proveedores que tengas activado en tu negocio. Si tienes desactivado un proveedor para tu negocio, la plataforma no usara a tal proveedor para las búsquedas. No Entrega (Not Delivered) Este escenario sucede cuando el conductor esta intentando entregar al pedido al cliente, pero por alguna razón no puede completar el pedido. Esto puede suceder por distintas razones: Conductor no encuentra con la dirección de entrega (Dirección errónea o incompleta) Cliente no recibe pedido o lo rechaza. Conductor no puede contactar con cliente para coordinar la entrega (Número de teléfono o datos de contacto erróneos). Hay que tener en consideración que cuando se dispara este escenario, el pedido pasará al estado NOT_DELIVERED si este no es requerido de retorno al local. Returned Si el pedido no pudo ser entregado al cliente (bajo los escenario descritos en No Entrega), y este requiere que sea retornado al local o comercio, para al estado RETURNING , el cual indica que el pedido va de regreso al local. Una vez que el pedido sea retornado satisfactoriamente al local, pasa al estado final RETURNED.
  • [Estados del Pedido](https://app.theneo.io/pickerexpress/picker-api-suite/ciclo-de-vida-de-un-booking/estados-del-pedido.md): A continuación presentamos un glosario de todos los estados que se tienen en Picker. Title Description Estado Descripción ON_HOLD Es el estado inicial del pedido si existe un tiempo de preparación. Durante este estado, el pedido aún no busca conductor. Pasa automáticamente a READY_FOR_PICKUP si: Se cumple el tiempo de preparación o cooktime. Se activa manualmente la búsqueda desde dashboard. Se activa mediante el endpoint de Start Search . READY_FOR_PICKUP En este estado se inicia la búsqueda de motorizados en los distintos proveedores activados para el local. Este estado se puede disparar en los siguientes escenarios. Se termina tiempo de preparación de pedido en ON_HOLD Se inicia una búsqueda manualmente Si un pedido ya con conductor ejecuta una nueva búsqueda de conductores. (Por ejemplo: Pedido en ACCEPTED con conductor vuelve a READY_FOR_PICKUP ). Si el pedido se crea sin tiempo de preparación, será el estado inicial del pedido. ACCEPTED Este estado se guarda en el pedido al momento que un proveedor asigna un motorizado al pedido. Este estado únicamente llega por medio del webhook de DRIVER_ASSIGNED ARRIVED_AT_PICKUP Cuando el conductor notifica que el conductor llego al local y esta esperando que local le entregue el pedido WAY_TO_DELIVER Cuando el conductor indica que abandono el local y va en dirección al punto de entrega ARRIVED_AT_DELIVERY Cuando el conductor llega donde el cliente y esta por terminar el pedido COMPLETED Pedido fue completado satisfactoriamente PROVIDER_NOT_FOUND Cuando ningún proveedor activado para tu local no puede atender tu pedido. No se ejecuta ninguna búsqueda CANCELLED_BY_BUSINESS Negocio dispara la cancelación del pedido. Esto puede suceder cuando: Pedido es cancelado desde dashboard Pedido es cancelado vía API por medio del endpoint de Cancel Booking CANCELLED_BY_ADMIN Cuando la cancelación es disparada por el área de Soporte de Picker CANCELLED_BY_DELIVERY_PROVIDER Cuando la cancelación es disparada por el proveedor de delivery NOT_DELIVERED Cuando el pedido no pudo ser entregado al cliente; y el paquete de entrega no puede ser devuelto al negocio RETURNING Cuando el pedido no pudo ser entregado al cliente y el pedido esta en camino a ser retornado al negocio RETURNED Cuando el pedido fue retornado exitosamente al negocio Todos los estados, a excepción del estado inicial y del ACCEPTED (que llega en webhook de DRIVER_ASSIGN ), llegan en el webhook de UPDATE_BOOKING_STATUS .
• [Que es una Guía?](https://app.theneo.io/pickerexpress/picker-api-suite/ciclo-de-vida-de-un-delivery/que-es-una-guia.md): Una guía es la agrupación de varias entregas o deliveries (no bookings) que deben ser recogidas en un mismo local y entregadas en varios puntos de una ruta. Estas guías tienen los siguientes elementos: Local : Es la representación del negocio/restaurante en Picker. Representa el punto de despacho con una dirección y una geolocalización . Es desde donde se van a entregar todos los paquetes al conductor para que gestione su ruta Estado : Representa la fase en que esta la guía actualmente. Conductor : Es la representación de la persona que se encargará de entregar los deliveries a los clientes de la ruta. Contiene datos como número de teléfono para poder contactarse. Proveedor : Nombre del proveedor que atiende la ruta. Órdenes : Son todos los llamados que hace Picker hacia cada uno de los proveedores durante una guía. Si una guía al crearse no tiene respuesta de ningún proveedor o no hay proveedores que puedan atender esta ruta, esta se guarda con el estado PROVIDER_NOT_FOUND Deliveries: Es la agrupación de entregas ordenadas en una ruta para su entrega. Cada delivery agrupada en una ruta o guía tendra los siguientes elementos: Cliente : Es el consumidor final del delivery. Representa un punto de entrega con una dirección y una geolocalización . Estado: Representa la fase en que esta el delivery actualmente. Es distinto al estado de la guía. Características del Paquete: Representa el volumen, peso y número de paquetes a entregar al cliente. Flujo de una guía El flujo de una guía es muy similar a la de un booking, con sus ciertas diferencias: Antes de que se cree una guía, se agrupan todas las entregas que se deben hacer de un local. Estas se agrupan de tal manera, para que en las siguiente 2 o 3 horas (de acuerdo a ciertos parametros) se puedan realizar las entregas correspondientes. Esta agrupación de entregas ya establecidas es una ruta o guía. Si existen muchas entregas a realizar, puede existir mas de una guía (cada una con sus respectivas entregas). Realizada la agrupación, el flujo aqui es similar a bookings: Se crea por cada proveedor una orden. El proveedor que acepta la orden se debe encargar de gestionar la ruta y sus respectivas entregas. Se cancela las ordenes en otros proveedores si es existe.
• [Ciclo de una Guía Exitosa](https://app.theneo.io/pickerexpress/picker-api-suite/ciclo-de-vida-de-un-delivery/ciclo-de-una-guia-exitosa.md): Como se mencionó en el punto anterior, una guía es un conjunto de entregas en una ruta. La guía es lo que va a operar cada proveedor con su respectivo conductor. Ahora para entender un poco cuando una guía es exitosa, hay que tomar en cuenta cuando una entrega se finaliza exitosamente y una guía es finalizada con éxito. Entrega finalizada Se realiza la entrega satisfactoria del paquete al cliente final Guía finalizada Se finalizan todas las entregas (no necesariamente deben ser todas exitosas) de la ruta. Teniendo en cuenta todo lo que se ha revisado anteriormente, el ciclo para una guía exitosa, desde la creación de las entregas, hasta la finalización de la guía es la siguiente. 1 Creación de Entrega(s) Se crea una o mas entregas vía API o mediante el dashboard. En este punto las entregas estan en estado PENDING. En este punto aun no existe la guía 2 Agrupación de Entregas - Creación de Guía Despues de un tiempo determinado, las entregas se agrupan de acuerdo a su local de despacho y su tiempo de entrega. En este punto se crea la guía con sus respectivas entregas y se da inicio a la búsqueda de conductor. Tanto la guía como las entregas agrupadas tendrán el estado READY_FOR_PICKUP 3 Aceptación de conductor Cuando un conductor acepta la guía por medio de uno de los proveedores, tanto la guía como las entregas pasan a estado ACCEPTED 4 Arrived at Pickup Este estado sucederá cuando el conductor haya llegado al local. Tanto guía como las entregas pasan a estado ARRIVED_AT_PICKUP 5 Way To Deliver Este estado se activará cuando el conductor abandone el local con las entregas que tiene que realizar en ruta. Tanto guía como las entregas pasan a estado WAY_TO_DELIVER. 6 Arribo a lugar de entrega Cuando se vaya a realizar una entrega al cliente y el conductor ya haya arrivado donde el mismo, solo cambiará a estado ARRIVED_AT_DELIVERY la entrega que se esta realizando. Tanto guía como las otras entregas de la ruta continuarán en WAY_TO_DELIVER 7 Entrega de Paquete Cuando se haya entregado satisfactoriamente el paquete al cliente, esta entrega pasará a estado COMPLETED. 8 Siguiente Entrega Una vez realizada una entrega, si existe una entrega pendiente de realizar, se repiten los del 5 al 7 consecuentemente con las entregas pendientes. 9 Finalización de Ruta Una vez realizadas todas las entregas, la guia pasa a estado COMPLETED.
• [Ciclos No Exitosos](https://app.theneo.io/pickerexpress/picker-api-suite/ciclo-de-vida-de-un-delivery/ciclos-no-exitosos.md): Así como bookings o pedidos, existen escenarios en que una guía o una entrega no termina satisfactoriamente. Para empezar, se va a describir los casos para las entregas. Entregas No Exitosas Cancelled By Business Este estado se dispará sobre una entrega en el caso de que el negocio (vía API o vía Dashboard) solicita una cancelación. Esta cancelación se puede realizar mientras la entrega este en estado PENDING. Not Delivered Este estado indica que una entrega no se pudo realizar al cliente. Este estado solo se dispara al momento que el delivery esta en una guía. Si una entrega queda marcada como NOT_DELIVERED , no significa que la guía o ruta no haya finalizado exitosamente ( COMPLETED) Provider Not Found Se actualiza a este estado cuando no existen proveedores que no pueden atender la guía a la que pertenece la entrega. Guías No Exitosas Cancelled By Business Este estado se dispará sobre una guía en el caso de que el negocio (vía API o vía Dashboard) solicita una cancelación. Esta cancelación se puede realizar mientras la guía este en estado READY_FOR_PICKUP. Si una guía se cancela con este estado, todas sus entregas se guardan con este mismo estado. Provider Not Found Se actualiza a este estado cuando no existen proveedores que no pueden atender la guía. Las entregas de esta guía se guardan con este mismo estado.
• [Estados de la Parada](https://app.theneo.io/pickerexpress/picker-api-suite/ciclo-de-vida-de-un-delivery/estados-de-la-parada.md): A continuación presentamos un glosario de todos los estados que se tienen en Picker y que interactuan con la parada. Title Description Estado Descripción PENDING Es el estado inicial de la parada. Durante este estado la parada aun no es procesada en una guía. Unicamente durante este estado la parada puede ser cancelada. READY_FOR_PICKUP En este estado la parada ya esta agrupada en una ruta o guía. Aquí la guía esta buscando un proveedor que pueda atenderla. ACCEPTED Este estado se guarda en la parada al momento que un proveedor asigna un motorizado a su respectiva guía. Este estado únicamente llega por medio del webhook de DRIVER_ASSIGNED ARRIVED_AT_PICKUP Cuando el conductor notifica que el conductor llego al local y esta esperando que local le entregue los paquetes a entregar durante la guía. WAY_TO_DELIVER Cuando el conductor indica que abandono el local y va en dirección a uno de los puntos de entrega. ARRIVED_AT_DELIVERY Cuando el conductor llega donde el cliente y esta por terminar la parada. COMPLETED Paquete fue entregado satisfactoriamente PROVIDER_NOT_FOUND Cuando ningún proveedor activado para tu local no puede atender la guía en que esta agruapada esta parada. No se ejecuta ninguna búsqueda CANCELLED_BY_BUSINESS Negocio dispara la cancelación del pedido. Esto puede suceder cuando: Parada es cancelada desde dashboard Parada es cancelada vía API por medio del endpoint de Cancel Express Delivery Guía es cancelada NOT_DELIVERED Cuando el paquete no pudo ser entregado al cliente.
• [Estados de la Guía](https://app.theneo.io/pickerexpress/picker-api-suite/ciclo-de-vida-de-un-delivery/estados-de-la-guia.md): A continuación presentamos un glosario de todos los estados que puede tener una guía. Title Description Estado Descripción READY_FOR_PICKUP En este estado se inicia la búsqueda de motorizados en los distintos proveedores activados para el local. Este estado se dispara una vez que ya se le hayan asignado las paradas a la guía. ACCEPTED Este estado se guarda en la guía al momento que un proveedor asigna un motorizado. Este estado únicamente llega por medio del webhook de DRIVER_ASSIGNED ARRIVED_AT_PICKUP Cuando el conductor notifica que el conductor llego al local y esta esperando que local le entregue los paquetes que se deben entregar en la guía WAY_TO_DELIVER Cuando el conductor indica que abandono el local y va en dirección al primer punto de entrega COMPLETED Guía y todos sus paradas fueron finalizadas satisfactoriamente PROVIDER_NOT_FOUND Cuando ningún proveedor activado para tu local no puede atender tu guía. No se ejecuta ninguna búsqueda CANCELLED_BY_BUSINESS Negocio dispara la cancelación de la guía. Esto puede suceder cuando: Guía es cancelado desde dashboard Guía es cancelada vía API por medio del endpoint de Cancel Guide
• [Ambientes](https://app.theneo.io/pickerexpress/picker-api-suite/ambientes.md): Para la API v2, las url's son distintas a la de la v1. Tenerlo en consideración para las pruebas y puestas en producción.
• [Pre Booking](https://app.theneo.io/pickerexpress/picker-api-suite/pre-booking.md): La sección de Pre-Booking permite a los usuarios iniciar, recuperar y gestionar solicitudes de pre-booking dentro de la API externa. Proporciona las herramientas para crear nuevos pre-bookings, acceder a las existentes para su revisión y cancelar pendientes, facilitando así la gestión fluida de las mismas.
  • [Create Pre Booking](https://app.theneo.io/pickerexpress/picker-api-suite/pre-booking/create-pre-booking.md): El endpoint de Create PreBooking te permite crear una plantilla con datos preliminares de un pedido, a excepción de la ubicación de entrega. Para poder ingresar la ubicación de entrega, la respuesta de este endpoint te retornará una url (que deberás proveerla al cliente final) donde se podrá ingresar la ubicación del cliente final. Una vez ingresado la ubicación final en el link indicado, el pedido comenzará su proceso de búsqueda de repartidores. Ten en consideración que mientras que la dirección final no haya sido ingresada mediante el link, el pedido no estará creado ni se visualizará en tu tablero de pedidos de tu Dashboard.
  • [Get Pre Booking](https://app.theneo.io/pickerexpress/picker-api-suite/pre-booking/get-pre-booking.md): Con el endpoint de Get Pre-Booking podrás obtener los detalles de un pre-booking de acuerdo a su id. Ojo. E l prebooking que consultes deberá haber sido procesado y creado con el Api Key del local que estes usando. Si intentas buscar un id de un prebooking que pertenece a otro local, la plataforma no te lo devolverá.
  • [Cancel Pre Booking](https://app.theneo.io/pickerexpress/picker-api-suite/pre-booking/cancel-pre-booking.md): El endpoint de Cancel Pre-Booking te permitirá cancelar un pre-booking antes de que se haya ingrese la dirección final (y que por ende se haya convertido en un booking). Podrás cancelar cualquier pedido perteneciente al negocio identificado por el Api Key. El endpoint de Cancel Pre-Booking te permitirá cancelar un pre-booking antes de que se haya ingrese la dirección final (y que por ende se haya convertido en un booking). Podrás cancelar cualquier pedido perteneciente al negocio identificado por el Api Key.
  • [Add Webhook](https://app.theneo.io/pickerexpress/picker-api-suite/pre-booking/add-webhook.md): El endpoint de /pre-booking/webhooks unicamente permitira ingresar un solo webhook por Workspace. Solo permitirá suscribirse al tópico LTD_ADDRESS_CONFIRMATION.
• [Booking](https://app.theneo.io/pickerexpress/picker-api-suite/booking.md): La sección Bookings ofrece herramientas integrales para gestionar el ciclo de vida de los pedidos, desde la creación y la recuperación de detalles hasta el inicio de búsquedas y la gestión de cancelaciones. Permite a los usuarios optimizar los flujos de trabajo de los pedidos y acceder a los motivos de cancelación relevantes. Esta sección permite a los desarrolladores gestionar eficientemente las operaciones de pedidos y mejorar la experiencia del usuario.
  • [Pre Checkout](https://app.theneo.io/pickerexpress/picker-api-suite/booking/pre-checkout.md): La sección de Pre Checkout facilita la preparación y validación de los pedidos de los usuarios antes del envío final. Permite a los desarrolladores enviar información esencial del pedido, como la ubicación, el método de pago y la información del vehículo, para garantizar un costo de delivery aproximado. Para este endpoint es obligatorio la locación del punto de entrega. La ubicación del local ya la obtenemos automáticamente por el Api Key del negocio que usas en la autorización. Otros datos que puedes ingresar en este endpoint son: paymentMethod : Es el método de pago que usarás para el pedido. En el caso que exista un pago en efectivo al momento de entregar el pedido, deberás usar CASH . Caso contrario, si no hay ningún pago de por medio y el conductor unicamente tiene que recoger el pedido y entregarle al cliente, deberás usar CARD . carName : Indicá el tipo de vehículo que necesitas para tu pedido. Si es un pedido de dimensiones pequeñas y necesitas una moto, debes ingresar aquí BIKE . Si tu pedido es de mayores dimensiones y necesitas un coche, deberás usar LITE . Booking Stops Para pedidos con múltiples pickup stops, Multi Picking, se extiende el endpoint de Pre Checkout para permitir el siguiente campo: bookingStops: Esta es la lista de pickup stops que puedes crear con el pedido para que el repartidor recoja items de diferentes pickup stops
  • [Create Booking](https://app.theneo.io/pickerexpress/picker-api-suite/booking/create-booking.md): El endpoint de Create Booking es el mas importante de todo el Api Suite de Picker. Este endpoint es el que permitirá poder crear un pedido dentro de la plataforma de Picker. La ejecución de este endpoint desencadenará todo el proceso del pedido (desde su creación, búsqueda de proveedores, actualizaciones de estado y finalización). Si necesitas mas detalles, puede visitar la sección de Ciclo de Vida del Pedido . Cada dato que se ingrese aquí es muy importante para el correcto desarrollo del pedido: Los datos del cliente como sus nombres deben ser claros y completos. Así mismo como su número de teléfono y dirección. Recuerda que en cuanto mas exacto sea el pedido, menos inconvenientes tendrá el conductor para localizar y entregarle su pedido al cliente. El método de pago con el cual se procesará el pedido. Así podemos procesar tu pedido con los proveedores que apliquen para el método de pago indicado. Los valores del pedido como orderAmount y businessDeliveryFee. Estos valores son importantes para que el proveedor tenga claro el costo del pedido, en el caso que exista alguna novedad (no importa si el pedido es en efectivo o no). El parámetro sendTrackingLink te indicará si necesitas que nosotros como Picker enviemos el link de tracking al cliente. El envío de tracking dependerá de las configuraciones que tienes en tu local (Whatsapp o Correo). Cooktime que representa el tiempo de preparación del pedido. Este tiempo correrá apenas se cree el pedido. Una vez cumplido el tiempo, se iniciará la búsqueda de un conducto. Si necesitas que la búsqueda se inicie enseguida, deberás ingresar 0. Para saber la tarifa del pedido, deberás sumar los campos priceBreakUp.baseFare + priceBreakUp.perKmCharge Es recomendable que una vez que se cree el booking, guardes el id o bookingNumericId del pedido para poder posteriormente consultarlo y hacer match en el caso que tengas activados los webhooks.
  • [Cancel Booking](https://app.theneo.io/pickerexpress/picker-api-suite/booking/cancel-booking.md): El endpoint de Cancel Booking te permitirá cancelar un pedido en curso. Podrás cancelar cualquier pedido perteneciente al negocio identificado por el Api Key. Puedes agregarle una razón de cancelación que puedes tomar desde el endpoint de Get Cancel Reasons . Así como el endpoint de Get Booking Details, solo vas a poder cancelar pedidos pertenecientes al negocio referenciado por el Api Key Solo podrás cancelar pedidos que estén en los siguientes estados: ON_HOLD READY_FOR_PICKUP ACCEPTED ARRIVED_AT_PICKUP
  • [Get Booking](https://app.theneo.io/pickerexpress/picker-api-suite/booking/get-booking.md): Con este endpoint se puede obtener información detallada de un booking en específico mediante su identificador único. Esta sección permite a los usuarios acceder a datos completos de los bookings , lo que facilita la gestión y revisión eficiente de cada uno dentro del sistema API externo.
  • [Start Search](https://app.theneo.io/pickerexpress/picker-api-suite/booking/start-search.md): El endpoint de Start Search al ejecutarlo iniciará la búsqueda de conductores para pedidos que tienen cooktime. Unicamente será posible iniciar una búsqueda siempre y cuando el pedido este con el status ON_HOLD . Si el pedido ya inicio una búsqueda, se retornará como código de error 409.
  • [Get Cancel Reasons](https://app.theneo.io/pickerexpress/picker-api-suite/booking/get-cancel-reasons.md): Con el endpoint de Get Cancel Reasons podrás consultar las razones de cancelación que tenemos disponibles y que puedes enviar en el caso que requieras cancelar el pedido. Ten en cuenta que utilizar estas razones no son obligatorias; sin embargo es recomendable que se la utilice para poder tener mas datos acerca de los pedidos
  • [Get Concepts](https://app.theneo.io/pickerexpress/picker-api-suite/booking/get-concepts.md): El endpoint de Get Concepts te permite consultar los valores que se facturarán en tu cuenta sobre un pedido finalizado. Este servicio te retornará un listado de todos los conceptos que se cobrarán por el booking que consultas. Ten en consideración que unicamente aparecerán los conceptos de pedidos que hayan finalizado. Aquellos que aun estan en proceso, no presentarán concepto alguno.
• [Webhooks](https://app.theneo.io/pickerexpress/picker-api-suite/webhooks.md): Esta sección proporciona una gestión integral de webhooks, lo que permite a los usuarios crear, actualizar y enlistar configuraciones de webhooks. Permite una integración fluida con servicios externos, garantizando la entrega y gestión precisa de notificaciones de eventos en tiempo real.
  • [Get Store Webhooks](https://app.theneo.io/pickerexpress/picker-api-suite/webhooks/get-store-webhooks.md): Este endpoint proporciona acceso a la lista de webhooks configurados para un local en específico, lo que le permite ver todos los puntos de conexión de suscripción activos y sus tipos de eventos asociados. Con esta información, puede verificar la configuración de los webhooks, supervisar las suscripciones a eventos y asegurarse de que sus integraciones estén configuradas correctamente para las notificaciones en tiempo real.
  • [Get Workspace Webhooks](https://app.theneo.io/pickerexpress/picker-api-suite/webhooks/get-webhooks-copy.md): Este endpoint proporciona acceso a la lista de webhooks configurados para su workspace, lo que le permite ver todos los puntos de conexión de suscripción activos y sus tipos de eventos asociados. Con esta información, puede verificar la configuración de los webhooks, supervisar las suscripciones a eventos y asegurarse de que sus integraciones estén configuradas correctamente para las notificaciones en tiempo real. Este endpoint solo consultará los webhooks generales de su workspace. No los que tiene configurado el negocio
  • [Add Store Webhooks](https://app.theneo.io/pickerexpress/picker-api-suite/webhooks/add-store-webhooks.md): El endpoint de Add Business Webhook te permitirá agregar webhooks a los eventos que afectan un booking de un negocio o local en específico. Los eventos que pueden registrarse con una url para su respuesta son: DRIVER_ASSIGNED : Cuando un conductor es asignado a un pedido. UPDATE_BOOKING_STATUS : Cuando un pedido cambia de estado. 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 Workspace Webhooks](https://app.theneo.io/pickerexpress/picker-api-suite/webhooks/add-webhooks-copy.md): El endpoint de Add Workspace Webhooks te permitirá agregar webhooks a los eventos que afectan un booking a nivel de Workspace. Los eventos que pueden registrarse con una url para su respuesta son: DRIVER_ASSIGNED : Cuando un conductor es asignado a un pedido. UPDATE_BOOKING_STATUS : Cuando un pedido cambia de estado. 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). A diferencia de Add Business Webhooks, estos webhooks son configurados en todo el workspace. Es decir, si configuras un webhook mediante este endpoint, ya no es necesario hacerlo a nivel de business o negocio.
  • [Topics](https://app.theneo.io/pickerexpress/picker-api-suite/webhooks/topics.md): En esta sección podrás encontrar cada uno de los tópicos de las suscripciones y la información que se envía en cada uno de ellos. 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. Si el llamado al webhook registrado falla, se harán hasta 2 intentos nuevos de llamada con un intervalo de 30 segundos.
    • [Driver Assigned](https://app.theneo.io/pickerexpress/picker-api-suite/webhooks/topics/driver-assigned.md): 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: Se asigna un conductor al pedido. Se reasigna un nuevo conductor a un pedido que ya tenía un conductor. 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. Cabe recalcar que si a un pedido se le asigna un conductor, automáticamente se lo pasará al estado ACCEPTED.
    • [Update Booking Status](https://app.theneo.io/pickerexpress/picker-api-suite/webhooks/topics/update-booking-status.md): 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. 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 validationCode . El contenido de este campo deberá ser proveído al cliente para poder completar la entrega (el conductor solicitará este código). El campo proofOfDelivery contendrá la url de la foto tomada por el repartidor al momento de la entrega. Esta url solo llegará al momento que el pedido este en estado COMPLETED
• [Store](https://app.theneo.io/pickerexpress/picker-api-suite/store.md): La sección Store ofrece funciones para gestionar y recuperar datos relacionados con la tienda dentro de la API externa. Los usuarios pueden crear nuevas entradas de tienda o acceder a listados completos de tiendas existentes, lo que permite una gestión e integración eficaz de la información de la tienda en sus aplicaciones.
  • [Get Stores](https://app.theneo.io/pickerexpress/picker-api-suite/store/get-stores.md): El endpoint de Get Stores te permitirá consultar todos los locales que tiene el empresa. Como este endpoint se basa en el alcance que tiene el empresa, se deberá enviar en el header como autorización el Master Key del empresa.
  • [Create Store](https://app.theneo.io/pickerexpress/picker-api-suite/store/create-store.md): Este endpoint te ayudará a crear una tienda en tu empresa. La función principal de este endpoint es establecer un nuevo local en la plataforma de Picker relacionado a tu empresa. Recopila varios detalles sobre la tienda en cuestión, incluida su ubicación física, información de contacto e identificación de la empresa. En concreto, recibe datos como la dirección completa de la tienda, coordenadas de geolocalización (longitud y latitud), nombre de la empresa y una referencia de dirección. El response de este endpoint es el Api Key de la tienda.
  • [Delete Store](https://app.theneo.io/pickerexpress/picker-api-suite/store/create-store-copy.md): Este endpoint te ayudará a eliminar una empresa existente de tu workspace. IMPORTANTE: Una vez eliminada la tienda, no se podrar realizar operaciones sobre la misma y el api key de la tienda quedará como inválido.
• [Express Delivery](https://app.theneo.io/pickerexpress/picker-api-suite/express-delivery.md): La sección Express Delivery permite una gestión fluida de las solicitudes de envío dentro de la API externa. Los usuarios pueden crear, recuperar, actualizar y buscar express deliveries, lo que facilita la gestión eficiente de los envíos y el seguimiento de sus estado.
  • [Create Express Delivery](https://app.theneo.io/pickerexpress/picker-api-suite/express-delivery/create-ed.md): La sección Create Express Delivery permite a los usuarios iniciar una solicitud de entrega express enviando información detallada del paquete y la entrega. Facilita la creación de un nuevo registro de entrega, permitiendo a los usuarios especificar detalles de recogida y entrega, características del paquete y metadatos asociados para agilizar el proceso de entrega. Una vez creada la entidad Express Delivery, posteriormente se lo agrupará a una guía para poder ser operador por un proveedor de delivery
  • [Get Express Delivery](https://app.theneo.io/pickerexpress/picker-api-suite/express-delivery/get-ed.md): La sección Get Express Delivery permite a los usuarios obtener información detallada sobre una entrega express específica mediante su identificador único. Esto facilita el seguimiento y la gestión de cada entrega, garantizando actualizaciones oportunas y una toma de decisiones informada dentro de la aplicación. Al igual que en bookings, el id del express delivery debe pertenecer al negocio. Caso contrario, el endpoint retornara 403
  • [Get Express Delivery by Business](https://app.theneo.io/pickerexpress/picker-api-suite/express-delivery/get-ed-by-business.md): Esta sección permite a los usuarios recuperar información detallada sobre express deliveries asociadas a un local específico. Mediante la API proporcionada, los usuarios pueden acceder y gestionar los datos de entrega de forma eficiente, facilitando la integración y sincronización de datos para las operaciones logísticas externas.
  • [Get Express Delivery by External Id](https://app.theneo.io/pickerexpress/picker-api-suite/express-delivery/get-ed-by-external-id.md): La sección "Get Express Delivery by External Id" permite a los usuarios obtener información detallada sobre un express delivery específico utilizando su identificador externo. Esta funcionalidad facilita el seguimiento y la gestión eficiente de los envíos mediante el acceso a datos precisos de entrega asociados a una referencia externa.
  • [Cancel Express Delivery](https://app.theneo.io/pickerexpress/picker-api-suite/express-delivery/cancel-ed.md): Esta sección permite a los usuarios cancelar un express delivery existente, con la posibilidad de especificar un motivo. Agiliza la gestión de entregas, permitiendo a los interesados actualizar eficientemente los estados de entrega según sea necesario.
  • [Start Search](https://app.theneo.io/pickerexpress/picker-api-suite/express-delivery/start-search.md): El endpoint de Start Search para Express Deliveries al ejecutarse realiza la agrupación de los express deliveries sin guía que el local aun tiene pendiente. Aquí inicia la agrupación de entregas en una ruta de acuerdo a sus características y distancias de entrega. Finalizado este proceso, todos los express deliveries del local tendrán asignada una guía
• [Guide](https://app.theneo.io/pickerexpress/picker-api-suite/guide.md): Las guías son las agrupaciones de express deliveries que siguen un orden o “ruta” para poder realizar sus entregas. En esta sección podras consultar los endpoints para la consulta de guías y su cancelación.
  • [Get Guide](https://app.theneo.io/pickerexpress/picker-api-suite/guide/get-guide.md): La sección Get Guide proporciona acceso a información detallada sobre una guía específica dentro de la API externa. Permite a los usuarios recuperar datos completos de una guía específica y sus express deliveries agrupados, lo que facilita la revisión, el análisis y la integración a partir de los registros de guías existentes.
  • [Cancel Guide](https://app.theneo.io/pickerexpress/picker-api-suite/guide/cancel-guide.md): La sección "Cancel Guide" proporciona las herramientas necesarias para finalizar un proceso de guía activo, lo que permite a los usuarios detener eficientemente las operaciones en curso. Con esta función, los usuarios pueden especificar el motivo de la cancelación, lo que garantiza el seguimiento y la gestión adecuados de las guías canceladas dentro del sistema.
• [Certificación](https://app.theneo.io/pickerexpress/picker-api-suite/certificacion.md): Previo a la salida a producción, es imperativo 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: Bookings: Pre Checkout Create Booking Datos correctos y concretos del cliente Dirección y Geolocalización correcta Número de teléfono válido Referencia a dirección de entrega Valores a cobrar Uso correcto de métodos de pago Uso de cook time (Opcional) Cancel Booking (Opcional) Webhooks Registro de Webhooks Interpretación de estados en su sistema Stores Create Store Get Store (Opcional) Pre Booking Create Pre Booking Datos del cliente y del negocio sea correcto Flujo de envió de link para confirmar dirección Cancel Pre Booking (Opcional) Interacción con Usuario Final Visualización de Estados Visualización de datos de pedido Visualización de Tracking de Picker Para acordar una reunión de certificación, se la puede agendar mediante este link.
• [FAQ](https://app.theneo.io/pickerexpress/picker-api-suite/faq.md): ¿Es necesario usar el endpoint de pre-checkout para usar el API? 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. ¿Para que me sirve el Dashboard? El Dashboard de Picker es una herramienta visual donde podrás: Visualizar, administrar y crear pedidos. Visualizar y administrar tus locales. Manejar tus configuraciones generales. Consultar los keys para la integración. ¿En que escenario debo enviar CASH o CARD en paymentMethod al crear un booking? CASH : Cuando el pedido requiere un pago contra entrega en efectivo. CARD : 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). ¿Qué valor debo ingresar en el campo orderAmount? 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. ¿Qué sucede si tengo configurado webhooks tanto en tienda como en workspace? Si tienes configurado webhooks en ambos lugares, pueden existir estos escenarios al dispararse un evento: Si tienes la misma url suscrita tanto para negocio como workspace para el mismo evento, el request POST solo se te va a disparar una vez. Si son distintas urls, se disparará tanto la de negocio como la de workspace para el mismo evento. Si solo tienes url en la configuración de negocio, solo se disparará la de negocio. Si solo tienes url en la configuración de workspace, solo se disparará la de workspace. Acabo de crear mi pedido, pero no esta buscando en ningún proveedor. ¿Qué me esta haciendo falta? 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: Esperar que se cumpla el tiempo de espera Iniciar la búsqueda manualmente mediante la opción de Iniciar Búsqueda en el menu del pedido en Dashboard Usar endpoint de Start Search. Me aparece que mi workspace esta suspendido. ¿Qué debo hacer? Si tu empresa esta suspendida, puedes contactar a soporte mediante la opción de chat que existe en Dashboard para conocer mas del asunto. El precio que me muestra el endpoint de Pre Checkout es distinto al que me estan cobrando. ¿Por qué sucede esto? El precio que se muestra en el Pre Checkout es solo un precio referencial aproximado al valor real que puede tener un pedido. Ten en consideración que el precio puede variar de acuerdo a varios factores, algunos de estos pueden efectuarse o no durante un pedido: Proveedor que operó el pedido Tiempos de espera Liberaciones y Reasignaciones
• [Glosario](https://app.theneo.io/pickerexpress/picker-api-suite/glosario.md): Empresa: 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. Local: 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. Master Key: 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. Api Key: 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. Booking: 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. Orden: 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. Dashboard: 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 aquí . Restart Search: 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: Proveedor cancela pedido antes de llegar al local Proveedor desasigna un conductor antes de llegar al local Soporte lo ejecuta manualmente en el caso que exista alguna novedad con el conductor del pedido