El reto
Zone Soft, proveedor de soluciones de punto de venta y facturación, quería expandirse al País Vasco. Para ello, necesitaba que sus sistemas fueran compatibles con TicketBAI, la normativa de facturación electrónica del Gobierno vasco, que exige requisitos técnicos y legales distintos en cada provincia. El reto era integrar correctamente la firma digital XAdES, adaptar los formatos XML y garantizar la generación de facturas válidas para todos los clientes, sin perder agilidad ni usabilidad para comercios y usuarios finales.
Nuestro enfoque
Comenzamos con un análisis exhaustivo de la documentación técnica y legal de TicketBAI, en contacto directo con los equipos de las diputaciones forales para resolver dudas y anticipar cambios. Detectamos diferencias relevantes entre provincias y la necesidad de una solución flexible, capaz de gestionar plantillas de facturas personalizables y adaptarse a cualquier sector.
Optamos por crear una API centralizada que conectara todos los productos y servicios de Zone Soft con TicketBAI. Esta API debía transformar los datos de ventas en facturas electrónicas firmadas digitalmente y listas para ser enviadas a las administraciones, gestionando automáticamente las particularidades de cada provincia.
La solución
Desarrollamos una API robusta y modular usando Slim Framework, siguiendo principios SOLID y aplicando controles automáticos de calidad y seguridad en el código.
Implementamos conversión dinámica de datos a XML mediante plantillas Twig, adaptables a las necesidades de cada cliente y provincia.
Desarrollamos la gestión de certificados digitales y la firma XAdES-T para garantizar la validez legal de cada factura.
Añadimos módulos independientes para Álava, Bizkaia y Gipuzkoa, permitiendo actualizaciones rápidas y específicas.
Automatizamos la generación de facturas en PDF con código QR y datos simplificados para el cliente final.
La API se integró fácilmente con los sistemas existentes de Zone Soft y permitió monitorizar el estado de las facturas en tiempo real, con alertas proactivas ante cualquier incidencia.
El impacto
Zone Soft pudo lanzar sus servicios en el País Vasco cumpliendo al 100% con la normativa TicketBAI desde el primer día. Los comercios vascos ahora emiten facturas electrónicas válidas en minutos, con menos errores y sin complicaciones técnicas. La solución ha reducido drásticamente el tiempo y el esfuerzo dedicados a la gestión fiscal, ha facilitado la incorporación de nuevos clientes y ha consolidado a Zone Soft como proveedor de referencia en la región.