Cómo conectar tu propio sistema con la API de Vecipp

(Categoría: Cuenta)

Una API es una puerta por la que otro programa puede pedirle información a Vecipp de forma automática, sin que nadie entre al panel a copiarla a mano.

Con tu usuario y tu token puedes conectar tu propia página web, una hoja de cálculo, una herramienta de automatización o el sistema que ya usas, y que lean tus datos de Vecipp solos.

Es distinto de conectar un asistente de IA. Aquel se conecta pegando una dirección y autorizando desde tu cuenta; este es para cuando tú o tu desarrollador están armando la conexión.

• Se acaba el copiar y pegar. Los datos que hoy exportas a Excel a mano pueden llegar solos a donde los necesites.
• Tus reportes, a tu manera. Si quieres un tablero propio o cruzar tus ventas con otra información, ya no dependes de que exista la pantalla.
• Conecta con miles de herramientas. Plataformas de automatización pueden hablar con Vecipp usando tu token, sin que nadie programe nada.
• Un dato, una sola vez. Lo que la API responde sale de la misma fuente que la pantalla, así que no hay dos verdades.

Cada vez que otro programa le pide algo a Vecipp, manda tu correo y tu token para identificarse. Vecipp comprueba tres cosas antes de responder, siempre en este orden:

1. Que la credencial sea válida. El token va siempre junto a tu correo: uno sin el otro no sirve.
2. De qué empresa se trata. Si tienes varias, por defecto responde por la principal.
3. Que tú tengas permiso. La API ve exactamente lo que verías tú al entrar. Si tu usuario no puede ver Contabilidad, la API tampoco.

Tres detalles que conviene tener claros:

• Solo lee. Hoy la API no puede crear ni modificar nada.
• El token se muestra una sola vez. Vecipp no lo guarda tal cual, sino cifrado, así que no puede volver a enseñártelo. Si lo pierdes, generas otro.
• Hay un tope de 150 peticiones por minuto, para que una integración con un error no deje tu cuenta lenta.

A generar tu token de API, a saber qué información puedes consultar, a hacer tu primera prueba, y a renovar o anular el token cuando haga falta.

1. Entra a "Configuración" → "Integraciones" en tu panel.
2. Abre la pestaña "Integración manual (API)".
3. Ahí ves ya la Dirección de la API y tu Usuario (que es tu correo). Cópialos con el botón de copiar.
4. Haz clic en "Generar token".
   ⚠️ Cópialo en ese momento: en cuanto cierres la pantalla no se vuelve a mostrar. Guárdalo donde guardas tus contraseñas.
5. Dáselos a tu sistema o a tu desarrollador: dirección, usuario y token. Con eso ya puede consultar.
6. ¿Quieres ver qué se puede consultar? Abre la dirección de la API en el navegador: te muestra la lista de recursos disponibles.
7. Si el token se te perdió o crees que alguien más lo tiene, vuelve a esta pantalla y haz clic en "Renovar token".
   ⚠️ Renovar invalida el anterior: las integraciones que lo estén usando dejarán de funcionar hasta que las actualices con el nuevo.

¿Sabías que...? Puedes consultar los datos de otra de tus empresas agregando ?id_empresa= a la consulta. El número de cada empresa sale del recurso companies.

• "Me responde 401." La credencial no es válida. Revisa que estés mandando el correo y el token juntos: el token solo no sirve. Y comprueba que no hayas renovado el token después de configurar la integración.
• "Me responde 403." O estás pidiendo una empresa que no es tuya, o tu usuario no tiene permiso sobre ese módulo. Pídele a un administrador que revise tu rol en "Configuración" → "Equipo".
• "Me responde 429." Superaste las 150 peticiones por minuto. Espera un minuto; la respuesta te dice cuántos segundos faltan.
• "Me responde 405 al intentar crear algo." Es lo esperado: la API es de solo lectura por ahora.
• "Perdí el token." No se puede recuperar, solo generar otro. Usa "Renovar token" y actualiza tus integraciones.
• "Cambié algo en Vecipp y la API sigue mostrando lo viejo." No debería: lee la misma información que la pantalla. Si pasa, avísanos.

• Solo lee, no escribe. No se pueden crear facturas, registrar pagos ni modificar productos desde la API. Está previsto, pero primero hay que resolver que un reintento no duplique un documento.
• No avisa cuando algo cambia (no hay webhooks). Tu sistema tiene que preguntar; Vecipp todavía no le avisa solo.
• Consulta 15 áreas: facturas de venta, contactos, productos e inventario, compras, pagos, bancos, categorías, listas de precio, impuestos, retenciones, términos de pago, numeraciones, centros de costo, bodegas y tus empresas. Todavía no llega a nómina, cotizaciones, remisiones, activos fijos ni comprobantes contables.
• Un token por usuario. Todavía no se pueden tener varios con nombres distintos para separar integraciones.
• Sin campos de facturación electrónica. Cuando exista, se agregarán.