Lo que vas a lograr en 15 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 adicional, 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 para no tener que releer la documentación la próxima vez.
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.
- 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.
