API de calendario
Feriados, días hábiles y vencimientos SUNAT
Para que tu sistema sepa qué días no cuentan, cuándo vence un plazo y qué vence en SUNAT este mes. Cada fecha con la norma que la fija. Gratis, sin descontar consultas.
curl "https://nexoid.victorllerena.com/id/v1/vencimientos/proximos?digito=5" \
-H "Authorization: Bearer nxid_test_sandboxpublicodenexoidpruebas001"{
"success": true,
"resumen": { "digito": "5", "buen_contribuyente": false, "desde": "…" },
"data": [
{ "periodo": "…", "vence": "…", "estado": "publicado", "dias_restantes": 8 }
],
"meta": {
"origen": "sunat_cronograma",
"atribucion": "Cronograma de obligaciones mensuales — SUNAT, RS 281-2022/SUNAT"
}
}Endpoints
GET /id/v1/calendario/feriados/{anio}
Los feriados y no laborables del año · gratis, no consume
GET /id/v1/calendario/{fecha}
Si un día es hábil, y por qué no · gratis, no consume
GET /id/v1/calendario/plazo?desde=…&dias=…
Cuándo vence un plazo de días hábiles · gratis, no consume
GET /id/v1/vencimientos/{anio}
El cronograma SUNAT del año, por dígito · gratis, no consume
GET /id/v1/vencimientos/proximos?digito=…
Lo próximo que vence para un dígito · gratis, no consume
Pide el último dígito del RUC, nunca el RUC: un RUC que empieza en 10 lleva un DNI dentro, y no tiene por qué viajar. Pruébala en el navegador con las herramientas gratis.
Qué devuelve
| Campo | Qué es | De dónde sale | Presente en |
|---|---|---|---|
| fecha · nombre · norma | Cada feriado o no laborable, con la ley o el decreto que lo fija | El Peruano | siempre |
| tipo | feriado (para todos) o no_laborable (sector público) | — | siempre |
| habil · motivo | Si un día cuenta, y si no, por qué | — | siempre |
| vence · saltados | El día en que vence un plazo y los inhábiles que hubo en medio | — | siempre |
| periodos[].vencimientos | Por periodo, la fecha para cada último dígito y para los buenos contribuyentes | SUNAT | siempre |
| estado | publicado (la tabla de SUNAT) o calculado (la regla, antes de que SUNAT publique el año) | — | siempre |
| meta.cubre | Los años que responde: fuera de ellos, 404 anio_no_disponible | — | siempre |
Preguntas frecuentes
¿Cuenta como consulta?
No. Es un catálogo, como el ubigeo: no descuenta de tu cuota ni de tu bolsa, y responde también al token público del sandbox, con datos reales.
¿De dónde salen las fechas del cronograma?
De la RS 281-2022/SUNAT: cada vencimiento cae en un día hábil del mes siguiente según el último dígito. Comprobamos que esa regla reproduce, fecha por fecha, las tablas que SUNAT publicó para 2025 y 2026.
¿Cómo se mantienen los feriados?
Los de ley se calculan para cualquier año, Semana Santa incluida. Los no laborables se cargan con su decreto supremo cuando salen. Solo nacionales: los regionales no están.
¿Los no laborables mueven el cronograma de SUNAT?
No: para fines tributarios son días hábiles, y así lo dicen los decretos. Con ?sector=publico sí cuentan para un plazo administrativo.