Consultar Stock por Bodega de Softland via API
Softland gestiona inventario en multiples bodegas, pero no ofrece una forma nativa de exponer ese dato a sistemas externos. ConectaERP resuelve esto con endpoints REST que retornan stock desglosado por bodega, incluyendo calculo automatico de kits.
El problema
Por que consultar stock en Softland es dificil
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.
Multiples 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 calculo nativo
Si un producto es un kit (compuesto por otros productos), el stock disponible depende del componente con menor existencia. Ese calculo no esta 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 estandar de obtener este dato.
Exportaciones manuales se desactualizan
Exportar stock a Excel o CSV es una foto del momento. Minutos despues de exportar, un despacho o recepcion ya cambio las cantidades. Para decisiones en tiempo real, no sirve.
Endpoints
Lo que entrega la API de stock
ConectaERP expone tres endpoints para consultar stock. Todos retornan JSON, aceptan filtro por bodega y calculan automaticamente el stock de productos kit.
Filtro por bodega
Todos los endpoints aceptan el parametro bodega para limitar la respuesta a una bodega especifica. Si no se envia, 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 automaticamente.
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 Concepcion", "Stock": 20 } ] } }
Casos de uso
Donde 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 automaticamente.
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.
Automatizacion
Alertas cuando el stock baja de un umbral.
Con n8n, Make o Zapier, programe consultas periodicas. Si el stock de un producto en una bodega cae bajo el minimo, envie una alerta al equipo de compras o logistica.
Preguntas frecuentes
¿Se puede filtrar por bodega?
Si. Los endpoints de stock aceptan el parametro bodega para limitar la consulta a una bodega especifica. Si no se envia, retorna el stock de todas las bodegas.
¿Que 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 automaticamente en base al componente mas restrictivo.
¿El stock se actualiza en tiempo real?
ConectaERP 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?
Si. 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?
ConectaERP entrega stock desglosado por bodega con una sola consulta REST. Implementacion en 1 hora.