Autoemisión y emisión para terceros
Los dos modelos de operación de una cuenta VeriBai, qué cambia entre ellos y qué no.
Una cuenta VeriBai puede emitir facturas a nombre de la propia empresa (autoemisión) o a nombre de las empresas a las que da servicio (emisión para terceros). El contrato de la API es el mismo en ambos casos. Lo que cambia es la gestión alrededor: altas de emisores, representación ante las administraciones y quién consulta qué.
| Autoemisión | Emisión para terceros | |
|---|---|---|
| Quién factura | Tu propia empresa | Cada empresa cliente (y la tuya, si la das de alta) |
| Emisores dados de alta | Uno: tu NIF | Uno por empresa cliente |
| Cadena de registros | Una | Una por NIF, independientes entre sí |
| Representación | Un documento, firmado una vez | Un documento por cliente y administración |
| Portal de clientes | No aplica | Opcional, por cliente |
El modelo se elige al crear la cuenta, en el primer paso del alta, y puede cambiarse después desde el panel.
El emisor es un cliente dado de alta
Cada petición a POST /v1/verifactu/crear o POST /v1/ticketbai/crear lleva un bloque emisor con el NIF de quien factura. Ese NIF debe corresponder a un cliente dado de alta bajo tu cuenta. En autoemisión, ese cliente es tu propia empresa. En emisión para terceros, es cualquiera de las empresas que has registrado.
Las altas se hacen desde el panel o por API, con la misma clave que usas para facturar:
POST https://api.veribai.com/v1/clientes/crear
GET https://api.veribai.com/v1/clientes
GET https://api.veribai.com/v1/clientes/{nif}Cada NIF mantiene su propia cadena de registros. La numeración, el encadenado y el estado ante la administración de un cliente nunca dependen de los demás.
Representación ante las administraciones
Para remitir registros en nombre de un emisor, la administración exige un documento de representación firmado por su representante legal:
| Administración | Documento |
|---|---|
| AEAT (VeriFactu) | Anexo I |
| Hacienda Foral de Araba | Mandato de representación TicketBAI |
| Hacienda Foral de Bizkaia | Modelo R32 |
| Hacienda Foral de Gipuzkoa | Anexo II de autorización TicketBAI |
VeriBai genera el documento con los datos del cliente y lo deja listo para firmar. La firma es del representante legal de cada emisor, con su certificado: desde tu panel, o desde el portal de clientes si se lo permites. En autoemisión firmas el de tu propia empresa.
En TEST la representación no bloquea nada. En LIVE, un emisor sin representación firmada recibe 403 REPRESENTATION_PENDING al intentar emitir. Las condiciones del servicio recogen el detalle.
El portal de clientes
Si emites para terceros, puedes abrir a cada empresa cliente un acceso propio en clientes.veribai.com, separado de tu panel:
- Consulta sus facturas, con QR y estado ante la administración. Solo las suyas.
- Firma su documento de representación, si le concedes esa capacidad.
- Nunca entra en tu panel ni ve a otros clientes.
El portal se activa a petición desde tu panel. Una vez activo, decides cliente a cliente quién tiene acceso, con qué correo y si puede firmar. Revocar un acceso es inmediato.
Siguientes pasos
- Crear factura (VeriFactu) y Crear factura (TicketBAI): el bloque
emisorcampo a campo. - Entornos TEST y LIVE: qué exige cada entorno antes de emitir.
- Endpoints: la referencia completa, incluida la gestión de clientes.