Desarrolladores
Documentación API para integraciones
Conecta tu POS, marketplace o panel propio con OperioHub. Cada endpoint vive en una página propia generada desde contenido estructurado, para que la referencia pueda crecer sin convertir la landing en una página interminable.
API Reference
Endpoints de integración
Consulta los campos obligatorios, la autenticación, los ejemplos de petición y las respuestas de error de cada endpoint. Usa la referencia para desarrollar una integración de pedidos y estados desde tu sistema. Si integras el reparto de un local, revisa el caso de uso: restaurantes con reparto propio.
Prueba rápida
Envía una petición desde la documentación
Usa el endpoint de creación de pedido con un payload editable y pega un token válido para comprobar la integración sin salir de la referencia.
Consola de prueba
Envía una petición de creación
Ajusta la URL base, pega un token válido y modifica el payload para enviar una petición de prueba desde esta página. También puedes copiar el ejemplo como cURL o JavaScript.
Orders API
Orders API
POST
/api/orders Dispatcher o restaurante Crear pedido Crea pedidos desde una cuenta dispatcher o restaurante para un restaurante ya dado de alta o para un restaurante externo enviado en la petición. POST /api/orders/:orderId/status Dispatcher Actualizar estado de pedido Actualiza el estado operativo de un pedido desde una integración dispatcher sin exponer la actualización general del pedido. POST /api/orders/:orderId/cancel Dispatcher o restaurant Cancelar pedido Cancela manualmente un pedido activo desde una cuenta dispatcher o restaurante usando el mismo flujo operativo que el frontend. POST /api/orders/:orderId/release-from-route Dispatcher o restaurant Liberar pedido de ruta Libera un pedido de su asignación activa de route/rider y lo devuelve a la operativa del dispatcher. POST /api/orders/:orderId/complete Dispatcher con permiso de escritura Finalizar pedido Finaliza manualmente un pedido en reparto sin evidencia GPS. GET /api/orders Dispatcher, restaurant o rider Listar pedidos Consulta pedidos con filtros, paginación y ordenación desde el perfil autenticado. GET /api/orders/:orderId Dispatcher, restaurant o rider Consultar detalle de pedido Obtiene la información de un único pedido dentro del alcance del perfil autenticado. Routes API
Routes API
Dispatchers API
Dispatchers API
Marketplace externo
Marketplace externo
POST
quoteEndpointUrl configurado en la interfaz Flota externa Cotización de reparto externo OperioHub solicita una propuesta y la flota responde en la misma llamada con precio, ETAs y rider previsto. POST webhooks.award.url configurado en la interfaz Flota externa Recibir una adjudicación OperioHub confirma a la flota ganadora que su propuesta ha sido adjudicada y entrega credenciales temporales de operación. POST webhooks.cancellation.url configurado en la interfaz Flota externa Recibir una cancelación OperioHub notifica a la flota adjudicada la cancelación iniciada desde el espacio de trabajo del restaurante. POST /api/marketplace/orders/:orderId/external-status Flota externa adjudicada Actualizar el estado del pedido externo Actualiza los estados operativos de un pedido adjudicado con la credencial temporal de estado entregada en la adjudicación. POST /api/marketplace/orders/:orderId/external-rider-location Flota externa adjudicada Enviar tracking del rider externo Publica la última ubicación del rider externo mediante el token temporal entregado en la adjudicación. POST data.webhooks.incidentChat.url (ACK) y operations.incidentChat.url Flota externa adjudicada Chat de incidencias externo Sincroniza el chat de incidencias entre el restaurante y la flota externa con dos direcciones acordadas en la adjudicación.