Especificaciones técnicas
Descripción de la arquitectura
Firma de seguridad entre conexión Helisa y App Externa
Esquema de respuestas
Estructura de envío / WEBSERVICE
- Consulta de cuentas
- Consulta de existencias de un producto
- Consulta estado de cartera de cliente
- Consulta movimiento de inventario
- Inserción de documentos
- Inserción de entrada de mercancia/Inventario
- Inserción de ordenes de compra
- Inserción de pedidos
- Inserción de productos
- Inserción de remisiones
- Inserción y actualización de acreedores
- Inserción y actualización de clientes
- Inserción y actualización de terceros
- Lectura balance general
- Lectura de cartilla de centros de costo
- Lectura de cartilla de productos
- Lectura de cartilla de terceros, clientes y proveedores
- Lectura resumen de documentos
- Lectura saldos de una cuenta por terceros
- Lectura de Listas de precios
- Lectura detalle de facturas electrónicas
Estructura de envío
Lectura detalle de facturas electrónicas
El modo de envío será por medio de un formulario.
URL: http://webconekta.helisa.com:9590/KansasWS/summary/billDetails
Parámetros de entrada: 
- String json: JSON con rango de fechas de consulta.
- String id: Código de la empresa a consultar.
- String sign: Firma de seguridad, lo firmado será el JSON.
Salida: (ver Esquema de respuestas) 
- 200 Ok: (ver estructura de salida del servicio)
-
400 Solicitud Incorrecta:
- JSON inválido: {“error”: {“code”:4, message: “Invalid JSON”}}
- ID inválido: {“error”: {“code”:3, message: “Invalid company ID”}}
- Campos obligatorios incompletos: {“error”: {“code”:6, message: “Mandatory fields missing”, fields: [{“name”:”---” , “value”: ”---”}]}}
- Contenido de campos incorrecto: {“error”: {“code”:7, message: “Incorrect data fields”, fields: [{“name”:”---”, “value”: ”---”}]}}
Ejemplo del parámetro JSON: 
{
"date": {
"day": 1,
"month": 1,
"year": 2026
},
"dateEnd": {
"day": 31,
"month": 1,
"year": 2026
}
}
Ejemplo de salida: 
{
"billDetails": [
{
"rdocTipo": "FV",
"rdocConsecutivo": "00000123",
"rdocFecha": "2026-01-12",
"rvendedorIdentidad": "123456789",
"rvendedorNombre": "VENDEDOR DEMO",
"rterIdentidad": "900123456",
"rterNombre": "CLIENTE DEMO SAS",
"rterDireccion": "CRA 1 # 2-3",
"rterTelefono": "6011234567",
"rterEmail": "[email protected]",
"rterNumeroMovil": "3001234567",
"rterCiudadNombre": "BOGOTA",
"rdetCentroCostoNombre": "PRINCIPAL",
"rdocOrigen": "FACTURACION",
"rdetCantidad": 2,
"rdetVrBase": 100000,
"rdetVrBruto": 119000,
"rdetVrUnitario": 50000,
"rdetVrTotal": 100000,
"rdetVrDescuento": 0,
"rdetListaPrecioNombre": "LISTA GENERAL",
"rdetBodegaNombre": "BODEGA PPAL",
"rartReferencia": "REF-001",
"rartCodigoBarras": "7701234567890",
"rdetClaseConcepto": "PRODUCTO",
"rdetCodigo": 10,
"rdetSubNombre": "SUBLINEA",
"rdetNombreConcepto": "PRODUCTO DEMO",
"rartTipoArticuloSer": "A",
"rartGrupoNombre": "GRUPO 1",
"rartFamiliaNombre": "FAMILIA 1",
"rartReconocido": "S"
}
]
}
Diccionario de palabras:
- Parámetro JSON

- Salida JSON

| Campo JSON | Descripción |
|---|
| Campo JSON | Descripción |
|---|