Documentación
Ver Guia
API Delivery
sistema para hacer tus entregas.
Dashboard de Control
sistema para hacer tus entregas.
Dashboard de Analítica
sistema para hacer tus entregas.
Consulta de distancia y precio en tu plataforma
Cuando tu cliente llena su carrito y está listo para hacer el checkout, tu plataforma consulta a Picker en vivo la distancia entre los puntos y te devuelve el costo del delivery.
Creación de pedido
Una vez que el cliente confirma el pedido, se envía a Picker los Booking Details con los que crearemos el pedido de nuestro lado.
NOTA: La búsqueda de un repartidor se inicia al momento de crear el pedido.
Búsqueda y asignación de repartidor
El sistema RADAR de Picker ubicará y asignará el pedido al repartidor más cercano al punto de recogida.
Devolución de datos
Picker te devuelve los datos del pedido: Repartidor, ETA, fase del pedido, tiempo, distancia. Puedes usar estos datos para control de despacho tuyo o de terceros.
URL de Seguimiento
Picker envía a tu cliente una URL que abre en su navegador web una ventana de seguimiento del pedido. Esta URL se puede enviar por SMS, Mail o WhatsApp.
Chat Integrado
Tu cliente podrá comunicarse con el repartidor a través del chat integrado, para ultimar detalles de la entrega.
Cierre del pedido
Una vez confirmada la entrega por el repartidor. Se envía el estado de pedido completado.
Te damos la bienvenida a la integración del plugin de Picker con WooCommerce, para utilizar el plugin de Picker, ya debes tener la cuenta de tu negocio registrado en nuestra plataforma. Si aún no la has creado, puedes hacerlo ahora dando click Crear una cuenta con Picker.
1) Busca “Picker” en la tienda de Wordpress y dale a instalar ahora.
2) Activa el plugin de Picker, dale a la opción “Activar”
Cuando tengas el plugin de Picker activo, ya puedes comenzar a configurarlo.
Para conectar el plugin de Picker a tu eCommerce debes añadir la API Key de la tienda, la puedes encontrar en tu Dashboard en la sección Cuenta.
1) Copia tu API Key
2) Pégala en la sección de WooCommerce / Configuración / Envío/Picker
3) Guarda los cambios para tener conectado los datos de tu negocio con tu eCommerce.
Es necesario hacer algunas configuraciones adicionales para el funcionamiento correcto del plugin de Picker. Te las contamos a continuación:
- Instalación de SG Map to Address
- Tener listo el API Key de Google Maps
- Tener Habilitado Geocoding API, Maps JavaScript API, Places API
- Activar la opción de Pagar al enviar ( Función de WooCommerce )
Para que el plugin de Picker se pueda usar efectivamente, te recomendamos instalar el plugin SG Map to Address que es complementario al plugin de Picker y tiene como función permitir a los usuarios de tu eCommerce seleccionar su ubicación de envío en Google Maps.
Cuando vayas a configurar el plugin de SG Map to Address en WooCommerce / Configuración / Avanzado SG Map to Address te pedirá que ingreses tu API Key de Google Maps.
Te compartimos la Documentación de SG Map to Address aquí.
Debes tener habilitados desde Google Cloud Platform estas 3 opciones de API que permitirán que el plugin de Picker funcione correctamente.
*Estos pasos son obligatorios para el funcionamiento de Google Maps.
Cuando tu negocio está afiliado a Picker, te recomendamos que actives esta opción para que los repartidores puedan cobrarle a tus clientes al momento de entregar un producto.
En el Dashboard de Picker puedes administrar todos tus pedidos hechos desde tu eCommerce. Puedes editarlos, ver detalles y cancelarlos.
Al ingresar a descargar el Plugin, te vas a encontrar con 2 archivos comprimidos:
- La primera carpeta comprimida contiene el plugin apuntando al ambiente de producción (Para ingresar a tu dashboard de tu empresa en producción debes ingresar a https://dashboard.pickerexpress.com).
- La segunda carpeta comprimida, con el sufijo dev, es la que apunta al ambiente de pruebas o desarrollo. Para solicitar una cuenta de desarrollo, debes ingresar a https://picker-dashboard.vercel.app
1) Descarga el Plugin de Picker
2) Dale click a la opción “Subir plugin” , y súbelo en formato .zip
3) Activa el plugin de Picker
Cuando tengas el plugin de Picker activo, ya puedes comenzar a configurarlo.
Para conectar el plugin de Picker a tu eCommerce debes añadir la API Key de la tienda, la puedes encontrar en tu Dashboard en la sección Cuenta.
1) Copia tu API Key
2) Pegala en la sección de WooCommerce/Configuración/Envío/Picker
3) Guarda los cambios para tener conectado los datos de tu negocio con tu eCommerce.
Es necesario hacer algunas configuraciones adicionales para el funcionamiento correcto del plugin de Picker. Te las contamos a continuación:
- Instalación de SG Map to Address
- Tener listo el API Key de Google Maps
- Activar la opción de Pagar al enviar ( Función de WooCommerce )
Para que el plugin de Picker se pueda usar efectivamente, te recomendamos instalar el plugin SG Map to Address que es complementario al plugin de Picker y tiene como función permitir a los usuarios de tu eCommerce seleccionar su ubicación de envío en Google Maps.
Cuando vayas a configurar el plugin de
SG Map to Address en
WooCommerce /Configuración/Avanzado/SG Map to Address te pedirá que ingreses tu API Key de Google Maps.
Te compartimos la Documentación de SG Map to Address aquí.
Debes tener habilitados desde Google Cloud Platform estas 3 opciones de API que permitirán que el plugin de Picker funcione correctamente.
*Esta opción es obligatoria para el funcionamiento de Google Maps.
Cuando tu negocio está afiliado a Picker, te recomendamos que actives esta opción para que los repartidores puedan cobrarle a tus clientes al momento de entregar un producto.
En el Dashboard de Picker puedes administrar todos tus pedidos hechos desde tu eCommerce. Puedes editarlos, ver detalles y cancelarlos.
Te damos la bienvenida a la integración de Picker con VTEX, para realizar la integración completa, ya debes tener la cuenta de tu negocio registrado en nuestra plataforma. Si aún no la has creado, puedes hacerlo ahora dando click a Crear una cuenta con Picker.
Para poder integrar tu sitio de VTEX con la Plataforma Picker es necesario primero crear tus app keys para poder sincronizar y autorizar cualquier request que se realizará con VTEX. Para esto deberás dirigirte a Account Settings > Application Keys.
Posteriormente, deberás hacer click en “Manage Keys”.
Aquí deberás hacer click en la opción “Generate New”. En la siguiente ventana, podrás agregarle un nombre a tu nueva key.
Para que las credenciales a crear tengan los accesos necesarios, deberás agregarle un rol. Como Picker consultará las órdenes creadas y los pickup points, deberás agregarle roles que tengan acceso a estas instancias (en el caso de la demostración, se le pondrá accesos administrativos).
Una vez guardado los datos de los keys, se presentará una pantalla donde se te presentarán las credenciales. Es muy importante que en este momento copies tanto el Application Key y su Application Token, ya que, posteriormente a esta pantalla no vas a poder volver a consultarlos.
Ten en consideración que estos set de keys te servirán para cualquier request API que quieras hacer con VTEX (algunos de los pasos que verás a continuación los va a requerir).
Picker en VTEX se lo considera un Carrier, el cual debe tener asignado un Shipping Policy. Antes de crear a Picker cómo Shipping Policy deberás tener antes los siguientes requerimientos:
1) Activar Geolocation Shipping https://help.vtex.com/en/tutorial/registering-geolocation--tutorials_138
2) Crear Pickup Points:
https://help.vtex.com/en/tutorial/o-que-e-uma-transportadora-7u9duMD5UQa2QQwukAWMcE
a) Al crear un pickup point (que para Picker representa un local en tu workspace), deberas crearlo con los mismos datos con los que lo creaste en tu plataforma de Picker.
b) Para poder identificar en VTEX tus locales de Picker, deberás ingresar como ID del Pickup Point el API Key de tu local
Para crear un shipping policy, se lo puede hacer de 2 distintas maneras:
1) Vía Portal Web https://help.vtex.com/en/tutorial/shipping-policy--tutorials_140
IMPORTANTE: Al crear manualmente un shipping policy que quieres que se integre con Picker, debes ingresar como ID la palabra “PICK”.
2) Vía API con Postman https://developers.vtex.com/vtex-rest-api/reference/post_logistics-pvt-shipping-policies
De la misma forma como en su versión por el Portal Web, es necesario que para este shipping policy, se debe ingresar como ID la palabra “PICK”
Adicionalmente a esto, se debe tomar en cuenta que una vez creada esta política, deberán ingresar las reglas de precios de este método de delivery (Estos precios son aquellos que se les cobrará al cliente y son totalmente independientes a los precios que cobra Picker por cada delivery)
Una vez que tengas todos los pasos anteriores, vamos a ejecutar vía Postman el registro de hook de órdenes. Este paso es el más importante, ya que una vez ingresado este paso, todos los pedidos que tengan el método de shipping de Picker, se ingresarán a la plataforma.
Para crear el hook necesario para la creación del pedido en Picker, deberás ejecutar el siguiente endpoint con tus credenciales https://developers.vtex.com/vtex-rest-api/reference/hookconfiguration
Para este caso en particular, ejecutaremos el endpoint con el siguiente body:
Antes de ejecutar este endpoint deberás tener en consideración lo siguiente:
1) Nosotros queremos que la orden se cree en Picker una vez que esté aceptada, es por eso que en el campo status, utilizamos “order-accepted”.
2) Es obligatorio que en el campo status (a pesar de que sea un arreglo), solo ingreses un solo tipo de estado, para evitar duplicaciones de las órdenes en Picker.
3) En url, deberás ingresar el endpoint del ambiente que quieres utilizar:
a) Para ambiente de pruebas: https://dev-api.pickerexpress.com/api/pushVtexOrder
b) Para ambiente de producción: https://api.pickerexpress.com/api/pushVtexOrder
Si necesitas mas información
acerca de hooks, puedes verla aquí https://developers.vtex.com/vtex-rest-api/docs/orders-feed#hook-notifications
Te damos la bienvenida a la integración de Picker con Shopify, para realizar la integración completa, ya debes tener la cuenta de tu negocio registrado en nuestra plataforma. Si aún no la has creado, puedes hacerlo ahora dando click a Crear una cuenta con Picker.
También debes tener en cuenta que debes tener un plan pagado con tu tienda de Shopify.
Para empezar a integrar Picker en Shopify, debes empezar creando una aplicación para tu tienda. Puedes hacerlo mediante la opción Aplicaciones > Desarrollar aplicaciones para tu tienda.
A continuación, permite el desarrollo de aplicaciones personalizadas (Recuerda leer los términos y condiciones).
Una vez aprobado el desarrollo de aplicaciones personalizadas, te aparecerá esta pantalla. Haz clic en crear una aplicación.
Creamos la aplicación (en este caso vamos a ponerle Picker), y procedemos hacer clic en Configurar alcances de la API del panel de control.
En esta pantalla es muy importante tener seleccionados los siguientes permisos que va a tener la API de Picker. Se deben seleccionar los siguientes:
read_payment_terms
read_shipping
read_orders
read_locales
read_fulfillments
read_locations
read_assigned_fulfillment_orders
read_third_party_fulfillment_orders
read_merchant_managed_fulfillment_orders
Así mismo, procura que la versión de API y Webhooks sea la 2022-04
Una vez realizado esto, procedemos hacer click en Instalar aplicación para poder solicitar el token de acceso para los servicios del API de Shopify.
Ten en consideración que este token solo se puede revelar una vez. Cópialo y guárdalo en un lugar seguro.
Para poder sincronizar los locales de Picker en Shopify, vamos a proceder a colocar un identificativo en cada local o sucursal de las tiendas que se están configurando en Shopify. Primero vamos a la opción de Sucursales.
Para poder identificar cada sucursal al crear un pedido, vamos a copiar el identificador que se tiene en el dashboard de Picker en cada tienda.
Copiamos el Restaurant Token de Picker, y lo procedemos a pegar en el nombre de una sucursal.
De esta manera las locales o sucursales de Shopify van a poder ser identificadas por Picker al momento de crear un pedido.
Para poder guardar tus credenciales de Shopify en tu Workspace de Picker, deberás invocar un endpoint donde se guardarán tus datos. Para poder identificar tu Workspace, deberás enviar el header (como un Bearer Token) el master key de tu Workspace. Lo puedes obtener desde el dashboard.
Dependiendo del ambiente que quieres configurar, a continuación, están las urls de cada uno de nuestros ambientes:
1) Para ambiente de pruebas: https://dev-api.pickerexpress.com/api/saveShopifyConfig
2) Para ambiente de producción: https://api.pickerexpress.com/api/saveShopifyConfig
En el payload, debes enviar los siguientes datos:
- accessToken: Token de acceso de API Shopify
- Shopifyurl: URL de tu sito de Shopify
El curl que puedes ejecutar desde Postman o cualquier otro API Manager, debe verse de la siguiente manera:
curl --location --request POST 'https://devapi.pickerexpress.com/api/saveShopifyConfig'
\--header 'Authorization: Bearer 85cb6cfb-a344-482b-b9dc-b8927eee57d4'
\--header 'Content-Type: application/json'
\--data-raw '{
"accessToken": "shopify_token",
"url": "https://my-site.myshopify.com"
}'
Para poder indicar a Shopify a que endpoint se debe enviar el pedido, se deberá ejecutar el siguiente servicio:
En los siguientes campos deberás suplantar lo siguiente:
url: Aquí debe ir la url de tu página de Shopify (la misma que configuras al guardar las credenciales en Picker)
orderAPI: Aquí debes ingresar el endpoint de Picker que recibirá tus ordenes creadas. Dependiendo del ambiente que quieras configurar:
- Para ambiente de pruebas: https://dev-api.pickerexpress.com/api/pushShopifyOrder
- Para ambiente de producción: https://api.pickerexpress.com/api/pushShopifyOrder
Ten en cuenta que para ejecutar este endpoint, debes agregar en la cabecera el token de acceso de tu sitio. Para más información, puedes consultar este linkhttps://shopify.dev/api/admin-rest/2022-04/resources/webhook#post-webhooks
Consideraciones:
Si las sucursales de Shopify no tienen el identificativo de Picker, la plataforma no podrá identificar de qué lugar saldrá tu pedido, y por ende no se podrá crear.
Encuentra aquí todas las preguntas frecuentes que tienes al momento de hacer la integración de Picker con los plugins.
Debes tener en consideración que el plugin debe usar el api key del local del cual se va a despachar. El API Key de tu local lo puedes encontrar en tu dashboard (https://dashboard.pickerexpress.com) en la sección de Locales.
En el registro del local, en la parte superior derecha, encontrarás el API Key perteneciente al local.
Para poder utilizar el plugin de Woocommerce (y cualquier plugin o integración vía API), debes tener activado el Plan Pro de Picker.
Una vez instalados los plugins de dirección y de Picker, la mejor forma de saber si estás integrado o no, es intentando hacer un checkout en tu plataforma con una dirección de delivery válida (no debe ser tan lejana a la ubicación de tu local). Al ingresar la dirección de entrega y demás campos necesarios en tu carrito de compras, el precio del delivery te aparecerá en el checkout.
En el caso de que no aparezca, revisa tu configuración.
Como todo plugin de Woocommerce, el uso de varios plugins puede hacer que algunos de estos no funcionen correctamente. Para el caso de Picker, también puede suceder. En especial aquellos que alteran o customizan los campos que se pueden manejar en el checkout (ej: Checkout for Woocommerce).
Para este caso en específico, si el plugin de Picker no está funcionando correctamente, debes revisar que dentro de los campos que tienes en el checkout, estén registrados los siguientes:
- billing_address_latitude
- billing_address_longitude
- shipping_address_latitude
- shipping_address_longitude
En el caso de seguir teniendo inconvenientes, puedes comunicarte con nosotros en el canal de soporte o tu asesor comercial para poder ayudarte.