Introducción

Bilteo es una plataforma de facturación electrónica con Veri*Factu. Para integrarte ofrece dos productos distintos, según quién emite la factura:

• API Pública de Bilteo — Bilteo es tu sistema de facturación: creas la factura, Bilteo la numera, calcula los impuestos, genera el documento (PDF/Facturae) y la registra en Veri*Factu.
• Verifactu Direct API — Bilteo es tu pasarela a Veri*Factu: tu software ya emitió la factura; Bilteo solo la registra en Veri*Factu y la remite a la AEAT.

No son dos APIs separadas: se consumen sobre la misma API REST (/api/v1), con las mismos scopes, mediante API key u OAuth2, y la misma cadena Veri*Factu. Lo que cambia es el modelo y el para qué. Puedes usar uno, el otro o ambos.

¿Cuál necesito?

Si dudas, empieza por Dos productos: cuál necesito: explica cada uno, sus diferencias, qué resuelve y casos de uso.

Conceptos

• Tenant — tu empresa/obligado tributario dentro de Bilteo. Cada API key o conexión OAuth2 opera sobre un único tenant.
• Registro Veri*Factu — el registro de facturación (alta o anulación) que Bilteo encadena por huella y remite a la AEAT. Lo generan los dos productos. Ver Veri*Factu.
• Serie / Factura — propios de la API Pública (emisión nativa): la factura nace como borrador y, al emitirse, toma su número de una serie correlativa. En Verifactu Direct API la serie y el número los pones tú.

La API en una frase

REST sobre HTTPS, JSON, autenticación por API key u OAuth2 con scopes, y una especificación OpenAPI 3.1 que puedes explorar en la Referencia de la API.

Base URL:  https://api.test.bilteo.com/api/v1

Host de ejemplo

Sustituye https://api.test.bilteo.com por el host de tu entorno. Los tenants de pruebas (sandbox) remiten a los servicios de test de la AEAT; los tenants live a producción.

Por dónde empezar

• API Pública de Bilteo (emitir desde Bilteo) → Primeros pasos.
• Verifactu Direct API (registrar una factura ya emitida) → Verifactu Direct API.
• Fundamentos comunes a ambos → Autenticación y scopes y Webhooks.