1.0 Resumen
Al ejecutar el procesamiento de nóminas 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óminas 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 por defecto, 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.
También puede usar modelos XSLT entregados por SAP para convertir los datos de nómina XML a formato Excel.
Los clientes pueden acceder a estos modelos a través del gerente de cuentas o de proyectos de implementación de SAP. Para obtener más información acerca de este proceso, consulte Ajustar reglas de conversión XSLT [página 173].
Los empleados y socios de SAP pueden descargar estas plantillas XSLT suministradas por SAP directamente desde el Business Center de SAP para soluciones On-Demand. Después de entrar al sistema, seleccione: SAP Business ByDesign, luego Comunidady haga clic en Intercambio de información de Wiki.
En Información del alcance de la solución, haga clic en Información de la aplicación y desplácese hacia abajo hasta el tema Convertir datos de nómina XML a Microsoft Excel. Elija el ByDesign Feature Pack para acceder a una página dedicada para la descarga que incluya un resumen e información sobre los requisitos previos.
Nuevas mejoras o desarrollos de nómina pueden requerir que sustituya los archivos de plantilla XML o XSLT existentes. El proceso para esta sustitución difiere en lo siguiente:
● Los archivos XML serán sustituidos automáticamente con una actualización de software dedicada de SAP
● Debe sustituir las plantillas de conversión XSLT manualmente. Navegue hasta la ubicación Business Center de SAP para soluciones On-Demand especificada en este documento y descargue la versión más nueva de la plantilla. Luego sustituya los archivos con la tarea regular de nómina Ajustar reglas de conversión.
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, que incluyen campos como:
● • <ID> : Identificador de archivos único generado por sistema
● • <CreationDateTime> : Datos de creación de archivos
Gráfico genérico: Datos de cabecera
En este ejemplo no se muestran otros datos técnicos contenidos en la cabecera.
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 <DE_EmployeePayrollInputCollection> y </DE_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 frecuentesde 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 <DE_EmployeePayrollInputCollection> y </
DE_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>: 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 del servicio de cálculo de nómina necesitan un identificador único para cargar el archivo, que se introduce aquí.
Gráfico 1: Datos genéricos
<DE_EmployeePayrollInputCollection>
<PayrollProcessID>AB-1DE0092009</PayrollProcessID>
<PayrollProcessPayrollProviderID>AB-1_2009_09</PayrollProcessPayrollProviderID>
2.2.2 Datos específicos de empleado
Los datos nuevos, modificados o borrados de cada empleado se ubican en una subsección de la etiqueta XML <DE_EmployeePayrollInputCollection>, dentro de las etiquetas XML iniciales y finales <DE_EmployeePayrollInput> y </DE_EmployeePayrollInput>. Los datos específicos de empleado se componen de dos subsecciones: datos generales y datos individuales de empleado.
2.2.2.1 Datos generales
La sección de cada empleado comienza con los datos generales, compuestos por nodo de objeto e información de proceso de cálculo de nómina:
● <ObjectNodeReference> : Contiene IDs generados por sistema y códigos que no son relevantes para descifrar el archivo
● <DE_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 usan los siguientes códigos de acción:
● 01– Crear (se ha añadido recientemente el registro y no se envió anteriormente)
● 02– Actualizar (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
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 modifica su apellido.
Ejemplo 1
Gráfico 2: Entrada inicial de la información personal del empleado
Ejemplo 2A
Gráfico 3: Delimitación del apellido original del empleado
Ejemplo 2B
Gráfico 4: Adición del apellido nuevo del empleado
Ejemplo básico de un archivo XML para el procesamiento de nóminas en Alemania. Este archivo contiene información sobre empleados, salarios y deducciones:
<nomina> <empleados> <empleado> <id>001</id> <nombre>Hans Müller</nombre><puesto>Desarrollador de Software</puesto> <salario>50000</salario> <deducciones><seguro_salud>3500</seguro_salud> <seguro_pensiones>4000</seguro_pensiones><impuesto_renta>8000</impuesto_renta> </deducciones> </empleado> <empleado> <id>002</id><nombre>Lisa Schmidt</nombre> <puesto>Gerente de Ventas</puesto> <salario>60000</salario><deducciones> <seguro_salud>4000</seguro_salud> <seguro_pensiones>4500</seguro_pensiones><impuesto_renta>10000</impuesto_renta> </deducciones> </empleado> </empleados> </nomina>En este ejemplo:
- Cada
<empleado>tiene elementos para<id>,<nombre>,<puesto>y<salario>. - El elemento
<deducciones>contiene subelementos para diferentes tipos de deducciones, como el seguro de salud, el seguro de pensiones y el impuesto sobre la renta. Cada uno de estos subelementos tiene el monto correspondiente de la deducción.