ada:konectanominaelectronica

Nomina Electronica

Configuracion del Servidor WildFly: Añadir en standalone.xml datasources NOMINADS, INTEGRACION y CONFIGFENEDS

NOMINADS: <datasource jta=“true” jndi-name=“java:/NOMINADS” pool-name=“NOMINADS” enabled=“true” use-ccm=“true”>

  <connection-url>jdbc:oracle:thin:@ip:puertp:servicename</connection-url>
  <driver>OracleJDBCDriver</driver> 
      <security>
          <user-name>PEDIRLO A QUIEN CORRESPONDA</user-name> 
          <password>PEDIRLO A QUIEN CORRESPONDA</password>
      </security> 
      <validation>
          <valid-connection-checker class- name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleValidConnectionChecker"/>
          <stale-connection-checker class- name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleStaleConnectionChecker"/>
          <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleExceptionSorter"/>
      </validation>

</datasource>

INTEGRACION: <datasource jta=“true” jndi-name=“java:/INTEGRACION” pool-name=“INTEGRACION” enabled=“true” use-ccm=“true”>

  <connection-url>jdbc:oracle:thin:@ip:puertp:servicename</connection-url>
  <driver>OracleJDBCDriver</driver> 
      <security>
          <user-name>PEDIRLO A QUIEN CORRESPONDA</user-name> 
          <password>PEDIRLO A QUIEN CORRESPONDA</password>
      </security> 
      <validation>
          <valid-connection-checker class- name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleValidConnectionChecker"/>
          <stale-connection-checker class- name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleStaleConnectionChecker"/>
          <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleExceptionSorter"/>
      </validation>

</datasource>

CONFIGFENEDS: <datasource jta=“true” jndi-name=“java:/INTEGRACION” pool-name=“INTEGRACION” enabled=“true” use-ccm=“true”>

  <connection-url>jdbc:oracle:thin:@ip:puertp:servicename</connection-url>
  <driver>OracleJDBCDriver</driver> 
      <security>
          <user-name>PEDIRLO A QUIEN CORRESPONDA</user-name> 
          <password>PEDIRLO A QUIEN CORRESPONDA</password>
      </security> 
      <validation>
          <valid-connection-checker class- name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleValidConnectionChecker"/>
          <stale-connection-checker class- name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleStaleConnectionChecker"/>
          <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleExceptionSorter"/>
      </validation>

</datasource>

Crear el driver: <driver name=“OracleJDBCDriver” module=“com.oracle”>

  <driver-class>oracle.jdbc.OracleDriver</driver-class>

</driver>

CONFIGURACIONES ESPECIALES 1/1 En la ruta definida por la propiedad de sistema creada en el standalone.xml (CONFIG_PATH), crear una carpeta en la ruta adafe_home/com/ada/adafe/certificado, y asegurarse que el usuario que ejecuta el servidor tiene acceso de escritura. En esa ruta se almacenará la información de los clientes de nómina. Una vez terminadas las configuraciones desplegar el artefacto NominaElectronica.war en el servidor wildfly.

BASE DE DATOS DE CONFIGURACIÓN Nómina Electrónica usa tablas de configuración alimentadas por otras aplicaciones, para acceder a ellas, tal como se explica en la sección anterior, se utilizan los datasources configurados en el servidor a través de la aplicación apiRestConfig. Es importante recordar que las credenciales proporcionadas para los datasources tengan acceso a todos los schemas requeridos. En esta sección se detallan los campos claves para el correcto funcionamiento de los servicios web que Nómina Electrónica publica para su consumo. TABLA INTEGRACION.TBL_FE_CONEXION_CLIENTE En esta tabla se almacena la información relevante a los datos necesarios para que el cliente interactúe con la DIAN y el software pueda acceder a los datos de los empleados del cliente. Cada cliente tiene su cadena de conexión a base de datos guardada en esta tabla, y el software dinámicamente utiliza la cadena de conexión para acceder a los datos del cliente. Los campos NE_URL, NEV_URL y NUMERACION_URL hacen referencia a dianWsRest y deben tener la siguiente estructura:


CAMPO		VALOR

NE_URL		URL_WSREST/dianWsRest/v1/nomina

NEV_URL		URL_WSREST/dianWsRest/v1/habilitacion

NUMERACION_URL		URL_WSREST/dianWsRest/v1/numeracion

Donde URL_WSREST es la url donde se ha desplegado dianWsRest.war Por ejemplo, si dianWsRest.war se ha desplegado en el mismo servidor donde se va a desplegar Nómina y el servidor está accesible en la IP 127.0.0.1 puerto 8080, los valores serían:


NE_URL		http://127.0.0.1:8080/dianWsRest/v1/nomina

NEV_URL		http://127.0.0.1:8080/dianWsRest/v1/habilitacion

NUMERACION_URL		http://127.0.0.1:8080/dianWsRest/v1/numeracion

SERVICIOS PUBLICADOS

nomina/NominaGeneral “/nomina/NominaGeneral/{codigoCliente}/{codigoMEmpresa}/{periodo}/{tipoArchivo}” Servicio para enviar a la DIAN las nóminas de todos los empleados del cliente de un determinado periodo.

