agosto 25, 2025

Integración de APIS Datalife

Innovaciones, Optimizaciones y Nuevas Funcionalidades del Ecosistema AS2

Manual de Procedimientos para Mejoras y Actualizaciones 

Ecosistema AS2 

Este manual documenta de manera detallada los procesos de cambio, optimización o actualización implementados en las soluciones del Ecosistema AS2. 

CAMBIOS, MEJORAS O ACTUALIZACIONES 

SISTEMA: AS2 ERP 

ANTECEDENTES 

Actualmente, el sistema AS2-ERP, cuenta con integración de Datalife (Sistema de talento Humano). 

OBJETIVO 

  • Validar y agregar campos en el API “Guardar Asientos”. 
  • Realizar la integración de los comprobantes contables (rol, finiquitos), vía API, para la organización. 

DESARROLLO 

  1. APIs 

Se cuanta con una estructura de datos para DataLife en las APIS para la integración contable. 

Desde la herramienta del Postman, podemos ver los Apis a emplear. 

En la API llamada “Guardad Asiento”, se valida lo siguiente: 

  • Los campos “descripción” y documento Referencia”, existen y están funcionando 
  • Se agrega campo “descripcion2”, no requerido obligatoriamente. 
  • Se agrega campo “beneficiario”, no requerido obligatoriamente. 

Los campos antes mencionados Pueblan la base datos: 

  • El campo “descripción” y se guarda en la columna descripción de la tabla detalle_asiento
  • El campo “descripcion2” se guarda en la columna descripción2 de la tabla detalle_asiento
  • El campo “beneficiario” se guarda en la columna beneficiario de la tabla detalle_asiento y de la tabla movimiento_bancario
  • El campo “documentoReferencia” se guarda en la columna documento_referencia de la tabla movimiento_bancario

Ejemplo del API’s “Guardar Asiento”. Con los nuevos campos agregados. 

Al enviar la nuestra consulta, podemos ver en la respuesta la creación de nuestro Asiento contable. 

Con el numero “ROL-00002”, podemos ver la informacion de nuestro asiento, en nuestro sistema AS2-ERP 

Pantalla: /paginas/financiero/contabilidad/procesos/asientoContable.jsf 

Al editar, podemos ver los detalles del asiento 

Solo se creará Movimiento Bancario en el asiento, cuando la cuenta contable es de tipo “Banco  

Pantalla: /paginas/financiero/contabilidad/configuracion/cuentaContable.jsf 

La documentación y detalles de APIs, se encuentra en el siguiente URL: 

DATALIFE  
 
 

Se realizan validaciones de los siguientes puntos en ambientes UAT con la documentación adjunta en la URL compartida: 

  • API de Login 
  • API de Obtener Lista Cuentas Contables 
  • API de Obtener Lista Dimensiones Contables 
  • API de Guardar Asientos, considerar: 
  • Que la información se guarde en los campos indicados. 
  • Si se envía un código o valor que no existe en el AS2, el api debe retornar el error respectivo, por ejemplo, al enviar códigos de cuantas contables, dimensiones, nombre de tipo de asiento. 
  • Tener en cuenta que la dimensión contable la usa y válida si tiene activo el check de “validar dimensión”. 
  • Si no se envía un dato que es requerido, el API debe mostrar el mensaje de error respectivo. 
  • Si no se envía, o se envía en null o blanco, los nuevos campos “descripción 2” y “beneficiario”, el funcionamiento actual de la API no debería verse afectado, no debe dar error. 
  • En la documentación de la API se agregan la información de los nuevos campos. 
  • API de Anular de Asientos 
  • Importante: Validar la documentación de las APIS “DATALIFE” que contiene las modificaciones. 
  1. CONSIDERACIONES 
  • Revisar la documentación aloja en la URL.