Lo que vas a lograr en 20 minutos
Tu IA de siempre va a poder leer y operar tu tienda: productos y fotos, precios por lista, categorías, clientes, pedidos y carritos abandonados. Le pides en tu idioma («sube 8% la lista Mayorista B en Limpieza y muéstrame la tabla antes») y la IA habla con la tienda por su API. No tienes que entender nada de lo que pasa por detrás: el prompt del paso 3 le explica todo a la IA.
Paso 1: activa la API y copia tu clave
- Entra a tu panel de administración con un usuario administrador y ve a Configuración → ERP.
- En Integraciones API, elige la tarjeta API Token y activa el servicio. Es un servicio mensual que se cotiza aparte del plan, disponible en todos los países.
- En Configuración de API Token aparece tu clave. Pulsa Copiar token (o Descargar archivo de token). Ahí mismo tienes el enlace Ver documentación de la API y el botón Regenerar token por si algún día la necesitas cambiar.
- Anota también la dirección de tu tienda, la que ven tus clientes (por ejemplo
https://mitienda.com).
Paso 2: abre una IA que trabaje en tu computadora
El chat común del navegador no alcanza: necesitas la versión de tu IA que puede trabajar en tu computadora, porque es la que lee documentación, guarda tu clave y llama a la tienda. Cualquiera de estas sirve:
| Tu IA | Qué abrir |
|---|---|
| Claude | La app de Claude para computadora, pestaña Code. Elige una carpeta nueva (por ejemplo «Mi tienda») cuando te la pida. También sirve Claude Code en la terminal. |
| ChatGPT | La app de ChatGPT para computadora, sección Codex (incluida en los planes pagos). Elige una carpeta nueva. |
| Gemini | Gemini CLI en la terminal, dentro de una carpeta nueva. |
| Copilot · Cursor | Visual Studio Code con Copilot en modo agente, o Cursor, con una carpeta nueva abierta. |
Paso 3: pega este prompt y completa dos datos
Cópialo entero, reemplaza [DIRECCIÓN DE TU TIENDA] y [TU CLAVE] por los datos del paso 1, y envíalo. El resto lo hace la IA sola: lee la documentación completa de la API, guarda la clave, prueba la conexión y te cuenta qué puede hacer.
Quiero que operes mi tienda mayorista de VentasxMayor a través de su API, siguiendo estos pasos en orden.
1. LEER LA DOCUMENTACIÓN COMPLETA.
Abre https://admin.ventasxmayor.com/api-console (la portada explica la autenticación y lista todos los endpoints; cada endpoint tiene su propia página con parámetros, cuerpo y ejemplo: ábrelas todas). Si algo no queda claro, compleméntalo con https://ventasxmayor.com.ar/centro-de-ayuda/integ-api. Recursos disponibles: productos, imágenes, precios por lista, categorías, listas de precios, clientes, pedidos y carritos.
2. GUARDAR MIS DATOS DE ACCESO.
Dirección de mi tienda: [DIRECCIÓN DE TU TIENDA]
Clave de la API: [TU CLAVE]
Guárdalos en un archivo .env dentro de esta carpeta (VXM_URL y VXM_TOKEN) y usa la clave siempre en el encabezado "Authorization: Bearer". No la muestres, no la repitas en el chat y no la subas a ningún lado. Los endpoints cuelgan de /api/v1/ sobre la dirección de la tienda.
3. PROBAR LA CONEXIÓN.
Haz una lectura simple (por ejemplo, los últimos 3 productos). Si responde 401, dime que la clave está mal copiada. Si responde 403, dime que la API todavía no está activa en mi panel (Configuración → ERP). Cuando funcione, deja en un archivo NOTAS.md un resumen de la API y anota ahí la fecha en que leíste la documentación.
4. CONTARME QUÉ PUEDES HACER.
Explícame en lenguaje simple, sin términos técnicos, qué tareas puedes hacer en mi tienda, y pídeme la primera.
5. REGLAS PERMANENTES.
- Antes de crear, modificar o borrar cualquier cosa, muéstrame exactamente qué vas a cambiar y espera mi confirmación.
- En cambios masivos, primero una tabla con el antes y el después y cuántos registros afecta.
- Respeta los límites de la API: trae los datos de a páginas, y si te frena espera y reintenta; si un recurso cambió mientras lo editabas, vuelve a leerlo antes de insistir.
- Al terminar cada tarea, resúmeme qué cambió, cuántos registros y qué quedó pendiente.
- La API suma endpoints y campos nuevos seguido. Al empezar a trabajar, si pasaron más de 7 días desde la fecha anotada en NOTAS.md, vuelve a leer la documentación completa, actualiza NOTAS.md con la fecha nueva y cuéntame qué novedades encontraste. Haz lo mismo sin esperar los 7 días si te pido algo que no figura en tus notas o si la API responde con un campo o un error que no conoces.
- Háblame siempre en lenguaje simple. Para probar: tus primeros pedidos a la IA
Empieza por consultas (no cambian nada) y pasa a los cambios cuando veas que entiende tu tienda:
- «Lístame los pedidos de hoy con cliente, total y estado, y marca los que no tienen pago.»
- «¿Qué productos de la categoría Limpieza están sin stock?»
- «Compara los precios de la lista Mayorista A y la B para los 50 productos más vendidos.»
- «Sube 8% la lista Mayorista B en Limpieza. Antes muéstrame la tabla y espera mi OK.»
- «Carga los productos de esta planilla con sus fotos. Los que ya existen, actualízalos.»
- «Cárgale a Distribuidora Norte su pedido de siempre: 20 cajas del RM-204 y 10 del RM-310. Muéstrame el total antes de confirmar.»
- «Estos 12 clientes tienen deuda vencida. Bloquéalos y anota el motivo en cada ficha.»
Si algo falla
- La IA dice que la clave no es válida (401). Se copió incompleta o con un espacio de más. Vuelve a Configuración → ERP → API Token, pulsa Copiar token y pásasela de nuevo: «Esta es la clave correcta, actualízala».
- La IA dice que la API no está activa (403). Falta activar el servicio en tu panel (Configuración → ERP → API Token). Actívalo y pídele que vuelva a probar.
- La IA no logra abrir la documentación. Pídele que use el artículo del centro de ayuda (el enlace está en el prompt) o cópiale el texto de la consola y pégaselo.
- La IA pide permiso para instalar o ejecutar algo. Es normal: así trabaja en tu carpeta. Lo que no debería hacer nunca es mostrarte la clave en pantalla.
- Un cambio no se aplicó y la IA habla de un «conflicto» (409). Alguien editó lo mismo en el panel al mismo tiempo. Pídele que vuelva a leer y reintente.
Otras vías, para cuando quieras más
La vía de arriba alcanza para la gran mayoría. Estas son más técnicas, y la buena noticia es que no tienes que armarlas tú: se las pides a la IA que ya conectaste.
- Usar la tienda desde la app de chat (Claude, ChatGPT, Gemini, Copilot Studio). Hace falta un conector MCP, el estándar con el que esas apps usan herramientas externas; VentasxMayor todavía no publica uno oficial. Pídele a tu IA: «Arma un servidor MCP que exponga como herramientas los endpoints de la API que ya conoces, con la clave guardada adentro, y dime cómo agregarlo a mi app». Después lo pegas en la configuración de conectores de la app (en Claude: Configurar → Conectores; en ChatGPT: Apps y conectores → Modo desarrollador; en Gemini: Apps conectadas).
- Un asistente para todo tu equipo (un GPT personalizado en ChatGPT o un agente en Microsoft 365 Copilot). Necesita una descripción de la API en formato OpenAPI. Pídele a tu IA: «Genera el esquema OpenAPI de la API y explícame cómo cargarlo como acción con autenticación Bearer».
- Tareas que corren solas (n8n, Make, Zapier, Power Automate, o un programa propio). La automatización consulta la tienda cada tanto y una IA resume o decide. Pídele a tu IA: «Déjame un script que todos los lunes a las 8 arme el resumen semanal de pedidos y me lo mande por WhatsApp». La API no envía avisos por sí sola: la automatización pregunta.
