Prueba el webhook

POST/api/v1/account/webhook/test

Envía en el momento un evento webhook.test firmado igual que los reales (X-Facturoa-Signature) al webhook de la cuenta (o al de su casa de software) y responde si llegó. Sirve para comprobar la URL, la firma y el secreto antes del primer documento. No se reintenta. Sin webhook: 409 error.webhook.required.

Respuestas

200Resultado de la entrega

eventstring
Ejemplo: webhook.test
sent_atstring · date-time
deliveredboolean
true si el webhook respondió 2xx
errorstring
Por qué no llegó (código HTTP o error de red)
Ejemplo: webhook delivery failed: http 401

401Falta la key o es inválida, está deshabilitada, vencida o revocada (error.missing_api_key, error.invalid_api_key, error.api_key.disabled, error.api_key.expired, error.api_key.revoked)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring

409Conflicto con el estado actual (p. ej. documento referenciado no aceptado, rango agotado)

codestring
Ejemplo: error.document.invalid
messagestring
errorsarray<object>
Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)
+ Ver 2 campos− Ocultar 2 campos
- fieldstring
  Ruta del campo en el JSON enviado
  Ejemplo: lines[0].quantity
- messagestring
  Ejemplo: Cantidad inválida: debe ser mayor que cero.
detailsarray<string>
Rutas de los campos inválidos (compatibilidad; usa errors)
request_idstring