Saltar al contenido
Vintu API
Tema de la documentación
Ir a la app

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

CampoQué es
entidadsunat o sunafil.
buzonEl 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.
tipoLa clasificación del aviso según su buzón; puede ser nula.
asuntoEl asunto tal como lo publica la entidad; puede ser nulo.
fecha_notificacionCuándo lo notificó la entidad. Es nula cuando el buzón no la publica, como en las orientaciones de SUNAFIL.
creado_enCuá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"

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.