Consultar stock por bodega de Softland vía API
Softland gestiona inventario en múltiples bodegas, pero no ofrece una forma nativa de exponer ese dato a sistemas externos. ConexionERP resuelve esto con endpoints REST que retornan stock desglosado por bodega, incluyendo cálculo automático de kits.
El problema
Por qué consultar stock en Softland es difícil
Obtener el stock real de un producto en Softland no es tan simple como leer un campo. Hay varias razones por las que las empresas terminan con datos desactualizados o incompletos.
Múltiples bodegas
El stock de un producto puede estar distribuido en 5, 10 o 20 bodegas. Necesita el desglose por cada una, no solo el total.
Productos kit sin cálculo nativo
Si un producto es un kit (compuesto por otros productos), el stock disponible depende del componente con menor existencia. Ese cálculo no está disponible de forma directa.
Sin API nativa para sistemas externos
Softland On-Premise no expone un endpoint REST para consultar stock. Los sistemas externos — e-commerce, dashboards, ERPs secundarios — no tienen forma estándar de obtener este dato.
Exportaciones manuales se desactualizan
Exportar stock a Excel o CSV es una foto del momento. Minutos después de exportar, un despacho o recepción ya cambió las cantidades. Para decisiones en tiempo real, no sirve.
Endpoints
Lo que entrega la API de stock
ConexionERP expone tres endpoints para consultar stock. Todos retornan JSON, aceptan filtro por bodega y calculan automáticamente el stock de productos kit.
Filtro por bodega
Todos los endpoints aceptan el parámetro bodega para limitar la respuesta a una bodega específica. Si no se envía, retorna todas las bodegas.
Soporte de productos kit
Si el producto es un kit, la respuesta incluye el campo Componentes con cada producto que lo compone, la cantidad requerida y el stock disponible. El StockTotal se calcula automáticamente.
Ejemplo
Respuesta de stock por bodega
Una consulta a GET /api/v1/productos/NOTEBOOK-HP/stock retorna el stock total del producto y el desglose por cada bodega donde tiene existencia.
{ "data": { "CodProd": "NOTEBOOK-HP", "DesProd": "Notebook HP 15-dw3", "EsKit": false, "StockTotal": 142, "Bodegas": [ { "CodBode": "01", "DesBode": "Bodega Central Santiago", "Stock": 85 }, { "CodBode": "02", "DesBode": "Bodega Viña del Mar", "Stock": 37 }, { "CodBode": "03", "DesBode": "Bodega Concepción", "Stock": 20 } ] } }
Casos de uso
Dónde se usa este dato
E-commerce
Sincronizar stock con WooCommerce, Shopify o VTEX para evitar sobreventa.
Antes de confirmar un pedido online, consulte el stock real en la bodega de despacho. Si el producto no tiene existencia suficiente, bloquee la compra o marque como agotado automáticamente.
Power BI / Google Sheets
Dashboards de inventario sin acceso directo a SQL.
Conecte sus reportes de inventario directamente a la API. Obtenga stock por bodega actualizado sin exportar archivos, sin acceso a la base de datos y sin depender del equipo de TI.
Automatización
Alertas cuando el stock baja de un umbral.
Con n8n, Make o Zapier, programe consultas periódicas. Si el stock de un producto en una bodega cae bajo el mínimo, envíe una alerta al equipo de compras o logística.
Preguntas frecuentes
¿Se puede filtrar por bodega?
Sí. Los endpoints de stock aceptan el parámetro bodega para limitar la consulta a una bodega específica. Si no se envía, retorna el stock de todas las bodegas.
¿Qué pasa con productos kit?
Si el producto es un kit, la API retorna cada componente con la cantidad requerida y el stock disponible. El StockTotal del kit se calcula automáticamente en base al componente más restrictivo.
¿El stock se actualiza en tiempo real?
ConexionERP consulta Softland en vivo en cada request. Los datos son tan frescos como los del ERP: si alguien acaba de registrar un movimiento en Softland, la siguiente consulta ya lo refleja.
¿Puedo consultar stock de todos los productos a la vez?
Sí. El endpoint GET /api/v1/stock retorna el stock consolidado de todos los productos. Para el desglose por bodega, use GET /api/v1/stock/bodegas.
¿Necesita consultar stock de Softland desde otro sistema?
ConexionERP entrega stock desglosado por bodega con una sola consulta REST. Implementación en 1 hora.