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

Vintu API

API REST de solo lectura para llevar a tus sistemas lo que Vintu ya tiene de tus empresas: los comprobantes que recibe, los avisos de los buzones SUNAT y SUNAFIL y los próximos vencimientos tributarios.

Todas las operaciones están en https://api.vintu.io/v1, responden JSON en UTF-8 y se autentican con una clave de API en la cabecera Authorization: Bearer. Si es tu primera vez, empieza por el inicio rápido.

Qué puedes leer

Recurso Qué es Operaciones
Cuenta Plan, límites y uso de la cuenta dueña de la clave.
Empresas Empresas (RUC) registradas en la cuenta.
Comprobantes Comprobantes recibidos por correo, WhatsApp o Drive y extraídos.
Avisos Notificaciones de los buzones SUNAT y SUNAFIL.
Vencimientos Próximos vencimientos tributarios según el último dígito del RUC.
Archivos Descarga del original de un comprobante.

Cada operación tiene su página en la referencia, generada del OpenAPI que publica la propia API, con parámetros, ejemplos de petición en curl, JavaScript y Python, respuesta y errores posibles.

Requisitos

  • Una cuenta de Vintu en el plan Contador o Estudio. Con el plan Gratis, la API responde 403 API_PLAN_REQUIRED.
  • Una clave de API. La crea el propietario de la cuenta o un administrador con acceso a todas las empresas, en app.vintu.io, Configuración → API y webhooks. Ver Autenticación y claves.
  • Un servidor desde el que llamar. La API no envía cabeceras CORS, así que un navegador no la deja llamar desde otro dominio; y una clave nunca debe viajar en código que se ejecute en el navegador.

Lo que esta versión no hace

  • No escribe. Todas las operaciones de v1 son GET.
  • No tiene entorno de pruebas. Solo existen claves de producción (vk_live_…) y leen los datos reales de tu cuenta.
  • No expone todo lo que ves en la app. Los comprobantes que entraron por la conexión con Gmail, o cuyo origen no se conoce, no salen por la API.
  • No avisa de los cambios. Para enterarte de lo nuevo, consulta con actualizado_desde: ver Paginación y sincronización.

Datos de los ejemplos

Los RUC, las razones sociales y los importes de los ejemplos son ficticios. Los RUC llevan un dígito verificador inválido para que no correspondan a ningún contribuyente.