Conectar Shipday
Administra el servicio Shipday en Connect → Delivery services. Usa los campos disponibles del proveedor para configurar credenciales y después define cuándo y dónde se aplica.
Antes de empezar
Confirma el acceso de administrador a Delivery services, la cuenta de Shipday prevista y un pedido y entorno de entrega de prueba autorizados.
1. Comprobar si Shipday está disponible
Revisa primero la lista de servicios de entrega del proyecto. Si Shipday no aparece, confirma la disponibilidad y activación con el responsable de la cuenta de Ordering.co. Si confirma que hace falta instalarlo, consulta el catálogo aprobado en Settings → Apps & developers → API & integrations → Plugins.
2. Configurar la clave API y el token de webhook
Abre Shipday en Connect → Delivery services. Introduce la clave API y el token de webhook en los campos del proveedor que muestre el proyecto. En la cuenta aprobada de Shipday, registra el receptor del proyecto y el mismo token exacto cuando se requiera. Guarda los valores en tu gestor de secretos.
3. Configurar el servicio de entrega
- En Ordering.co Dashboard, abre Connect → Delivery services.
- Busca Shipday Delivery Integration.
- Habilita el servicio únicamente cuando la operación esté preparada para usarlo.
- Abre el servicio y configura su Driver Group.
Configura deliberadamente cada pestaña:
| Pestaña de configuración | Qué definir | Límite que se debe confirmar |
|---|---|---|
| General | Clave API y token de webhook, activador de asignación automática y cualquier regla de vencimiento para rechazos automáticos. | Seleccionar un activador no demuestra que el pedido llegue a Shipday o se asigne. |
| Businesses | Restaurantes o tiendas que pueden usar el servicio. | Seleccionar un negocio no hace que todos sus pedidos sean elegibles. |
| Schedule | Días y horarios en que debería funcionar el servicio. | Guardar un horario no demuestra que el proveedor esté disponible. |
| Payment methods | Métodos de pago elegibles para este servicio, como efectivo, Stripe, PayPal o Apple Pay cuando corresponda. | Seleccionar un método no captura, reembolsa, liquida ni concilia pagos. |
| Delivery zones | Zonas geográficas que debe cubrir el servicio. | Asociar una zona no garantiza que un conductor pueda aceptar un pedido. |
Consulta Configurar un servicio de entrega para conocer el flujo de Dashboard relacionado.
4. Validar el comportamiento de pedidos, despacho y seguimiento
Después de que los propietarios de la conexión aprueben una prueba controlada, usa un pedido de prueba elegible y confirma la secuencia:
- El pedido de prueba corresponde a un negocio, método de pago, horario y zona de entrega seleccionados.
- Se alcanza el activador configurado, por ejemplo Accepted by business, si ese es el activador seleccionado.
- Shipday recibe los datos previstos del pedido.
- Un operador autorizado puede asignar el pedido a un conductor disponible, o se aplica la configuración aprobada de asignación automática.
- El seguimiento y estado de entrega mostrados para la prueba aprobada coinciden con el flujo previsto del pedido y el conductor.
No uses pedidos reales de clientes para diagnosticar la integración. Una lista de pedidos visible, un interruptor habilitado o una página de seguimiento no demuestran por sí solos que se haya despachado o entregado el pedido correcto.
Qué verificar en cada límite
| Límite | Evidencia que se debe buscar | Qué no demuestra |
|---|---|---|
| Instalación y configuración | El plugin Shipday y los ajustes del servicio de entrega están disponibles y se guardaron los campos previstos. | Que Shipday haya aceptado credenciales, un webhook o un pedido. |
| Credenciales del proveedor | La clave API y el token de webhook se obtuvieron para la cuenta prevista y se configuraron en los sistemas correspondientes. | Que las credenciales estén activas, aceptadas o autorizadas para la operación prevista. |
| Conexión y webhook | Los propietarios del proveedor y del endpoint confirman la configuración del webhook específico del proyecto. | Que se haya enviado, entregado, reintentado o procesado un callback. |
| Pedido y sincronización de datos | Una prueba aprobada llega a Shipday con los detalles del pedido previstos después del activador seleccionado. | Que todos los pedidos futuros se transfieran o contengan los datos correctos. |
| Despacho | La prueba aprobada cumple los requisitos y el proveedor la acepta para asignación. | Que un conductor la haya aceptado o completado. |
| Entrega y seguimiento | Un operador autorizado confirma el seguimiento previsto y el estado final de la prueba. | Que se haya completado el pago o enviado un mensaje al cliente. |
| Pago | Se seleccionaron métodos elegibles para el servicio de entrega. | Que se haya autorizado, capturado, reembolsado, liquidado o conciliado un pago. |
| Notificaciones | El seguimiento o las actualizaciones de webhook pueden respaldar un flujo, pero no demuestran que se haya enviado o leído una notificación al cliente. | Una actualización del proveedor no demuestra la entrega de una notificación. |
| Resultado | La misma prueba aprobada se puede rastrear desde la elegibilidad hasta la asignación del proveedor y el estado final. | Un token guardado, respuesta de Dashboard o botón de la app no son una transacción completada. |
Prácticas operativas
- Usa una prueba aprobada antes de ofrecer el servicio a clientes reales.
- Mantén idéntico el token del webhook en ambos sistemas; si no coincide, no se puede validar de forma confiable el callback.
- Alinea las zonas de entrega con las áreas que pueden cubrir los conductores disponibles de Shipday.
- Habilita la asignación automática y el rechazo automático solo después de aprobar su activador y tiempos.
- Revisa los métodos de pago elegibles del servicio como parte de la configuración operativa; el procesamiento de pagos es un flujo independiente.
- Si tu espacio de trabajo ofrece una vista de registros de Dashboard, trata sus solicitudes y respuestas como sensibles y sigue el proceso de soporte aprobado en vez de copiarlas a tickets o chats.
Solución de problemas
Shipday no recibe el pedido de prueba
Confirma que el negocio, horario, zona, método de pago y activador de asignación seleccionados correspondan a la prueba aprobada. Luego, pide a los responsables del proveedor y del endpoint que verifiquen la conexión sin compartir claves, tokens, URL, datos enviados, información de clientes ni pedidos.
El pedido se recibió, pero no se puede asignar
Revisa el horario aprobado del servicio, la zona de entrega y la disponibilidad de conductores. La aceptación del proveedor, la asignación de un conductor y la finalización de la entrega son resultados distintos que deben investigarse por separado.
Falta el seguimiento o una actualización de estado
Confirma que el enlace API específico del proyecto y el token de webhook que distingue mayúsculas coincidan en ambos sistemas. Un ajuste guardado no indica si un callback se entregó o procesó; verifica la prueba aprobada en ambos endpoints.
Guías relacionadas: Plugins · Delivery services · Configurar un servicio de entrega