Configuración del Sistema y Migración Masiva
El módulo Configuración (/configuration, accesible para usuarios ADMIN y CONTABLE) concentra todos los parámetros fiscales, operativos, contables, de correo, usuarios, suscripción y migración de tu empresa en 11 pestañas organizadas en su barra lateral.
Tour por las pestañas de Configuración
Sección titulada «Tour por las pestañas de Configuración»1. Empresa
Sección titulada «1. Empresa»Define la identidad institucional y fiscal que aparece en tus facturas formato Carta, recibos térmicos 80mm y cotizaciones:
- Logotipo de la Empresa: Sube imágenes PNG, JPG, WebP o SVG (máx.
4 MB); Zoule optimiza y redimensiona automáticamente formatos raster para PDF de alta resolución. - Modo de Visualización en Encabezado: Elige entre
Logo + Nombre,Solo Logo(ideal si tu logo ya contiene el nombre comercial) oSolo Nombre. - Datos Fiscales:
Nombre Comercial,Razón Social,RNC *(obligatorio),Dirección,Teléfono,Correo ElectrónicoySitio Web.
2. Facturación
Sección titulada «2. Facturación»Configura cómo se emiten las facturas estándar y su control de caja:
- Facturación Electrónica: Habilita el flujo de comprobantes e-CF. Una vez que cargas y validas un certificado
.p12, este interruptor queda bloqueado activo por cumplimiento DGII. - Control y Cierre de Caja en Facturación Estándar (Opcional): Activa
enableStandardCashClosepara habilitar apertura de turno, entradas/salidas de efectivo, arqueo por denominaciones y reporte de cierre en/billing/cash-register. Puedes combinarlo conExigir turno de caja abierto para facturar al contado o registrar cobros(requireOpenCashDrawerToBill); guardar borradores y emitir cotizaciones nunca se bloquea. Ver Cierre de Caja en Facturación. - Formato y Numeración:
Serie de Facturación(referencia interna; se recomienda prefijoEcuando emites e-CF),Tipo de Documento para Facturación(CARTAoTERMICA),Moneda Predeterminada(PESOS DOMINICANOS (RD)),Término y condicionesyPie de factura.
3. Punto de Venta (POS)
Sección titulada «3. Punto de Venta (POS)»Controla el comportamiento de comandas y los add-ons de Hospitality:
- Comanda obligatoria en cada despacho y cobro (
mandatoryComanda): Exige generar e imprimir comanda en todo despacho y al cobrar ventas directas o ítems pendientes. - Add-on Diseño de Establecimiento, Mapa en Vivo y QRs por Mesa (
enableVenueDesigner): Habilita el diseñador visual 2D drag & drop de zonas/mesas (/pos/venue-designer), tarjetas QR imprimibles por zona y mapa operativo en vivo dentro del POS. - Add-on Autopedido QR en Mesa y Llamado de Mesero (
enableQrSelfOrder): Activa el menú digital/menu/:qrTokeny permite activarExigir aprobación previa en Barra en el 1er pedido de una mesa vacía(qrRequireBarApproval) para evitar pedidos falsos desde fuera del local. - Add-on Propina Legal 10% Elegible (
enableLegalTip): Permite aplicar o retirar el10%de Propina Legal sobre el subtotal neto (sin generar ITBIS sobre la propina) en pre-cuentas, tickets 80mm, Carta, asientos y XML e-CF (código adicional001), con opción de pre-marcarla automáticamente en mesas (legalTipDefaultOnTables). Ver Salón, Mesas y Menú QR.
4. Inventario
Sección titulada «4. Inventario»Define el comportamiento base de existencias:
- Control de Stock (
stockControl): Activa la validación automática de inventario disponible. - Stock Mínimo por Defecto (
minStock): Umbral base de alerta cuando creas productos nuevos. - Almacén predeterminado: Almacén seleccionado por defecto en operaciones comerciales.
- Método de valoración de inventario: Método
FIFO(First-In, First-Out / PEPS) para el costeo exacto por capas de compra. Ver Almacenes y Costeo FIFO.
5. Usuarios
Sección titulada «5. Usuarios»Administra los colaboradores de la empresa:
- Crea o edita usuarios con
Nombre Completo,Correo Electrónico,Contraseña,PIN POS(4 dígitos numéricos para desbloqueo rápido en terminal) yCódigo de Sobrescritura(para autorizadoresADMIN,CONTABLEoSUPERVISOR). - Asigna uno o varios roles (
ADMIN,CONTABLE,SUPERVISOR,CAJERO,MESERO) o desactiva cuentas existentes. - Recuerda que el usuario
CONTABLE(1 por empresa) está incluido sin consumir tu cupo de usuarios operativos.
6. Correo (SMTP)
Sección titulada «6. Correo (SMTP)»Conecta tu buzón corporativo para enviar facturas, cotizaciones y volantes de pago directamente desde tu dominio:
- Completa
Servidor SMTP (Host),Puerto,Usuario (Correo)yContraseña, y verifica al instante con Probar Conexión. - La pestaña incluye guías rápidas integradas para Gmail / Google Workspace (host
smtp.gmail.com, puerto465SSL/TLS usando una Contraseña de aplicación), Microsoft 365 / Outlook (hostsmtp.office365.com, puerto587STARTTLS) y proveedores cPanel/Hostinger/GoDaddy.
7. Suscripción
Sección titulada «7. Suscripción»Panel Mi Membresía y Pagos:
- Visualiza el estado de la suscripción (
Activa,En Periodo de Gracia,Vencida / Bloqueada,Suspendida), el consumo de tus cuotas mensuales de facturación, usuarios operativos y almacenes, los módulos incluidos en tu plan (Facturación,Negocio,Pro) y opciones de mejora de nivel. - Muestra las cuentas bancarias oficiales, el botón Reportar Pago / Subir Bauche, el historial de pagos reportados con descarga de comprobante y acceso directo a Soporte WhatsApp.
8. Migración
Sección titulada «8. Migración»Centro unificado para cargar datos desde Excel/CSV mediante la Plantilla Maestra de 10 hojas, ejecutar respaldos completos (Respaldar Todo) o activar el Modo Demo 360° (carga idempotente de datos coherentes en todos los módulos para pruebas o demostraciones comerciales). Detallamos este flujo completo en la segunda mitad de esta guía.
9. Contabilidad
Sección titulada «9. Contabilidad»Mapeo de cuentas contables por defecto para la generación automática de asientos al facturar, comprar o cobrar:
- Ventas e Ingresos:
Cuenta de Ventas (Ingresos),ITBIS por Pagar (Fiscal)yCuentas por Cobrar (Clientes). - Compras y Activos:
Cuenta de Inventario,ITBIS Pagado (Compras),Cuentas por Pagar (Proveedores)yCosto de Ventas. - Tesorería y Caja:
Cuenta de Caja General. - Si creaste tu empresa con el Catálogo estándar RD pre-cargado, todas estas cuentas ya vienen mapeadas automáticamente.
10. RRHH & Nómina
Sección titulada «10. RRHH & Nómina»Disponible cuando la empresa cuenta con el Add-on RRHH activo:
- Configura parámetros legales del Código de Trabajo Ley 16-92 (
190.64horas/mes,23.83días/mes, recargo nocturno15%, horas extras diurnas35%, fines de semana y feriados100%), tasas y topes de TSS (SFS,AFP,SRL,INFOTEP), tope exento mensual DGII IR-3, coberturas de licencias (SISALRILeIDOPPRIL) y cuentas contables de nómina. Ver Empleados y Nómina RD.
11. Facturación Electrónica
Sección titulada «11. Facturación Electrónica»Gestión técnica de tu identidad digital e-CF ante la DGII:
- Carga tu certificado digital
.p12/.pfxjunto con su contraseña (almacenado cifrado con seguridad AES-256). - Consulta titular, entidad emisora (CA) y fecha de vencimiento del certificado.
- Selecciona el ambiente operativo DGII:
Certificación (CerteCF)(ecf.dgii.gov.do/CerteCF) oProducción, y accede al Wizard de Certificación DGII en 15 Pasos.
Migración Masiva: Plantilla Maestra de 10 Hojas
Sección titulada «Migración Masiva: Plantilla Maestra de 10 Hojas»En Configuración → Migración dispones de tres botones superiores principales:
- Plantilla Maestra: Descarga el libro Excel único
plantilla_maestra_zoule.xlsxque contiene exactamente 10 hojas listas para llenar. - Respaldar Todo: Genera y descarga al instante el archivo
backup_completo_YYYY-MM-DD.xlsxcon el respaldo integral de tu empresa (Cuentas_Contables,Productos,Suplidores,Clientes,CxC_Pendientes,CxP_Pendientes,Secuencias_NCFyEmpleados_RRHH). - Modo Demo 360°: Carga un ecosistema de ejemplo completo y sin duplicados en entornos de prueba o demostración.
Orden recomendado de importación y detalle de las 10 hojas
Sección titulada «Orden recomendado de importación y detalle de las 10 hojas»Aunque cada tarjeta permite subir un archivo individual (.xlsx, .xls o .csv) o el mismo libro maestro multi-hoja (el motor detecta automáticamente la hoja correspondiente por nombre o usa la primera hoja), sigue este orden lógico para que las relaciones entre módulos existan al momento de validar:
| Orden | Tarjeta en Migración | Hoja en Plantilla Maestra | Columnas clave y reglas reales de validación |
|---|---|---|---|
| 1 | Catálogo Contable | Contabilidad |
Codigo, Nombre, Tipo (ASSET, etc.), Categoria (VIEW para grupo o ACCOUNT para detalle registrable), Padre, Codigo_DGII_606. Reconoce jerarquías por código. |
| 2 | Saldos Iniciales | Saldos_Iniciales |
Cuenta_Codigo, Nombre_Referencial, Debito, Credito, Referencia. Permite elegir Fecha de Corte / Apertura. Valida que las cuentas existan y sean de detalle (ACCOUNT, no VIEW) y que la partida doble cuadre (Débito = Crédito); ofrece ajuste automático opcional contra 31 CAPITAL SOCIAL. |
| 3 | Secuencias NCF / e-CF | Secuencias_NCF |
Tipo_Comprobante (B01, B02, E31, etc.), Secuencia_Inicial, Secuencia_Final, Ultimo_Usado, Fecha_Asignacion, Fecha_Vencimiento, Alerta_Cantidad, Alerta_Dias. Detecta conflictos con rangos activos previos y permite suspender rangos anteriores del mismo tipo al importar. |
| 4 | Suplidores | Suplidores |
Nombre, RNC, Telefono, Email, Direccion, Contacto. Previsualiza nuevos vs existentes antes de aplicar. |
| 5 | Clientes | Clientes |
Nombre, RNC, Telefono, Email, Direccion, Contacto, Saldo_Favor. Carga base de clientes y saldos iniciales a favor en billetera. |
| 6 | Productos y Servicios | Productos |
SKU, Nombre, Descripción Interna, Precio, Costo, Impuesto, Stock Mínimo, Tipo (product o service), Categoría, Unidad. Crea categorías faltantes automáticamente y verifica el límite de ítems por carga según tu plan (300, 1,000 o 2,500 filas). |
| 7 | Ajuste de Stock | Inventario |
SKU, Nombre (Opcional), Cantidad, Costo Unitario. Seleccionas el Almacén Destino en el diálogo; registra un ajuste de inventario creando capas FIFO con el costo unitario indicado. |
| 8 | Facturas Históricas / CxC Iniciales | CxC_Iniciales |
Cliente_Nombre, Cliente_RNC, NCF_o_Referencia, Fecha_Emision, Fecha_Vencimiento, Monto_Original, Monto_Pendiente, Moneda, Notas. Crea facturas abiertas en Facturación, alimenta CxC, Antigüedad, Cobros Masivos y Portal de Clientes sin alterar inventario físico ni consumir secuencias NCF vigentes; crea clientes nuevos sin duplicar y permite marcar opcionalmente el asiento contable de apertura (Débito CxC 1102-01 vs Capital Social 31). |
| 9 | Compras Históricas / CxP Iniciales | CxP_Iniciales |
Suplidor_Nombre, Suplidor_RNC, Factura_o_NCF, Fecha_Emision, Fecha_Vencimiento, Monto_Original, Monto_Pendiente, Moneda, Notas. Crea compras pendientes en Compras y alimenta CxP y Pagos a Suplidores sin duplicar existencias en almacén; crea suplidores nuevos sin duplicar y permite marcar opcionalmente el asiento contable de apertura (Débito Capital Social 31 vs Crédito CxP 2101-01). |
| 10 | Colaboradores RRHH | Empleados_RRHH |
Nombres, Apellidos, Tipo_Documento, Numero_Documento, NSS, Email, Telefono, Direccion, Departamento, Cargo, Salario_Mensual, Frecuencia_Pago (QUINCENAL, MENSUAL, SEMANAL), Tipo_Contrato, Fecha_Ingreso, Banco, Cuenta_Bancaria, Tipo_Cuenta. Crea automáticamente departamentos y cargos inexistentes. |
Paso a paso para ejecutar cada importación
Sección titulada «Paso a paso para ejecutar cada importación»-
Descarga la Plantilla Maestra o la plantilla individual Desde Configuración → Migración, descarga
plantilla_maestra_zoule.xlsx(o usa el botón Descargar Plantilla dentro de la tarjeta específica que vas a cargar). -
Llena tus datos respetando formatos de fecha y montos Usa fechas en formato
YYYY-MM-DD(por ejemplo2026-01-31) y montos numéricos limpios. Puedes mantener nombres de hoja exactos si subes el archivo maestro completo a cada importador. -
Ejecuta la pre-validación (
Validar) Sube tu archivo.xlsx,.xlso.csvdentro de la tarjeta correspondiente. Zoule lee el archivo sin modificar la base de datos y muestra un resumen previo: registros nuevos, existentes, advertencias, errores por número de fila y vista previa de muestra. -
Confirma e importa con barra de progreso en vivo Corrige cualquier observación si existe y confirma la importación. Verás el avance en tiempo real mediante WebSockets y, al finalizar, el log quedará registrado tanto en la pestaña Historial de cada importador (con opción de Revertir / Deshacer cuando aplique) como en Actividad Reciente de Migración.