# VeriBai

> API REST de cumplimiento fiscal para software: VeriFactu (AEAT) y TicketBAI (haciendas forales de Araba, Bizkaia y Gipuzkoa) con una sola integración. Valida, firma, encadena y remite registros de facturación, y devuelve el código QR verificable.

Entornos: TEST https://sandbox.veribai.com · LIVE https://api.veribai.com
Autenticación: cabecera x-api-key (claves en https://app.veribai.com)
Documentación completa: https://veribai.com/docs

## Primeros pasos

- [Introducción](https://veribai.com/docs/introduccion.md): Emite tu primer registro de facturación en el entorno TEST en menos de diez minutos.
- [Autenticación](https://veribai.com/docs/autenticacion.md): Claves API por entorno, enviadas en la cabecera x-api-key.
- [Entornos TEST y LIVE](https://veribai.com/docs/entornos.md): Dos entornos separados, mismo contrato de API. Desarrolla en TEST, emite en LIVE.
- [Cliente de Python](https://veribai.com/docs/cliente-python.md): El paquete oficial de Python, con entornos explícitos, reintentos seguros, veredictos y errores tipados.

## Guías

- [Crear factura (VeriFactu)](https://veribai.com/docs/crear-factura-verifactu.md): Alta de un registro de facturación VeriFactu ante la AEAT, campo a campo.
- [Crear factura (TicketBAI)](https://veribai.com/docs/crear-factura-ticketbai.md): Alta de una factura TicketBAI ante la hacienda foral que corresponda, con firma y encadenado inmediatos.
- [Rectificar y anular](https://veribai.com/docs/rectificar-anular.md): Corrección de registros ya remitidos. Subsanación, anulación y facturas rectificativas.
- [Consultar facturas y registros](https://veribai.com/docs/consultar.md): Estado, QR, XML firmado y listados. Los endpoints de lectura de la API.

## Conceptos

- [¿VeriFactu o TicketBAI?](https://veribai.com/docs/verifactu-o-ticketbai.md): Qué sistema aplica a cada emisor, y cómo lo resuelve una sola integración.
- [El registro de facturación](https://veribai.com/docs/registro-de-facturacion.md): Qué es un registro, en qué se diferencia de la factura, y por qué se encadena.
- [Fechas de la factura](https://veribai.com/docs/fechas.md): El formato de fechaExpedicion y fechaOperacion, la regla de no-futuro, la zona horaria y qué espera cada administración.
- [Autoemisión y emisión para terceros](https://veribai.com/docs/modelo-b2b2c.md): Los dos modelos de operación de una cuenta VeriBai, qué cambia entre ellos y qué no.

## Recursos

- [Soporte](https://veribai.com/docs/soporte.md): Cómo contactar con el equipo, y qué incluir para una respuesta rápida.

## Referencia API: General

- [Endpoints](https://veribai.com/docs/api.md): El mapa completo de la API. Todos los endpoints, en dos superficies.
- [Cuenta y cumplimiento](https://veribai.com/docs/api/cuenta.md): Comprobar la clave y el estado de la cuenta, y obtener la Declaración Responsable vigente.
- [Errores](https://veribai.com/docs/api/errores.md): El formato de error, la tabla de códigos y qué reintentar.
- [Límites y convenciones](https://veribai.com/docs/api/limites.md): Límites de peticiones, paginación y las convenciones comunes a toda la API.

## API de facturación

- [VeriFactu](https://veribai.com/docs/api/verifactu.md): Alta, subsanación y anulación de registros VeriFactu. El contrato completo.
- [TicketBAI](https://veribai.com/docs/api/ticketbai.md): Alta, subsanación y anulación de facturas TicketBAI ante las haciendas forales.
- [Facturas y registros](https://veribai.com/docs/api/facturas.md): Los endpoints de lectura. Estado, detalle, QR, XML firmado y listados.

## API de gestión

- [Validación de NIF](https://veribai.com/docs/api/nif.md): Comprueba NIF y razón social contra el censo de la AEAT antes de emitir.
- [Clientes (emisores)](https://veribai.com/docs/api/clientes.md): Alta y gestión de los emisores en cuyo nombre factura tu software.
- [Dispositivos (Alta capacidad)](https://veribai.com/docs/api/dispositivos.md): El registro de dispositivos de los emisores de gran volumen, donde cada dispositivo lleva su propia cadena de encadenado.
- [Representación](https://veribai.com/docs/api/representacion.md): El documento que habilita a VeriBai a remitir en nombre de cada emisor, y su flujo de firma.
- [Webhooks](https://veribai.com/docs/api/webhooks.md): Notificaciones firmadas cuando una factura alcanza su estado final, sin polling.