Leer avisos de SUNAT y SUNAFIL
Vintu lee los buzones electrónicos de SUNAT y SUNAFIL de tus empresas y guarda cada notificación como un aviso.
GET /v1/avisos los devuelve; necesitas el permiso avisos:leer.
Qué trae un aviso
| Campo | Qué es |
|---|---|
entidad | sunat o sunafil. |
buzon | El buzón de origen. En SUNAT: notificaciones o mensajes. En SUNAFIL: fiscalizacion, cobranza, acciones_previas, formalizacion, sst u orientaciones. Es nulo en avisos antiguos que no lo registraron. |
tipo | La clasificación del aviso según su buzón; puede ser nula. |
asunto | El asunto tal como lo publica la entidad; puede ser nulo. |
fecha_notificacion | Cuándo lo notificó la entidad. Es nula cuando el buzón no la publica, como en las orientaciones de SUNAFIL. |
creado_en | Cuándo lo leyó Vintu por primera vez. |
Avisos de una empresa
curl -G "https://api.vintu.io/v1/avisos" \
--data-urlencode "empresa_id=00000000-0000-4000-8000-0000000000c1" \
--data-urlencode "limite=100" \
-H "Authorization: Bearer $VINTU_API_KEY"const url = new URL("https://api.vintu.io/v1/avisos");
url.searchParams.set("empresa_id", "00000000-0000-4000-8000-0000000000c1");
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/avisos",
params={"empresa_id": "00000000-0000-4000-8000-0000000000c1", "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())Solo los nuevos
Usa el mismo patrón que con los comprobantes: guarda la marca_superior al terminar cada recorrido y pásala en
actualizado_desde la vez siguiente. Ver Paginación y sincronización.
No es tiempo real
Vintu lee los buzones de forma periódica, no en el momento en que la entidad publica. Un aviso aparece en la API
cuando Vintu lo leyó, así que su creado_en puede ser posterior a su fecha_notificacion.
Lo que esta versión no hace
- No trae el documento adjunto de la notificación ni su texto completo: solo los datos de la tabla.
- No marca un aviso como leído ni como atendido, ni en Vintu ni en el portal de la entidad.
- Solo hay avisos de los buzones que tu cuenta tiene conectados en Vintu.