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 y actualización de clientes
El modo de envío será por medio de un formulario.
URL: http://webconekta.helisa.com:9590/KansasWS/set/client2_0
Parámetros de entrada:
- String json: JSON con información del tercero (ver Estructura de envío, Envío de terceros)
- 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, Envío de cuentas)
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”: ”---”}, {“name”:”---” , “value”: ”---”}]}}
- Contenido de campos incorrecto: {“error”: {“code”:7, message: “Incorrect data fields”, fields: [{“name”:”---”, “value”: ”---”}, {“name”:”---”, “value”: ”---”}]}}
Ejemplo del parámetro JSON:
{
"client": {
"portfolio": 1,
"id": "1077974506",
"checkDigit": "",
"documentType": {
"tag": "C"
},
"name": "Cliente No. 1",
"address": "Carrera 30 #45-00",
"telephones": "3015604484",
"cellphone": "3216940073",
"fax": "1564891578",
"city": "05001",
"email": "[email protected]",
"zone": "Detalle_Zona",
"group": "Detalle_Grupo",
"free1": "Detalle_Campo_Libre_1",
"free2": " Detalle_Campo_Libre_2",
"toleranceDays": 60,
"maxCredit": 150000,
"regimen": {
"tag": "O"
},
"paymentForm": 6,
"cree": true,
"economicActivity": 10,
"nature": {
"value": 0
},
"firstName": "Cliente",
"secondName": "Cliente",
"firstLastName": "1",
"secondLastName": "1",
"year": 2022,
"applyRteFte": "S",
"applyMaxRteFte": "S",
"applyMaxRteIva": "S",
"applyMaxRteIca": "S",
"fiscalResponsibility": 7,
"fiscalRegime": 48,
"businessName": "Cliente No. 1",
"taxLiability": 0,
"contactName": " Cliente No. 1",
"contactPhone": "3216940073",
"contactEmail": "[email protected]",
"accountPortfolio": "130505",
"idVendor": "9999999",
"priceListServices": 1,
"priceListArticules": 2
}
}
Diccionario de palabras:
Name | Position |
---|