VentasxMayor tiene una API REST para que conectes tu propio sistema y manejes productos, categorías, listas de precios, clientes y pedidos desde afuera del panel. Es lo que usás si querés cargar productos desde otra aplicación, sincronizar con un desarrollo propio o automatizar tareas que hoy hacés a mano.
Paso a paso
- En el menú lateral, andá a Configuración → ERP.
- Elegí la opción API Token entre las integraciones disponibles.
- Generá el token desde esa misma tarjeta. Guardalo apenas lo veas: es la credencial de tu negocio.
- Desde tu sistema, mandá cada pedido HTTP con el encabezado
Authorization: Bearer <tu-token>. - Apuntá tus llamadas a
/api/v1/sobre el dominio de tu tienda.
En la misma tarjeta tenés el enlace a la documentación técnica completa, con el detalle de cada campo.
Qué podés hacer
La API trabaja sobre cinco recursos. Los productos se direccionan por su código; los demás, por su id.
| Recurso | Podés |
|---|---|
/api/v1/products | listar, crear, leer, modificar y eliminar |
/api/v1/products/{codigo}/images | agregar y eliminar imágenes |
/api/v1/products/{codigo}/prices | leer y escribir los precios por lista |
/api/v1/categories | listar, crear, leer, modificar y eliminar |
/api/v1/price-lists | listar, crear, leer, modificar y eliminar |
/api/v1/customers | listar, crear, leer y modificar |
/api/v1/orders | listar, leer y modificar |
Dos límites de diseño que conviene tener claros antes de empezar:
- Los pedidos no se crean por la API. Se leen y se modifican. Un pedido nace en el carrito de tu tienda o desde el panel, porque ahí es donde se resuelven precios, listas y descuentos.
- Los clientes no se eliminan por la API. Se crean, se leen y se modifican.
Límites y códigos de error
- 120 llamadas por minuto por token y por método. Si te pasás, recibís
429. - 5 MB de tamaño máximo de cuerpo. Más que eso devuelve
413.
| Código | Qué pasó |
|---|---|
400 | el cuerpo no es JSON válido |
401 | falta el token o no es válido |
403 | el servicio de API no está activo en tu cuenta |
404 | la ruta no existe, o el negocio no existe |
405 | la ruta existe pero no con ese método |
409 | el recurso cambió mientras lo editabas: volvé a leerlo y reintentá |
413 | el cuerpo supera los 5 MB |
422 | los datos no pasaron la validación |
429 | superaste el límite de llamadas por minuto |
Si algo no aparece
- No ves la opción API Token en Configuración → ERP. Hoy la API se ofrece únicamente a negocios de Argentina. En otros países la opción no se muestra.
- Tenés el token pero todas las llamadas devuelven
403. La API es un servicio que se contrata aparte. Si se dio de baja o nunca se activó, el token existe pero no habilita nada. Escribinos para activarlo. - Te aparece
401con un token que antes funcionaba. Revisá que el encabezado viaje comoAuthorization: Bearer <token>, sin comillas ni espacios de más.
Consejos
- Guardá el token como un secreto de tu aplicación, igual que una contraseña. Quien lo tenga puede leer y escribir el catálogo y los clientes de tu negocio.
- Usá siempre el código del producto como identificador estable. Es el mismo que usás en tu inventario y en tus pedidos mayoristas, y no cambia aunque edites el producto.
- Si vas a cargar muchos productos de una vez, respetá el límite por minuto y espaciá las llamadas. Es más rápido un lote ordenado que reintentar sobre
429. - Para una carga inicial grande de catálogo, evaluá antes la importación desde planilla: resuelve el mismo problema sin escribir código.