Electronic Certificate

In order to comply with TicketBAI, the billing or POS system must be equipped with a software that generates an XML file for each transaction, signs it with an electronic certificate and sends it to the corresponding Tax Authority.

The signature of the TicketBAI Files is carried out in the SIGN ES API signing component.

Each invoice will be chained to the previous one and the digital signature guarantees that the information is not tampered with.

SIGN ES API uses a fiskaly-managed electronic certificate to sign and send all TicketBAI XML files on behalf of the taxpayer.

Why use fiskaly’s certificate?

At fiskaly, we’ve decided to use our own Electronic Certificate due to its multiple advantages:

• It is managed completely by fiskaly, so you don’t have to worry about expiration dates or renewal.
• The taxpayer does not have to provide its own private certificate.
• The signing and sending of the TicketBAI files can be done with the same certificate, because fiskaly is a social collaborator of the Tax Authorities of all three Basque Country territories: Araba, Bizkaia, and Gipuzkoa.

📘Note

Using fiskaly’s electronic certificate for the signer creation allows you to be compliant without any additional effort!

Social collaboration agreement between fiskaly and the taxpayer

As part of the integration process, it is required to implement the endpoints corresponding to the generation and upload of the social collaboration agreement between fiskaly and the taxpayer.

Through the Generate agreement endpoint, you will provide all the information needed for fiskaly to generate the agreement. The information required changes depending on whether the Taxpayer is a COMPANY or an INDIVIDUAL.

• For an INDIVIDUAL (e.g. self-employed), all information is provided through the Create taxpayer endpoint, where the issuer’s legal_name, tax_number, and address are needed. No additional information is used from the Generate agreement endpoint.
• For a COMPANY, you need to provide:
  • legal_name, tax_number and address from the Create taxpayer endpoint
  • Information of the representative of the company (full_name, tax_number, and address) as required in the Generate agreement endpoint.

As a successful response, you will obtain the PDF, which needs to be signed by the taxpayer.

📘Important

The agreement must be signed by the taxpayer using any valid digital signature. For companies, this will be the signature of the legal representative, and for the self-employed, the signature of the individual.

Once the document is digitally signed, SIGN ES requires that you provide it as a Base-64 encoded PDF document through the Upload signed agreement endpoint.