Mapeos Contables

Los Mapeos Contables (o configuración de integración contable) definen qué cuentas del plan de cuentas se afectan automáticamente cuando otros módulos del ERP generan operaciones financieras.

Sin mapeos configurados, las operaciones de nómina, compras, proyectos e inventario no generarán asientos contables automáticos.

---

¿Qué es un Mapeo Contable?

Un mapeo define:

• Módulo origen: el módulo que genera la operación (payroll, procurement, projects, inventory, treasury)
• Tipo de entidad: el tipo de operación dentro de ese módulo (SALARY_EXPENSE, INVENTORY_ASSET, etc.)
• Cuenta Débito: la cuenta que se cargará (D) automáticamente
• Cuenta Crédito: la cuenta que se abonará (C) automáticamente

---

Cómo acceder

1. En el menú lateral, seleccione "Contabilidad"
2. Haga clic en "Mapeos Contables"
3. Verá la lista de todos los mapeos configurados, agrupados por módulo

---

Módulos y tipos de mapeo disponibles

Módulo: Nómina (payroll)

Tipo de Entidad	Qué representa	Débito	Crédito
SALARY_EXPENSE	Gasto de salario bruto	Gasto de Personal	—
SALARY_PAYABLE	Salarios por pagar a empleados	—	CxP Nómina
BANK_ACCOUNT	Cuenta bancaria de pago	CxP Nómina	Banco
SS_PAYABLE	Seguridad social por pagar	—	CxP IVSS
EMPLOYER_SS_EXPENSE	Gasto IVSS patronal	Gasto IVSS	—
TAX_WITHHOLDING_PAYABLE	Retenciones de ISLR	—	Retenciones por Pagar

Módulo: Inventario (inventory)

Tipo de Entidad	Qué representa
INVENTORY_ASSET	Cuenta de inventario en almacén
INVENTORY_PAYABLE	Cuentas por pagar a proveedores por compra
INVENTORY_COGS	Costo de ventas (salida por venta)
INVENTORY_ADJUSTMENT_GAIN	Ganancia por ajuste de inventario
INVENTORY_ADJUSTMENT_LOSS	Pérdida por ajuste de inventario
FIXED_ASSET	Activo fijo (cuando ítem se convierte en activo)
PROJECT_MATERIAL_EXPENSE	Gasto de materiales para proyectos
PURCHASE	Compra de inventario
SALE	Venta de inventario
DONATION_INCOME	Ingreso por donación de inventario

Módulo: Proyectos (projects)

Tipo de Entidad	Qué representa
CONSTRUCTION_IN_PROGRESS	Construcción en proceso (CAPEX)
CONTRACTOR_PAYABLE	CxP Contratistas por valuaciones aprobadas
BANK_ACCOUNT	Cuenta bancaria para pago a contratistas

Módulo: Procura (procurement)

Tipo de Entidad	Qué representa
PAYMENT	Pago de factura de proveedor

Módulo: Tesorería (treasury)

Tipo de Entidad	Qué representa
INCOME	Ingreso de tesorería (transacción de tipo INCOME)
EXPENSE	Egreso de tesorería (transacción de tipo EXPENSE)

---

Crear o editar un Mapeo

Paso 1

En la pantalla de Mapeos Contables, haga clic en "+ Nuevo Mapeo" o en el ícono de edición (✏️) de un mapeo existente.

Paso 2: Completar el formulario

Campo	Requerido	Descripción
Módulo	✅	Seleccione el módulo que genera la operación
Tipo de Entidad	✅	Seleccione el tipo de operación dentro del módulo
Cuenta Débito	✅	Cuenta que se cargará (D) en el asiento automático
Cuenta Crédito	✅	Cuenta que se abonará (C) en el asiento automático
Descripción		Descripción interna del mapeo
Prioridad		Orden de aplicación si hay múltiples mapeos del mismo tipo
Activo		Activar o desactivar el mapeo

Paso 3

Haga clic en "Guardar".

Nota: Solo pueden seleccionarse cuentas con accepts_transactions = true (cuentas de detalle, no cuentas padre de resumen).

---

Ejemplo de configuración de Nómina

Para que el pago de nómina genere asientos correctos, configure:

Módulo: payroll | Tipo: SALARY_EXPENSE
  Débito:  5.1.01 - Gasto de Salarios y Sueldos
  Crédito: (ninguno — este mapeo solo define el débito del gasto)

Módulo: payroll | Tipo: SALARY_PAYABLE
  Débito:  (ninguno)
  Crédito: 2.1.05 - Nómina por Pagar

Módulo: payroll | Tipo: BANK_ACCOUNT
  Débito:  2.1.05 - Nómina por Pagar
  Crédito: 1.1.01 - Banco Principal VES

Al aprobar la nómina, el sistema creará automáticamente:

• Asiento de acumulación: Gasto Salarios D / Nómina por Pagar C
• Asiento de pago: Nómina por Pagar D / Banco C

---

Verificar si un mapeo está funcionando

Si un módulo no genera asientos contables automáticos:

1. Vaya a Contabilidad → Mapeos Contables
2. Busque el módulo y tipo de entidad correspondiente
3. Verifique que el mapeo esté Activo
4. Verifique que las cuentas seleccionadas existan y estén activas
5. Verifique que las cuentas sean de tipo "detalle" (aceptan transacciones)

---

Preguntas Frecuentes

"Una operación de nómina no generó asiento contable"

• Verifique que existe un mapeo activo para payroll / SALARY_EXPENSE y payroll / SALARY_PAYABLE
• Verifique que las cuentas asignadas están activas

"¿Puedo tener múltiples mapeos para el mismo tipo?"

Sí, usando el campo Prioridad. El sistema aplicará el de mayor prioridad primero. Útil para mapear según moneda u otras condiciones.

"¿Los mapeos aplican retroactivamente?"

No. Los mapeos solo aplican a operaciones nuevas. Las operaciones anteriores no se recontabilizan automáticamente.

"¿Qué pasa si elimino un mapeo?"

Las futuras operaciones de ese tipo no generarán asientos automáticos. Las operaciones pasadas no se ven afectadas.