Límites

Peticiones por API key

Cada API key puede hacer 60 peticiones por minuto, contadas aparte para las rutas de comprobantes y para las rutas /v1: consultar placas no le quita cupo a la descarga de comprobantes. Al pasarse, el servicio responde 429 hasta que se libera hueco.

Consultas al MTC

El registro del MTC es una consulta pública, así que el servicio lo usa con cuidado:

• Lo ya consultado se sirve sin volver al MTC (ver Vehículos por placa).
• El servicio hace como mucho 120 consultas nuevas al MTC por hora, para todos sus clientes. Al pasarse, responde 429 con RATE_LIMITED; lo ya guardado se sigue sirviendo.

Estado de comprobantes

• Hasta 50 comprobantes por petición; la petición cuenta como una para el límite de su API key.
• Cada API key puede hacer 100 consultas a SUNAT por minuto (una por comprobante), y el servicio 300 para todos sus clientes. Si se alcanza a mitad de un lote, los comprobantes que faltan salen unknown con RATE_LIMITED; si no se pudo consultar ninguno, la petición entera responde 429 con Retry-After.
• Una petición dura unos segundos. Si SUNAT va lento, a los 20 segundos no se empieza ninguna consulta más y los comprobantes que faltan salen unknown con SUNAT_UNAVAILABLE.

Descargas masivas

• Vaya de una en una y espere la respuesta antes de pedir la siguiente.
• Ante un 429, espere lo que diga Retry-After, o un minuto, antes de seguir.
• Espere hasta 30 segundos por respuesta: SUNAT a veces tarda.
• Si tiene muchos comprobantes atrasados, repártalos en el tiempo (por ejemplo, de noche).