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
- Lecturax saldos de una cuenta por tercerosx
- Lectura de Listas de precios
Estructura de envío
lectura de cartilla de terceros clientes y proveedores
El modo de envío será por medio de un formulario.
URL: http://webconekta.helisa.com:9590/KansasWS/get/thirdParty2_0
Parámetros de entrada: 
- int year: Año de trabajo a consultar.
- String identity: Documento de identificación del tercero.
- String id: Código de la empresa a consultar.
- long date: Fecha y hora de petición (Milisegundos).
- String sign: Firma de seguridad, lo firmado será la concatenación en string de year, identity y date separados por pipe (|).
Salida: (ver Esquema de respuestas)
- 200 Ok: (ver Estructura de envío, Envío de cuentas)
400 Solicitud Incorrecta:
- Year inválido: {“error”: {“code”:2, message: “Invalid year”}}
- ID inválido: {“error”: {“code”:3, message: “Invalid company ID”}}
Ejemplo de salida de json
- Terceros
{
"thirdParty": {
"secondLastName": "Apellido2",
"cree": false,
"serialversionuid": 1,
"clients": [],
"address": "CALLE 45",
"suppliers": [],
"economicActivity": 1311,
"city": "05001",
"documentType": {
"tag": "C"
},
"nature": {
"value": 0
},
"year": 2022,
"telephones": "3234840257",
"firstName": "Nombre2",
"firstLastName": "Apellido1",
"name": "Name No. 1",
"cellphone": "4954800",
"transactionCount": 1,
"id": "1030613839",
"checkDigit": "",
"regimen": {
"tag": "C"
},
"email": "[email protected]",
"secondName": "Nombre1"
}
}
{
"thirdParty": {
"secondLastName": "1",
"cree": true,
"serialversionuid": 1,
"clients": [
"serialversionuid": 1,
"applyMaxRteIca": "S",
"code": 72232,
"paymentForm": 10,
"city": "05001",
"priceListArticules": 2,
"telephones": "3015604484",
"businessName": "",
"applyRteFte": "S",
"idVendor": " 43268147",
"priceListServices": 1,
"free2": " Detalle_Campo_Libre_2",
"portfolio": 1,
"zone": "Detalle_Zona",
"maxCredit": 150000,
"free1": "Detalle_Campo_Libre_1",
"cellphone": "3216940073",
"fax": "1564891578",
"email": "[email protected]",
"group": "Detalle_Grupo",
"fiscalRegime": 49,
"fiscalResponsibility": 100,
"address": "Carrera 30 #45-00",
"accountPortfolio": "1305051",
"contactEmail": "[email protected]",
"contactName": " Cliente No. 11",
"discountLine": {
"discountClassLine": "P",
"discountPlanLine": "M",
"discountVariableLine": 50
},
"additionalDiscountLine": {
"additionalLineDiscountPlan": "M",
"additionalLineDiscountVariable": 3,
"additionalLineDiscountClass": "P"
},
"additionalDiscount": {
"additionalDiscountClass": "P",
"additionalDiscountVariable": 10
},
"applyMaxRteFte": "S",
"discountTotal": {
"handleTotalDiscount": "S",
"discountClassTotal": "V",
"discountVariableTotal": 15000
},
"toleranceDays": 60,
"contactPhone": "3216940011",
"applyMaxRteIva": "S"
}
],
"address": "Carrera 30 #45-00",
"suppliers": [],
"economicActivity": 10,
"city": "05001",
"documentType": {
"tag": "C"
},
"nature": {
"value": 0
},
"year": 2022,
"telephones": "3015604484",
"firstName": "Cliente",
"firstLastName": "1",
"name": "Cliente No. 1",
"cellphone": "3216940073",
"transactionCount": 2,
"id": "1077976051",
"checkDigit": "",
"regimen": {
"tag": "O"
},
"email": "[email protected]",
"secondName": "Cliente"
}
}
{
"thirdParty": {
"secondLastName": "1",
"cree": false,
"serialversionuid": 1,
"clients": [],
"address": "Cll 14 # 20-46 apto 506",
"suppliers": [
{
"serialversionuid": 1,
"code": 484,
"address": "Cll 14 # 20-46 apto 506",
"city": "05001",
"telephones": "7894526",
"selfRetainer": false,
"zone": "Zona",
"postalCodeX": "0001",
"cellphone": "3216940073",
"areaIca": " ",
"supplierType": 1,
"fax": "1564891578",
"email": "[email protected]"
}
],
"economicActivity": 10,
"city": "05001",
"documentType": {
"tag": "C"
},
"nature": {
"value": 0
},
"year": 2022,
"telephones": "7894526",
"firstName": "Supplier",
"firstLastName": "1",
"name": "Supplier No. 1",
"cellphone": "3216940073",
"transactionCount": 2,
"id": "26515259",
"checkDigit": "",
"regimen": {
"tag": "C"
},
"email": "[email protected]",
"secondName": "Supplier"
}
}
Diccionario de palabras:
| Name | Position |
|---|