Verifacti glossary
Definitions of the terms shared by every Verifacti API: social collaborator, representation form, NIF management API, NIF active in production, webhook, idempotency and more. Each term links to the page that explains it; the terms of each regulation are in the Verifactu, TicketBAI, SII and e-invoicing glossaries.
A
API key
Credential that identifies a NIF in one environment: it goes in the Authorization header and sets the issuer and whether the submission is test (vf_test_…) or production (vf_prod_…). The NIF management API uses its own key (vfn_…). Keys can be rotated.
F
Free account
Verifacti account to integrate and test at no cost, with the Verifactu, TicketBAI and SII test environments. A Verifactu test NIF is created when you sign up; support provides the TicketBAI and SII ones. Registering more NIFs and using the NIF management API require a subscription.
I
Idempotency (Idempotency-Key)
The Idempotency-Key header lets you retry a submission without duplicating it: the same key with the same body returns the first response for 24 hours.
L
llms.txt
All the Verifacti documentation in Markdown, meant to be read by the customer’s AI.
N
NIF active in production
Taxpayer registered and active in the production environment. It is Verifacti’s pricing unit.
NIF management API
API to register, activate and deactivate NIFs and to manage representation and webhooks. It is shared by every regulation: you integrate it once and each regulation adds its own submission integration.
O
Online signing
Signing the representation form without a digital certificate: the holder verifies their identity from a phone and signs. For individuals only, with a DNI; holders of an NIE sign with their passport. €2.90 + VAT per signature.
R
Recipient validation
Prior check of the recipient’s NIF with the AEAT or of their VAT number in VIES, to avoid rejections.
Representation form
Authorisation each taxpayer signs so that Verifacti can submit on their behalf. It is signed once per NIF and is valid for the AEAT and the three foral treasuries.
S
Startup plan
Plan for companies less than 12 months old, with under €100,000 in revenue and under €200,000 in funding: €14.99 a month for the first NIF and €1.99 for each additional NIF, excluding VAT, with 500 invoicing records a month per NIF. You request it from the free account and we review it before confirming.
T
Test and production environments
Two separate environments, each with its own API keys: the test one sends to the tax authority’s test environment and has no tax effect; the production one does.
Test NIF
Test NIF that comes with the free account, to make calls to the Verifactu API without registering a NIF of your own. Support provides the TicketBAI and SII ones.
W
Webhook
Automatic notice sent to a URL of yours with the response of the AEAT or the foral treasury. It is configured with the NIF management API and attached to NIFs.
Other glossaries
Create your free account
Test environment and test NIF included.