Resumen
Al ejecutar el procesamiento de nómina basado en archivos con un proveedor de servicios de nómina externo, se producen datos de archivos XML con datos maestros de empleado y datos de transacciones de nómina incluidos en una instantánea de nómina. Después de descargar este archivo del sistema ByDesign, se transmite al proveedor de servicios de nómina para que lo procese. En el procesamiento basado en archivos estándar, cuando se crea un nuevo archivo de datos de nómina, se produce en el sistema un archivo de salida XML estándar. La conversión XSLT estándar del archivo de datos de nómina es una selección, propuesta por SAP, de los datos de nómina generados.
Este documento proporciona un resumen del contenido del archivo XML estándar. Explica la estructura y muestra el empleado clave y los datos de pago contenidos en el archivo, incluidas todas las referencias a las etiquetas XML y las explicaciones de las opciones de entrada (por campo), cuando corresponde. Muchos campos técnicos no se describen, ya que generalmente los proveedores de servicios de nómina no hacen referencia a ellos.
2.0 Estructura de archivos XML
El archivo XML que se descarga del sistema ByDesign está dividido en dos secciones principales:
2.1 Datos de cabecera
2.2 Datos de empleado delta y de pago
2.1 Datos de cabecera
La sección de datos entre las etiquetas XML <cabecera de mensaje>y </ cabecera de mensaje>contiene datos de cabecera clave con campos como:
● • <ID> : Identificador de archivos único generado por sistema
● • <CreationDateTime> : Datos de creación de archivos
2.2 Datos de empleado delta y de pago
El resto del archivo XML contiene datos genéricos y específicos de empleado para todos los empleados, ubicados entre las etiquetas XML <IN_EmployeePayrollInputCollection> y </IN_EmployeePayrollInputCollection>.
En general, cuando se crea un archivo XML haciendo clic en Crear archivo de datos en la vista Ejecución de nómina de procesamiento de nóminas, solamente se incluyen en el archivo los datos de nómina delta. Es decir, todos los datos de empleado o de pago nuevos, modificados o borrados introducidos a partir de la creación del archivo en el período de nómina anterior, con una fecha de entrada en vigor igual o anterior al período de pago actual. Hay algunas excepciones a esta regla:
1. Algunos campos siempre se transfieren para empleados actualmente activos en la nómina:
● ID de empleado
● ID de proveedor de servicios de nómina del empleado
● Fecha de contratación/Fecha de recontratación
● Categoría administrativa
● Contrato de trabajo
2. Cuando se transfiere un empleado de un grupo de nómina a otro, todos sus datos se incluyen en el archivo XML.
3. En la vista Tareas frecuentes de Procesamiento de nóminas, si selecciona Sincronizar datos de empleado, se crea un archivo XML que contiene todos los datos de empleado de los empleados seleccionados.
2.2.1 Datos genéricos
La primera sección de datos entre las etiquetas <IN_EmployeePayrollInputCollection> y </ IN_EmployeePayrollInputCollection> contiene datos genéricos relevantes de todos los empleados incluidos en el archivo XML. Estos datos genéricos incluyen:
● <PayrollProcessID>: ID generado por sistema, compuesto por grupo de nómina, país, período de nómina y año de nómina
● <PayrollProcessPayrollProviderID>: El ID de proceso de nómina introducido en la actividad Actualizar períodos de cálculo de nómina, ubicada en la vista Tareas frecuentes. Algunos proveedores de servicios de nómina necesitan un identificador único para cargar el archivo, que se introduce aquí.
2.2.2.1 Datos generales
La sección de cada empleado comienza con los datos generales, compuestos por el nodo de objeto y la información del proceso de cálculo de nómina:
● <ObjectNodeReference> : Contiene IDs generados por el sistema y códigos que no son relevantes para descifrar el archivo
● <IN_EmployeePayrollInput> : Proporciona datos genéricos relacionados con el procesamiento de nómina y simplemente repite la información de la sección 2.2.1 de este documento
2.2.2.2 Datos individuales de empleado
Para cada empleado incluido en la creación del archivo, a los datos generales de la sección 2.2.2.1 le siguen los datos específicos de empleado que se introdujeron en el registro u hoja de horas de trabajo del empleado. La etiqueta XML de la sección es <EmployeeActionCode>.
Los códigos de acción se usan dentro del archivo XML para identificar la manera en que se deben tratar los datos. Se utilizan los siguientes códigos de acción:
● 01– Crear (se ha añadido recientemente el registro y no se envió anteriormente)
● 02– Modificar (el registro se envió anteriormente y ahora se ha actualizado)
● 03– Borrar (el registro se borra previamente en el sistema ByDesign)
● 04– Grabar (crear o modificar)
● 05– Eliminar (borrar si está presente)
● 06– Sin acción (verificación)
Los datos individuales de empleado se estructuran de manera similar a las pantallas de SAP Business ByDesign, es decir, se agrupan por código de acción y período de validez. Los tres ejemplos secuenciales que aparecen a continuación muestran los datos XML la primera vez que se introducen en el sistema SAP Business ByDesign y después de que un empleado modifique su apellido.
Ejemplo básico de un archivo XML para el procesamiento de nóminas en India. Este archivo contiene información sobre empleados, incluyendo detalles como el nombre, el número de identificación, el salario y las deducciones:
<nomina> <empleados> <empleado> <id>001</id> <nombre>Rahul Kumar</nombre> <puesto>Gerente de Ventas</puesto> <salario>50000</salario> <deducciones> <deduccion> <tipo>PF</tipo><monto>5000</monto> </deduccion> <deduccion> <tipo>ESI</tipo> <monto>2000</monto></deduccion> </deducciones> </empleado> <empleado> <id>002</id> <nombre>Priya Singh</nombre> <puesto>Desarrolladora de Software</puesto> <salario>45000</salario><deducciones> <deduccion> <tipo>PF</tipo> <monto>4500</monto> </deduccion> <deduccion><tipo>ESI</tipo> <monto>1800</monto> </deduccion> </deducciones> </empleado> </empleados></nomina>En este ejemplo, cada <empleado> tiene elementos para <id>, <nombre>, <puesto> y <salario>. Además, hay un elemento <deducciones> que contiene una lista de <deduccion> para las deducciones específicas de cada empleado, donde se incluye el tipo de deducción (como PF o ESI) y el monto correspondiente.