Factuarea API
VeriFactu (AEAT)

Obtenir un registre d'accés a AEAT

Obté un únic registre d'accés AEAT dissociat pel seu `id` (UUID v7). Retorna 404 si el registre no existeix o pertany a una altra empresa.

GET
/verifactu/aeat-access/records/{record}

Authorization

AuthorizationBearer <token>

A: header

Paràmetres de ruta

record*string

Cos de la resposta

application/json

application/json

application/json

application/json

application/json

{
  "data": {
    "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a15",
    "object": "verifactu_aeat_access_record",
    "accessed_at": "2026-04-15T10:31:05+02:00",
    "accessor_identifier_hash": "5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8",
    "record_count_disclosed": 1,
    "disclosure_scope": "alta"
  }
}

{
  "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"
  }
}

Llistar registres d'accés d'AEAT

Retorna el llibre d'accessos AEAT dissociat (anonimitzat) amb paginació per cursor. Els identificadors fiscals de tercers (NIF) mai no s'exposen; el cursor usa l'UUID v7 del registre subjacent només per ordenar.

Activar un certificat d'empresa

Converteix en actiu un certificat pujat prèviament. Qualsevol altre certificat actiu es desactiva de manera atòmica. Retorna 404 si el certificat no existeix a la teva empresa.