Diferencia entre revisiones de «Emisión - Portal HKANómina»

Revisión actual - 15:08 16 oct 2025

Carga Masiva Nómina CSV

The Factory HKA a liberado en archivo excel 4.A - Excel_NominaIndividual - Campos Generales - 12 May 2023 - 1 NuevoCampo, en el cual se realizará el registro de las nóminas para Carga Masiva CSV a través del Portal Demo De Nómina Electrónica.

@IMPORTANTE: Esta opción se encuentra funcional para el ambiente Demo y Producción para conocer la estructura correcta el archivo y la funcionalidad al momento de enviar nóminas de forma masiva.

NOTA: Recuerde antes de iniciar el proceso debe crear previamente el secuencial para carga masiva. Podrá visitar la siguiente sección para su orientación:

Secuencial Tipo De Servicio Carga Masiva

Pasos para subir el archivo de nóminas CSV al Portal Web Nómina Electrónica:

Video guía En el siguiente video pueden visualizar los pasos para realizar una Carga Masiva desde el Portal HKA Nómina

A continuación, se detalla esta funcionalidad, para ofrecer una comprensión completa del funcionamiento del módulo:

1. Diligenciar archivo Excel 4.A - Excel_NominaIndividual - Campos Generales - 12 May 2023 - 1 NuevoCampo

A continuación documentamos las instrucciones que se deben considerar para el adecuado registro de las nóminas en el archivo excel de carga masiva que posteriormente se debe convertir en CSV para subirlo a través del portal:

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.

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

Formato Carga Masiva

2. Pasos para guardar un archivo Excel en CSV

Ir a panel de control del computador, cambiar la configuración de reloj y región
Hacer clic en Región y luego ingresa a configuración adicional
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
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.
Seleccionar la opción texto en la lista izquierda de opciones de formato (Categoría) y luego presionar acepta
Luego se dirige a exportar el documento en Archivo-> Guardar como -> Examinar y seleccionaTipo: CSV(delimitado por comas).

3. Ingreso al portal Demo/Producción de Nómina Electrónica

URL's Portal Nomina Electrónica:

Portal Demo Nómina Electrónica

Portal Producción Nómina Electrónica

4. Subir Nómina Masiva

En la sección Emisión de Nómina del portal Web de Nómina Electrónica en Demo o Producción se implemento la función de carga masiva a través de un archivo CSV, para continuar con este proceso lo invitamos a seguir los siguientes pasos:

Emisión Nómina
- Carga Masiva

Carga Masiva Nómina Electrónica : Debe dar clic en el botón seleccionar archivo el cual permite que ubique el archivo a subir en cualquier ubicación que este se encuentre dentro del ordenador.
Subir Archivo CSV: Una vez seleccionado el archivo csv indicado, para que este sea procesado debe dar clic en el botón llamado Subir.
Carga Exitosa: Al subir el archivo el sistema recibirá la cantidad de nominas registradas en el CSV e indicara cuantos de estos registros están correctos, de igual forma se indica el Código del lote generado y el nombre del archivo CSV que se subió

5. Lotes Generados

En la sección Emisión de Nómina -> Carga Masiva del portal Web de Nómina Electrónica en Demo podrá visualizar los lotes de nómina agendados o enviados ante la DIAN, estos se organizan de la siguiente forma según los parámetros descritos a continuación:

Emisión Nómina
- Carga Masiva

Descripción de la Gestión de Lotes

Esta sección presenta la información de los lotes agendados y enviados a la DIAN, y ofrece las siguientes opciones para su consulta y gestión:

1. Código Lote: Es el identificador único que el servicio asigna a cada lote. Permite filtrar y concultar un lote específico de manera sencilla.

2. Fecha Generación: Muestra la fecha exacta en la que el lote fue enviado a la DIAN.

3. Nombre Archivo: Indica el nombre del archivo CSV que se construyó y se agendó o envió a la DIAN

4. Estatus: Informa el resultado del envio del lote. Los posibles estados son:

* Procesado con Éxito: El envío se realizó correctamente.
* Pendiente envío DIAN: El documento aún está pendiente de ser enviado.
* Procesado con Errores: Se detectaron inconsistencias que pueden resultar en rechazados o porque el archivo no contiene registros válidos

5. Envío Programado: Muestra la fecha establecida por el usuario para un envío masivo de nómina programado.

6. Mensaje: En caso de que se presente alguna novedad con el archivo, este campo mostrará un mensaje detallado para identificar la inconsistencia.

7. Acciones: Ofrece varias opciones para la validación y descarga de la información:

* Mostrar listado Nóminas: Permite ver el listado de las nóminas generadas.
* Descargar Request Lote: Descarga los archivos de solicitud (request) de las nóminas enviadas.
* Descargar Response Lote: Descarga los archivos de respuesta (response) de las nóminas enviadas.
* Descargar Resultado Lote: Permite obtener los resultados de las nóminas generadas.

Lotes Agendados

