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 ordenes de compra
El modo de envío será por medio de un formulario.
URL: http://webconekta.helisa.com:9590/KansasWS/set/purchase-order
Parámetros de entrada:
- String json: JSON con información del documento (ver Estructura de envío, Envío asientos contables)
- int year: Año de inserción
- 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”}}
- Producto duplicado: {“error”: {“code”:5, message: “Already exists”}}
- 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:
{
"purchaseOrder": {
"accountingDocument": {
"type": "OC",
"number": "1"
},
"date": {
"day": 01,
"month": 09,
"year": 2022
},
"questionGlobal": [
{
"question": "Pregunta Global",
"answer": "Respuesta Global"
},
{
"question": "Pregunta Global",
"answer": "Respuesta Global"
}
],
"supplierIdentity": "26519525",
"documentCost": "0302",
"idVendor": "9999999",
"transactions": [
{
"question": "Pregunta transaccion",
"answer": "Respuesta transaccion",
"kind": 1,
"costCenter": 0101,
"quantity": 35,
"idProduct": 10779,
"measure": 1,
"unitValue": 16000,
"totalValue": 560000,
"priceList": 1,
"rawValue": 15780,
"idWarehouse": 1
}
]
}
}
Diccionario de palabras:
Campo JSON | Descripción |
---|