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 mercancía/Gestión de Compras
- 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
Estructura de envío
Inserción de documentos
El modo de envío será por medio de un formulario.
URL: http://webconekta.helisa.com:9590/KansasWS/set/document
Parámetros de entrada: 
- String json: JSON con información del documento (ver Estructura de envío, Envío asientos contables)
- 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 envío, Consulta resumen de documentos)
400 Solicitud Incorrecta:
- JSON inválido: {“error”: {“code”:4, message: “Invalid JSON”}}
- ID inválido: {“error”: {“code”:3, message: “Invalid company ID”}}
- Documento duplicado: {“error”: {“code”:5, message: “Already exists”}}
- Documento descuadrado: {“error”: {“code”:8, message: “Total debits is not equal to total credits”}}
- Códigos de emparejamiento errados: {“error”: {“code”:9, message: “Invalid match codes”}}
- Campos obligatorios incompletos: {“error”: {“code”:6, message: “Mandatory fields missing”, fields: [{“name”:”---”} , “value”: ”---”, {“name”:”---” , “value”: ”---”}]}}
- Contenido de campos incorrecto: {“error”: {“code”:7, message: “Incorrect data fields”, fields: [{“name”:”---”, “value”: ”---”}, {“name”:”---”, “value”: ”---”}]}}
Ejemplo del parámetro JSON:
- Factura de Venta Contable
{
"document": {
"date": {
"day": "01",
"month": "07",
"year": "2023"
},
"document": {
"type": "FV",
"number": "999903"
},
"transactions": [
{
"accountingClass": {
"value": "0"
},
"nature": {
"tag": "C"
},
"matchCode": "1",
"costCenter": "13PP08",
"concept": "Venta Segun Factura WCON 999903",
"value": "1000000",
"idThirdParty": "1031555400",
"account": "41350505",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "0"
},
"nature": {
"tag": "C"
},
"matchCode": "2",
"costCenter": "13PP08",
"concept": "Iva Generado 19%",
"value": "190000",
"idThirdParty": "1031555400",
"account": "240805",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "0"
},
"nature": {
"tag": "D"
},
"matchCode": "3",
"costCenter": "13PP08",
"concept": "Rete Fuente 2.5%",
"value": "25000",
"idThirdParty": "1031555400",
"account": "13551525",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "0"
},
"nature": {
"tag": "D"
},
"matchCode": "4",
"costCenter": "13PP08",
"concept": "Cuenta Por Cobrar a Clientes",
"value": "1165000",
"idThirdParty": "1031555400",
"account": "13050505",
"userCode": "1",
"taxBase": "1165000",
"accountingTransactionClient": {
"clientCode": 72232,
"idVendor": "43268147",
"paymentForm": 10,
"affectDocument": {
"type": "WCON",
"number": "999903"
}
}
},
{
"accountingClass": {
"value": "1"
},
"nature": {
"tag": "C"
},
"matchCode": "1",
"costCenter": "13PP08",
"concept": "Venta Segun Factura WCON 999903",
"value": "1000000",
"idThirdParty": "1031555400",
"account": "41350505",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "1"
},
"nature": {
"tag": "C"
},
"matchCode": "2",
"costCenter": "13PP08",
"concept": "Iva Generado 19%",
"value": "190000",
"idThirdParty": "1031555400",
"account": "240805",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "1"
},
"nature": {
"tag": "D"
},
"matchCode": "3",
"costCenter": "13PP08",
"concept": "Rete Fuente 2.5",
"value": "25000",
"idThirdParty": "1031555400",
"account": "13551525",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "1"
},
"nature": {
"tag": "D"
},
"matchCode": "4",
"costCenter": "13PP08",
"concept": "Cuenta Por Cobrar A Clientes",
"value": "1165000",
"idThirdParty": "1031555400",
"account": "13050505",
"userCode": "1",
"taxBase": "1165000"
}
]
}
}
{
"document": {
"date": {
"day": "30",
"month": "07",
"year": "2023"
},
"document": {
"type": "RC",
"number": "999903"
},
"transactions": [
{
"nature": {
"tag": "C"
},
"costCenter": "13PP08",
"concept": "Pago Factura FV-999903",
"accountingClass": {
"value": "0"
},
"value": "1165000",
"idThirdParty": "1031555400",
"account": "13050505",
"userCode": "1",
"taxBase": "1165000",
"accountingTransactionClient": {
"affectFee": "1",
"idVendor": "43268147",
"clientCode": "72232",
"affectDocument": {
"type": "FV",
"number": "999903"
},
"affectDate": {
"day": "01",
"month": "07",
"year": "2023"
}
},
"matchCode": "1"
},
{
"nature": {
"tag": "D"
},
"costCenter": "13PP08",
"concept": "Pago Factura FV-999903",
"accountingClass": {
"value": "0"
},
"value": "1165000",
"idThirdParty": "1031555400",
"account": "11050505",
"userCode": "1",
"taxBase": "0",
"matchCode": "2"
},
{
"nature": {
"tag": "C"
},
"costCenter": "13PP08",
"concept": "Pago Factura FV-999903",
"accountingClass": {
"value": "1"
},
"value": "1165000",
"idThirdParty": "1031555400",
"account": "13050505",
"userCode": "1",
"taxBase": "0",
"matchCode": "1"
},
{
"nature": {
"tag": "D"
},
"costCenter": "13PP08",
"concept": "Pago Factura FV-999903",
"accountingClass": {
"value": "1"
},
"value": "1165000",
"idThirdParty": "1031555400",
"account": "11050505",
"userCode": "1",
"taxBase": "0",
"matchCode": "2"
}
]
}
}
{
"document": {
"date": {
"day": "01",
"month": "07",
"year": "2023"
},
"document": {
"type": "FC",
"number": "888803"
},
"transactions": [
{
"accountingClass": {
"value": "0"
},
"nature": {
"tag": "D"
},
"matchCode": "1",
"costCenter": "13PP08",
"concept": "Compra Segun Factura FC 888803",
"value": "1000000",
"idThirdParty": "1031555400",
"account": "14032005",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "0"
},
"nature": {
"tag": "D"
},
"matchCode": "2",
"costCenter": "13PP08",
"concept": "Iva Generado 19%",
"value": "190000",
"idThirdParty": "1031555400",
"account": "240805",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "0"
},
"nature": {
"tag": "C"
},
"matchCode": "3",
"costCenter": "13PP08",
"concept": "Rete Fuente 2.5%",
"value": "25000",
"idThirdParty": "1031555400",
"account": "23654005",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "0"
},
"nature": {
"tag": "C"
},
"matchCode": "4",
"costCenter": "13PP08",
"concept": "Cuenta Por Pagar A Proveedores",
"value": "1165000",
"idThirdParty": "1031555400",
"account": "22050505",
"userCode": "1",
"taxBase": "1165000",
"accountingTransactionSupplier": {
"supplierCode": 36091,
"idVendor": "43268147",
"paymentForm": 10,
"affectDocument": {
"type": "WCON",
"number": "888803"
}
}
},
{
"accountingClass": {
"value": "1"
},
"nature": {
"tag": "D"
},
"matchCode": "1",
"costCenter": "13PP08",
"concept": "Compra Segun Factura FC 888803",
"value": "1000000",
"idThirdParty": "1031555400",
"account": "14032005",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "1"
},
"nature": {
"tag": "D"
},
"matchCode": "2",
"costCenter": "13PP08",
"concept": "Iva Descontable 19%",
"value": "190000",
"idThirdParty": "1031555400",
"account": "240805",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "1"
},
"nature": {
"tag": "C"
},
"matchCode": "3",
"costCenter": "13PP08",
"concept": "Rete Fuente 2.5",
"value": "25000",
"idThirdParty": "1031555400",
"account": "23654005",
"userCode": "1",
"taxBase": "1000000"
},
{
"accountingClass": {
"value": "1"
},
"nature": {
"tag": "C"
},
"matchCode": "4",
"costCenter": "13PP08",
"concept": "Cuenta Por Pagar A Proveedores",
"value": "1165000",
"idThirdParty": "1031555400",
"account": "22050505",
"userCode": "1",
"taxBase": "1165000"
}
]
}
}
{
"document": {
"date": {
"day": "30",
"month": "07",
"year": "2023"
},
"document": {
"type": "CE",
"number": "888803"
},
"transactions": [
{
"nature": {
"tag": "D"
},
"costCenter": "13PP08",
"concept": "Pago Factura FC-999903",
"accountingClass": {
"value": "0"
},
"value": "1165000",
"idThirdParty": "1031555400",
"account": "22050505",
"userCode": "1",
"taxBase": "1165000",
"accountingTransactionSupplier": {
"affectFee": "1",
"idVendor": "43268147",
"supplierCode": "36091",
"affectDocument": {
"type": "WCON",
"number": "888803"
},
"affectDate": {
"day": "01",
"month": "07",
"year": "2023"
}
},
"matchCode": "1"
},
{
"nature": {
"tag": "C"
},
"costCenter": "13PP08",
"concept": "Pago Factura FC-999903",
"accountingClass": {
"value": "0"
},
"value": "1165000",
"idThirdParty": "1031555400",
"account": "11050505",
"userCode": "1",
"taxBase": "1165000",
"matchCode": "2"
},
{
"nature": {
"tag": "D"
},
"costCenter": "13PP08",
"concept": "Pago Factura FC-999903",
"accountingClass": {
"value": "1"
},
"value": "1165000",
"idThirdParty": "1031555400",
"account": "22050505",
"userCode": "1",
"taxBase": "1165000",
"matchCode": "1"
},
{
"nature": {
"tag": "C"
},
"costCenter": "13PP08",
"concept": "Pago Factura FC-999903",
"accountingClass": {
"value": "1"
},
"value": "1165000",
"idThirdParty": "1031555400",
"account": "11050505",
"userCode": "1",
"taxBase": "1165000",
"matchCode": "2"
}
]
}
}
Diccionario de palabras:
- Documento para clientes
- Documento para proveedores
| Name | Position |
|---|
| Name | Position |
|---|