Registro de cambios
5 de noviembre de 2026
La clave de cifrado del software garante (encryption_key) debe tener 32
caracteres ASCII, es decir, 32 bytes. Las claves que no cumplen este requisito
devuelven 422 en ese campo en lugar de 500.
- Una clave de 32 caracteres con tildes, «ñ» u otros caracteres no ASCII se
rechaza en todas las peticiones que la reciben: el
alta de facturas, el reenvío
(
resubmit), la anulación, Zuzendu, la consulta de facturas y los envíos al LROE de gastos y facturas recibidas y de operaciones de bienes. - Una clave de longitud distinta de 32 devuelve
422, y ya no500, en la anulación, las operaciones de bienes, los gastos y las facturas recibidas.
2 de noviembre de 2026
Dos consultas nuevas devuelven, en un JSON común a Araba y Bizkaia, las facturas emitidas que la hacienda tiene registradas de una empresa, con su estado y sus errores o avisos:
- La consulta de facturas, paginada y con filtros, en Araba y Bizkaia.
- La consulta de la última factura, solo en Araba.
Cada certificado solo ve las facturas que presentó o firmó, y en Araba la consulta paginada devuelve los datos del día anterior. La guía Consulta de facturas en Hacienda explica cómo interpretar la respuesta.
29 de octubre de 2026
La nueva consulta de NIF comprueba en el censo de la AEAT si un NIF existe y está activo y, si es de una persona física, si corresponde al nombre indicado.
16 de octubre de 2026
El alta de facturas y las solicitudes Zuzendu incorporan nuevas validaciones
y correcciones de encadenamiento. Revisa tu integración si omites tax_quota
o envías fechas futuras. Las nuevas validaciones devuelven 422 cuando no
se cumplen.
tax_quotapasa a ser obligatoria cuando se informatax_rate, incluido0, en los desgloses sujetos y no exentos del alta y de Zuzendu.- El alta de facturas limita
operation_datey rechaza fechas de expedición futuras eninvoice_datetime. - Se rechazan los caracteres no admitidos en XML.
- Los valores que superan los límites de campos en el
alta de facturas devuelven
422en lugar de500. - El recargo de equivalencia de los desgloses extranjeros del alta de facturas admite los mismos tipos que el desglose local.
- Se corrige el encadenamiento por TPV/POS para no exigir factura anterior al iniciar una cadena sin TPV/POS.
previous_invoice_datapasa a ser opcional en Zuzendu, que conserva el encadenamiento de la factura original ante la hacienda foral.
22 de julio de 2026
Publicamos la primera versión beta del portal de documentación de KubiBAI Web Services. La cobertura y la organización del contenido seguirán evolucionando a medida que completemos y revisemos la documentación.
- Guías para conocer los conceptos y requisitos generales de la integración.
- Referencia API generada a partir de la especificación OpenAPI.
- Ejemplos de cuerpos de petición para casos de facturación habituales.