Ir al contenido

Clientes y Padrón Maestro DGII

El catálogo de Clientes (/billing/customers) centraliza los datos fiscales, condiciones comerciales y el historial financiero de tus compradores, integrado directamente con una réplica local del Padrón Maestro de Contribuyentes de la DGII.

Padrón Maestro DGII Local (<1 ms de respuesta)

Sección titulada «Padrón Maestro DGII Local (<1 ms de respuesta)»

Zoule mantiene indexada en base de datos local (dgii_rnc_cache) la nómina oficial de más de 794,000 contribuyentes registrados ante la DGII en República Dominicana. Esto elimina errores de digitación y evita depender de la disponibilidad de consultas externas al momento de facturar:

  • Consulta instantánea (<1 ms): Al ingresar un RNC (9 dígitos) o Cédula (11 dígitos) en Clientes, Facturación Estándar, Cotizaciones o POS, Zoule recupera al instante la Razón Social, el Nombre Comercial, la Actividad Económica y el Estado (ACTIVO, etc.).
  • Autocompletado desde cualquier pantalla de venta: Si un cliente empresarial llega por primera vez, el botón Nuevo Cliente en Facturación o Cotizaciones busca en el padrón DGII y guarda la ficha lista para emitir B01 o E31.
  • Sincronización global (exclusiva de SUPER_ADMIN): La actualización del padrón nacional desde el archivo oficial .zip de la DGII o carga manual .zip/.txt se gestiona centralizadamente en Configuración → Facturación mediante la tarjeta Padrón Maestro de Contribuyentes DGII y beneficia automáticamente a todas las empresas del entorno.

Ficha del cliente y configuración comercial

Sección titulada «Ficha del cliente y configuración comercial»

Al crear o editar un cliente en Facturación → Clientes → Crear (/billing/customers/new), su expediente se organiza en cuatro pestañas:

1. Información Fiscal y Comercial

Define Nombre / Razón Social, Dirección, Ciudad, País, Tipo de Identificación (RNC o CEDULA), el número de RNC/Cédula con búsqueda DGII y sus valores predeterminados de facturación.

2. Contacto

Almacena persona de contacto, teléfono (usado para compartir comprobantes y enlaces por WhatsApp) y correo electrónico (usado para el envío automático de PDFs).

3. Historial de Ventas

Muestra todas las facturas emitidas al cliente con acceso directo al detalle, estado de pago y monto pendiente.

4. Billetera / Saldo

Visualiza el Saldo a Favor (CustomerWallet) disponible y el kardex de entradas por Notas de Crédito y aplicaciones a facturas.

Configurar los valores por defecto en la pestaña Información acelera el trabajo de caja y facturación:

  • Plazo de Pago (paymentTerm): Elige entre CONTADO, 8 DIAS, 15 DIAS, 30 DIAS, 60 DIAS o PLAZO MANUAL. Al seleccionar al cliente en una factura estándar, Zoule asigna automáticamente este plazo, calcula la fecha de vencimiento para Cuentas por Cobrar (CxC) y determina el reporte de Antigüedad de Saldos (1-30, 31-60, 61-90, `>90 días`).
  • Moneda (currency): RD (Pesos Dominicanos) o USD (Dólares).
  • Tipo de Factura (invoiceType): Puedes fijar si el cliente recibe Crédito Fiscal (B01 / E31), Consumo (B02 / E32), Régimen Especial (B14 / E44) o Gubernamental (B15 / E45). Cuando la empresa tiene activa la Facturación Electrónica, Zoule mapea automáticamente los tipos B heredados hacia su equivalente E (B01 -> E31, B02 -> E32, etc.).

Si migras desde otro sistema o tienes una cartera existente en Excel:

  1. Entra a Facturación → Clientes y haz clic en Importar en la barra superior.
  2. Descarga o prepara tu archivo con columnas de nombre, RNC/Cédula, teléfono, correo, dirección y plazo de pago.
  3. Carga el archivo y sigue el asistente de mapeo y validación de duplicados para poblar tu cartera en segundos.

Al crearse cualquier empresa en Zoule, el sistema aprovisiona automáticamente un cliente genérico llamado CONSUMIDOR FINAL con los siguientes valores predeterminados:

  • Identificación: Cédula 000-0000000-0
  • Plazo de pago y moneda: DE_CONTADO en RD
  • Comprobante asignado: B02 (Consumo) en modo tradicional, o E32 (Consumo Electrónico) automáticamente cuando la empresa opera en modo e-CF.