Mosce ERP · Centro de ayuda
Contabilidad

Configuración contable

Mapear cuentas por defecto del tenant para guiar la generación automática de asientos por ventas, compras, ITBIS, caja, banco y cierre.

La Configuración contable es el mapeo del tenant entre eventos del negocio y cuentas del Plan de cuentas. Cuando facturás una venta, registrás un cobro o cerrás el ejercicio, Mosce ERP lee este mapeo para saber qué cuenta debitar y qué cuenta acreditar. Sin un mapeo completo, las automatizaciones devuelven ACCOUNTING_MAPPING_MISSING y el sistema te frena antes de generar asientos inconsistentes.

Tiempo de lectura: ~6 min

Cuándo usar esto

  • Acabás de activar Contabilidad y querés revisar los mapeos auto-asignados por el seed.
  • Cambiaste tu cuenta bancaria principal y necesitás reapuntar la Cuenta de caja (transferencia).
  • Tu contador pidió usar una cuenta distinta para ITBIS por pagar.
  • Vas a habilitar facturación con notas de crédito y necesitás mapear la cuenta de notas de crédito por pagar.

Antes de empezar

  • El módulo Contabilidad está activo. Si no, prendelo desde Ajustes → Módulos; la pantalla muestra un banner que te invita a activarlo.
  • El Plan de cuentas ya fue seedeado.
  • Tu rol incluye permiso accounting:settings.

Cómo funciona el modelo

AccountingSettings es un singleton por tenant - existe una sola fila por negocio. El seed la crea junto con el plan de cuentas y precarga los enlaces a las cuentas estándar (caja, banco, ITBIS, ventas, etc.) usando los códigos del catálogo dominicano. Desde la UI editás cada slot y guardás el cambio.

Cada slot es opcional a nivel base de datos, pero las automatizaciones fallan si la cuenta que necesitan está vacía: el sistema prefiere parar antes que postear contra una cuenta incorrecta.

Secciones de la pantalla

La pantalla Contabilidad → Configuración contable agrupa los mapeos por temática:

Caja por método de pago

  • Cuenta de caja (efectivo) → débito al cobrar en efectivo.
  • Cuenta de caja (tarjeta) → débito al cobrar con tarjeta.
  • Cuenta de caja (transferencia) → débito al recibir transferencia.
  • Cuenta de caja (cheque) → débito al recibir cheque.

Cada cuenta bancaria que crees en Banca → Cuentas bancarias genera automáticamente su propia cuenta contable enlazada. Asignala al método de pago que corresponda.

Cuentas por cobrar / pagar

  • Cuentas por cobrar (AR): débito al facturar a crédito; crédito al cobrar.
  • Cuentas por pagar (AP): crédito al recibir factura de proveedor; débito al pagarla.

Ventas e ITBIS

  • Ventas: crédito al facturar.
  • ITBIS por pagar: crédito al facturar - registra el impuesto que el negocio le debe a la DGII.

Para entender cómo Mosce ERP calcula el ITBIS en cada comprobante (tasas, exenciones, ISC, retenciones), consulta ITBIS y otros impuestos.

Retenciones en compras

Cuando tu negocio actúa como agente de retención y retiene ITBIS o ISR al comprar, lo retenido es una deuda frente a la DGII. Mosce ERP la registra en dos cuentas de pasivo:

  • Retenciones de ITBIS a Terceros: se acredita por el ITBIS que retuviste al proveedor.
  • Retenciones de ISR a Terceros: se acredita por el ISR que retuviste al proveedor.

Ambas se saldan cuando enteras lo retenido a la DGII. El cálculo de cuándo y cuánto se retiene se explica en Retenciones de ITBIS e ISR en compras.

Momento de la retención de ISR

Esta opción controla cuándo se reconoce el pasivo de la retención de ISR:

  • Al facturar / recibir: el pasivo de ISR se reconoce cuando registras la compra.
  • Al pago (valor por defecto): el pasivo de ISR se reconoce cuando efectivamente le pagas al proveedor.

La retención de ITBIS siempre se reconoce al recibir / facturar la compra - eso no es configurable. La opción de momento aplica únicamente a la retención de ISR.

