Diferencia entre revisiones de «Manual TOOL Carga Masiva Nómina Electrónica TFHKA»
(Página creada con «<includeonly>=</includeonly>== '''TOOL Carga Masiva Nómina Electrónica TFHKA''' ==<includeonly>=</includeonly> <DIV ALIGN=justify>En este apartado se brinda todas las ca…») |
|||
(No se muestran 5 ediciones intermedias de 2 usuarios) | |||
Línea 1: | Línea 1: | ||
− | <includeonly>=</includeonly>== '''TOOL Carga Masiva Nómina Electrónica TFHKA''' ==<includeonly>=</includeonly> | + | <includeonly>=</includeonly>== <font color="Blue">'''TOOL Carga Masiva Nómina Electrónica TFHKA'''</font> ==<includeonly>=</includeonly> |
<DIV ALIGN=justify>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.</DIV> | <DIV ALIGN=justify>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.</DIV> | ||
− | === Objetivo === | + | ===<font color="Blue"> Objetivo</font> === |
− | <DIV ALIGN=justify>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 | + | <DIV ALIGN=justify>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''' que debe ser transformado a CSV posteriormente.</DIV> |
− | === Alcance === | + | ===<font color="Blue"> Alcance</font> === |
− | <DIV ALIGN=justify>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 | + | <DIV ALIGN=justify>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''', 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.</DIV> |
− | === Definiciones y Términos === | + | === <font color="Blue">Definiciones y Términos </font>=== |
<DIV ALIGN=justify>'''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.</DIV> | <DIV ALIGN=justify>'''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.</DIV> | ||
− | === Configuración === | + | === <font color="Blue">Configuración </font>=== |
− | <DIV ALIGN=justify>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 | + | <DIV ALIGN=justify>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''' . La estructura del archivo config_ne.xml debe ser la siguiente:</DIV> |
<br /> | <br /> | ||
<center>'''Configuración Config_ne.xml'''</center> | <center>'''Configuración Config_ne.xml'''</center> | ||
Línea 30: | Línea 30: | ||
! Campo !! Descripción | ! Campo !! Descripción | ||
|- | |- | ||
− | | Url || | + | | Url || Dirección del servicio Web Service según esquema de integración para Nómina Electrónica implementado por The Factory HKA. |
− | :'''@IMPORTANTE:''' Utilice la Url establecida para el ambiente que | + | :'''@IMPORTANTE:''' Utilice la Url Web Service establecida para la integración REST en el ambiente que desee utilizar Demo o Producción. |
+ | :'''[[Tips Urls de Emisión Nómina Electrónica| Consulte URL REST]]''' | ||
|- | |- | ||
| timeOut|| Tiempo de espera de la respuesta del servicio | | timeOut|| Tiempo de espera de la respuesta del servicio | ||
Línea 45: | Línea 46: | ||
{{clear}} | {{clear}} | ||
− | ===<big><u> Instrucciones de uso TOOL Carga Masiva</u></big> === | + | ===<font color="Blue"><big><u> Instrucciones de uso TOOL Carga Masiva</u></big></font> === |
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. | 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. | ||
− | ====<big><u>Diligenciar Archivo 4.A - Excel_NominaIndividual - Campos Generales | + | ====<font color="Blue"><big><u>Diligenciar Archivo 4.A - Excel_NominaIndividual - Campos Generales</u></big></font>==== |
<br /> | <br /> | ||
− | 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 | + | 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, 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; |
<br /> | <br /> | ||
* Incluya los datos de los comprobantes de Nómina Electrónica en la hoja '''Carga Masiva'''. | * Incluya los datos de los comprobantes de Nómina Electrónica en la hoja '''Carga Masiva'''. | ||
Línea 63: | Línea 64: | ||
* 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. | * 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. | ||
<br /> | <br /> | ||
− | <font color="red">@IMPORTANTE:</font> Al diligenciar el archivo 4.A - Excel_NominaIndividual - Campos Generales | + | <font color="red">@IMPORTANTE:</font> Al diligenciar el archivo 4.A - Excel_NominaIndividual - Campos Generales en la columna '''AC rangoNumeracion''' debe registrar el secuencial creado en el portal de Nómina Electrónica como <u>Tipo Servicio: Portal</u> |
<br /> | <br /> | ||
− | Para obtener el archivo excel donde registrar las nóminas de los trabajadores puede dar clic e el siguiente enlace: | + | '''Para obtener el archivo excel donde registrar las nóminas de los trabajadores puede dar clic e el siguiente enlace:''' |
<br /> | <br /> | ||
− | :[https:// | + | |
+ | |||
+ | '''<u> Compatible Tool V1.0.0 - V2.0.0</u>''' | ||
+ | :[https://docs.google.com/spreadsheets/d/1AzhjfvyirVGcjvxiMgURNa4tYUtnuJlY/edit?usp=drive_link Descargar Formato Carga Masiva 4.A - Excel_NominaIndividual - Campos Generales - 4 Oct 2021] | ||
+ | '''<u> Compatible Tool V3.0.0</u>''' | ||
+ | :[https://docs.google.com/spreadsheets/d/15HSW3M5PnGLBZp_YzlWZtD3GGZKIOXtR/edit?usp=drive_link Descargar Formato Carga Masiva 4.A - Excel_NominaIndividual - Campos Generales - 12 May 20231 NuevoCampo] | ||
<br /> | <br /> | ||
− | ====<big><u> Pasos para crear un CSV en Excel </u></big>==== | + | ====<font color="Blue"><big><u> Pasos para crear un CSV en Excel </u></big></font>==== |
1. Ir a panel de control del computador, cambiar la configuración de reloj y región | 1. Ir a panel de control del computador, cambiar la configuración de reloj y región | ||
Línea 113: | Línea 119: | ||
<br /> | <br /> | ||
− | ====<big><u> Ejecute TFHKACO_CargaMasivaNEL.exe</u></big>==== | + | ====<font color="Blue"><big><u> Ejecute TFHKACO_CargaMasivaNEL.exe</u></big></font>==== |
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: | 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: | ||
Línea 142: | Línea 148: | ||
:[https://drive.google.com/drive/folders/10BgVfKYOwPCk324A-ATRnTS-VP-I7vlr Descargar TOOL Carga Masiva Nómina Electrónica TFHKA ] | :[https://drive.google.com/drive/folders/10BgVfKYOwPCk324A-ATRnTS-VP-I7vlr Descargar TOOL Carga Masiva Nómina Electrónica TFHKA ] | ||
<br /> | <br /> | ||
+ | |||
+ | <br> | ||
+ | <br> | ||
+ | <br> | ||
+ | <br> | ||
+ | |||
+ | <center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]<font color="Blue">THE FACTORY HKA COLOMBIA</font></big> | ||
+ | <br>Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center> | ||
− | |||
− | |||
− | |||
− | <br | + | |
+ | <br> | ||
+ | |||
+ | |||
+ | {{clear}} | ||
+ | <!-- | ||
+ | --> |
Revisión actual del 19:04 4 ago 2023
TOOL Carga Masiva Nómina Electrónica TFHKA
Objetivo
Alcance
Definiciones y Términos
Configuración
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 | Dirección del servicio Web Service según esquema de integración para Nómina Electrónica implementado por The Factory HKA.
|
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
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, 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 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:
Compatible Tool V1.0.0 - V2.0.0
Compatible Tool V3.0.0
Pasos para crear un CSV en Excel
1. Ir a panel de control del computador, cambiar la configuración de reloj y región
2. Hacer clic en Región y luego ingresa a configuración adicional
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
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.
5. Seleccionar la opción texto en la lista izquierda de opciones de formato (Categoría) y luego presionar aceptar.
6. Luego se dirige a exportar el documento en Archivo-> Guardar como -> Examinar y seleccionaTipo: 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.
- 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.
- 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.
- 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.
Para descargar el aplicativo del TOOL Carga Masiva Nómina Electrónica TFHKA puede dar clic e el siguiente enlace:
Copyright © 2016 The Factory HKA. Todos los derechos reservados.