Preus i límits de l'API
Què costa l'API, quin tier atorga cada pla i els topalls per tier de peticions, API keys i endpoints de webhook.
L'API pública i el servidor MCP estan inclosos en tots els plans de
pagament de Factuarea. No hi ha cap complement per contractar ni sol·licitud
d'accés: crea una clau des de
Dashboard → Developers → API Keys
i comença a cridar /v1.
El que sí que pots pagar és capacitat. El teu pla atorga un tier de límits; si en necessites un de superior sense canviar de pla, subscriu-te a un boost de capacitat. La columna de preu de sota és el preu d'aquest boost, mai el preu de l'accés.
Nivells
| Tier | Preu del boost | Per minut | Per mes | API keys actives | Endpoints de webhook |
|---|---|---|---|---|---|
| Free | No es ven (tier del trial) | 10 rpm | 100 | 1 | 0 |
| Starter | 4,90 € / mes | 30 rpm | 5.000 | 3 | 1 |
| Pro | 19,90 € / mes | 300 rpm | 50.000 | 25 | 10 |
| Scale | Sales-led | Personalitzat | Personalitzat | Il·limitades | Il·limitats |
Xifres verificades contra la configuració de tiers del backend el
2026-07-31. Per saber com es comporten les quotes —finestra lliscant,
capçaleres X-RateLimit-*, el codi 429 i l'estratègia de reintent—
consulta Límits de peticions.
Què atorga ja el teu pla
| El teu pla | Tier atorgat sense cost addicional |
|---|---|
| Trial (encara sense subscripció activa) | Free |
| Emprendedor | Starter |
| Empresario | Pro |
| Enterprise | Scale |
El tier segueix el pla tot sol: no es tria per clau ni per petició, i canvia tan bon punt canvia el teu pla.
Boost de capacitat
Un boost compra un tier estrictament superior al que ja atorga el teu pla —per exemple Starter → Pro en el pla Emprendedor—. Es contracta des de Dashboard → Developers → Upgrade i es factura mensualment. Mentre el boost està actiu, totes les claus de l'empresa fan servir el tier del boost.
Com que el pla ja atorga un tier, comprar-ne un d'igual o inferior al seu es rebutja: la regla i l'error que retorna són a Límits de peticions → Boost de capacitat.
Topalls que no són peticions
Hi ha dos límits que es compten per empresa, no per petició.
API keys actives
Una clau compta mentre no estigui revocada ni caducada; revocar-ne una
allibera lloc a l'instant. Crear-ne una per sobre del topall respon 422 amb
code: max_api_keys_exceeded, indicant el tier i el topall. Per superar-ho,
revoca una clau que ja no facis servir o puja de tier.
Endpoints de webhook
Un endpoint compta mentre és viu (active o degraded); un de deshabilitat
o esborrat no compta. Crear-ne un per sobre del topall respon 422 amb
code: business_rule_violation i subcode: max_webhook_endpoints_reached.
Al tier Free el topall és 0, així que ja falla el primer endpoint —i
ho fa amb 402 addon_required en comptes del 422 de dalt, perquè no hi ha
res per alliberar—. Els webhooks requereixen un pla de pagament (Starter o
superior) o un boost de capacitat.
El mode test no és un tier més barat
Una clau fact_test_ porta el mateix tier que les teves claus de
producció, així que al trànsit de sandbox se li apliquen les mateixes quotes
per minut i mensual. En mode test no s'eximeix cap límit de peticions.
El que el sandbox treu és l'efecte real, no la quota: els registres de VeriFactu es creen en local i mai no es transmeten a l'AEAT, els correus de documents no arriben a destinataris reals i els esdeveniments queden registrats però no s'entreguen als teus endpoints. Tens la llista completa a Mode test i sandbox.
Un topall sí que es comporta diferent: les claus de test viuen en una empresa sandbox a part, així que consumeixen la quota de claus d'aquella empresa i no la de la teva empresa real.
Volum alt
Scale no té preu publicat: els topalls s'acorden cas per cas. Escriu a info@factuarea.com des del correu associat a la teva empresa a Factuarea, amb el volum de peticions que esperes i els endpoints que faràs servir. El que porta el tier: quotes per minut i mensual personalitzades, claus actives i endpoints de webhook il·limitats, acord de nivell de servei i gestor de compte dedicat.
Com veure el que consumeixes
Dashboard → Developers → Usage
mostra el teu consum enfront del tier actual. Cada resposta de l'API porta a
més les capçaleres X-RateLimit-*, la manera més barata de detectar que
t'acostes al límit abans d'arribar-hi: com llegir-les és a
Límits de peticions.