Transferz Webhook API

POST /api/transferz/webhook Webhook

Recibe eventos de Transferz, valida la cabecera Authorization y llama a PROC_TRANSFERZ_ADD_WEBHOOK.

Headers

Nombre	Obligatorio	Descripcion
`Content-Type`	Si	`application/json`
`Authorization`	Si	`HMAC {firmaBase64}`, calculada con body raw + `WEBHOOK_SECRET`.

Responses

Codigo	Descripcion
`200`	Webhook recibido y firma correcta.
`401`	Firma HMAC incorrecta o `WEBHOOK_SECRET` no configurado.
`405`	Metodo distinto de POST.
`500`	Error interno al procesar o guardar en SQL.

Eventos Direct Assignment

journeyFleetAssignedEvent

Nuevo journey asignado a nuestra flota. Se guarda el journeyId como pendiente para que el servicio llame a Get journey information.

journeyStatusChangedEvent

Cambio de estado del journey, por ejemplo cancelacion. Se refresca el servicio completo por journeyId.

journeyExecutionDetailsUpdatedEvent

Cambio de recogida, destino u hora de recogida. Se refresca el servicio completo por journeyId.

journeyTravellerInfoUpdatedEvent

Cambio de datos del pasajero. Se refresca el servicio completo por journeyId.

journeyFleetUnassignedEvent

Transferz desasigna el journey de nuestra flota. Se guarda el evento para marcar/anular segun procedimiento.

No usados

Como soporte indico que trabajaremos solo con Direct Assignment flow, no son necesarios offerCreatedEvent ni offerStatusChangedEvent.

Ejemplo

POST http://localhost:PUERTO/api/transferz/webhook
Content-Type: application/json
Authorization: HMAC FIRMA_CALCULADA

{"journeyFleetAssignedEvent":{"created":"2026-07-21T10:00:00","journeyId":392553,"transferCompanyId":151}}

Nota: si se llama a /api/transferz/webhook con GET, la API devuelve 405 porque Transferz enviara POST.