¿Por qué una API REST y no un webservice SOAP para Softland?

Si trabaja con Softland On-Premise en Chile, probablemente ha evaluado cómo acceder a los datos de su ERP desde otros sistemas. Las opciones reales son cuatro: los webservices SOAP oficiales, una conexión directa al SQL Server, Softland Balcony, o una API REST como ConexionERP.

Las cuatro funcionan. Pero no son equivalentes.

Webservices SOAP de Softland

Softland incluye un conjunto de webservices basados en SOAP (el formato XML que era estándar en los años 2000). El más conocido es ServicioWebSHG.asmx, que expone operaciones como activar licencias y subir archivos.

El problema es que estos servicios fueron diseñados para la operación interna de Softland, no para integración con sistemas externos. En la práctica:

• La documentación es escasa o inexistente.
• Las respuestas son XML, no JSON — lo que complica la integración con herramientas modernas como n8n, Power BI o cualquier framework web.
• No cubren los datos que más se necesitan: stock por bodega, saldos con crédito disponible, o listas de precios completas.
• No permiten crear documentos como Notas de Venta o clientes de forma programática.

Conexión directa a SQL Server

La otra alternativa es conectarse directamente a la base de datos de Softland. Esto funciona y es lo que muchas empresas hacen hoy para alimentar reportes.

Pero tiene riesgos:

• Seguridad: requiere abrir puertos del SQL Server y compartir credenciales que tienen acceso a toda la base de datos — lectura y escritura.
• Fragilidad: sus queries dependen de la estructura interna de las tablas de Softland. Si una actualización cambia un nombre de columna, sus reportes se rompen.
• Complejidad: calcular algo como el crédito disponible de un cliente requiere cruzar 4 capas de datos (saldo contable, facturas no centralizadas, despachos no facturados y notas de venta sin despacho). Esa lógica queda repartida en cada sistema que consulta.
• Solo lectura práctica: aunque técnicamente se puede escribir, insertar datos directamente en las tablas de Softland es peligroso y puede corromper la integridad del ERP.

Softland Balcony

Balcony es la plataforma de integración oficial de Softland. Está orientada principalmente a los productos cloud de Softland, con soporte parcial para On-Premise.

Consideraciones:

• Requiere una licencia anual adicional sobre la licencia de Softland.
• La cobertura de módulos para On-Premise es limitada — no todos los datos están disponibles.
• La documentación está en el portal de soporte de Softland (Zendesk), no siempre actualizada.
• Funciona bien si ya tiene Softland Cloud o si los endpoints que necesita están cubiertos.

API REST via ConexionERP

ConexionERP toma un enfoque distinto: se instala en su red, se conecta al SQL Server de Softland y expone los datos como endpoints REST estándar sobre HTTPS. Pero no se limita a leer.

Lectura — 34 endpoints para consultar clientes, productos, stock por bodega, precios por lista, saldos con crédito disponible y catálogos auxiliares. Todo como JSON estándar.

Escritura — Crea Notas de Venta, cotizaciones y clientes en Softland a partir de pedidos de su e-commerce. Si el cliente no existe, lo crea automáticamente con RUT, razón social, giro y dirección.

¿Por qué esto importa?

• JSON estándar: cualquier sistema que hable HTTP puede consumir los datos. Sin parsear XML, sin drivers especiales.
• Lógica centralizada: el cálculo de crédito disponible, el stock de kits, y la resolución de catálogos se hacen una sola vez. Sus sistemas reciben el dato listo.
• Sin acceso directo a SQL Server: ConexionERP es el único que toca la base de datos. Sus otros sistemas solo ven la API.
• Sin licencia adicional de Softland: no depende de Balcony ni de los webservices oficiales.
• Documentación completa: 34 endpoints documentados con ejemplos reales.

¿Cuándo conviene cada opción?

La mayoría de los casos de integración modernos — e-commerce, automatización, BI, IA — se resuelven mejor con una API REST que con los webservices SOAP, el acceso directo a SQL o una licencia adicional de Balcony.

---

Si quiere explorar las alternativas en detalle, la guía completa de API Softland compara cada opción con pros, contras y casos de uso específicos.