Factuarea API

Precios y límites de la API

Qué cuesta la API, qué tier otorga cada plan y los topes por tier de peticiones, API keys y endpoints de webhook.

La API pública y el servidor MCP están incluidos en todos los planes de pago de Factuarea. No hay ningún complemento que contratar ni solicitud de acceso: crea una clave desde Dashboard → Developers → API Keys y empieza a llamar a /v1.

Lo que sí puedes pagar es capacidad. Tu plan otorga un tier de límites; si necesitas uno superior sin cambiar de plan, suscríbete a un boost de capacidad. La columna de precio de abajo es el precio de ese boost, nunca el precio del acceso.

Niveles

TierPrecio del boostPor minutoPor mesAPI keys activasEndpoints de webhook
FreeNo se vende (tier del trial)10 rpm10010
Starter4,90 € / mes30 rpm5.00031
Pro19,90 € / mes300 rpm50.0002510
ScaleSales-ledPersonalizadoPersonalizadoIlimitadasIlimitados

Cifras verificadas contra la configuración de tiers del backend el 2026-07-31. Para saber cómo se comportan las cuotas —ventana deslizante, cabeceras X-RateLimit-*, el código 429 y la estrategia de reintento— consulta Límites de peticiones.

Qué otorga ya tu plan

Tu planTier otorgado sin coste adicional
Trial (todavía sin suscripción activa)Free
EmprendedorStarter
EmpresarioPro
EnterpriseScale

El tier sigue al plan por sí solo: no se elige por clave ni por petición, y cambia en cuanto cambia tu plan.

Boost de capacidad

Un boost compra un tier estrictamente superior al que ya otorga tu plan —por ejemplo Starter → Pro en el plan Emprendedor—. Se contrata desde Dashboard → Developers → Upgrade y se factura mensualmente. Mientras el boost está activo, todas las claves de la empresa usan el tier del boost.

Como el plan ya otorga un tier, comprar uno igual o inferior al suyo se rechaza: la regla y el error que devuelve están en Límites de peticiones → Boost de capacidad.

Topes que no son peticiones

Hay dos límites que se cuentan por empresa, no por petición.

API keys activas

Una clave cuenta mientras no esté revocada ni caducada; revocar una libera hueco al momento. Crear una por encima del tope responde 422 con code: max_api_keys_exceeded, indicando el tier y el tope. Para superarlo, revoca una clave que ya no uses o sube de tier.

Endpoints de webhook

Un endpoint cuenta mientras está vivo (active o degraded); uno deshabilitado o borrado no cuenta. Crear uno por encima del tope responde 422 con code: business_rule_violation y subcode: max_webhook_endpoints_reached.

En el tier Free el tope es 0, así que ya falla el primer endpoint —y lo hace con 402 addon_required en vez del 422 de arriba, porque no hay nada que liberar—. Los webhooks requieren un plan de pago (Starter o superior) o un boost de capacidad.

El modo test no es un tier más barato

Una clave fact_test_ lleva el mismo tier que tus claves de producción, así que al tráfico de sandbox se le aplican las mismas cuotas por minuto y mensual. En modo test no se exime ningún límite de peticiones.

Lo que el sandbox quita es el efecto real, no la cuota: los registros de VeriFactu se crean en local y nunca se transmiten a la AEAT, los correos de documentos no llegan a destinatarios reales y los eventos quedan registrados pero no se entregan a tus endpoints. Tienes la lista completa en Modo test y sandbox.

Un tope sí se comporta distinto: las claves de test viven en una empresa sandbox aparte, así que consumen el cupo de claves de esa empresa y no el de tu empresa real.

Alto volumen

Scale no tiene precio publicado: los topes se acuerdan caso por caso. Escribe a info@factuarea.com desde el correo asociado a tu empresa en Factuarea, con el volumen de peticiones que esperas y los endpoints que vas a usar. Lo que lleva el tier: cuotas por minuto y mensual personalizadas, claves activas y endpoints de webhook ilimitados, acuerdo de nivel de servicio y gestor de cuenta dedicado.

Cómo ver lo que consumes

Dashboard → Developers → Usage muestra tu consumo frente al tier actual. Cada respuesta de la API lleva además las cabeceras X-RateLimit-*, la forma más barata de detectar que te acercas al límite antes de alcanzarlo: cómo leerlas está en Límites de peticiones.

En esta página