A new powerful API for ZoneSoft invoicing system
somoscuatro developed the integration of TicketBAI for Zone Soft’s invoicing system. Thanks to their efforts, the Zone Soft API now meets the technical and legal requirements of the tax authorities of the Basque Country. We found somoscuatro to be a trustworthy, professional, and reliable partner. We highly recommend working with them.
Anabela Carvalho
Product Owner at Zone Soft
Brand
Zone Soft
Location
Lisbon
Industry
Retail Solutions
What we did
Custom API Development, Consulting, Maintenance Plan
Release
2022 + Ongoing Maintenance Plan
The problem
Zone Soft wanted to enter the Basque Country market with its retail PoS and invoicing solutions. In order to do so, they needed to integrate their products with the Basque Government’s electronic invoice system, TicketBAI.
Our approach
As is often the case with public administrations, it was not always easy to obtain the complete technical requirements and documentation. As an additional complexity, the different provinces had slightly but significant differences in the way they wanted to receive data. This required us to do a lot of preparation, consulting TicketBAI technical team and legal departments.
We needed to investigate reliable and maintainable solutions for signing the invoice using the XAdES standard. Additionally, we looked for flexible template systems to generate invoices that meet the varying requirements of each retailer type served by Zone Soft.
The natural conclusion was to suggest creating a centralised API where all Zone Soft’s different services and products could send data to generate electronically-signed invoices.
The solution
After evaluating various technologies, we concluded that the most practical approach would be to develop the API using Slim, a lightweight PHP framework specifically designed for API development.
We ensured to follow the highest standards in terms of code quality. This included applying SOLID principles, making the code modular and extensible, and implementing automated quality and security checks such as sniffers and linters.
As invoice templates can be complex and vary greatly across the different provinces, we made the decision to use Twig to ensure future extensibility and long-term maintainability.
We put extra effort into the code that manages the digital certificate entity, handles Twig to XML conversion, and applies XAdES signatures.
The impact
Zone Soft successfully began selling their services in the Basque Country market being sure to comply with the legal requirements.
Related Case Studies
A new powerful API for ZoneSoft invoicing system
ZoneSoft, a company specialised in mobile POS, commercial management, and online invoicing, wanted to expand their business in Spain. We developed a custom API integration between their platform and the Basque Country electronic invoicing system (TicketBAI).
How 8Belts helped their sales agent to sell faster and more
8Belts, an online language learning platform, needed a tool to streamline their sales process. We developed a custom WooCommerce-based solution that can generate purchase links, register new students on their platform’s API and integrate with Holded for invoicing.
Quisto: How to scale a feature-rich multivendor system
Quisto is a B2B e-commerce platform that supplies food and beverage products to retailers. We audited the existing WooCommerce site and improved its performance and UX, with a special focus on mobile devices.
