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 pedís en tu idioma («subí 8% la lista Mayorista B en Limpieza y mostrame la tabla antes») y la IA habla con la tienda por su API. No tenés que entender nada de lo que pasa por detrás: el prompt del paso 3 le explica todo a la IA.
Paso 1: activá la API y copiá tu clave
- Entrá a tu panel de administración con un usuario administrador y andá a Configuración → ERP.
- En Integraciones API, elegí la tarjeta API Token y activá 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. Apretá Copiar token (o Descargar archivo de token). Ahí mismo tenés el enlace Ver documentación de la API y el botón Regenerar token por si algún día la necesitás cambiar.
- Anotá también la dirección de tu tienda, la que ven tus clientes (por ejemplo
https://mitienda.com).
Paso 2: abrí una IA que trabaje en tu computadora
El chat común del navegador no alcanza: necesitás 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. Elegí 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). Elegí 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: pegá este prompt y completá dos datos
Copialo entero, reemplazá [DIRECCIÓN DE TU TIENDA] y [TU CLAVE] por los datos del paso 1, y envialo. 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.
Abrí 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: abrilas todas). Si algo no queda claro, complementá 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]
Guardalos en un archivo .env dentro de esta carpeta (VXM_URL y VXM_TOKEN) y usá 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.
Hacé una lectura simple (por ejemplo, los últimos 3 productos). Si responde 401, decime que la clave está mal copiada. Si responde 403, decime que la API todavía no está activa en mi panel (Configuración → ERP). Cuando funcione, dejá en un archivo NOTAS.md un resumen de la API y anotá ahí la fecha en que leíste la documentación.
4. CONTARME QUÉ PODÉS HACER.
Explicame en lenguaje simple, sin términos técnicos, qué tareas podés hacer en mi tienda, y pedime la primera.
5. REGLAS PERMANENTES.
- Antes de crear, modificar o borrar cualquier cosa, mostrame exactamente qué vas a cambiar y esperá mi confirmación.
- En cambios masivos, primero una tabla con el antes y el después y cuántos registros afecta.
- Respetá los límites de la API: traé los datos de a páginas, y si te frena esperá y reintentá; si un recurso cambió mientras lo editabas, volvé a leerlo antes de insistir.
- Al terminar cada tarea, resumime 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, volvé a leer la documentación completa, actualizá NOTAS.md con la fecha nueva y contame qué novedades encontraste. Hacé 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 conocés.
- Hablame siempre en lenguaje simple. Para probar: tus primeros pedidos a la IA
Empezá por consultas (no cambian nada) y pasá a los cambios cuando veas que entiende tu tienda:
- «Listame los pedidos de hoy con cliente, total y estado, y marcá los que no tienen pago.»
- «¿Qué productos de la categoría Limpieza están sin stock?»
- «Compará los precios de la lista Mayorista A y la B para los 50 productos más vendidos.»
- «Subí 8% la lista Mayorista B en Limpieza. Antes mostrame la tabla y esperá mi OK.»
- «Cargá los productos de esta planilla con sus fotos. Los que ya existen, actualizalos.»
- «Cargale a Distribuidora Norte su pedido de siempre: 20 cajas del RM-204 y 10 del RM-310. Mostrame el total antes de confirmar.»
- «Estos 12 clientes tienen deuda vencida. Bloquealos y anotá 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. Volvé a Configuración → ERP → API Token, apretá Copiar token y pasásela de nuevo: «Esta es la clave correcta, actualizala».
- La IA dice que la API no está activa (403). Falta activar el servicio en tu panel (Configuración → ERP → API Token). Activalo y pedile que vuelva a probar.
- La IA no logra abrir la documentación. Pedile que use el artículo del centro de ayuda (el enlace está en el prompt) o copiale el texto de la consola y pegáselo.
- 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. Pedile 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 tenés que armarlas vos: se las pedís 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. Pedile a tu IA: «Armá un servidor MCP que exponga como herramientas los endpoints de la API que ya conocés, con la clave guardada adentro, y decime cómo agregarlo a mi app». Después lo pegás 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. Pedile a tu IA: «Generá el esquema OpenAPI de la API y explicame 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. Pedile a tu IA: «Dejame 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.
