Errores y límites¶

Códigos de error HTTP¶

Código	Significado
`200`	Éxito
`201`	Recurso creado
`401`	No autenticado — API key inválida o ausente
`403`	Prohibido — Sin permiso sobre este recurso
`404`	No encontrado
`422`	Validación fallida — Revisa los campos enviados
`429`	Cuota mensual excedida
`500`	Error interno del servidor

Formato de error¶

{
  "message": "Validation failed.",
  "errors": {
    "invoice_number": [
      "The invoice number has already been registered for this NIF."
    ],
    "invoice_date": [
      "Invoice date must be equal or after 2026-03-12 (last invoice date for this NIF)."
    ]
  }
}

Límites de cuota¶

Plan	Facturas/mes	Contribuyentes
Free	100	1
Starter	1,000	5
Professional	5,000	Ilimitados
Enterprise	Personalizado	Ilimitados

Cuando se excede la cuota:

{
  "message": "Monthly quota exceeded.",
  "data": {
    "monthly_quota": 5000,
    "monthly_used": 5000
  }
}

Rate limiting¶

La API aplica un límite de 60 peticiones por minuto por API key.

Consultar uso

Usa GET /api/v1/auth/me para ver tu cuota actual y el consumo del mes.