TOOL Carga Masiva Nómina Electrónica TFHKA- Indice Manual Integración Nómina Electrónica

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda

TOOL Carga Masiva Nómina Electrónica TFHKA

En este apartado se brinda todas las características que The Factory HKA Colombia a implementado para la integración de Nómina Electrónica a través de archivo Excel exportado a CSV bajo el desarrollo del TOOL Carga Masiva TFHKA como herramienta complementaria y temporal para la transmisión de Nómina Electrónica Masiva a la DIAN.

Objetivo

El presente manual tiene como propósito dar a conocer los detalles de la interfaz de aplicación TFHKACO_CargaMasivaNEL para la integración directa y la descripción de las funciones para la generación de Nóminas Electrónicas y Nóminas de Ajuste ofrecida por The Factory HKA Colombia SAS. El consumo del Tool es muy sencillo, solo deben centrarse en generar el origen de datos en el formato 4.A - Excel_NominaIndividual - Campos Generales - 4 Oct 202 que debe ser transformado a CSV posteriormente.

Alcance

Teniendo en cuenta que existen clientes que requieren subir de manera masiva, los datos de las nóminas de sus empleados a través del archivo 4.A - Excel_NominaIndividual - Campos Generales - 4 Oct 2021, el presente documento abarca la configuración del Tool para el consumo del servicio sin necesidad de contar con sistemas administrativos (ERP) que nativamente tienen limitantes para el consumo de servicios web referenciando o importando el WSDL.

Definiciones y Términos

EXE: En el ámbito de la informática .exe (de la abreviación del inglés executable, que se traduce en ejecutable) es una extensión que se refiere a un archivo ejecutable de código reubicable, es decir, sus direcciones de memoria son relativas. Los sistemas operativos que utilizan de forma nativa este formato son DOS, Microsoft Windows, OS/2 y ReactOS.

Configuración

En el archivo descargado .zip, se encontrará con las herramientas básicas para realizar la integración del software administrativo con nuestra plataforma de Nómina Electrónica: librería de integración indirecta (TFHKACO_CargaMasivaNEL), un archivo de texto (config_ne.xml) que contendrá los datos de acceso a la plataforma de Nómina Electrónica de The Factory HKA y el archivo 4.A - Excel_NominaIndividual - Campos Generales - 4 Oct 2021 . La estructura del archivo config_ne.xml debe ser la siguiente:


Configuración Config_ne.xml
Configuración Config_ne.xml


Para la adecuada configuración los parámetros que se deben tener en cuenta son los registrados en la tabla que se ilustra a continuación:

Campo Descripción
Url Direccion del servicio Rest implementado por The Factory http://demonominaelectronica.thefactoryhka.com.co
@IMPORTANTE: Utilice la Url establecida para el ambiente que valla a utilizar demo o producción.
timeOut Tiempo de espera de la respuesta del servicio
idSoftware Este campo podrá colocar un dato temporal o vacío
token Puede utilizar los mismos tokens de emisión
nit Debe corresponder al nit del empleador
resultado Nombre que asigna al archivo resultado

Instrucciones de uso TOOL Carga Masiva

Una vez configurado el archivo config_ne teniendo en cuenta lo mencionado anteriormente, a continuación de ilustra el proceso a seguir para el correcto funcionamiento del aplicativo y cargue de la Nómina Electrónica.

Diligenciar Archivo 4.A - Excel_NominaIndividual - Campos Generales - 4 Oct 2021


