Webhooks

Webhooks SIFEN con eventos firmados, reintentos y replay

Fisnodo notifica cambios de estado para que el ERP/POS actualice su propia operación sin polling constante ni revisión manual de la consola.

Operación de eventos

Los webhooks son parte del flujo de reconciliación: deben verificarse, guardarse y poder reintentarse.

Eventos

  • document.accepted.
  • document.rejected.
  • document.failed.
  • webhook.test para pruebas controladas.

Firma

  • X-Webhook-Signature.
  • HMAC SHA-256 sobre timestamp y body.
  • Comparación constante en el receptor.

Reintentos

  • Entregas registradas por endpoint.
  • Estados pending, delivering, delivered, retrying y failed.
  • Backoff por worker.

Replay

  • POST /v1/webhooks/{id}/replay.
  • Reencola una entrega almacenada.
  • Útil después de caídas del sistema origen.