Introducció

Bilteo és una plataforma de facturació electrònica amb Veri*Factu. Ofereix dos productes diferents segons qui emet la factura:

• API pública de Bilteo — Bilteo és el teu sistema de facturació: crees la factura, Bilteo la numera, calcula els impostos, genera el document (PDF/Facturae) i la registra a Veri*Factu.
• Verifactu Direct API — Bilteo és la teva passarel·la a Veri*Factu: el teu programari ja ha emès la factura; Bilteo només la registra a Veri*Factu i la remet a l'AEAT.

No són dues API separades: es consumeixen sobre la mateixa API REST (/api/v1), amb els mateixos scopes, mitjançant API key o OAuth2, i la mateixa cadena Veri*Factu. El que canvia és el model i la finalitat. Pots utilitzar-ne una, l'altra o totes dues.

Quin necessito?

Tria l'API pública de Bilteo si vols que Bilteo emeti i numeri les factures. Tria Verifactu Direct API si el teu programari ja les emet i només necessites registrar-les a Veri*Factu.

Conceptes

• Tenant — la teva empresa o obligat tributari dins de Bilteo. Cada clau API o connexió OAuth2 opera sobre un únic tenant.
• Registre Veri*Factu — el registre de facturació, d'alta o anul·lació, que Bilteo encadena per empremta i remet a l'AEAT. Tots dos productes el generen.
• Sèrie / Factura — pròpies de l'API pública: la factura neix com a esborrany i, quan s'emet, rep el número d'una sèrie correlativa. A Bilteo Direct, tu proporciones la sèrie i el número.

L'API en una frase

REST sobre HTTPS, JSON, autenticació per API key o OAuth2 amb scopes i una especificació OpenAPI 3.1 que pots explorar a la Referència de l'API.

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

Host d'exemple

Substitueix https://api.test.bilteo.com pel host del teu entorn. Els tenants de proves (sandbox) remeten als serveis de test de l'AEAT; els tenants live, a producció.

Per on començo

• API pública de Bilteo (emetre des de Bilteo) → Primers passos.
• Verifactu Direct API (registrar una factura ja emesa) → Verifactu Direct API.
• Contracte complet dels endpoints → Referència de l'API.