Limites de Uso
| Endpoint | Limite |
|---|---|
Submissão de documentos (/facturas, /factura/{tipo}, /factura/consultar, /facturas/listar) | 4 pedidos/minuto |
/estado, /status/{requestId}, /validar | 60 pedidos/minuto |
| Outros | 500 pedidos/minuto |
Ao exceder o limite:
{
"error": "Demasiadas solicitações. Aguarda 2 minutos antes de tentar novamente.",
"code": "E98",
"retry_after": "120s"
}Com cabeçalho Retry-After: 120. Respeita este valor antes de repetir o pedido.
Recomendações
- Submete documentos em lote (
/v1/client/facturas, até 30 por pedido) em vez de um a um. - Usa webhooks para saber o resultado, em vez de fazer polling constante em
/status/{requestId}.