Factuarea API
VeriFactu (AEAT)

Recupera la configuració de VeriFactu

Retorna la configuració VeriFactu de la teva empresa (mode, entorn, estat d'alta). La contrasenya del certificat mai no s'exposa. Es retorna com a `{ "data": VeriFactuConfig }`.

GET
/verifactu/config

Authorization

AuthorizationBearer <token>

A: header

Cos de la resposta

application/json

application/json

application/json

application/json

application/json

{
  "data": {
    "object": "verifactu_config",
    "enabled": true,
    "mode": "verifactu",
    "auto_transmit": true,
    "environment": "production",
    "notification_emails": [
      "avisos@empresa.es"
    ],
    "is_locked_until": "2026-12-31T23:59:59+01:00",
    "has_active_certificate": true,
    "active_certificate_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a13",
    "updated_at": "2026-04-15T10:30:00+02:00"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No se ha proporcionado una API key válida en el header Authorization.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido para esta operación.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
  }
}

Valida la cadena de hashes de VeriFactu

Recalcula la cadena d'empremtes VeriFactu (`huella`) de la teva empresa i la compara amb els valors persistits sense mutar dades. Retorna si la cadena està íntegra i, si no, el primer registre corrupte. Limitat a 1 petició/minut i rebutjat amb 422 `dataset_too_large` per a conjunts de més de 50,000 registres.

Recupera la declaración responsable actual

Retorna la versió vigent (la més recent) de la Declaración Responsable VeriFactu a nivell de productor. Només lectura: la declaració és global del productor del sistema (Factuarea), no per empresa. Retorna 404 `declaracion_not_found` si no se n'ha publicat cap.