Al descomprimir la carpeta TFHKACO_CargaMasivaNEL, en el interior de esta carpeta encontrara una carpeta llamada Documentación la cual contiene el archivo Archivo 4.A - Excel_NominaIndividual - Campos Generales - 4 Oct 2021, el cual es mandatorio diligenciarlo ya que este contiene toda la estructura definida por TFHKA en el objeto Nómina y cumple con lo solicitado en el anexo técnico 1.0 de la resolución 000013; para diligenciarlo correctamente debe cumplir las siguientes instrucciones;

  • Incluya los datos de los comprobantes de Nómina Electrónica en la hoja Carga Masiva.
  • Utilice 1 fila de la hoja Carga Masiva por empleado al cual le reporte Nómina Electrónica, si necesita reportar mas de 1 empleado, utilice filas consecutivas sin dejar filas intermedias entre empleados. No elimine columnas de la hoja Carga Masiva, esto generará errores en la carga de los datos.
  • En la hoja Carga Masiva se debe incluir todos los campos obligatorios, la definición de si un campo es obligatorio o no, lo puede observar en el nombre de la columna en la hoja Carga Masiva en color rojo "Campo Obligatorio" - "Campo No Obligatorio".
  • Existen campos no obligatorios que pueden ser obligatorios dependiendo de lo que se incluya en otros campos, para conocer como aplica este tipo de obligatoriedad, debe remitirse a la hoja Diccionario.
  • Los nombres de las columnas de la hoja Carga Masiva, tienen vínculos que al dar clic en ellos, se direcciona a la explicación del campo en la hoja Diccionario.
  • La columna Observaciones de la hoja Diccionario, tiene vínculos que al dar clic en las celdas que relacionan catálogos del Anexo Técnico, se direcciona al catálogo correspondiente del Anexo Técnico, en la hoja Catálogos.
  • Una vez finalice de ingresar los datos de todos los empleados para el reporte de Nómina Electrónica en la hoja Carga Masiva, exporte la hoja Carga Masiva a formato CSV sin incluir los nombres de las columnas utilizando como separador de columnas el carácter "Pipe" (|).
  • Referencie el archivo CSV generado, en la opción de carga masiva de nómina electrónica en el Portal Web de Nomina Electrónica de The Factory HKA.


@IMPORTANTE: Al diligenciar el archivo 4.A - Excel_NominaIndividual - Campos Generales - 4 Oct 2021 en la columna AC rangoNumeracion debe registrar el secuencial creado en el portal de Nómina Electrónica como Tipo Servicio: Portal


Para obtener el archivo excel donde registrar las nóminas de los trabajadores puede dar clic e el siguiente enlace:

Formato Carga Masiva


Pasos para crear un CSV en Excel

1. Ir a panel de control del computador, cambiar la configuración de reloj y región

Panel de Control
Panel de Control



2. Hacer clic en Región y luego ingresa a configuración adicional

Configuración Región
Configuración Región



3. Cambiar el separador de Listas que trae por defecto windows que es punto y coma (;) por el pipe (|) como se muestra en la imagen y presionar aceptar

Personalizar Formato(|)
Personalizar Formato



4. Selecciona las filas con las nominas registradas, sin seleccionar los títulos del documento y las copia en un nuevo documento, luego presionar botón derecho del mouse y seleccionar formato de celdas.

Formato Celdas
Formato Celdas



5. Seleccionar la opción texto en la lista izquierda de opciones de formato (Categoría) y luego presionar aceptar.

Formato Texto
Formato Texto


6. Luego se dirige a exportar el documento en Archivo-> Guardar como -> Examinar y seleccionaTipo: CSV(delimitado por comas).

Tipo Csv Delimitado Por Comas
Csv Delimitado Por Comas


Ejecute TFHKACO_CargaMasivaNEL.exe

Una vez haya finalizado de diligenciar el archivo de carga masiva y lo haya exportado tipo CSV separado por pipes(|), podrá ejecutar el archivo .EXE llamado TFHKACO_CargaMasivaNEL, el cual le permitirá realizar el envió de na nomina para pruebas, habilitación o producción de la siguiente forma:


  • En la carpeta de la aplicación descargada, de clic en el archivo .EXE, se abrirá la siguiente ventana y luego pulse el botón CARGA ARCHIVO CSV que lo llevara a buscar el archivo en su computador una ves lo ubique de clic en Abrir.


TFHKACO_CargaMasivaNEL
Tool Carga Masiva


  • Inmediatamente elija el archivo csv se abrirá automáticamente una consola del sistema en la cual se ilustrará el envió de las nominas por cada una de las lineas registradas.


Consola Carga Masiva
Consola Masiva


  • Terminado el proceso la consola se cierra automáticamente y en la pantalla de la aplicación TFHKACO_CargaMasivaNEL se visualizara el mensaje Proceso Lote/Carga Masiva Finalizado!!! esto determina que el proceso ha sido completado.


Proceso Lote/Carga Masiva Finalizado
CargaMasivaFinalizada


  • Al finalizar el envió en la carpeta principal de la aplicación se crea una carpeta llamada lote donde se encontrara los archivos Response, Request y Resultado, los cuales le permitirán conocer la respuesta del servicio.


Carpeta Lote
Carpeta Lote


Para descargar el aplicativo del TOOL Carga Masiva Nómina Electrónica TFHKA puede dar clic e el siguiente enlace:

Descargar TOOL Carga Masiva Nómina Electrónica TFHKA