Factuarea API
VeriFactu (AEAT)

Obtener un registro de acceso a AEAT

Obtiene un único registro de acceso AEAT disociado por su `id` (UUID v7). Devuelve 404 si el registro no existe o pertenece a otra empresa.

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

Authorization

AuthorizationBearer <token>

En: header

Parámetros de ruta

record*string

Cuerpo de la respuesta

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

Listar registros de acceso de AEAT

Devuelve el libro de accesos AEAT disociado (anonimizado) con paginación por cursor. Los identificadores fiscales de terceros (NIF) nunca se exponen; el cursor usa el UUID v7 del registro subyacente solo para ordenar.

Activar un certificado de empresa

Convierte en activo un certificado subido previamente. Cualquier otro certificado activo se desactiva de forma atómica. Devuelve 404 si el certificado no existe en tu empresa.