Producto
Cómo funciona ConexionERP
Se instala en su red, se conecta a Softland y responde consultas por HTTPS. Sin modificar su ERP.
Flujo
De la consulta al dato en milisegundos
Su sistema hace una consulta HTTP. ConexionERP la recibe, consulta Softland, y devuelve los datos en formato estándar. Todo por HTTPS.
Su sistema envía una consulta
Cualquier aplicación que hable HTTP: e-commerce, BI, app interna, n8n, Zapier, Power BI.
ConexionERP consulta Softland
Valida la clave de acceso, consulta los datos solicitados a Softland y los convierte a JSON.
Su sistema recibe los datos
Respuesta JSON estándar con los datos de Softland, listos para usar.
Detalle técnico
Lo que su equipo técnico necesita saber
Autenticación
Clave en el header X-Api-Key con prefijo ws_. Sin OAuth ni flujos complejos. Cada clave se puede asociar a un sistema específico.
Formato de respuesta
JSON con campos en PascalCase consistentes. Dato único: { "data": {...} }. Listado: { "data": [...], "pagination": {...} }.
Paginación
50 registros por defecto, máximo 200. Parámetros page y limit en query string.
Rate limit
100 consultas por minuto por clave. Si se excede, HTTP 429 con código RATE_LIMITED.
Errores estructurados
7 códigos: BAD_REQUEST, UNAUTHORIZED, NOT_FOUND, CONFLICT, VALIDATION_ERROR, RATE_LIMITED, INTERNAL_ERROR. Cada error incluye código y mensaje descriptivo.
Filtros disponibles
Auxiliares: tipo, rut, nombre, email. Productos: grupo, subgrupo, activo. Stock: bodega. Todos opcionales.
Soporte para kits
Si un producto es kit, el endpoint de stock devuelve los componentes con cantidad requerida y stock disponible. StockTotal se calcula automáticamente.
Alias de clientes
Los endpoints /clientes son un alias de /auxiliares que filtra automáticamente por tipo=cliente. Misma respuesta, ruta más intuitiva.
Requisitos
Lo que necesita para empezar
La implementación toma aproximadamente 1 hora de configuración remota y se hace en conjunto con nuestro equipo.
¿Tiene preguntas técnicas?
Nuestro equipo puede resolver sus dudas técnicas y planificar la implementación.