Ganchos web

Se dispara cuando se crea un pedido de entrega local (Delivery / Pickup / P2P) por cualquier vía: formulario web, API REST/GraphQL, sincronización con plataforma de e-commerce, reglas automáticas, filas importadas, etc. Excluye los pedidos label-service y otros tipos que no son de entrega. Se omite en el flujo por lotes cuando el mismo destinatario tiene también order_create_async_postback_url configurado. Configure con order_create_webhook_url.

Se dispara en cada transición de estado del pedido — recogido, en tránsito, entregado, excepción, cancelado. Configure con order_status_change_webhook_url.

Se dispara en cada evento del ciclo de vida del seguimiento de un paquete (información enviada, inicio de entrega, entrega exitosa, no entregado, etc.). Configure con tracking_event_webhook_url. Los eventos de entrega y de recogida también incluyen la prueba de entrega: proof_files y proof_files_detail (file_id, type, url, full_url, URL de descarga firmada). Las fotos subidas después del evento llegan como pod.files_updated. Cada archivo incluye además el contexto de su evento: tracking_event_id, tracking_event_status_id, tracking_event_key, service_type (1 = delivery / 2 = pickup) y service_status (1 = success / 2 = failed); en archivos antiguos sin evento registrado son null.

Se dispara una vez tras finalizar una importación masiva de pedidos. La carga contiene el array de resultados por fila. Configure con order_create_async_postback_url.

Se dispara cuando una foto de entrega o firma se añade, se reemplaza o se elimina (action: added / updated / removed) — un envío por archivo, sin más sondeo de adjuntos. Se activa configurando pod_files_webhook_url. Cada archivo incluye además el contexto de su evento: tracking_event_id, tracking_event_status_id, tracking_event_key, service_type (1 = delivery / 2 = pickup) y service_status (1 = success / 2 = failed); en archivos antiguos sin evento registrado son null.

Se dispara cuando un pedido se elimina permanentemente, para que su sistema pueda reflejar la eliminación. Se activa configurando order_deleted_webhook_url.

Se dispara cuando un intento de cancelación es rechazado (por ejemplo, el pedido ya está en reparto), para que su equipo de operaciones pueda supervisar las cancelaciones fallidas sin consultar la API. Se activa configurando order_cancel_failed_webhook_url.

Se dispara cuando un asiento del tablero de rutas cambia de manos o el tablero cambia de estado — el campo action indica qué ocurrió (claimed, standby, pooled, promoted, withdrawn, vetoed, replaced, assigned, awarded, lost, displaced, settled, board_opened, board_closed, board_cancelled). Solo a nivel de empresa. Suscripción mediante route_board_webhook_url.

Puertas Abiertas — Se dispara en el momento en que se abren las puertas de los casilleros para un intento de entrega — tanto si el repartidor usó la pantalla del casillero con el código de acceso como la API de apertura remota — incluidas las reaperturas por reasignación. El bloque opening lista cada compartimento abierto con su grid_id, el número de puerta de hardware compartment_number y el pickup_locker_number (número secuencial de visualización contado de arriba abajo por columna y luego de izquierda a derecha). Cada compartimento incluye además pickup_locker_code: la etiqueta "{shelf_code}-{pickup_locker_number}" a la que se envía al destinatario; null cuando el compartimento no tiene número de recogida. La carga útil también incluye pickup_code: el código de recogida del destinatario, asignado en el momento en que se abren las puertas; sigue siendo el mismo código después de que el repartidor confirme el depósito, y solo puede usarse para recoger una vez confirmado el depósito.

Entregado en la taquilla — Se dispara cuando se confirma un depósito y los paquetes están en la taquilla. La carga incluye el código de recogida del destinatario. Cada compartimento incluye además pickup_locker_code: la etiqueta "{shelf_code}-{pickup_locker_number}" a la que se envía al destinatario; null cuando el compartimento no tiene número de recogida. Para puertas abiertas mediante la API de apertura remota, la plataforma liquida el depósito en cuanto la taquilla informa de que todas las puertas abiertas están cerradas, por lo que este evento se dispara sin llamada a confirm; confirmed_by indica la vía de liquidación: courier_terminal, partner_api, door_close, timeout_door_closed o console.

