OdooWiki OCA HUB

Payroll Sheet Importer

account_payroll_sheet_import folder_open OCA/account-financial-tools open_in_new
Accounting Licencia: AGPL-3

Este módulo permite importar datos de nóminas desde archivos Excel (.xlsx) a asientos contables en Odoo. Agiliza la integración entre sistemas externos de RR. HH./nóminas y el módulo de contabilidad de Odoo.

Características principales:

  • Asignar columnas de Excel a cuentas contables específicas.
  • Detectar y notificar empleados faltantes según los números de VAT/ID/Pasaporte.
  • Asociar los datos importados con un diario contable específico.
  • Compatibilidad con múltiples configuraciones de asignación por compañía.

Este módulo es ideal para empresas que reciben nóminas procesadas externamente en formato Excel y necesitan una forma semiautomatizada de registrarlas en el sistema de contabilidad de Odoo.

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 19.0

Permite a los contables importar una hoja de nóminas de Excel y crear automáticamente un asiento contable en borrador en Odoo, usando asignaciones guardadas de columna a cuenta y emparejando cada fila con un empleado por ID o número de pasaporte.

Este módulo añade una forma de convertir una hoja de cálculo de nóminas preparada externamente en un asiento contable, sin teclear las líneas a mano.

Dónde aparece en Odoo: - En la configuración de Contabilidad hay una nueva sección "Payroll Mapping" con dos pantallas: "Payroll Mapping" (las cabeceras de mapeo) y "Payroll Mapping Lines" (las reglas individuales de columna a cuenta). - En los asientos contables hay un menú "Payroll Import" que abre una pequeña ventana de carga.

Cómo funciona: - Primero creas un mapeo: le das un nombre, eliges el diario contable y nombras la columna de Excel que contiene el ID o el número de pasaporte del empleado. Después indicas, para cada columna de Excel, a qué cuenta contable va y si es un débito o un crédito. Opcionalmente, una columna puede registrarse en un partner fijo en lugar del empleado. - En la ventana de importación subes el archivo Excel, eliges un mapeo y pulsas Import.

El módulo comprueba entonces que todas las columnas mapeadas y la columna de ID existan en el archivo, y rechaza la importación en caso contrario. Cada fila se empareja con un empleado mediante su número de identificación o de pasaporte; las filas sin coincidencia se recopilan y se muestran en una ventana de advertencia "Missing Contacts" que lista los números de ID desconocidos, para que puedas crear primero esos empleados.

Reglas de negocio: - Solo se aceptan archivos .xlsx/.xls. - Los importes cero o vacíos se omiten. - Para cada empleado, el total de débitos debe ser igual al total de créditos; si no, la importación se detiene y muestra las líneas del empleado con sus totales de débito y crédito. - El asiento resultante se crea en el diario elegido, referenciado con el nombre del archivo y la fecha de hoy, y se abre para su revisión.

Los mapeos son específicos de cada compañía, y las reglas multi-compañía mantienen separados los mapeos de cada compañía. El acceso está limitado a los usuarios de contabilidad.

Depende de

accounthr

Menús que añade

Payroll MappingPayroll MappingPayroll Mapping LinesPayroll ImportImport Payroll
Modelos y campos (4)
  • payroll.import.wizard · modelo nuevofile (Excel File), filename, mapping_id (Column Mapping)
  • missing.partner.wizard · modelo nuevomissing_ids (Missing IDs)
  • payroll.import.mapping · modelo nuevoname (Mapping Name), id_column (ID Column), company_id (Company), journal_id (Journal), mapping_line_ids (Column Mappings)
  • payroll.import.mapping.line · modelo nuevosequence, move_type, account_id (Account), company_id (Company), column_name (Excel Column Name), other_partner_id (Other Partner)

Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 3 confirmadas, 6 sin información de 9 versiones.

Fuentes · Odoo 19.0

Confirmado el 2026-11-03 en la rama 19.0 de OCA/account-financial-tools.

terminal Instalación y uso

Documentación de OCA · Odoo 19.0

Requisitos del archivo Excel

  • El archivo debe estar en formato .xlsx.
  • Debe contener una columna con identificadores de empleados (p. ej., VAT/ID/Passport).
  • Las columnas de datos deben coincidir con las definidas en el mapeo seleccionado.
  • El formato debe ser:

| VAT/ID/Passport | Base Salary | Extra Hours | Other Concepts.. | |-----------------|-------------|-------------|------------------| | 1 | 2000 | 500 | ... | | 2 | 1800 | 250 | ... |

Requisitos de los empleados

Para emparejar correctamente los apuntes de nómina con los empleados existentes (y sus contactos vinculados), cada empleado debe tener un identificador único definido en uno de los siguientes campos:

  • Identification Nº (identification_id)
  • Passport (passport_id)

Estos campos deben coincidir con los valores proporcionados en la columna correspondiente del Excel. Si no se encuentra ningún empleado coincidente, el sistema listará los identificadores faltantes, y deberá crear los registros que falten o actualizar los identificadores en consecuencia.

Creación de un mapeo de columnas

  • Vaya a Accounting > Configuration > Payroll Mapping.
  • Cree un nuevo mapeo y configure:
  • Nombre del mapeo.
  • Diario de destino.
  • Nombre de la columna que contiene el VAT/ID/Pasport del empleado.
  • Líneas de mapeo: columna Excel → cuenta → tipo de apunte (debit/credit). Ej.: "NET SALARY", 230000, credit
  • Other Partner (opcional): defina este campo en una línea de mapeo para usar un contacto específico en lugar del contacto asociado al empleado. Si se deja vacío, se usa el contacto del empleado. Ejemplo: para un seguro de salud privado pagado por la empresa, seleccione la aseguradora como Other Partner para que el apunte contable correspondiente se asigne a la aseguradora en lugar del empleado.
  • Guarde el mapeo para usarlo en el futuro.

Importación

  • Vaya a Accounting > Accounting > Payroll Import.
  • Suba un archivo Excel que contenga los datos de nómina.
  • Elija un mapeo de columnas configurado previamente.
  • El sistema intentará emparejar a los empleados usando los números VAT/ID/Passport:
  • Tras la validación, haga clic en Import para generar los apuntes contables.
  • Si faltan empleados, se mostrará una advertencia con los identificadores no emparejados.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Configuración.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.