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.
La capacitat també forma part del pla: no existeix un tier Developer API ni un boost que es pugui comprar per separat. Canviar de pla canvia el tier efectiu de totes les claus existents automàticament.
Nivells
| Tier | Per minut | Per mes | API keys actives | Endpoints de webhook |
|---|---|---|---|---|
| Free | 10 rpm | 100 | 1 | 0 |
| Starter | 30 rpm | 5.000 | 3 | 1 |
| Pro | 300 rpm | 50.000 | 25 | 10 |
| Scale | 1.200 rpm | 5.000.000 | 100 | 50 |
Xifres verificades contra la configuració de tiers del backend el
2026-08-27. Per saber com es comporten les quotes —finestra lliscant,
capçaleres X-RateLimit-*, eixos agregats d'empresa/cartera gestionada,
codis 429 i 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. Una migració històrica
grandfathered_addon pot conservar un tier superior mentre continuï actiu un
pla vàlid; els boosts heretats que no es van migrar són inerts.
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 canvia a un pla amb un tier superior.
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 que atorgui Starter o
superior.
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 clau, per minut i mensuals. Els eixos agregats d'empresa i cartera
gestionada ometen les empreses sandbox: el trànsit de prova no consumeix la
capacitat agregada de l'empresa live.
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. La seva capacitat inclosa és la fila numèrica anterior: fins a 100 claus actives i 50 endpoints de webhook, no un tier sense límits. 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 si necessites una ampliació auditada per a la teva empresa. Scale també inclou un 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.