Ejemplo de uso:

http://10.1.140.102:8081/NominaElectronica/nomina/NominaGeneral/ADA_TESTNE/9999999999/202004/1/ codigoCliente =ADA_TESTNE codigoMEmpresa = 9999999999 periodo = 202004 tipoArchivo = 1

NominaIndividual “/nomina/NominaIndividual/{codigoCliente}/{codigoMEmpresa}/{periodo}/{tipoArchivo} /{codigoEmpleado}” Servicio para enviar la nómina de un empleado en específico.

Ejemplo de uso: http://10.1.140.102:8081/NominaElectronica/nomina/NominaIndividual/ADA_TESTNE/9999999999/202004/1/10 codigoCliente =ADA_TESTNE codigoMEmpresa = 9999999999 periodo = 202004 tipoArchivo = 1 codigoEmpleado = 10

NominaDeAjuste “/nomina/NominaDeAjuste/{codigoCliente}/{codigoMEmpresa}/{periodo}/{tipoArchivo} Servicio para modificar o eliminar las nóminas de los empleados preparados en la base de datos

Ejemplo de uso: http://10.1.140.102:8081/NominaElectronica/nomina/NominaDeAjuste/ADA_TESTNE/9999999999/202001/2 codigoCliente =ADA_TESTNE codigoMEmpresa = 9999999999 periodo = 202001 tipoArchivo = 2

ValidarCliente ”/nomina/ValidarCliente/{codigoCliente}/{codigoMEmpresa}/{periodo}/{tipoArchivo}/{validaciones}“ Servicio para realizar la habilitación en la DIAN de un cliente, donde el parámetro validaciones indica el número de nóminas a enviar para obtener la habilitación.

Ejemplo de uso: http://10.1.140.102:8081/NominaElectronica/nomina/ValidarCliente/METROPARQUES_NE/9999999999/202109/1/ 5 codigoCliente = METROPARQUES_NE codigoMEmpresa = 9999999999 periodo = 202109 tipoArchivo = 1 validaciones = 5

testCliente ”/nomina/testCliente/{codigoCliente}“ Servicio que realiza un chequeo de que toda la información del cliente está bien configurada y es accesible. Se realizan las siguientes comprobaciones: - El código del cliente existe en la tabla de configuración: tblFeConexionCliente ADA_TESTNE: OK El cliente existe en la tabla de certificados: feCertificateInfo 800167494: OK - El archivo con las rutas a la información del certificado existe: propiedadesCliente: OK - El certificado del cliente existe: CFX_CRIPTO : EXISTE OK - Se hace una firma de un xml vacio para comprobar que las claves funcionan: FIRMA EXITOSA OK - Se intenta conectar a la base de datos del cliente:

