Ajustes generales

Toda la configuración base del tenant vive en Ajustes: datos de la empresa, moneda y zona horaria, plantillas de documentos, integraciones (email y storage), impuestos, condiciones de crédito y márgenes. Esta es la pantalla a la que vuelves cada vez que algo "global" cambie.

Tiempo de lectura: ~7 min

Cuándo usar esto

• Acabas de crear el tenant y vas a dejar listos los datos de la empresa.
• Cambió el teléfono, la dirección o el correo del negocio.
• Vas a configurar los prefijos de tus facturas (FAC-, COT-) o el método de valoración de inventario.
• Tienes que conectar un proveedor de email (Brevo o SMTP) o de almacenamiento (R2 o S3).
• Quieres editar las tasas de impuesto, las condiciones de crédito o los márgenes por defecto.

Antes de empezar

• Para escribir necesitas el permiso settings:write. Para los apartados específicos hay permisos por recurso: tax-rates:write, credit-conditions:write, profit-margins:write, integrations:write. Sin ellos, ves la pantalla en modo lectura con la nota No tienes permiso para editar la configuración.
• Algunos campos (como el RNC del tenant fiscal) se gestionan desde Fiscal, no desde aquí.

Mapa de la sección Ajustes

La barra de navegación de Ajustes tiene estas secciones (en este orden):

• General (/settings) - datos de la empresa, localización, prefijos, inventario.
• Impuestos (/settings/tax) - catálogo de tasas de ITBIS u otras.
• Crédito (/settings/credit) - condiciones de crédito disponibles para clientes.
• Márgenes (/settings/margins) - margen por defecto y reglas de redondeo de precios.
• Usuarios (/settings/users) - ver Usuarios, roles y permisos.
• Roles (/settings/roles) - ídem.
• Integraciones (/settings/integrations) - proveedores de email y storage.
• Módulos (/settings/modules) - ver Módulos.

General: datos de la empresa

Editables en Ajustes › General:

• Nombre comercial (companyName) - el que ven tus clientes.
• Nombre legal (legalName) - el que va en documentos legales.
• Teléfono, Email, Sitio web, Dirección.

Estos datos alimentan plantillas de facturación, cotizaciones y correos transaccionales del tenant.

El RNC del tenant se establece desde el módulo Fiscal y queda en solo lectura una vez configurado. No se edita en esta pantalla.

General: localización

• Moneda - DOP (Peso dominicano), USD o EUR. Es la moneda principal del tenant.
• Zona horaria - America/Santo_Domingo, America/New_York o UTC. Afecta cómo se muestran y agrupan fechas en reportes.
• Formato de fecha - DD/MM/YYYY, MM/DD/YYYY o YYYY-MM-DD.

El idioma de la interfaz se selecciona por usuario, no a nivel tenant.

General: prefijos y notas de documentos

• Prefijo de factura (FAC- por defecto), de cotización (COT-), de orden de compra (OC-) y de nota de crédito (NC-). Se usan para la numeración interna; cámbialos solo antes de emitir documentos para evitar saltos en la secuencia.
• Notas de factura, política de cotización y política de devoluciones - bloques de texto largos que aparecen al pie de cada documento generado.

General: inventario y contabilidad

• Alerta de stock bajo - switch que activa los avisos cuando un producto cae bajo su mínimo.
• Método de valoración - FIFO, LIFO o Average Cost. Cámbialo solo antes de tener movimientos; alterar el método con historial puede recalcular costos.
• Asentar asientos contables automáticamente - switch que, si está encendido y el módulo Contabilidad está activo, postea las facturas y pagos al diario contable sin intervención manual.

Impuestos

En Ajustes › Impuestos mantienes el catálogo de tasas. Cada tasa tiene:

• Nombre (por ejemplo ITBIS 18%).
• Porcentaje (ratePercent) entre 0 y 100.
• Código opcional para integraciones.
• Flag Por defecto - la tasa que se aplica al crear un producto nuevo. Solo una puede ser por defecto a la vez.

Los botones de lápiz y papelera permiten editar y eliminar. La tasa por defecto del sistema no se puede borrar mientras esté marcada como tal.

Condiciones de crédito

En Ajustes › Crédito configuras los términos que ofreces a clientes:

• Nombre (por ejemplo Contado, 15 días, 30 días).
• Días para pagar (daysToPay) - 0 para contado.
• Descripción opcional.
• Flag Por defecto - la que se preselecciona al crear un cliente o factura.

Márgenes

En Ajustes › Márgenes defines reglas globales de pricing:

• Margen por defecto - porcentaje que se sugiere al crear un producto.
• Aplicar automáticamente a productos nuevos - switch que, si está activo, calcula el precio de venta a partir del costo y este margen.
• Redondear al múltiplo de - por ejemplo 1.00 para pesos enteros o 0.50 para múltiplos de medio peso.

Integraciones

Ajustes › Integraciones tiene dos tarjetas:

Email del tenant

Selecciona el proveedor que manda los correos transaccionales del tenant (envío de facturas, recordatorios de pago, etc.):

• Brevo - pega la API key, el email y el nombre del remitente.
• SMTP - host, puerto, usuario, contraseña, y un switch de TLS/SSL.

Tras guardar, usa el botón Probar conexión para verificar que las credenciales son válidas. Verás un badge Configurado con la fecha del último test.

El correo de bienvenida y otras comunicaciones globales de la plataforma siempre salen del Brevo de Mosce ERP; lo que configures aquí solo se usa para correos generados por tu tenant.

Storage

Mismo patrón para el almacenamiento de archivos (logos, adjuntos, exportaciones):

• Cloudflare R2 - endpoint y credenciales.
• AWS S3 - región, bucket y credenciales.

Resultado esperado

• Cada cambio confirma con un toast (Configuración guardada) y queda activo de inmediato para todos los usuarios del tenant.
• Las plantillas de facturas y cotizaciones recogen los nuevos datos en el siguiente documento que generes.
• Los proveedores de integración configurados muestran un punto verde Configurado en su tarjeta.

Errores comunes

• Cambié el método de valoración de inventario y se desordenaron costos. El cambio recalcula con base en el nuevo método; revierte y revisa el historial antes de volver a probar.
• Probé email y dice "no configurado". Guarda primero, luego prueba. El test usa lo que está persistido, no lo que tienes en pantalla.
• No veo la sección X en Ajustes. O te falta el permiso correspondiente, o el módulo asociado está apagado. Revisa Módulos y Usuarios, roles y permisos.
• El logo no aparece en facturas. Súbelo desde el módulo Fiscal o desde la sección de plantillas; Ajustes generales no expone el campo de logo en esta versión.

Relacionados

• Módulos - los apartados que veas dependen de qué módulos están activos.
• Usuarios, roles y permisos - gestión de personas con acceso al tenant.
• Facturación y suscripción - datos de pago de tu suscripción a Mosce ERP (no se editan aquí).
• Fiscal - RNC del tenant, secuencias de e-CF y certificado fiscal.