Frequently asked questions about Verifacti
These are the questions common to every Verifacti API: free account, pricing and subscription, API keys, NIF management, representation form and support. The questions about each regulation are on their own page: Verifactu, TicketBAI, SII and e-invoicing.
General concepts
9 questions
What is Verifacti?
Verifacti is a solution designed for software developers who need to adapt their invoicing systems to Verifactu (Spain's Tax Agency system), TicketBAI in the Basque Country, and soon NaTicket in Navarra. Verifacti offers one API per regulation (Verifactu, TicketBAI and SII), each a separate integration over a common layer, the NIF management API, plus an intuitive, easy-to-use web platform.👉 Watch Verifacti Online DemoVerifactu APIThe Verifactu API enables compliance with the Verifactu system regulations of the Spanish Tax Agency (AEAT). It is a cloud-based REST API that operates in three fundamental steps:
- Receiving a request with invoice data in JSON format.
- Immediately returning a response with the corresponding QR code for the invoice.
- Immediately generating the invoicing record (XML) and submitting it to the AEAT, meeting Verifactu's technical requirements (chaining, hash and format).
- E-invoicing: the E-invoicing API will cover the B2B e-invoice of RD 238/2026, with dates published in the BOE: 6 October 2027 for businesses with turnover over €8M and 6 October 2028 for the rest.
- Navarra Tax Authority: Verifacti will develop a specific API for the Navarra NaTicket system when the necessary regulatory framework is established.
How can the Verifacti API help me adapt my software to Verifactu and ensure compliance?
We explain the essential requirements of the Verifactu regulation and how Verifacti helps you meet them (within VERI*FACTU mode):
- QR Code Generation - Invoices issued by your software must include the Verifactu QR code => When you make a call to communicate the issuance of an invoice, our API instantly returns the QR code so you can attach it to the invoice.
- Generation and submission of the invoicing record - When you issue an invoice, an XML file must be generated (at that same moment) according to AEAT requirements (the so-called "invoicing record") and must be submitted to the AEAT without delay => When you make a call to communicate the issuance of an invoice, we generate the XML synchronously and instantly, and submit it to the AEAT with our own digital certificate.
- Checking the AEAT response - Once the invoice has been sent to the AEAT (a process that may take a few minutes), it is important to check the AEAT response to rule out / fix errors => Verifacti provides webhooks and specific endpoints to monitor and manage AEAT responses.
- Responsible declaration (Declaración responsable) - You must have a responsible declaration accessible in a visible place for your users / clients. => Verifacti provides a template and materials to complete this document.
- Representation models (Modelos de representación) - Before sending the first invoice of a taxpayer who uses your software to the AEAT, you must manage the signing by the taxpayer of a very simple form => Verifacti provides pre-filled forms with clear signing instructions, as well as simple mechanisms for you to send us the form (manually or via endpoint).
Is the Verifacti API right for me?
Verifacti is a solution designed for developers and technical teams who need to adapt their software to the tax requirements established by the Spanish Tax Agency (Verifactu) and/or the Basque Provincial Tax Authorities (TicketBAI). Verifacti is the ideal solution for:1. Invoicing software vendors and distributorsAny software provider that includes invoicing functionality will need to ensure compliance with Verifactu and TicketBAI requirements. Software subject to compliance includes ERPs, CRMs, invoicing software, SaaS platforms, and in general any software that includes invoice issuance among its features.2. Companies or freelancers with their own invoicing systems.Verifactu will also be mandatory for taxpayers who use their own software for invoice issuance.👉 Watch short video: what is Verifacti, who is it for and what does it do
How long does the integration take?
In most cases, the integration is completed by a single developer in one to three full-time days, plus a few additional part-time days afterwards.
If I integrate with your API, do I have any legal responsibility regarding Verifactu compliance?
In the eyes of the AEAT, an architecture that relies on an API like Verifacti's is a mixed architecture with 2 components:
- CPF (Main Invoicing Component): your SIF (Invoicing Information System) from which invoices are issued.
- CEF (External Invoicing Component): our API.
- Real-time submission of invoices with correct data - We don't know when your users interact with your software; it is your responsibility to ensure correct real-time submission.
- Publication of the responsible declaration (declaración responsable) - While we provide a template and guide you, it is you who must complete and ensure the correct publication of this document in your software.
- Inclusion of the QR on the invoice - While we provide the QR, it is you who must ensure it is placed on the invoice.
What are the advantages of using an API for Verifactu or TicketBAI compared to integrating directly with the tax authorities' APIs?
The main reason for using an API like Verifacti's is to save countless development hours during integration and maintenance phases.By using the Verifacti API, you avoid the main challenges of direct integration with the tax authority, such as:
- Confusing and insufficient documentation.
- Mandatory use of XML as the communication format.
- Time and frequency restrictions on calls to the tax authority's API.
- Mandatory certificate-based signing.
- Mandatory chaining of invoicing records.
- Hash generation and verification.
What advantages does Verifacti have over other APIs?
Verifacti is designed to keep the Verifactu challenge to a minimum: it minimizes the number of development hours and queries needed to solve this challenge:
- Dedicated and personalized support to ensure an easy and correct integration
- API Documentation that is simple and clear
- Section with call and request examples
- Hyper-detailed FAQ section
- APIs for TicketBAI and the SII too, and soon Navarre
- NIF Management API for programmatic registration and deregistration of your users
- Automated representation management system via API
- Webhooks to receive AEAT responses
- Each invoice is validated before it is sent, and any error comes back with a code (code catalogue)
- Invoice recipient verification to avoid AEAT errors
- Serverless architecture based on containers, enabling automatic scaling based on load
Can I use Verifacti for TicketBAI?
Yes. Verifacti also helps you comply with TicketBAI. With very little additional integration effort, you can meet the requirements of any of the Basque Country's provincial tax authorities. TicketBAI API here.
Do you have references or testimonials from current clients?
You can see client logos and testimonials on our Home page.
Support, resources and help
6 questions
How can I contact Verifacti support?
We distinguish ourselves by actively helping our clients and users adapt their software to Verifactu, both during the integration phases and subsequent maintenance.For any questions, please follow these steps:
- Check our 🛟 FAQ section—90% of questions are already answered there.
- For commercial inquiries, write to ventas@verifacti.com
- For any other type of question, write to soporte@verifacti.com. Your email is read by several people and you will receive a prompt response.
- We will schedule a call if necessary.
Can you give me a demo?
We provide a pre-recorded online demo available for you to watch at any time. It lasts about 30 minutes and covers the most important aspects of how Verifacti helps any software adapt to Verifactu, including the most common questions about certificates, representation, responsible declaration, deadlines, and more.If you prefer a personalized demo, request a demo here.
Can you contact me by phone to resolve some questions?
To assess the need for a call, we ask our users and clients to first contact us by email with their specific and concrete questions.
- If we can resolve your questions by email, we will do so.
- If necessary, we will send you a link to schedule a video call.
What help materials does Verifacti provide for developers?
You have access to a series of key resources to speed up your software adaptation and minimize errors that we encourage you to review:
- Quick Start Guide: we explain step by step how to adapt your software.
- Simple and clear documentation for the Verifactu, TicketBAI, SII and NIF management APIs.
- Call examples: we show you how to structure your calls for all types of invoices.
- Hyper-detailed FAQ section, with a search bar at the top.
- Online demo where we explain how Verifacti works and answer the most common questions.
- Verifactu Tutorial with a series of short videos covering all key compliance aspects.
Do you have code examples for different types of invoices?
We have request examples for many invoice types, each one validated against the API:
Do you have an llms.txt?
Yes. /llms.txt summarises the Verifacti documentation for AI assistants and /llms-full.txt contains all of it. Every page also has a Markdown version (the same URL ending in
.md, for example /en/api-verifactu.md), and the OpenAPI specs of each API can be downloaded as YAML, full or trimmed: /openapi/verifactu.en.yaml and /openapi/verifactu.en.min.yaml, and the same for ticketbai, sii and nifs.Pricing
14 questions
What is the price of Verifacti for me?
Verifacti works with a subscription model with recurring monthly or annual payments depending on your plan.The cost (monthly or annual) of the Verifacti API depends primarily on the number of active NIFs in the production environment (number of actual taxpayers).For a low number of NIFs, prices are public: from €14.99 per month for the first NIF active in production, excluding VAT, and the annual plan has a 10% discount. On the pricing page you choose your number of NIFs (taxpayers who will issue invoices with your software).For a high number of NIFs, we can provide you with a proposal tailored to your needs (use the contact form for this). To send you relevant information and a tailored proposal and to resolve your questions, we need to know the following:
- Is the software you are going to integrate for your own company's use or is it software you sell/distribute to third parties?
- What is the approximate number of NIFs issuing invoices with your software? (number of taxpayers who issue invoices with your software)
- What is the approximate number of invoices issued with your software? (for example, approximate range of invoices issued per month or per year per NIF)
When do I start paying? Do I have to pay now if Verifactu is not mandatory yet?
No. You can complete the whole integration with the free account and you only start paying when you activate your subscription to register NIFs in production.You decide when: you can wait until the mandatory date that applies to you, or start sending invoices to the AEAT voluntarily before then.
What is a NIF when it comes to calculating the Verifacti price?
In Verifacti, we use the terms NIF, company, taxpayer, or obligated taxpayer interchangeably. Each NIF within Verifacti represents a taxpayer whose tax information (invoices) needs to be sent to the tax authority.When we talk about the number of NIFs, we refer to the number of taxpayer users of your invoicing software:
- If you sell software or deploy it, it refers to the users of your invoicing software, i.e., those users who issue invoices using your software (number of individual taxpayers who issue invoices with your software).
- If it is about adapting your own internal software, with which you issue your own invoices, then it would be a single NIF (your own), or several NIFs if you are a group of companies.
Do test NIFs count towards the price?
No. Only NIFs active in the production environment count towards the price.With the free account you get a test company to build your integration. To create additional test NIFs, free and unlimited, you need an active paid subscription for at least 1 NIF in production.
We are a group of companies. Do we pay for each company?
Yes. Each company with its own NIF counts as one NIF. Tiered pricing applies, so from the second NIF onwards the price per NIF drops considerably.
Is there a limit on the number of invoices per month that can be issued and how does it work?
All Verifacti plans include a very high safety limit of invoicing records per NIF per month.
- This is a safety limit, designed so that it is never or almost never exceeded.
- Every registration, modification or cancellation you submit counts as an invoicing record.
- For the plans advertised on the pricing page, the current limit is 3,000 invoicing records per NIF per month (500 on the Startup plan). For custom plans, the limit may differ.
- If this figure is exceeded, operations are not interrupted—simply an additional variable amount is added to the Verifacti invoice for the extra records not covered by the plan. For plans advertised on the pricing page, each 1,000 additional records cost €2 excluding VAT.
- If this limit is not sufficient for you, contact us and we will make you a personalized offer.
Why is the first NIF more expensive?
The first NIF in Verifacti is the most expensive. This especially affects own-use software that only needs one NIF, paying a per-NIF price that is higher than users with multiple NIFs.The reason for structuring prices this way is that Verifacti has a significant cost associated with each client regardless of the number of contracted NIFs. We strive to monitor and help each client regardless of size, and this commitment to good support and assistance requires us to reflect this in a price that has a minimum regardless of the number of NIFs.This pricing structure ensures that we can resolve integration and maintenance queries with any client, even those who only have one NIF.
How do prices and payments evolve as the number of NIFs increases or decreases?
The payment dynamics as NIFs are created/activated or deactivated are as follows.For MONTHLY plans- First, you must create a paid subscription by choosing the "Month" option. At that time, you are charged for a single NIF. Let's say it is September 15.
- From then on, every 15th of each month, the same amount equivalent to 1 NIF will be charged.
- When you create your first NIF in production, you are not charged anything, because you are already paying for it.
- When you create your second NIF in production, nothing is charged at that moment, but on the next 15th you will be charged the time consumed by that second NIF in the previous month (retroactive payment for the prorated consumption of that NIF) and a full month in advance (prepayment of one full month).
- From then on, you would be charged for 2 NIFs each month (prepayment).
- Same dynamic with each NIF increase.
- If at any time you deactivate a NIF, simply when the next billing arrives, that NIF will not be charged. There is no refund for the paid and unused amount for that NIF.
- First, you must create a paid subscription by choosing the "Year" option. At that time, you are charged for a single NIF for the entire year. Let's say it is September 15.
- When additional NIFs are registered, the total annual amount prorated for the remaining time until the next September 15 is charged at the time of registration. That is, if a NIF is registered on March 15, there would be 6 months left to complete the one-year cycle, and 6 months would be charged in advance for the right to use that NIF for the next 6 months.
- The following September 15, the total annual amount for all active NIFs in production at that time will be charged.
What happens if a NIF stops issuing invoices?
As long as a NIF is active in production, it is billed even if it issues no invoices.You can deactivate it at any time from the platform or with the NIF Management API, and it stops being billed from the next billing date. The amount already paid for the current period is not refunded.
How do annual plans with their discount work?
If you pay for a year of use in advance, there are 10% discounts. This requires advance prepayment of 12 months for each NIF you add. The year counts from the date you created your annual subscription (the date you became a paying customer), or from the last renewal date of your annual plan.
Are there installation or commitment fees?
There is no installation fee. You pay for what you use and for the time you use it: you can cancel whenever you want and keep using the service until the end of the paid period, without being charged for the next one. The monthly plan is paid month by month; the annual plan, with a 10% discount, is paid a year in advance.
If I have multiple POS terminals and/or business locations, would I be charged for each POS or location?
No. Verifacti prices are per taxpayer (NIF) and independent of the number of POS terminals and/or locations from which invoices are issued. We are a cloud API that does not require local installation of any software.
Do the prices include the NIF Management API, webhooks, and representation model management?
Yes. We have an API for managing NIF activation and deactivation, webhooks, and automated representation model management. All of this is included in the price.
Do the prices include TicketBAI?
Yes. When you pay for a NIF in production, you can choose whether that NIF uses the TicketBAI or Verifactu path without affecting the cost.
Free account
9 questions
How can I try the API and perform the integration at no cost?
Verifacti offers a free account with a test environment and a test NIF so you can try the API and perform the integration. It includes the Verifactu, TicketBAI and SII test environments and test webhooks. The test NIF is a Verifactu NIF; for TicketBAI or the SII, ask soporte@verifacti.com for a test NIF.1. Create a free Verifacti accountRegister in seconds on Verifacti. Simply go to Verifacti, click Create Account, enter your email and password. After this step, you'll be ready to explore the platform.2. Access the test NIFYour free account includes a test NIF, which allows you to make calls to the tax authority's test environment. To access it:
- Go to the Companies section.
- Click on the test NIF to enter its control panel.
- This test NIF is included in the free plan and is sufficient for most Verifacti integration cases.
- Click on Terminal in the sidebar menu.
- From here, you can make calls to the various tax authority endpoints through Verifacti.
- Select a call type from the dropdown.
- Send the test call to the tax authority by clicking Send.
- If you test the Create Invoice endpoint, you will receive an immediate response with the QR ready to attach to the invoice.
- QR image and its associated link.
- JSON generated in the request.
- XML sent to the tax authority by Verifacti.
- XML response from the tax authority.
Can I complete the entire integration with the free account?
Yes. The sending integration can be done entirely with the free account and its test NIF, already created in the test environment.What requires a paid subscription are some very useful features, especially for clients with high NIF volumes:
- NIF management API
- Production webhooks (test webhooks are included in the free account)
- Automated representation model management
- Creation of multiple NIFs in the test environment
Are there limits on sending invoices to the AEAT test environment?
Yes. The AEAT test environment is intended solely for integration and validation, and its use must be limited in both volume and time. The AEAT sets limits on the number of invoices sent and monitors that there is no continuous and permanent use of the test environment.If you are not actively integrating, you need to stop submissions until you resume the integration process. For this reason, at Verifacti we have alert systems that notify when an integration is approaching these limits.
Why can't I list all invoices with the test API key?
The free test NIF has this limitation: since it is a NIF shared by many of our users, we have restricted access to that endpoint to prevent data sharing between users.
Can I reset a company or an invoice series or delete invoices in test mode?
Invoicing records in the test environment, just like in production, cannot be deleted. This makes sense: the test mode works exactly the same as the production mode, in which invoicing records cannot be deleted.It would be possible to cancel all invoices with the cancellation endpoint, but that would not delete the records, and those invoice numbers could not be reused.
Why can't I use the NIF management API and other features with the test NIF or free account?
The following features require a paid subscription equivalent to the cost of a single NIF in production:
- NIF management API
- Production webhooks (test webhooks are included in the free account)
- Automated representation model management
- Creation of multiple NIFs in the test environment
Is it possible to use fictitious CIFs for testing?
The AEAT does not allow testing with fictitious CIFs, which requires using real CIFs for testing, although these submissions are marked as tests and have no tax validity.
Why is a prefix added to the series with the Verifacti test NIF?
The prefix is added to the series only when using the shared test NIF (B75777847). Verifacti puts a four-character prefix specific to your API key in front of the series (series
A becomes XXXX_A) so that one user's numbering does not clash with another's.This prefix is not added with your own NIFs, whether test or production.How can I request the deletion of NIFs registered in Verifacti?
Yes, it is possible to delete registered NIFs, both in the test and production environments. Deletion is permanent and irreversible: it deletes the NIF and all associated information (including invoicing records) immediately and permanently. It does not include the representation model. Please note that this goes against Verifactu's purpose of preserving records, so it should be done with caution.You can delete a NIF in two ways:
- Manually, from the companies panel.
- Via endpoint, with the permanent NIF deletion endpoint.
Subscription and contracts
13 questions
Who has a commercial relationship with Verifacti: the software company or the NIFs (taxpayers)?
For software with multiple taxpayers, in most cases Verifacti is contracted as a provider by the invoicing software developer. This developer registers the taxpayers in Verifacti, so normally the taxpayers do not interact with Verifacti at all.Regarding how to pass the cost on to the taxpayers, this is an exclusive decision of the invoicing software. In this regard, we have seen all kinds of approaches from our clients:
- Absorbing the cost
- Passing the cost on
- Including a margin
- It is recommended that the software provide an easy path for the taxpayer to enter their unique API key.
- Prices might be higher, since there would be no volume discount for a high number of NIFs.
How do I activate my paid subscription and formalize the contract?
If you have received an offer by email, contact the person who sent you the proposal by email.If you have not received an offer by email, then the steps to follow are:
- Log in to the platform with your username and password
- Navigate to this page
- Click on "Buy first NIF" and follow the steps.
- Make sure to check the "I'm purchasing as a business" box and enter company details (name, NIF, etc.).
- Enter payment details: you will be charged the cost of one NIF in production at that time
- You will continue to be charged the equivalent cost of the first NIF per month from that point on
- If you activate the first NIF in production, you will not be charged anything extra
- If you activate more NIFs in production, your invoice will increase based on the number of activated NIFs
- As you add NIFs, the unit cost per NIF decreases (the first is the most expensive, then costs drop rapidly)
Is it possible to obtain a contract?
Verifacti, like most cloud-based SaaS services, has terms of use to which clients are bound when subscribing to a paid plan. These terms detail the legal rights and obligations of the parties, as well as the SLA, and incorporate by reference our Data Processing Agreement (DPA), available as a standalone document.We also have our public "responsible declaration (declaración responsable)", which establishes our responsibilities within the mixed architecture we form together with our clients.
Why does registering my Verifacti account only show the price for one license?
Verifacti's system is designed so that the initial purchase is for one license. As you add production NIFs to your account, the invoice will automatically adjust to reflect the actual number of licenses in use.
Why does my subscription appear as inactive and how can I fix it?
Common reasons why a subscription may appear as inactive are:
- Payment status issues (expired card, insufficient funds, or a transaction error).
- End of subscription period without automatic renewal.
- Pending manual activation after registration or initial payment.
- Access your control panel and check the Subscriptions or Billing section. There you should be able to see the current status of your plan and the expiration date.
- Check if there is any pending notification or message related to payments in your account.
Can a freelancer/self-employed person subscribe to Verifacti?
Yes, any person or entity can subscribe to Verifacti, whether an individual or a legal entity.
How do I apply for the Startup plan?
The Startup plan costs €14.99 per month for the first NIF and €1.99 per month for each additional NIF, excluding VAT, with 500 invoicing records per month per NIF. It is for companies less than 12 months old, with under €100,000 in revenue and under €200,000 in funding.If you are a startup, tick the startup box in the initial details form of your free account. We will review your request and contact you with the plan's conditions.If you have already signed up, write to us through the contact form saying that you want to join the Startup plan.
How do I obtain the Data Processing Agreement (DPA)?
The Verifacti DPA is a standalone document, available here, and incorporated by reference into our terms of use. If you need an individually signed copy, you can request one by writing to soporte@verifacti.com.
Is the Verifacti Client a Data Controller or a Data Processor of the personal data?
It depends on how you use Verifacti:
- If you issue your own invoices with Verifacti (own use, with no third-party users), you are the Data Controller of that tax data, and Bilbabit acts as Data Processor on your behalf.
- If you are a software provider (IIS) and your own clients (End Users) are the ones issuing their invoices through your Verifacti integration, then you act as the Data Processor for those End Users, and Bilbabit becomes a Sub-processor, on your behalf and, ultimately, on behalf of your End Users as Controllers.
Do you have a Service Level Agreement (SLA)?
Verifacti has an SLA that is published in the terms of use.
How is IGIC (Canary Islands tax) or a tax exemption applied to the Verifacti subscription?
If your company is located in the Canary Islands and IGIC or a tax exemption must be applied to the Verifacti subscription, you should contact our team at soporte@verifacti.com. We will adjust your account to be tax-exempt, allowing you to proceed with subscription activation without applying any tax.
What options do I have regarding my Verifacti subscription during the postponement? Can I cancel my subscription?
Following the postponement of the mandatory entry into force of Verifactu (January 1, 2027 for Corporate Income Tax payers and July 1, 2027 for everyone else, dates published in the BOE; the Ministry of Finance has announced a further postponement to October 2028 with no rule published), the management of the paid subscription in Verifacti depends on the type of user.1. Taxpayers who issue their own invoicesIf you use your own invoicing software, you have these options:
- Keep the subscription in production: you can continue sending invoices to the AEAT, to the production or test environment. During the transitional period, there are no repercussions and it serves to validate that the integration works correctly. The AEAT has confirmed that it is possible to leave Verifactu and return to non-adapted software at any time.
- Cancel the subscription: you can cancel your subscription, go to zero cost, and reactivate it later when you need it. Check the cancellation FAQ to learn about the procedure and its effects.
- You may consider deactivating production NIFs so you don't pay for them.
- You can easily reactivate those NIFs later when you need them.
How does cancelling the Verifacti paid subscription work?
How to request cancellation of my paid subscriptionTo request cancellation of your Verifacti paid subscription, follow these steps:
- Navigate to the billing section.
- Click on "Cancel".
- Follow the steps until you confirm the cancellation.
- Once you have requested cancellation of your subscription, you can continue using Verifacti until the end of your billing cycle (monthly or annual). Once the period ends, the cancellation of your subscription will take effect automatically.
- Deactivating NIFs is not the same as cancelling the subscription. Even if all the NIFs you have created are deactivated, you will continue to be charged the price equivalent to 1 NIF in production, which gives you the right to use functionality such as the ability to create NIFs in the test environment, webhooks, and the NIF Management API. To stop paying, it is necessary to cancel the paid subscription.
- Once you cancel your subscription, the NIFs and webhooks you have created will be automatically deactivated.
- If you try to make submissions with API keys from NIFs you created that have been deactivated as a result of subscription cancellation, these submissions will fail and cannot be made.
- Remember that once your subscription is cancelled, the invoicing records (XML) of each NIF are kept for 30 calendar days after it is deactivated and then deleted.
- If you want to keep the XMLs, remember to use the export XMLs endpoint to obtain the XMLs before cancelling the subscription to avoid losing them.
Billing and payment methods
8 questions
Where can I access the invoices issued by Verifacti for my subscription?
The invoices that Verifacti issues to your company for contracted services or subscriptions are available in the Billing section.
I can't find my invoice. Why can't I find my invoice?
When bank direct debit is chosen as the payment method, the invoice is generated when the payment reaches the destination bank account, and this usually takes a few days to materialize from the time of the charge (typically between 3 and 5 business days from the moment the charge is made).This is the standard way the payment platform we use (Stripe) works, and it is not something Verifacti can modify.
Can you send me my invoices by email?
We automatically send invoices to the email address indicated in the Billing section. This email can be edited and can be different from the email used to log in.
How can I add my company details to my invoice?
Here is how to make sure your tax details appear on the invoice that Verifacti issues to you. You can enter your billing details in two different ways.From the Billing area
- Log in to Verifacti with your account and navigate to Billing
- Click on Access your billing portal
- In the Billing Details section, click on Update details
What payment methods do you accept?
You can pay by card or by SEPA direct debit. You choose the payment method when you activate your subscription.
How can I change my payment method?
To change your payment method (from card to bank direct debit or vice versa), follow these steps:
- Navigate to the billing panel
- Click on "Access your billing portal"
- Find the payment methods section and change your payment method—you have two options: bank card and SEPA bank direct debit.
How can I change my billing plan from monthly to annual in Verifacti?
It is not possible to change the billing frequency (from monthly to annual) directly from the Verifacti dashboard. To make this change, please contact our team at soporte@verifacti.com so they can manage it for you.
Can I receive separate invoices from Verifacti for each NIF or company if I have multiple NIFs associated with the same account?
Verifacti issues a single invoice per registered account. If your account has multiple associated NIFs, all services will be grouped into that single invoice. To receive separate invoices for each NIF or company, it is necessary to create an independent Verifacti account for each one.
Verifacti web platform
5 questions
What does the Verifacti.com web platform offer?
Verifacti offers its users a web platform that allows you to:
- Explore Verifacti and integrate your software using a free account.
- Create, activate, and deactivate companies (NIFs).
- Make calls from the terminal.
- Access documentation, FAQ, and integration resources.
- View invoices and invoicing records.
- Home: Visualization of charts with invoicing information for the NIF.
- Invoices: View of all invoices issued for the NIF, in a table filterable by date and other criteria.
- Records: Access to all invoicing records sent to the Tax Agency, including any request made to the tax authority through Verifacti.
- Terminal: Make calls to the tax authority for this NIF, with request examples on the left side and the API response on the right side.
- Settings: Enter company data and access the API key, needed to make requests for this NIF.
To give access to other team members, do I need to share credentials or can I invite them?
Verifacti does not offer functionality to invite team members to an account. There is only one set of credentials per Verifacti account.
Can I give my clients access to Verifacti.com so they can view their invoices there?
In the case of software vendors and distributors, Verifacti is not designed for sharing access with taxpayers, since with one login, private information of other taxpayers could be viewed.However, it would be very easy to replicate the screens for records or invoices in your own software using information from your own database and/or endpoints that provide access to the available information:
Does Verifacti offer manual invoicing services from documents?
Verifacti is a platform and API that allows users to send and manage their invoices in an automated manner.We do not provide manual invoicing services from documents such as receipts or images.
Does Verifacti offer integration services with other third-party systems or APIs such as OpenCart and PrestaShop?
Verifacti's solution is based on a REST API that can be integrated with platforms like OpenCart and PrestaShop.However, we currently do not have specific solutions or pre-built plugins for these platforms.
API keys and NIF management
7 questions
How do API keys, environments, and NIF management work in Verifacti?
In Verifacti, there are two types of API keys that are obtained differently.NIF API keyEach taxpayer for whom invoices are to be submitted to the AEAT must be registered in Verifacti and will have a unique API key per environment. Ideally, there will be two API keys per NIF: one for the test environment and one for the production environment.This API key is essential for API calls. This API key allows:
- Identifying the taxpayer (VAT payer) who appears on the invoice as the seller of a product or service.
- Determining the tax authority environment to which the tax information should be sent (test vs. production).
- Determining the tax authority (AEAT vs. Basque Provincial Tax Authorities) to which the taxpayer belongs.
- In the test environment, the company API key starts with vf_test_
- In the production environment, the company API key starts with vf_prod_
- Software distributors and vendors will require multiple NIFs, one per user or taxpayer.
- Independent companies will only need to create API keys in test and production for their own NIF (or several NIFs if they are a group of companies).
- Manually from the home screen. Click on "Add company" and follow the steps.
- Through the NIF Management API. See documentation.
- From the settings section within each NIF.
- They can also be obtained with the NIF Management API, NIF API key endpoint.
- A paid subscription at the cost equivalent to 1 NIF in production gives you the ability to have multiple NIFs in the test environment without the cost increasing.
- With the paid subscription created, it is possible to create NIFs in the production environment, and the invoice will adjust upward.
Do API keys expire and need to be refreshed?
API keys do not expire, so there is no need to refresh them.However, you can rotate them at any time, for example if you suspect an API key has leaked. See How can I rotate (regenerate) an API key?
How can I rotate (regenerate) an API key?
Rotating an API key means generating a new one and invalidating the previous one. It is useful if you suspect an API key has leaked, or as a periodic security measure.NIF API key (vf_test_… / vf_prod_…)It can be rotated in two ways:
- From the dashboard: open the company, go to the API key tab and click "Rotate API key".
- With the NIF Management API, Rotate NIF API key endpoint. The response includes the new API key.
What happens to the previous API key when I rotate it?
The previous API key stops working immediately, with no grace period. Any request that still uses it will get a 401 error.So before rotating an API key, have your integration update ready and replace the API key as soon as you receive the new one. If you use it in several places (for example, several servers), update all of them.Rotating a NIF's API key does not affect its invoices: the NIF, its chaining and its record history stay the same.
I have thousands of NIFs. How can I manage high volumes of NIF registrations and deactivations?
Verifacti has a specific API for managing NIFs. If you have many taxpayers using your software, this API is essential for a successful integration.
How can I delete or deactivate NIFs?
In Verifacti you can either deactivate a NIF (reversible) or permanently delete it (irreversible).How to deactivate a NIFDeactivation is reversible. To deactivate a NIF, there are two paths:
- Manually, from the companies panel, by clicking the "Deactivate" button
- Via endpoint, with the NIF deactivation endpoint.
- It is no longer possible to submit invoices to the AEAT with that NIF.
- The NIF can be reactivated at any time (manually or via the Activate NIFs endpoint).
- If it is a production NIF and not the only production NIF (i.e., if you have several production NIFs and deactivate one of them), that NIF will no longer be charged on the next invoice.
- If it is the only production NIF, then even if it is deactivated, you will continue to be charged the amount equivalent to the first production NIF as long as the paid subscription is active.
- Manually, from the companies panel.
- Via endpoint, with the permanent NIF deletion endpoint.
If a client or company changes their NIF, is there an established procedure in the Verifacti API to update it?
In that case, you simply need to create a new NIF on our platform and deactivate the previous one.
Certificates and representation
19 questions
How does certificate and representation model management work with Verifacti?
Verifacti uses its own digital certificate to submit information to the AEAT on behalf of third parties. The AEAT requires the signing of a representation model by the taxpayers.Verifacti's certificate as a social collaboratorVerifacti uses its own representation digital certificate to send tax information to the tax authority on behalf of the taxpayers. This avoids the need to request certificates and passwords from Verifacti users, reducing security risks and avoiding user refusal to share sensitive credentials. To this end, Verifacti operates within the social collaboration framework, a figure predating Verifactu that is widely used for many tax advisory purposes. Specifically, Verifacti has signed agreement 017 with the AEAT, created specifically to provide coverage for the social collaboration figure in the scope of Verifactu. Verifacti appears listed (Bilbabit SL) in the official list of entities with agreement of the AEAT.👉 Watch short video: Certificates and representation (Part 1) - Verifacti's Social Collaborator CertificateRepresentation models (Modelos de representación)Whenever it is not the taxpayer themselves who submits their information to the AEAT, the regulation requires that taxpayers sign a representation model authorizing Verifacti to send tax information on their behalf. The same form covers all four tax authorities (AEAT, Álava, Bizkaia and Gipuzkoa) and only has to be handled once per NIF.Verifacti offers its clients two different paths to expedite the signing of these representation models:
- From the Verifacti web interface, following the steps indicated in the Settings → Representation section for each NIF.
- Programmatically, through the NIF Management API.
- Online signature (individuals / self-employed only): the NIF holder verifies their identity by video and signs from the browser, with no digital certificate. It costs €2.90 + VAT per signature process. You can see the step-by-step process in the Online signature of the representation model guide.
- Digital certificate signature (individuals and legal entities): download the model PDF, sign it with the issuing NIF's digital certificate, and upload it to Verifacti. It is free.
- Create the NIF in test.
- Manage the representation for that NIF.
- Create the NIF in production: the representation will already be managed, with no need to do it again.
It is possible that my users don't have a certificate to sign the model—isn't there another way to do this?
Yes. In addition to signing with a digital certificate, Verifacti offers Online signature: the NIF holder verifies their identity by video and signs the representation model directly from the browser, with no digital certificate and nothing to install. This method is only available for individuals (self-employed / autónomos); legal entities must still sign with a digital certificate. Each online signature process costs €2.90 + VAT. You can see the step-by-step process in the Online signature of the representation model guide.
Does the online signature of the representation model have a cost?
Yes. Each online signature costs €2.90 + VAT.
What does the signer need to complete the online signature?
Just a phone or computer with a camera and their identity document (DNI or passport). No digital certificate and nothing to install: the signer receives an email with the signing link, films their identity document and a short selfie video following the on-screen guidance, their identity is verified automatically in seconds, and they sign the representation model with one click. You can see the full process, step by step and with screenshots, in the Online signature of the representation model guide.
Can a company (legal entity) use the online signature?
No. The online signature is only available for individuals: the issuing NIF must be a DNI or NIE. Legal entities must sign the representation model with the company representative's digital certificate: download the model PDF, sign it with the certificate and upload it to Verifacti. This method is free.
The NIF holder has an NIE — can they sign online?
Yes. Identity verification during signing is done with a DNI or passport (the NIE card is not accepted as a verification document), so a holder whose NIF is an NIE must identify themselves with their passport. In all cases, the name verified during signing must match the NIF holder according to the AEAT; if it doesn't, the signature is rejected and the representation is not validated.
What happens if the verified identity does not match the NIF holder?
The signature is rejected and the representation is not validated: the status changes to Rechazado. This happens when the person completing the identity verification is not the NIF holder according to the AEAT (for example, if an accountant or a family member signs instead). In that case a new process can be started with the right person, which is charged as a new signature.
How long is the signing link valid? Can the signer resume the process later?
The process expires 28 days after it is created. While the signature is in progress (status Pendiente),
GET /representacion/estado/:nif returns the signing link and its expiry date (fecha_expiracion), and the signer can resume the process at any time from the email or from that link. If the process expires, a new one can be started, which is charged as a new signature.How do I know when the online signature has been completed?
When the signature is completed, the representation status changes automatically to Correcto and the NIF can already send invoices to the production environment, with no additional step on your side. You can check the status at any time with
GET /representacion/estado/:nif or from the web interface, under Configuration → Representation.What language does the signer see the process in? Can I customise the email they receive?
The signing ceremony and the notification email are shown in Spanish by default; with the optional
idioma field (es or en) of POST /representacion/firma_remota/:nif they can be shown in English. In addition, the optional notificacion object lets you customise the email the signer receives: the sender name, the subject and the message.I don't want an email to be sent when the signature is initiated — is that possible?
The
email field is mandatory, but it doesn't have to be the NIF holder's: you can simply provide an internal address of your own so that your end customer receives no email from Verifacti. The response of POST /representacion/firma_remota/:nif includes the signing link (url), so you can deliver it yourself through whichever channel you prefer (your own application, your email, WhatsApp…). If you lose the link, GET /representacion/estado/:nif returns it while the process is in Pendiente status.Can I cancel an online signature process that is in progress?
Yes, with
PUT /representacion/cancelar/:nif or from the web interface. Keep in mind that the €2.90 + VAT cost is applied when the process is created, so it is not refunded on cancellation; if another process is started afterwards, it is charged as a new signature.Is the online signature available in the test environment?
The online signature is independent of the environment: it works the same from a test NIF as from a production one, and it always has the same cost of €2.90 + VAT per process. Remember that the representation model is managed only once per NIF: a signature completed from the test environment also validates the same NIF in production, even if it hasn't been created yet.
What personal data processing does the biometric identity verification for signing the representation form involve?
To sign the representation form you can choose between a digital certificate (no biometric data) or an advanced electronic signature with online identity verification. This second route processes: the image of the identity document, the data extracted from it, the image/video of the face to check that you are physically present (liveness), and the biometric template resulting from comparing it against the photo on the document.Key points:
- Processing biometric data requires your explicit, prior and separate consent — it is optional, not a condition for using Verifacti.
- In this process, Bilbabit acts as Data Controller (not as Processor), with Ivnosys/Signaturit and Namirial as its processors carrying out the verification.
What file formats are accepted when submitting the signed Representation Model?
The Verifacti endpoint only accepts files in PDF format for the signed Representation Model.
What certification entities and digital signature software are valid in Spain?
In Spain, to interact with the Tax Agency (Hacienda) and platforms like Verifacti, digital certificates issued by any recognized Certification Entity are accepted, not limited exclusively to the FNMT (Fábrica Nacional de Moneda y Timbre - Spain's national mint).For managing and applying these digital signatures, AutoFirma software (developed by the Spanish Government) is an excellent option.Additionally, programs like Adobe Acrobat also allow you to digitally sign documents using the valid certificates installed on your system.
What should I check if my digital certificate is not recognized or accepted?
Make sure that the NIF appearing in the digital certificate is exactly the same as the NIF registered in our systems and in any associated documents, such as setup or registration PDF files.A common error is a one-digit or one-letter discrepancy between the certificate NIF and the NIF in other documents.To fix it, regenerate the representation document PDF with the correct NIF, sign it, and submit it.If you believe your model is valid, please contact soporte@verifacti.com so they can review and approve it manually.
Why do I receive error 4112: 'The certificate holder must be the Issuing Obligee, Social Collaborator, Attorney or Successor.' in the test environment?
This error (Codigo[4112]), in the AEAT test environment, is due to internal tests carried out by the AEAT itself and not a problem with Verifacti. It generally occurs on Saturday mornings.The Verifacti production environment is not affected and works correctly with the same certificate.
Data storage and export
2 questions
How can I view and/or download the invoices and XMLs sent to the Tax Agency through Verifacti?
You can access the data of a NIF in two different ways:
- Via endpoint - Verifacti provides endpoints to download the invoicing records for those users who wish to keep them.
- Web interface - You can view the latest records through the web interface, from the records screen of each NIF.
How long do you store invoices and XMLs?
All information related to a NIF (taxpayer) is stored while it is active in the production environment. Once it is deactivated, its invoicing records (XML) are kept for 30 calendar days and then deleted.Verifacti provides endpoints to download the invoicing records for those users who wish to keep them.Export XMLs endpointDownload XML endpointTicketBAI export XMLs endpointTicketBAI download XML endpointSII export XMLs endpoint
Future regulations
1 question
Questions about each API
Verifactu FAQInvoices, QR codes, corrective invoices, errors, webhooks, going to production and the statement of conformity.Verifactu FAQTicketBAI FAQÁlava, Bizkaia and Gipuzkoa: integration, representation and guarantor software.TicketBAI FAQSII FAQSending the issued-invoices book to the SII with the SII API.SII FAQE-invoicing FAQB2B e-invoicing and how Verifacti is getting ready for it.E-invoicing FAQ
Start integrating today
Try it for free with the test environment.