CONEXION A LA BASE DE DATOS DEL CLIENTE EXITOSA OK Se comprueba que el servicio de envío a la DIAN es accesible: 
CONEXION dianWsRest EXITOSA OK:
    {\"estadoTx\":true,\"msg\":null,\"codigoHttp\":200,\"fechaOperacion\":1646340020, \"objectResponse\":\"V 1.0.0\",\"lstObjectResponse\":null}"

Ejemplo de uso: http://10.1.140.102:8081/NominaElectronica/nomina/testCliente/ADA_TESTNE codigoCliente = ADA_TESTNE

RETORNO DE LOS SERVICIOS

Todos los servicios retornan la misma estructura json:


CAMPO	TIPO	DESCRIPCION

estadoTx	BOOLEAN	Cierto si el proceso ha terminado correctamente.

mag	STRING	Mensaje de error.

codigoHttp	NUMERIC	Código HTTP devuelto por la DIAN o interno del software en caso de no poder enviar la nómina a la DIAN.

fechaOperacion	STRING	Fecha y hora del evento.

numeroEnvio	NUMERIC	Número único del envío.

lstObjectResponse	STRING

Ejemplo exitoso: { “estadoTx”: true, “msg”: ”“, “codigoHttp”: 0, “numeroEnvio”: 221231102745,

  "fechaOperacion": "2021-12-31T15:27:45.269+0000",
  "lstObjectResponse": ""

}

Ejemplo fallido, con una nómina errónea:

{ “estadoTx”: false, “msg”: “Error XML DIAN”, “codigoHttp”: 307, “numeroEnvio”: 221231104011, “fechaOperacion”: “2021-12-31T15:40:11.895+0000”, “lstObjectResponse”: “15” }

Ejemplo fallido, varias nóminas erróneas:

{ “estadoTx”: false, “msg”: “Error XML DIAN”, “codigoHttp”: 307, “numeroEnvio”: 221231104149, “fechaOperacion”: “2021-12-31T15:41:49.265+0000”,

  "lstObjectResponse": "10-13-15-8778-8979-9332-9398-11715-12744"

}

LOG Y BASE DE DATOS

Cada vez que se realiza un envío de una nómina se almacena la información en la tabla NOMINA.NE_ENVIADOS_WS cuyos campos son:


CAMPO	TIPO	DESCRIPCION

ID	NUMERIC	Identificador de la tabla.

PERIODO	VARCHAR	Periodo de generación del xml.

NIT_CLIENTE	NUMERIC	NIT del cliente.

CODIGO_EMPLEADO	NUMERIC	Código del empleado. Puede ser nulo si el error se produce antes de la generación del xml.

FECHA_ENVIO	TIMESTAMP	Fecha y hora de generación del registro.

NUMERO_PREDECESOR	VARCHAR	Consecutivo del xml, se almacena para su uso en caso de tener que generar una nómina de ajuste.

CUNE_PREDECESOR	VARCHAR	CUNE del xml, se almacena para su uso en caso de tener que generar una nómina de ajuste.

FECHA_GENERACION_PREDECESOR	TIMESTAMP	Fecha de generación del xml, se almacena para su uso en caso de tener que generar una nómina de ajuste.

TIPO_ARCHIVO	VARCHAR	Tipo de archivo del xml.

TIPO_NOTA	VARCHAR	Tipo de nota del xml.

ERROR	NUMERIC	Identificador del error. 0 = Sin error.1 = Error durante el proceso de generación del xml 2 = Error de la DIAN

TIPO_XML	NUMERIC	Tipo de xml.

CODIGO_EMPRESA	VARCHAR	Código multiempresa del cliente.
FECHA_REGISTRO	TIMESTAMP	Fecha y hora de generación del registro.
USUARIO_REGISTRO	VARCHAR	Usuario que genera el registro.
CLOB_XML	VARCHAR	Xml enviado a la DIAN

NUMERO_ENVIO	NUMERIC	Número de envío único por transmisión

El Sistema cuenta con una herramienta de configuración que le permite subir los certificados de seguridad y esta compuesta por dos artefactos: - confiFactura (Sistenma WEB). - apiRestConfig (Paquete de Servicios)

confiFactura Tiene los siguientes componentes: - Login

El login esta asociado a las siguientes tablas del sistema era:
- TBL_FE_CONEXION_CLIENTE_USER
- TBL_USUARIOS

NOTA: Configuración a realizar en la base de datos centralizada

Tener presente que este login debe estar creado para el CODIGO_CLIENTE que va utilizar NE es decir (PRUEBAS_NE_PROD) debe ser diferente al de FE, inicialmente se debe crear en la tabla TBL_FE_CONEXION_CLIENTE_USER se puede realizar desde la macro con el script 1119
El usuario debe estar creado en el módulo de presupuesto.
La clave por defecto es: 12345678 del usuario creado para acceder al portal de configuración que se encuentra en la url 10.1.40.189:8080
para insertar los datos en la tabla TBL_USUARIOS se debe ejecutar el siguiente insert

En el insert solo se deben modificar los campos denominados

login_usuario_ppto = login con el cual el usuario ingresa al modulo de presupuesto
Cargo_usser_ppto = cargo relacionado al usuario en presupuesto
cod_inter_usser_ppto = codigo interno de la tabla usuarios para la aplicacion 1
cod_cliente_para_ne = codigo cliente que va utilizar NE el cual ya fue previamente denominado en TBL_FE_CONEXION_CLIENTE_USER

INSERT INTO INTEGRACION.TBL_USUARIOS
(USER_LOGIN,USER_PASSWORD,NOMBRE,EMAIL,CODIGO_ROL,FECHA_REGISTRO,CODIGO_USUARIO_SICOF,CONFIG_NAME_FE)
VALUES (
'login_usuario_ppto',
'fa585d89c851dd338a70dcf535aa2a92fee7836dd6aff1226583e88e0996293f16bc009c652826e0fc5c706695a03cddce372f139eff4d13959da6f1f5d3eabe',
'Cargo_usser_ppto',
NULL,
'USUARIO',
SYSDATE,
'cod_inter_usser_ppto',
'cod_cliente_para_ne')

- Lista de empresas

Una ves ingresa el sistema le muestra la lista de empresas a las que el usuario logueado tiene permisos de configrar

- Configuracion del Certificado

Aqui el usuario debe ingresar información acerca del proveedor del certificado y fechas de vigencia como lo solicita el formulario asociado:

- Configuracion del Archivo

Aqui el usuario selecciona el archivo que contiene el certificado de seguridad para subirlo al sistema

Una vez realizado ese proceso el sistema esta preparado y se puede validar mediante el uso del servicio validado ya descrito en este documento.

apiRestConfig

Este artefacto de software es quien provee de servicios al sistema anterior el cual debe estar desplegado en el mismo servidor y se debe garantizar la configuración del datasourse CONFIGFENEDS el cual esta descrito al inicio de este documento. Ademas de esto es necesario que exista la carpeta configPath con la siguiente información:

Aqui se configura las rutas físicas donde se encuentra el directorio adafe_home.

Ademas se debe garantizar la carpeta image este en el directorio de adafe_home:

Anexo Técnico Nomina Electronica anexotecniconominaelectronica.pdf