Veri*Factu

Quan emets una venda, Bilteo genera el seu registre de facturació Veri*Factu, l'encadena amb l'anterior mitjançant una empremta i l'envia a l'AEAT. És automàtic: no has de construir ni signar res.

Què genera Bilteo

• Un registre d'alta (RegistroAlta) en emetre una venda.
• Un registre d'anul·lació (RegistroAnulacion) en anul·lar una factura emesa.
• Cada registre inclou una empremta SHA-256 calculada sobre els camps clau i l'empremta del registre anterior del tenant; així formen una cadena inalterable.

Factura A (alta) ──empremta──▶ Factura B (alta) ──empremta──▶ Factura A (anul·lació) ─▶ …
        └── encadenament per tenant: cada registre referencia l'empremta de l'anterior

Enviament i estats del registre

La generació i l'enviament estan desacoblats: el registre neix pendent i un procés posterior l'envia a l'AEAT. El seu estat reflecteix la resposta:

Estat	Significat
pending	Generat, pendent d'enviament.
in-process	Enviat, esperant resposta.
accepted	Acceptat per l'AEAT.
accepted_error	Acceptat amb errors (registrat).
rejected	Rebutjat (no registrat a l'AEAT).
unknown_response	Sense resposta ferma: error de transport o resposta no interpretable. response_code indica la causa (SOAP_CLIENT, HTTP_<status>, INVALID_JSON, INVALID_TYPE). No és un rebuig fiscal; cal revisar-ho.

Els errors transitoris de xarxa o de l'AEAT no canvien l'estat: el registre torna a pending i es reintenta sol.

Un registre amb resposta ferma (rejected, accepted o accepted_error) es pot subsanar.

No facis polling: utilitza webhooks

En lloc de consultar l'estat contínuament, subscriu-te a verifactu.accepted / verifactu.rejected i Bilteo t'avisarà quan l'AEAT respongui.

Codi QR

Cada factura emesa inclou el seu QR de contrast de l'AEAT (NIF, número de sèrie, data i import total), que permet al receptor verificar-la. Bilteo l'incorpora quan genera el PDF.

Lectura dels registres

Amb l'àmbit verifactu:read pots consultar els registres i el seu estat mitjançant l'API. Consulta la Referència.

En proves

En un tenant de proves, l'enviament va a l'entorn d'homologació de l'AEAT, mai a producció. També pots desactivar la generació del registre per provar només la teva integració. Consulta l'Entorn de proves.