Marketplace externo

Recibir una cancelación

OperioHub notifica a la flota adjudicada la cancelación iniciada desde el espacio de trabajo del restaurante.

Volver a todos los endpoints

Marketplace externo

Recibir una cancelación

La cancelación se persiste antes de enviar la notificación. Por tanto, un error o timeout del webhook no revierte el estado del pedido ni reactiva sus tokens.

POST webhooks.cancellation.url configurado en la interfaz 200-299 sin contrato de body
Sin auth Perfil: Bearer opcional configurado en la interfaz

Campos principales

Resumen de los campos relevantes para este endpoint.

Campo Tipo Descripción
eventType literal Siempre marketplace_order.cancelled.
order object orderId, dispatchOrderId y currentStatus cancelled.
marketplace object Correlación de solicitud, propuesta seleccionada y referencia externa opcional.
cancellation object Origen, estado previo, asignación, ruta activa y política de facturación aplicada.

Cuándo se envía

El evento tiene alcance deliberadamente limitado en la versión actual.

  • Se envía cuando un restaurante cancela un pedido adjudicado a una flota externa.
  • No se envía cuando la cancelación la inicia un dispatcher mediante la integración de estados.
  • Responder cualquier HTTP 2xx; no hay body de confirmación ni reintentos automáticos en esta versión.

Payload recibido

{
  "eventType": "marketplace_order.cancelled",
  "eventId": "44444444-4444-4444-8444-444444444444",
  "occurredAt": "2026-07-15T10:20:00.000Z",
  "order": { "orderId": "11111111-1111-4111-8111-111111111111", "dispatchOrderId": "POS-93442", "currentStatus": "cancelled" },
  "marketplace": { "marketplaceOrderRequestId": "22222222-2222-4222-8222-222222222222", "selectedQuoteId": "33333333-3333-4333-8333-333333333333", "externalQuoteId": "FLEET-QUOTE-42" },
  "cancellation": { "cancelledBy": "restaurant", "source": "restaurant_workspace", "previousStatus": "dispatcher_accepted", "dispatcherAssigned": true, "activeRouteAssigned": false, "billingPolicy": "charge_full" }
}

Errores esperados

Respuestas habituales que debe contemplar la integración.

502

Entrega fallida

OperioHub registra el fallo de webhook, pero la cancelación del pedido ya se ha completado.