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.