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

AEAT social collaborator

Status that allows Verifacti to submit data to the Spanish Tax Agency (AEAT) on behalf of third parties with its own certificate (type 17 agreement), once the representation form is signed.

Representation form

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.

NIF management API documentation

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.

Pricing

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.

Verifactu API documentation

L

llms.txt

All the Verifacti documentation in Markdown, meant to be read by the customer’s AI.

llms.txt

N

NIF active in production

Taxpayer registered and active in the production environment. It is Verifacti’s pricing unit.

Pricing

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.

NIF management API

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.

Online signing of the representation form

R

Recipient validation

Prior check of the recipient’s NIF with the AEAT or of their VAT number in VIES, to avoid rejections.

Validation in the NIF management API

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.

Representation form

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.

Startup plan

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.

Verifactu API documentation

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.

Quick start guide

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.

Webhooks in the NIF management API

Create your free account

Test environment and test NIF included.

Test environment and test NIF included