Recogido — Se dispara cuando el destinatario ha recogido los paquetes depositados.

Entrega fallida — Se dispara cuando una entrega falla; se incluyen los códigos de fallo por paquete.

Caducado — Se dispara cuando un código de entrega sin usar o un depósito sin recoger supera su fecha de caducidad.

Cancelado — Se dispara cuando una entrega se cancela antes de completarse.

Reapertura de corrección — Se dispara cuando los compartimentos ocupados se reabren dentro de la ventana de corrección para corregir una colocación errónea — desde la pantalla de la taquilla o mediante la API. El bloque correction enumera los compartimentos reabiertos. Cada compartimento incluye además pickup_locker_code: la etiqueta "{shelf_code}-{pickup_locker_number}" a la que se envía al destinatario; null cuando el compartimento no tiene número de recogida.

partner_locker_delivery.event_type_code_rotated — Se dispara cuando el socio renueva el código de entrega o el código de recogida de una entrega. El bloque rotation indica qué código se sustituyó, cuándo y si se reenvió la notificación al destinatario; el código nuevo nunca viaja en un webhook, solo se revela en la respuesta directa de la API de renovación.

Asignación creada — Se dispara cuando un pedido se asigna al proveedor — por una regla automática o manualmente. La carga útil incluye el número de asignación, los identificadores del pedido y los números de seguimiento de los paquetes.

Paquetes entregados en mano — Se dispara cuando el almacén ha entregado físicamente al proveedor todos los paquetes de la asignación.

Asignación cancelada — Se dispara cuando la plataforma retira una asignación al proveedor. El campo reason distingue entre cancelled (la asignación se canceló en el transportista), fallback_to_self_delivery (la plataforma recuperó el pedido para entregarlo por sus propios medios) y reassigned (el pedido se trasladó a otro proveedor).

Entrega parcial — Se activa cuando parte de un envío ha sido entregada mientras otros paquetes siguen en curso. El array packages incluye el resultado de cada bulto y legs enumera los pedidos externos registrados con el transportista: uno por paquete cuando el transportista no admite envíos de varios bultos.

Se asignó un conductor al pedido (manualmente, por planificación de rutas o por asignación automática). data.source = auto_assign cuando lo hizo el orquestador.

El pedido perdió a su conductor (traspaso, revocación, rechazo, tiempo agotado). data.previous_driver_id indica quién lo tenía.

El conductor aceptó en la app un pedido asignado automáticamente (turno de conductores con aceptación obligatoria).

El conductor rechazó un pedido asignado; data.reason lleva el motivo opcional en texto libre.

El conductor inició la recogida (estado Recogida iniciada / Fuera para recoger).

El paquete fue recogido (estado Ya recogido).

El paquete va de camino al destinatario (estado Entrega iniciada / Fuera para entrega).

La entrega se completó con éxito (estado Exitoso).

El intento de entrega falló (Reentregar más tarde, Necesita reprogramación, Rechazado por el destinatario).

El pedido fue cancelado.

El personal (o un conductor, cuando se permite) marcó el pedido como listo para recoger (Opciones de despacho → listo para recoger).

Un conductor entró o salió de turno en la app (opción de turno de conductores).

Una posición del conductor procedente de la app o del rastreador, limitada por conductor mediante driver_location_min_interval_sec (60 s por defecto). Se envía solo a driver_location_webhook_url.

Se depositó un paquete en la máquina y espera a la siguiente persona (destinatario, mensajero u operador, véase data.device_order.next_actor). due_at es la fecha límite de retirada.

La persona a la que esperaba retiró el paquete: el destinatario, el mensajero o el personal que vacía un buzón inteligente.

El personal sacó el paquete de la máquina. removal_reason indica el motivo: overdue_return, handover, relay, anomaly o recovery.

El paquete superó su due_at sin ser retirado. Sigue en la máquina y su código sigue funcionando; se establece overdue_at y next_actor pasa a operator.

Se abrió una incidencia sobre la gestión (por ejemplo door_left_open, deposit_unverified, item_missing, overdue). data.exception incluye id, type, severity y status.

Una persona cerró una incidencia sobre la gestión. data.exception.status es resolved o dismissed y resolution_action indica lo que se hizo.