Generar Comprobante

En esta sección podra visualizar el paso a seguir para Generar los documentos de nóminas

Para la elaboración de las nóminas debe tomar en cuenta los siguientes puntos:

Nóminas Individuales a través del Portal Nómina Electrónica

¿Comó generar una nómina individual desde el portal nomina?

1. Seleccionar el tipo de documento Nómina Individual

2. Seleccionar el establecimiento

3. Tener previamente creados los secuenciales para el tipo de nómina a emitir

4. En este campo le mostrada el listado de trabajadores agregados en el catalogo

5. En la sección de devengados se debe colocar la cantidad de días que el trabajador o aprendiz estuvo ejecutando sus labores en la empresa junto con el valor que el empleador paga de forma periódica al trabajador como contraprestación por el trabajo realizado, este puede ser fijo o variable de acuerdo a la unidad de tiempo en que las partes hayan acordado el pago, teniendo como base el día o la hora trabajada.

Adicional le permite agregar otros devengados que apliquen en la nómina según el caso de acuerdo a lo estipulado por la DIAN en el anexo técnico y en la resolución.

6. En esta sección se debe definir el monto a cotizar del trabajador afiliado al sistema de salud y al sistema de pensiones colocando de igual manera el porcentaje de deducciones aplicadas a estos sistemas.

Adicional le permite agregar otras deducciones que apliquen en la nómina según el caso de acuerdo a lo estipulado por la DIAN en el anexo técnico y en la resolución.

7. Se puede colocar una nota en la nómina para llevar un mejor control del documento liquidado en el caso de ser necesario (esta nota se visualizara en la Representación Gráfica de la nómina)

8. En la sección de pagos se muestra la forma de pago aplicada para la nómina del trabajador documentada anteriormente en la sección de catálogos al agregar el trabajador y se debe seleccionar la fecha de pago de la nómina liquidada.

9. En la sección de periodos se debe definir la fecha de liquidación inicio y fin del periodo liquidado la cual comprende del inicio o al final del mes.

La fecha de Ingreso se visualiza de forma automática ya que esta fue documentada al agregar el trabajador en la sección de catálogos.

La fecha de retiro se debe diligenciar solamente en el registro del mes en que el trabajador presenta retiro de la compañía o finaliza funciones de la misma.

10. En la sección de totales le mostrara el valor de deducciones, devengado y de comprobantes que se aplicó en la nómina una vez visualice los valores correctos presione la opción de Generar Documento para que la nómina sea emitida correctamente.

Nóminas de Ajuste a través del Portal Nómina Electrónica

Video guia: En el siguiente video puede visualizar el proceso para la emisión de nóminas de ajuste

A continuación, se detalla cada una de estas opciones para ofrecer una comprensión completa del funcionamiento del módulo:

Nómina de Ajuste Tipo Reemplazar

Seleccionar el tipo de documento "Nómina de Ajuste"
Seleccionar el establecimiento
Tener previamente creados los secuenciales para el tipo de nómina a emitir
Colocar el Periodo de la Nómina o Fecha de Generación
Buscar el N° de Nómina correspondiente al periodo o fecha seleccionado
Nota de Ajuste: Reemplazar

Se utilizará este escenario cuando se requiera realizar ajustes sobre Documentos Soporte de Pago de Nómina Electrónica o Notas de Ajuste del Documento Soporte de Pago de Nómina Electrónica, por errores aritméticos, contables o de contenido..

Nómina Ajuste Reemplazar Fecha Generación
Nómina Ajuste Reemplazar Periodo Nómina

Nómina de Ajuste Tipo Eliminar

Seleccionar el tipo de documento "Nómina de Ajuste"
Seleccionar el establecimiento
Tener previamente creados los secuenciales para el tipo de nómina a emitir
Colocar el Periodo de la Nómina o Fecha de Generación
Buscar el N° de Nómina correspondiente al periodo o fecha seleccionado
Nota de Ajuste: Eliminar

Se utilizará este escenario cuando se requiera eliminar el Documento Soporte de Pago de Nómina Electrónica, y/o una Nota de Ajuste del Documento Soporte de Pago de Nómina Electrónica, para los casos en los cuales se haya transmitido un documento por errores contables o de procedimiento. Adicional este comprobante se emite con los valores en cero (0).

Nómina Ajuste Eliminar Fecha Generación
Nómina Ajuste Eliminar Periodo Nómina

Nota: Se indica que el tipo de Nota de Ajuste del Documento Soporte de Pago de Nómina Electrónica con código 2 Eliminar, solo invalida los documentos enviados por error, no obstante los mismos seguirán existiendo en la base de datos pero quedarán marcados con esta observación

Nóminas de Ajuste a través del Archivo Excel 4.A - Excel_NominaIndividual - Campos Generales - 12 May 2023 - 1 NuevoCampo

Para carga masiva al realizar las nómina de ajuste a través del archivo exceL 4A debe tener en cuenta los siguientes pasos y debe reportar en la columna AC el secuencial creado para nómina de ajuste:

Creación Secuenciales Portal Demo Nómina Electrónica

Para las Notas Reemplazar:

Secuencial nómina ajuste (columna AC)
TipoDocumento 103 (columna AP)
TipoNota 1 (columna AS)
Referenciar la nomina individual a ajustar: fechaPred (columna AT), cunePred(columna AU) y numeroPred(columna Av).

Nota: Se debe diligenciar todas la líneas del archivo.

Para las Notas Eliminar:

Secuencial nómina ajuste (columna AC)
TipoDocumento 103 (columna AP)
TipoNota 2 (columna AS)
Referenciar la nomina individual a ajustar: fechaPred (columna AT), cunePred(columna AU) y numeroPred(columna Av).

Nota: no es necesario reportar datos de trabajadores, devengos y deducciones.

En nuestro ejemplo, la línea 3 es un ejemplo de reemplazo y la línea 4 es una nota de eliminación para su orientación:

Ejemplo Carga Masiva Nómina Electrónica

¿Cómo Agregar Devengados a la Nómina Electrónica?

Cesantías

Cuando en la nómina individual o de ajuste por reemplazo se desee informar el grupo de cesantías, se debe situar en la sección de devengados,

En la opción de otros devengados debe seleccionar la opción Cesantías (También puede escribirla)

para reportar cesantías en la opción debe tener en cuenta:

1. Pago : Valor que se va a pagar al fondo de cesantías
2. Porcentaje: este valor corresponde al porcentaje de los intereses
3. pago Interés: el valor al que corresponde al porcentaje de intereses

Primas

Cuando en la nómina individual o de ajuste por reemplazo se desee informar el grupo de prima, se debe situar en la sección de devengos,

En la opción de otros devengados debe seleccionar la opción Prima (También puede escribirla)

Para reportar prima en la opción debe tener en cuenta:

1. Cantidad días: corresponde a los días equivalentes al pago a realizar
2. Pago: valor correspondiente a la cantidad de días
3. Pago No Salarial: corresponde a pagos adicionales que no sean de tema salarial pero sí es incluida dentro de la contabilidad de la empresa(ejemplo provisionales)

Vacaciones

Cuando en la nómina individual o de ajuste por reemplazo se desee informar el grupo de vacaciones, se debe situar en la sección de devengados,

En la opción de otros devengados debe seleccionar la opción Vacaciones (También puede escribirse)

Para reportar vacaciones en la opción debe tener en cuenta:

Tipo de vacaciones: esta opción se divide en Comunes y Compensadas;

Comunes: consiste en el pago de 15 días hábiles sin pagar prestaciones de servicios

Cuando se elige comunes se anexan campos nuevos fecha inicio o fecha fin en los cuales se aplicará los días tomados de vacaciones

Compensadas: consiste en el pago de 15 días hábiles

1. Cantidad de días: hace referencia a la cantidad de días tomados o a la cantidad de días a los que corresponde el pago (en este valor sólo pueden ser como máximo 2 dígitos)
2. Pago: pago correspondiente a los días de vacaciones

y para finalizar se debe dar en el botón con el más “+” para agregar el valor

Transporte

Cuando en la nómina individual o de ajuste por reemplazo se desee informar el grupo de transporte, se debe situar en la sección de devengados,

En la opción de otros devengados debe seleccionar la opción Transporte (También se puede escribir)

Para reportar transporte en la opción debe tener en cuenta:

1. Viáticos, Manutención, Alojamiento de carácter: se divide en salarial y no salarial, estos campos si no completan con valores mayores a 0(cero), lo mejor es dejarlos vacios.
2. Auxilio: En este campo se debe completar con el valor correspondiente al auxilio de transporte

Para finalizar se debe dar en el botón con el más “+” para agregar el valor

Nóminas Generadas

Esta sección permite visualizar todas las nóminas aprobadas por la DIAN, incluyendo tanto las nóminas individuales como las nóminas de ajuste.

Para poder realizar la busqueda de las nóminas en meses anteriores debe hacer uso de los filtros, para ello cuenta con la opción de Filtro donde puede realizar la busqueda con los siguientes campos:

Seleccionar el tipo de nómina
Colocar el Nro de nómina
Seleccionar la Fecha de elaboración
Nro de Documento Trabajador
Código Trabajador
Código Lote (Código asignado al realizar carga masiva)
Filtro por Periodo Liquidación

Luego de diligenciar alguno de estos campos debe hacer clic en el ícono de buscar para mostrar el listado de las nóminas

Este listado cuenta con una opcion donde puede visualizar su nómina en el portal de la DIAN.

Para esto debe presionar el signo de (+) para visualizar la opción DIAN la cual al hacer clic la direcciona al portal del ente para ver la nómina

Nóminas Rechazadas

En esta sección, podrá visualizar el listado completo de las nóminas (individuales y de ajuste) que han sido rechazadas por la DIAN.