El repte
Zone Soft, proveïdor de solucions de punt de venda i facturació, volia expandir-se al País Basc. Per aconseguir-ho, necessitava que els seus sistemes fossin compatibles amb TicketBAI, la normativa de facturació electrònica del Govern Basc, que exigeix requisits tècnics i legals diferents a cada província. El repte consistia a integrar correctament la signatura digital XAdES, adaptar els formats XML i garantir la generació de factures vàlides per a tots els clients, sense perdre agilitat ni usabilitat per als comerços i els usuaris finals.
El nostre enfocament
Vam començar amb una anàlisi exhaustiva de la documentació tècnica i legal de TicketBAI, en contacte directe amb els equips de les diputacions forals per resoldre dubtes i anticipar canvis. Vam detectar diferències rellevants entre províncies i la necessitat d’una solució flexible, capaç de gestionar plantilles de factures personalitzables i adaptar-se a qualsevol sector.
Vam optar per crear una API centralitzada que connectés tots els productes i serveis de Zone Soft amb TicketBAI. Aquesta API havia de transformar les dades de venda en factures electròniques signades digitalment i llestes per ser enviades a les administracions, gestionant automàticament les particularitats de cada província.
La solució
Vam desenvolupar una API robusta i modular amb Slim Framework, seguint els principis SOLID i aplicant controls automàtics de qualitat i seguretat en el codi.
Vam implementar conversió dinàmica de dades a XML mitjançant plantilles Twig, adaptables a les necessitats de cada client i província.
Vam desenvolupar la gestió de certificats digitals i la signatura XAdES-T per garantir la validesa legal de cada factura.
Vam afegir mòduls independents per a Àlaba, Biscaia i Guipúscoa, que permeten actualitzacions ràpides i específiques.
Vam automatitzar la generació de factures en PDF amb codi QR i dades simplificades per al client final.
L’API es va integrar fàcilment amb els sistemes existents de Zone Soft i va permetre monitoritzar l’estat de les factures en temps real, amb alertes proactives davant de qualsevol incidència.
L’impacte
Zone Soft va poder llançar els seus serveis al País Basc complint al 100% la normativa TicketBAI des del primer dia. Els comerços bascos emeten ara factures electròniques vàlides en minuts, amb menys errors i sense complicacions tècniques. La solució ha reduït dràsticament el temps i l’esforç dedicats a la gestió fiscal, ha facilitat la incorporació de nous clients i ha consolidat Zone Soft com a proveïdor de referència a la regió.