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 pedidos
El modo de envío será por medio de un formulario.
URL: http://webconekta.helisa.com:9590/KansasWS/set/order
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:
- Pedido de servicio:
{
"order": {
"accountingDocument": {
"type": "PD",
"number": "1"
},
"date": {
"day": 01,
"month": 09,
"year": 2022
},
"questionGlobal": [
{
"question": "Preguntas Globales",
"answer": "Respuestas Globales"
}
],
"clientIdentity": "1077974506",
"clientCode": "1393",
"idVendor": "9999999",
"generalCost": "0302",
"transactions": [
{
"question": "Preguntas por transaccion",
"answer": "Respuestas por transaccion",
"kind": 2,
"quantity": 1,
"particularCost": "0101",
"idProduct": 10779,
"measure": 1,
"ivaRate": "19",
"ivaValue": "2090",
"unitValue": 11000,
"totalValue": 13090,
"priceList": 1,
"rawValue": 0,
"idWarehouse": 1
}
]
}
}
{
"order": {
"accountingDocument": {
"type": "PD",
"number": "2"
},
"date": {
"day": 01,
"month": 09,
"year": 2022
},
"questionGlobal": [
{
"question": "Preguntas Globales",
"answer": "Respuestas Globales"
}
],
"clientIdentity": "1077974506",
"clientCode": "1393",
"idVendor": "9999999",
"generalCost": "0302",
"transactions": [
{
"question": "Preguntas por transaccion",
"answer": "Respuestas por transaccion",
"kind": 1,
"quantity": 18,
"particularCost": "0101",
"idProduct": 10779,
"measure": 1,
"ivaRate": "19",
"ivaValue": "37620",
"unitValue": 11000,
"totalValue": 235620,
"priceList": 1,
"rawValue": 10500,
"idWarehouse": 1
}
]
}
}
Diccionario de palabras:
Campo JSON | Descripción |
---|