REST plano y predecible
Endpoints con verbos HTTP claros, JSON de ida y vuelta, fechas ISO y códigos de error consistentes. Lo que tu backend espera de una API seria.
Nuevo · API abierta
Tu tienda habla con todo lo demás.
Una API REST de verdad conecta tu portal mayorista con tu ERP, tu CRM, tu herramienta de BI o esa app que mandaste a hacer. Pedidos, stock, clientes y SKUs viajan en los dos sentidos con un token Bearer — y una consola te deja probar cada endpoint sin abrir Postman.
Para el negocio que ya tiene sistemas
Tu portal no es una isla
Ya tenés un ERP que factura, un CRM que sigue a tus vendedores y tal vez un tablero de BI donde mirás todo. La tienda mayorista tiene que hablar con ellos, no vivir aparte. La API abierta le da a tu equipo técnico una puerta REST estándar para leer y escribir lo que importa — sin exportaciones a mano ni planillas que se pisan.
La consola de API
Probá cada endpoint sin abrir Postman
Adentro del panel, en Configuración → ERP, hay una consola que corre llamadas reales contra los endpoints de integración. Tu equipo pega el token, completa los parámetros, aprieta Enviar y ve la respuesta con el código HTTP coloreado y el JSON formateado. Sin cURL, sin herramientas externas.
- Llamadas reales, no simuladas: la consola pega contra tus endpoints de verdad. Probá con un negocio de prueba antes de conectar el ERP de producción.
- Resumen de arranque: URL base, flujo de autenticación, formato de fechas y códigos de error, con los pasos sugeridos para empezar.
- Estado HTTP a la vista: verde para 2xx, rojo para 4xx/5xx, y el cuerpo JSON formateado y copiable.
- cURL listo para copiar: cada endpoint trae su ejemplo de cURL — la forma más rápida de pasar la integración a un script o un job programado.
Sincronización en dos vías
El ERP lee pedidos y escribe stock. Sin planillas.
El patrón de siempre: tu sistema baja los pedidos nuevos, los factura y los marca como sincronizados; después empuja el stock y los precios de vuelta a la tienda. Cada pieza es un endpoint claro, y el ciclo se mantiene solo mientras tu job corre.
- Descarga por fecha de corte: pedí solo los pedidos nuevos desde la última corrida. Nada de traer todo cada vez.
- Cerrá el ciclo: al marcar un pedido como sincronizado deja de aparecer en pendientes — la lista no crece al infinito.
- Stock de alta frecuencia: el endpoint de stock aguanta corridas seguidas, con límites por tamaño de lote para que nada se rechace.
- Precios y cuenta corriente: actualizá la lista de precios asignada y el saldo de cada cliente mayorista desde tu ERP.
Autenticación
Un token Bearer, y listo
Cada llamada viaja con un token Bearer que identifica a tu negocio. Se genera desde la configuración, se manda en el header Authorization y la consola lo guarda en el navegador para que no tengas que pegarlo en cada prueba. Simple para arrancar, seguro para producción.
- Un header y nada más:
Authorization: Bearer …en cada request. Sin OAuth de tres pasos ni firmas complicadas. - Rotalo cuando quieras: si sospechás que un token se filtró, generá uno nuevo y el viejo deja de servir.
- Límite por token: cada token tiene su propio límite de frecuencia, así una integración no pisa a las demás.
- Solo para admins: la consola y los tokens viven en el panel de administración, no en la tienda pública.
Los endpoints
Todo lo que tu integración necesita tocar
POST
register
Registra un comprador mayorista o un vendedor desde un sistema externo — replicá el alta que ya hacés en tu ERP.
GET
pending-orders
Lista los pedidos pendientes de sincronizar desde una fecha de corte, para que el ERP los baje y procese localmente.
POST
order-synced
Marca un pedido como ya sincronizado en el ERP, con un identificador externo y el tipo de comprobante opcionales.
POST
stock-update
Envía actualizaciones de stock desde el ERP: un lote de SKUs con su cantidad disponible. El de uso más frecuente.
POST
customers
Actualiza datos de compradores: saldo de cuenta corriente, lista de precios asignada y condiciones especiales.
GET
skus
Descarga los códigos SKU de la plataforma para conciliarlos con los de tu ERP.
POST
update-skus
Envía un lote de SKUs con sus precios y datos asociados desde el ERP hacia la tienda.
POST
orders
Crea un pedido en nombre de un cliente existente — con sus precios, descuentos e impuestos calculados por el mismo motor de la tienda.
Pensada para tu equipo técnico
Una API que no te pelea
Token Bearer
Un token por negocio, en el header de cada llamada. Se rota cuando querés y cada uno lleva su propio límite de frecuencia.
Lotes en JSON
Stock, SKUs y clientes se mandan en lotes: un arreglo JSON con la estructura esperada y el ejemplo de cada endpoint como plantilla.
cURL en cada endpoint
Al pie de cada endpoint hay un cURL listo para copiar — la forma más rápida de llevar la integración a un script o a un cron.
Sandbox antes de producción
Probá con datos reales en un negocio de prueba y validá la estructura de los lotes antes de enchufar el ERP de producción.
Pedidos con el motor real
Crear un pedido desde la API pasa por el mismo motor de precios, descuentos e impuestos de la tienda. Nada de precios inventados por request.
El ciclo no se atasca
Marcá cada pedido como sincronizado y sale de pendientes. La lista se mantiene corta, sin duplicados que se acumulan.
Documentada por dentro
La propia consola es la referencia viva: resumen, parámetros y respuesta de cada endpoint, siempre al día con lo que la API hace de verdad.
Conectá lo que ya tenés
Enchufá tu portal mayorista al resto de tu operación
Dale a tu equipo técnico la API y la consola para conectar tu ERP, tu CRM o tu app a medida — y que los datos dejen de viajar a mano.