HomeCase StudiesZoneSoft

A new powerful API for ZoneSoft invoicing system

Profile picture of Anabela Carvalho, Product Owner at Zone Soft

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).

Know More
A preview of the Zone Soft project

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.

Know More
A preview of the 8Belts project

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.

Know More
A preview of the Quisto project

Want to ship your
next digital project?
Drop us a line.