Inventario y COGS

  • Inventario: débito al recibir compras y crédito al vender.
  • Costo de ventas (COGS): débito al vender por el costo.
  • Compras: cuenta intermedia para flujos donde la operación distingue inventario y compras.

Ajustes de inventario

Cuando confirmas un ajuste de inventario (por ejemplo tras un conteo físico), el sistema registra la diferencia valorizada al costo contra estas dos cuentas:

  • Pérdida por ajuste de inventario: se debita cuando el ajuste baja el stock (había menos en la realidad que en el sistema). El faltante sale del inventario.
  • Sobrante por ajuste de inventario: se acredita cuando el ajuste sube el stock (había más en la realidad que en el sistema). El excedente entra al inventario.

Si estas cuentas están sin mapear, el ajuste te avisa al confirmar y no cierra su asiento hasta que las completes. Ver Ajustes de inventario por lote.

Devoluciones y notas de crédito

  • Devoluciones en ventas: débito al procesar refund.
  • Notas de crédito por pagar: pasivo que se debita cuando una nota de crédito liquida una factura.

Patrimonio

  • Utilidades retenidas: destino del resultado neto en el cierre anual.

Diferencia cambiaria

  • Ganancia cambiaria y Pérdida cambiaria: acomodan diferencias de FX en operaciones multi-moneda (disponible próximamente).

Activos fijos y distribuciones

  • Ganancia en disposición y Pérdida en disposición: se usan al dar de baja un activo fijo arriba o por debajo del valor en libros.
  • Distribuciones a propietarios: contra-cuenta de patrimonio que se debita al pagar dividendos o retiros.

Paso a paso

  1. Andá a Contabilidad → Configuración contable.
  2. Para cada slot, abrí el selector y elegí la cuenta del Plan de cuentas. El selector busca por código o nombre y filtra cuentas activas.
  3. Si querés dejar un slot sin asignar, seleccioná Sin mapeo - sabé que cualquier flujo que dependa de ese slot va a fallar hasta que lo completes.
  4. Pulsá Guardar cambios. Mosce ERP actualiza el singleton y devuelve un toast Configuración actualizada.

Cómo se usa el mapeo

  • Facturar venta (ORDER_BILLED): débito a Cuentas por cobrar; crédito a Ventas y a ITBIS por pagar.
  • Cobrar venta (ORDER_PAID): débito a la Cuenta de caja del método; crédito a Cuentas por cobrar.
  • Recibir factura de proveedor (PURCHASE_RECEIVED): débito a Inventario o a la cuenta de gasto; crédito a Cuentas por pagar.
  • Reembolso (REFUND): débito a Devoluciones en ventas; crédito a la Cuenta de caja.
  • Cierre anual (YEAR_END_CLOSE): zerifica Ingresos y Gastos contra Utilidades retenidas.
  • Disposición de activo fijo: usa Ganancia / Pérdida en disposición según el caso.

Cada uno de estos asientos lleva source distinto y queda enlazado a la entidad de origen para auditoría.

Resultado esperado

  • Las facturas, cobros, compras y cierres generan asientos completos sin intervención manual.
  • Cuando cambiás un mapeo, los asientos futuros usan la cuenta nueva - los pasados no se reescriben.
  • Mosce ERP bloquea la desactivación de cualquier cuenta del Plan que esté siendo usada como mapeo activo (ACCOUNT_IN_USE_BY_MAPPING).

Errores comunes

ErrorCausaSolución
ACCOUNTING_MAPPING_MISSING al facturarFalta uno de los slots críticos (AR, ventas, ITBIS, caja)Abrí Configuración contable y completalo
ACCOUNTING_SETTINGS_NOT_FOUNDEl módulo Contabilidad nunca se activóActivalo en Ajustes → Módulos - el seed crea el singleton
Cambié la cuenta de ITBIS pero los asientos viejos siguen igualEl mapeo solo afecta asientos futurosSi necesitás reclasificar pasados, registrá un asiento manual de ajuste
No puedo desactivar una cuenta del PlanEstá mapeada en Configuración contableReasigná el mapeo a otra cuenta antes de desactivar

Relacionados