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

Inicio rápido

  1. Crea una clave en Vintu

    Entra a app.vintu.io con una cuenta de propietario o de administrador con acceso a todas las empresas y abre Configuración → API y webhooks. Pulsa Crear clave, dale un nombre que diga dónde la vas a usar (por ejemplo, «Integración ERP») y deja marcados solo los permisos que necesites; por defecto vienen marcados todos los de lectura.

    La clave completa se muestra una sola vez, al crearla. Cópiala en ese momento: después la app solo enseña su prefijo.

  2. Guárdala en una variable de entorno

    Los ejemplos de esta documentación leen la clave de VINTU_API_KEY. No la escribas en el código ni la subas a un repositorio.

    export VINTU_API_KEY="vk_live_…"   # pega aquí tu clave
  3. Comprueba la clave

    GET /v1/cuenta responde con cualquier clave válida, tenga los permisos que tenga. Si devuelve 200, la clave funciona y la respuesta trae el plan, los límites de tu cuenta y el uso del mes.

    curl "https://api.vintu.io/v1/cuenta" \
      -H "Authorization: Bearer $VINTU_API_KEY"
  4. Lee tus datos

    Con la clave comprobada, pide la primera página de comprobantes. Cada elemento trae sus importes como cadenas decimales y un archivo_url para descargar el original durante una hora.

    curl -G "https://api.vintu.io/v1/comprobantes" \
      --data-urlencode "limite=25" \
      -H "Authorization: Bearer $VINTU_API_KEY"

    Si siguiente_cursor no es nulo, hay más páginas: pásalo en cursor para pedir la siguiente. Ver Paginación y sincronización.

Si algo falla

Toda respuesta de error trae {"error": {"codigo", "mensaje", "id_peticion"}}. Los tres casos más comunes al empezar:

  • 401 INVALID_API_KEY: la cabecera falta, la clave está mal copiada o fue revocada. Comprueba que el valor sea Bearer seguido de la clave completa, sin espacios ni saltos de línea al final.
  • 403 API_PLAN_REQUIRED: tu plan no incluye la API. Está en los planes Contador y Estudio.
  • 403 SCOPE_REQUIRED: la clave no tiene el permiso de esa operación. Los permisos se eligen al crear la clave; ver Permisos.

La lista completa está en Errores. Si escribes a soporte, cita el id_peticion.

Solo hay claves de producción

Las claves leen los datos reales de tu cuenta. Si una clave queda expuesta, revócala en Configuración → API y webhooks: deja de funcionar en un máximo de 60 segundos.

Siguientes pasos