Vencimientos por empresa
GET /v1/vencimientos cruza el RUC de cada empresa con el cronograma de
vencimientos de SUNAT y devuelve las fechas que vienen. Necesitas el permiso vencimientos:leer.
curl -G "https://api.vintu.io/v1/vencimientos" \
--data-urlencode "limite=100" \
-H "Authorization: Bearer $VINTU_API_KEY"const url = new URL("https://api.vintu.io/v1/vencimientos");
url.searchParams.set("limite", "100");
const respuesta = await fetch(url, {
headers: { Authorization: `Bearer ${process.env.VINTU_API_KEY}` },
});
if (!respuesta.ok) {
const { error } = await respuesta.json();
throw new Error(`${respuesta.status} ${error.codigo}: ${error.mensaje} (${error.id_peticion})`);
}
const cuerpo = await respuesta.json();
console.log(cuerpo);import os
import requests
respuesta = requests.get(
"https://api.vintu.io/v1/vencimientos",
params={"limite": "100"},
headers={"Authorization": f"Bearer {os.environ['VINTU_API_KEY']}"},
timeout=30,
)
if not respuesta.ok:
error = respuesta.json()["error"]
raise RuntimeError(f"{respuesta.status_code} {error['codigo']}: {error['mensaje']} ({error['id_peticion']})")
print(respuesta.json())Qué incluye
| Campo | Qué es |
|---|---|
obligacion | IGV_RENTA (IGV y Renta mensual) o PLAME. |
periodo | El periodo tributario que se declara, AAAA-MM. |
fecha_vencimiento | La fecha límite según el último dígito del RUC de la empresa. |
empresa_id | La empresa a la que corresponde. |
Solo salen vencimientos de hoy en adelante, según la fecha de Lima.
Cronograma general
Las fechas son las del cronograma general por último dígito del RUC. No cubren a los principales contribuyentes ni a los regímenes con fechas propias, y no incluyen la declaración anual de Renta. Comprueba en SUNAT las de una empresa que esté en alguno de esos casos.
Identificadores
El id de un vencimiento es estable para una empresa, una obligación y un periodo: puedes usarlo para no avisar dos
veces de lo mismo. Si cambia el RUC de una empresa, sus vencimientos se recalculan y llegan con id nuevos; los
anteriores dejan de aparecer.
Cuándo aparecen fechas nuevas
Vintu carga el cronograma oficial de SUNAT cuando se publica. Un periodo cuyo cronograma aún no está cargado no
aparece. Con actualizado_desde recibes también los vencimientos que entran al cargar un cronograma nuevo o al
registrar una empresa.