Documentación

Validación del destinatario

Opcionalmente, FactuBridge puede comprobar el identificador del destinatarioantes de registrar la factura: NIF españoles contra el censo de la AEAT (servicio VNifV2) y números de IVA intracomunitarios contra VIES. Sirve para detectar datos erróneos en origen, antes de que la AEAT marque el registro «aceptado con errores».

Cómo se activa

Con el parámetro validar_destinatario en/v1/create y /v1/create_bulk. Por defecto esfalse: la validación censal es una conveniencia, no el control regulatorio — el control definitivo lo aplica la AEAT al recibir el registro.

{
  "serie": "A",
  "numero": "2026-0007",
  "fecha_expedicion": "02-10-2026",
  "tipo_factura": "F1",
  "nif": "B12345678",
  "nombre": "EMPRESA EJEMPLO SL",
  "validar_destinatario": true,
  ...
}

Solo se bloquea la factura cuando la AEAT rechazaría el envío:

Resultado del censo	Efecto
`Identificado`	La factura se registra.
`Identificado-Baja` / `Identificado-Revocado`	Se registra (con aviso en nuestros logs). La AEAT los admite.
`No identificado-similar` (solo personas físicas)	Se registra con aviso: el nombre se parece pero no coincide del todo.
`No identificado`	Se rechaza con `400`.
Censo no disponible / respuesta no interpretable	Fail-open: se registra. Nunca bloqueamos una factura porque el censo esté caído.

HTTP 400 Bad Request

{
  "detail": "NIF B12345678 no identificado en el censo de la AEAT.
   Verifique el NIF o use validar_destinatario=false para omitir
   esta comprobación."
}

Detalles que conviene saber

Personas jurídicas: solo se coteja el CIF; la razón social no influye en el resultado.
Personas físicas: se cotejan NIF + nombre. El censo compara por palabras, sin importar el orden, pero un nombre con discrepancias puede bloquear una factura legítima — actívalo con cautela en B2C.
VAT intracomunitario (id_otro con tipo 02): se valida contra VIES; si el VAT no es válido, 400.
En lotes, los NIF únicos se resuelven en una sola consulta batch al censo, así que el coste por factura es mínimo. Recuerda que el lote es atómico: un solo destinatario no censado rechaza el lote entero.
Caché: los resultados se cachean 5 minutos por obligado, deduplicando consultas repetidas al mismo destinatario.
Sin sandbox: el censo AEAT y VIES son servicios de producción, sin entorno de pruebas. Aunque trabajes contra nuestro entorno de pruebas, con validar_destinatario=true los NIF deben estar realmente censados.

Validación suelta, sin factura

También puedes validar un identificador de forma independiente — útil en el alta de clientes en tu ERP, antes de que exista factura alguna:

POST/v1/validate/nif

POST /v1/validate/nif
Authorization: Bearer $FACTUBRIDGE_API_KEY

{ "nif": "B12345678", "nombre": "EMPRESA EJEMPLO SL" }

# → { "resultado": "Identificado", "fuente": "aeat",
#     "consultado_at": "2026-10-02T09:14:00Z", ... }

POST/v1/validate/vat

POST /v1/validate/vat
Authorization: Bearer $FACTUBRIDGE_API_KEY

{ "pais": "DE", "numero": "129273398" }

# → { "valido": true, "fuente": "vies", ... }

El campo fuente indica de dónde salió el resultado:aeat/vies (consulta en vivo), cache oservicio_no_disponible.