Documentación

Primeros pasos

FactuBridge es una API REST que convierte tu software de facturación en un sistema conforme al Reglamento Verifactu (RD 1007/2023). Envías los datos de la factura en JSON y recibes en la misma llamada la huella encadenada, el código QR y la URL de verificación de la AEAT. La remisión a la Agencia Tributaria corre de nuestra cuenta.

1. Solicita el acceso

El alta es semiautomatizada: escríbenos ainfo@factubridge.es o usa elformulario de contacto. Damos de alta a tu empresa como obligado tributario (o a tus clientes, si eres fabricante de SIF) y preparamos tu acceso al portal. A partir de ahí el proceso es de autoservicio:

1. Recibes un enlace de invitación de un solo uso (caduca a las 72 horas) con el que estableces tú mismo tu contraseña del portal web. Ninguna credencial viaja por correo.
2. Ya dentro del portal, generas tú mismo tu API key por instalación de SIF desde la sección «API keys», una sola vez. La clave se muestra solo en ese momento: guárdala en tu gestor de secretos. Si la pierdes o se compromete, la rearmas desde el propio portal (la anterior queda revocada al instante).
3. Por defecto los envíos se firman con el certificado de Intergal como colaborador social, así que no tienes que aportar nada; si el obligado es una entidad y prefiere usar su certificado propio (representante o sello), lo subís vosotros desde el portal (detalle).

El acceso incluye el entorno de pruebas, conectado al portal de preproducción de la AEAT, para que desarrolles y valides antes de pasar a producción.

2. Entornos

Ambos entornos son funcionalmente idénticos. En los ejemplos usamos$BASE_URL para la URL base del entorno que corresponda. Desarrolla y valida contra el sandbox; el paso a producción es cambiar la URL base y la API key del entorno de producción, que generas desde el portal una vez validada la integración. Más detalle enEntorno de pruebas.

3. Tu primera factura

curl -X POST "$BASE_URL/create" \
  -H "Authorization: Bearer $FACTUBRIDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serie": "A",
    "numero": "2026-0001",
    "fecha_expedicion": "01-10-2026",
    "tipo_factura": "F1",
    "descripcion": "Servicios de consultoría — octubre 2026",
    "nif": "B87654321",
    "nombre": "CLIENTE EJEMPLO SL",
    "lineas": [
      {
        "base_imponible": "1000.00",
        "tipo_impositivo": "21.00",
        "cuota_repercutida": "210.00"
      }
    ],
    "importe_total": "1210.00"
  }'

Respuesta síncrona, en el momento:

{
  "uuid": "9b2e7c1a-4f6d-4c1e-9a3b-2f8e5d7c0a11",
  "estado": "Pendiente",
  "url": "https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR?...",
  "qr": "iVBORw0KGgoAAAANSUhEUgAA...",
  "huella": "3AD5CA54A0DE383B0C1F79E1B2C4D6E8..."
}

Con esa respuesta tu software ya dispone de todos los datos —el QR incluido— para imprimir o entregar la factura: no hay que esperar a la AEAT. El envío del registro se hace en segundo plano y puedes conocer su resultado porconsulta de estado o webhook.

4. Siguientes pasos

• Autenticación — cómo usar la API key y qué papel juegan los certificados.
• Enviar facturas — tipos de factura (F1, F2, rectificativas), líneas, lotes.
• Anulaciones y subsanaciones — corregir lo ya registrado.
• Referencia de la API — todos los endpoints.