/api/v1 Productos e imágenes
Crear, editar y borrar productos por código, con sus variantes y categorías. Subir y quitar fotos.
GET · POST productsPUT · DELETE products/{code}POST products/{code}/images AGENTES DE IA · API ABIERTA
ChatGPT, Claude o Gemini al mando de tu tienda mayorista
Conecta tu asistente de IA a la API y pídele en tu idioma lo que hoy haces a mano en el panel: cargar productos, subir una lista de precios, revisar los pedidos del día, bloquear a un moroso. Todo lo que la API permite, tu IA lo hace por ti.
Funciona con cualquier IA que hable REST o MCP · Token Bearer · 20 minutos para la primera conexión Cómo funciona
Tu IA ya sabe hablar con una API. Solo le faltaban las llaves.
La API abierta de la tienda expone lo mismo que ves en el panel. Un agente de IA lee esa referencia como un manual, convierte tu pedido en las llamadas correctas y te muestra el resultado. Tú pones la voz; la IA, las manos.
1
Pides en tu idioma
«Sube 8% la lista Mayorista B en Limpieza y muéstrame la tabla antes.» Sin planillas, sin menús, sin exportar nada.
2
La IA llama a la API
Lee los 142 productos de la categoría, arma la tabla «antes → después», espera tu OK y escribe los precios nuevos por lista y variante.
3
La tienda cambia al instante
Tus clientes ya ven el precio nuevo. La IA te deja el resumen: qué cambió, cuántos registros, qué quedó pendiente.
No confundir con el Vendedor IA, que atiende a tus clientes adentro de la tienda, ni con el asistente de soporte del panel. Esto es tu propia IA, la que ya usas todos los días, operando el negocio desde afuera por la API.
Todo lo que la API permite
Lo que tu IA puede manejar en la tienda
Cada tarjeta es un recurso de la API. Debajo, un ejemplo de lo que le pedirías a la IA.
Precios por lista
Leer y escribir el precio de cada producto y variante en cada lista mayorista, sin tocar las demás.
GET · PUT products/{code}/pricesGET · POST price-listsPedidos
Listar y leer cada pedido con ítems, totales, pago y envío. Anular y dejar notas internas. Los pedidos nacen en el carrito: la IA no los inventa.
GET ordersGET · PUT orders/{id}Clientes
Dar de alta compradores, editar sus datos y condición fiscal, asignarles lista y bloquearlos. No se borran: el historial queda.
GET · POST customersGET · PUT customers/{id}Categorías
Crear, renombrar, anidar, ordenar y ocultar categorías. El árbol del catálogo, ordenado por una IA que lo entiende.
GET · POST categoriesPUT · DELETE categories/{id}Reportes y rutinas
Cruzar pedidos, clientes y catálogo para armar el informe que hoy haces a mano, y dejarlo corriendo solo cada semana.
GET orders · customers · productsReferencia completa de endpoints, parámetros y límites en la página de la API y en el centro de ayuda.
Con cualquier IA
La IA que ya usas, por la vía que te quede más cómoda
Todas llegan a la misma API. Lo único que cambia es el enchufe.
Un agente con terminal
Corre en tu computadora y llama a la API directo. Le dejás el token en una variable, le pasás la referencia y le pides. Sin programar nada.
- Claude Code
- Codex CLI
- Gemini CLI
- GitHub Copilot
- Cursor
- Windsurf
Un conector MCP
Para operar desde Claude, ChatGPT, Gemini o Copilot: un puente MCP expone los endpoints como herramientas. Lo escribe la propia IA en minutos a partir de la referencia.
- Claude
- ChatGPT
- Gemini
- Copilot Studio
- Le Chat
- VS Code
Un GPT o agente con acciones
Un «Operador de la tienda» que cualquiera de tu equipo usa desde ChatGPT o Microsoft 365 Copilot, con un esquema OpenAPI y el token como autenticación.
- GPT personalizado
- Copilot Studio
- Microsoft 365 Copilot
Automatizaciones y SDK
Para lo que tiene que correr solo: un disparador, un nodo HTTP a la API y un nodo de IA que resume o decide. O el SDK del proveedor que prefieras, incluidos los modelos abiertos.
- n8n
- Make
- Zapier
- Power Automate
- Anthropic · OpenAI · Google · Mistral
- Llama · DeepSeek · Qwen
Un día con la IA en la tienda
Lo que antes era una hora de panel, ahora es una frase
¿Qué pedidos entraron anoche, de quién y por cuánto? Márcame los que no tienen pago.
La IA lista los pedidos, cruza el estado de pago y te devuelve la tabla con totales por cliente.
GET ordersGET customers/{id}Llegó la lista nueva del proveedor. Actualiza costos y sube 6% la lista Mayorista A en esos 80 códigos.
La IA lee la planilla, arma la tabla antes → después, espera tu OK y escribe los precios.
GET products/{code}PUT products/{code}/pricesCarga los 300 productos nuevos de la planilla, con fotos. Si el código existe, actualízalo.
La IA separa nuevos de existentes, te dice cuántos de cada uno y los carga en lotes respetando el límite de la API.
POST productsPOST products/{code}/imagesEstos 12 clientes tienen deuda vencida. Bloquéalos y deja el motivo y la fecha en la ficha.
La IA encuentra cada cliente por correo, confirma la lista contigo y los bloquea uno por uno.
GET customersPUT customers/{id}El pedido 8842 lo retiran el jueves y el 8843 va con el flete de siempre. Déjalo anotado.
La IA escribe las notas internas en cada pedido, firmadas con quién lo pidió.
PUT orders/{id}Resumen semanal: pedidos por cliente, ticket promedio, productos sin stock y clientes que no compraron en 60 días.
La automatización consulta la API, la IA redacta el informe y te llega por WhatsApp antes de que abras el panel.
GET ordersGET productsGET customers Cómo se maneja
Con las llaves de la tienda, pero con reglas claras
Una IA conectada a la API tiene el mismo poder que un administrador. Seis reglas la convierten en el empleado más prolijo que tuviste.
- Lectura primeroLa primera semana, solo consultas y reportes. Las escrituras, cuando confíes en cómo entiende tu tienda.
- Confirmación antes de escribirTodo cambio se anuncia y espera tu OK. En lotes grandes, tabla previa con el antes y el después.
- El token no viaja por el chatVive en una variable de entorno, en el puente MCP o en la configuración del GPT. Es la llave maestra del negocio.
- Respeta los límites120 llamadas por minuto, páginas de 100, cuerpos de hasta 5 MB. La IA pagina, espera y reintenta sola.
- Lo que la API no deja, no pasaLos pedidos no se crean por API y los clientes no se borran: dos límites de diseño que acotan cualquier error.
- Cierre con resumenQué cambió, cuántos registros, qué quedó pendiente. En los pedidos, las notas internas dejan el rastro.
Qué necesitas
Tres cosas, y la primera conexión sale en 20 minutos
La IA la eliges tú. Lo demás lo tienes en el panel o te lo activamos nosotros.
- La API activa en tu cuenta. Es un servicio adicional; hoy está disponible para negocios de Argentina y lo activamos desde soporte. Si estás en otro país, consúltanos.
- Un token Bearer, que generas en Configuración → ERP → API Token. Se muestra una sola vez y lo guardas como una contraseña maestra.
- La IA que ya usas: Claude, ChatGPT, Gemini, Copilot, Cursor o una automatización. La guía tiene el paso a paso de cada una.
Preguntas frecuentes
Lo que todos preguntan antes de conectar su IA
¿Con qué IA funciona?+
Con cualquiera que pueda llamar a una API REST o conectarse a un servidor MCP: Claude y Claude Code, ChatGPT y Codex, Gemini y Gemini CLI, Microsoft Copilot y GitHub Copilot, Grok, Mistral, DeepSeek, modelos abiertos como Llama o Qwen, editores como Cursor y plataformas como n8n, Make o Zapier. La API habla JSON sobre HTTPS con un token Bearer, el formato que todas entienden.
¿Tengo que saber programar?+
No. Con un agente con terminal (Claude Code, Codex, Gemini CLI, Copilot) alcanza con darle el token como variable de entorno y el enlace a la referencia. Si una vía necesita código, como el puente MCP o el esquema OpenAPI, lo escribe la propia IA.
¿Qué puede y qué no puede hacer?+
Puede todo lo que la API permite: productos e imágenes, precios por lista, categorías, listas de precios, clientes (alta, edición, bloqueo) y pedidos (lectura, anulación, notas internas). No crea pedidos, porque nacen en el carrito o en el panel donde se calculan precios y descuentos, y no borra clientes: los bloquea.
¿Es seguro darle acceso a la tienda?+
Tan seguro como lo seas con el token: vive fuera del chat, en una variable de entorno o en el conector, y la IA trabaja con reglas (lectura primero, confirmación antes de escribir, resumen al cerrar). Cada token tiene su límite de frecuencia, los pedidos no se crean por API y los clientes no se borran. Si crees que el token se filtró, soporte te genera uno nuevo.
¿Hay un conector MCP oficial?+
Todavía no. Hoy el camino es la API REST: los agentes con terminal la usan directo, y para las apps de chat se levanta un puente MCP que la propia IA escribe en minutos a partir de la referencia. La guía explica cómo.
¿Cuánto cuesta?+
La API es un servicio adicional de tu plan de VentasxMayor; la IA la pagas a su proveedor como ya lo haces. No hay cargo por llamada ni por volumen de la API: el límite es de frecuencia, 120 llamadas por minuto por token.
Empieza hoy
Dale las llaves de tu tienda a la IA que ya usás
Activamos la API, revisamos tu primera conexión y te dejamos las reglas listas para tu equipo.