Skip to main content
Los webhooks permiten que Pruff notifique a tus sistemas, en tiempo real, cuando ocurre un evento relevante. Por cada evento, Pruff envía un POST con un body JSON al endpoint que configuraste para ese evento.

​
Eventos disponibles

X-Webhook-Id identifica el tipo de evento, no la entrega: todas las entregas de un mismo evento llevan el mismo valor. Para detectar entregas duplicadas, usa el header de idempotencia (ver Entregas y reintentos).

​
URL de destino

Pruff arma la URL de cada entrega concatenando la URL base de tu suscripción con el path del evento. Con la URL base https://api.tuempresa.cl/pruff, el evento invoice.newInvoices llega a:
Si prefieres recibir todos los eventos en una sola URL, Pruff puede configurar tu suscripción para enviarlos a la URL base sin agregar el path. En ese caso, distingue el evento con el header X-Webhook-Event.

​
Suscripción

La suscripción la configura el equipo de Pruff: solicítala a tu contacto en Pruff. Te suscribes evento por evento, y para cada uno se define:
  • La URL base de tu endpoint.
  • Si se agrega o no el path del evento a esa URL.
  • El secret compartido con el que Pruff firma cada entrega. Cada suscripción tiene su propio secret.
  • Opcional: un header de autenticación propio de tu sistema, con su nombre y su valor (por ejemplo, Authorization: Bearer <token>).
  • Opcional: un header de idempotencia, con el nombre que elijas, cuyo valor es un UUID v4 o un string hexadecimal de 64 caracteres.

​
Versiones

Todos los eventos están en su versión 1. Un cambio incompatible en el body de un evento se publica como una versión nueva, y cada suscripción queda fijada en la versión con la que se configuró. El body y los headers no indican la versión.

​
Próximos pasos

Headers y firma

Verifica que cada entrega viene de Pruff.

Entregas y reintentos

Qué respuesta esperamos, cuándo reintentamos y cómo manejar duplicados.