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_MISSINGy 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
- Andá a Contabilidad → Configuración contable.
- 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.
- 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.
- 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
| Error | Causa | Solución |
|---|---|---|
ACCOUNTING_MAPPING_MISSING al facturar | Falta uno de los slots críticos (AR, ventas, ITBIS, caja) | Abrí Configuración contable y completalo |
ACCOUNTING_SETTINGS_NOT_FOUND | El 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 igual | El mapeo solo afecta asientos futuros | Si necesitás reclasificar pasados, registrá un asiento manual de ajuste |
| No puedo desactivar una cuenta del Plan | Está mapeada en Configuración contable | Reasigná el mapeo a otra cuenta antes de desactivar |
Relacionados
- Plan de cuentas
- Asientos contables
- Períodos fiscales
- Cuentas bancarias
- ITBIS y otros impuestos - retenciones de ITBIS e ISR en compras.
- Compras - vista previa de retención al recibir.