Manual Operativo para Empresas
Guía oficial para instituciones que reportan cartera, consultan el buró de crédito privado y ofrecen financiamiento dentro del Club SUNSCORE
Índice general
- Introducción y modelo de red
- Onboarding y primer acceso
- Facturación, licencia y métodos de pago
- Panel principal y mantra operativo
- Mi Institución: marca y membrete
- Clientes y expediente único
- SC-01 digital e imprimibles oficiales
- Obligaciones: reporte y estados
- Carga masiva: modelo estándar y SUN Capital
- Calendario mensual de compromisos
- Data complementaria
- Consulta del buró y reporte crediticio
- Monitoreo y motor de políticas
- Calidad de datos y checklists
- Reclamaciones
- Documentos y evidencias
- Usuarios, roles y seguridad
- Auditoría inmutable
- Integración por API
- Preguntas frecuentes
- Soporte y capacitación
- Club de Crédito y Marketplace de Pagos
- Apéndices A–D (técnicos)
1.Introducción
SUNSCORE es la red privada que consolida el historial crediticio de cada ciudadano dominicano por cédula, uniendo los reportes de todas las instituciones afiliadas en un expediente único con score 300–850.
💡 ¿Para quién es este manual?
Para financieras, cooperativas, prestamistas y entidades de crédito que reportan su cartera al buró, consultan el expediente consolidado de sus solicitantes, y ofrecen financiamiento a los socios del Club SUNSCORE.
1.1 Problemas que resuelve
- Préstamos a ciegas: sin red, cada entidad presta sin saber si el cliente está sobreendeudado en otras.
- Decisiones por suposición: sin historial real de comportamiento de pago entre entidades.
- Sin trazabilidad: nadie sabe quién consultó a quién, cuándo y con qué motivo.
- Scores incompatibles: cada entidad calcula riesgo con su propia fórmula y visión parcial.
- Cobranza informal: pagos por WhatsApp o llamadas sin evidencia ni recibo formal.
1.2 Lo que ofrece la red
- Expediente único por cédula: todas las obligaciones de una persona, reportadas por las propias instituciones.
- Score 300–850 del conglomerado: pondera pagos, endeudamiento, antigüedad, obligaciones, comportamiento reciente, saldados y consultas (ver Apéndice D).
- Consulta con consentimiento: cada acceso queda registrado con usuario, IP, motivo y evidencia (Ley 172-13).
- Historial mensual inmutable: cada mes se guarda una foto del comportamiento; nunca se borra ni se edita.
- Carga masiva inteligente: acepta tu archivo tal cual lo genera tu sistema (incluso con portadas y banners).
- API abierta: reporta y consulta desde tu propio core bancario o ERP.
- Club de Crédito: marketplace donde los socios solicitan financiamiento y las Empresas Socias ofertan, validan pagos y emiten recibos formales.
1.3 Regla de oro de la red
🔒 Privacidad por diseño
Ninguna institución ve la cartera de otra. Solo ves: (a) tus propias obligaciones en el módulo Clientes, y (b) el expediente consolidado de una persona cuando la consultas con su consentimiento, con el nivel de detalle que configura el administrador de la red.
1.4 Novedades de la versión 2.1
| Módulo nuevo / mejorado | Qué aporta |
|---|---|
| Club de Crédito y Marketplace de Pagos | Solicitudes de préstamo del socio, ofertas de la empresa, mensajería interna, abonos parciales, recibos con folio único y recordatorios de vencimiento. |
| Datos de cobro configurables | La empresa registra cuentas, wallets y sucursales; aparecen al socio al momento de pagar la cuota. |
| Validación humana de pagos | La empresa aprueba o rechaza comprobantes con motivo visible; el socio reintenta con corrección. |
| Recibos formales con folio único | Cada pago aprobado genera recibo imprimible/PDF con folio SC-YYYYMMDD-XXXXXXXX. |
1.5 Novedades de la versión 2.0
| Módulo nuevo / mejorado | Qué aporta |
|---|---|
| Onboarding obligatorio | Wizard de 3 pasos al primer ingreso: identidad, compromiso de carga y declaración de data verificada. |
| Facturación multi-moneda | Precio de licencia en RD$, USD, USDT, BTC o ETH; reporte de pago con comprobante y validación; contacto directo por WhatsApp. |
| Carga masiva de 2 modelos | Modelo estándar (24 columnas) y modelo SUN Capital (49 columnas) con números latinos 1.234,56, fechas DD-MM-AAAA y salto automático de portadas. |
| Calendario operativo | Compromisos mensuales de carga, vencimientos y eventos con vista mensual. |
| SC-01 digital e imprimible | Solicitud de consulta con firma del titular, en pantalla y en papel con tu membrete. |
| Calidad de datos | Checklists operativos, semáforo de calidad y detección de inconsistencias. |
| Monitoreo y políticas | Tablero de mora de tu cartera y motor de políticas de aprobación con asistente. |
| Optimización de imágenes | Las fotos y documentos gráficos se comprimen automáticamente sin perder legibilidad. |
2.Onboarding y primer acceso
La primera vez que un usuario admin o analista inicia sesión, la plataforma lo guía por un asistente obligatorio de 3 pasos. Hasta completarlo, no puede operar: es el contrato operativo de la red.
Confirma tu identidad
Verificas tu nombre (fijo, asignado por tu administrador), tu correo corporativo y tu teléfono/WhatsApp. Estos datos se usan para notificaciones de licencia, reclamos y novedades de la red.
Compromiso de carga mensual
Aceptas reportar tu cartera actualizada entre los días 1 y 7 hábil de cada mes. La red depende de data fresca: un score calculado con información obsoleta pone en riesgo a todas las instituciones.
Declaración de data verificada
Declaras bajo responsabilidad que toda la información subida (cédulas, referencias, fotos, empleos, ingresos) corresponde a titulares reales y verificables, y que la falsificación será reportada a las autoridades competentes.
⚠️ Política versionada
La aceptación queda registrada con fecha, hora, IP y versión de política. Si SUNSCORE publica una nueva versión de la política (ej. v1.1), el asistente se presentará de nuevo a todos los usuarios para re-aceptación.
2.1 Después del onboarding
- Cambia tu clave temporal por una propia (mínimo 8 caracteres).
- Activa la autenticación de dos factores (2FA) con Google Authenticator o Authy.
- Configura tu marca en Mi Institución (logo y membrete).
- Realiza tu primera carga de cartera (sección 9).
3.Facturación y licencia
El módulo Facturación concentra el plan activo de tu institución, el precio acordado, la fecha de vencimiento, las instrucciones de pago y el reporte de comprobantes.
3.1 Tu chip de licencia
En la cabecera del módulo verás siempre tres datos clave:
- Plan: whatsapp, mensual, semestral, anual, vitalicio o personalizado.
- Precio y moneda: el monto acordado con la administración de la red (RD$, USD, USDT, BTC o ETH).
- Vence: fecha límite y días restantes. Con menos de 15 días, el aviso se torna naranja.
3.2 Cómo pagar
- Entra a Facturación y revisa las cuentas habilitadas para tu moneda: bancos (titular, RNC/cédula, número y tipo de cuenta) o wallets cripto (dirección y código QR escaneable).
- Realiza el pago por tu canal preferido.
- En el formulario Reportar pago indica método, monto, referencia o número de transacción y adjunta el comprobante (imagen o PDF, máx. 4 MB).
- La administración de la red valida el comprobante. Al aprobarlo, tu licencia se extiende automáticamente según tu plan (30/180/365 días) y recibes confirmación por correo.
- Si el comprobante es rechazado, recibes el motivo y puedes reportar un nuevo pago.
🧾 Facturas con folio
Cada licencia asignada genera una factura con folio único (ej. F-20260916-000042) que puedes consultar en el historial del módulo, con plan, monto, moneda, vigencia y días.
3.3 Contacto directo para pagos
Licencia vencida o institución suspendida
Si la licencia vence o la institución es suspendida, el panel se bloquea al iniciar sesión. Tu data no se pierde: se restaura el acceso al regularizar el estado. Coordina la renovación por WhatsApp o reporta el pago desde Facturación.
4.Panel principal y mantra operativo
Al iniciar sesión ves el dashboard de tu institución con los indicadores de tu cartera reportada.
| Indicador | Qué mide | Para qué sirve |
|---|---|---|
| Clientes reportados | Personas únicas con obligaciones en tu cartera | Dimensionar tu base activa |
| Cartera reportada | Suma de montos originales de créditos activos | Ver tu exposición total |
| Balance pendiente | Suma de saldos actuales | Cuánto te deben hoy |
| Score promedio | Promedio 300–850 de tus clientes | Calidad crediticia de tu cartera |
| % Al día | Obligaciones en estado AL_DIA | Salud general de la cartera |
| Mora 30+ / 60+ / 90+ | % de obligaciones con atraso mayor a 30/60/90 días | Priorizar cobranza preventiva |
4.1 El mantra de la barra superior
En la parte superior verás siempre un chip pulsante con tu compromiso operativo:
- Verde Fuera de ventana: muestra la fecha del próximo compromiso y los días faltantes.
- Ámbar Ventana abierta (días 1–7 hábil): te invita a cargar con un enlace directo a Carga masiva.
4.2 Panel lateral al pasar el mouse
En los listados (clientes, obligaciones, consultas), al dejar el cursor sobre una fila se despliega un panel lateral con resumen rápido: score, obligaciones, referencias, calidad y accesos directos a ficha, PDF e impresión. Se cierra con la tecla Esc.
📊 Ejemplo: lectura de cartera
5.Mi Institución
Configura la identidad corporativa con la que sales en toda la red.
5.1 Datos corporativos
- Nombre comercial, razón social, representante legal.
- Correo institucional, teléfono/WhatsApp, dirección.
- RNC no editable: es el identificador único validado en el registro.
5.2 Logo de pantalla
Aparece en el panel, fichas y encabezados internos. Formatos PNG, JPG, SVG, WEBP · máx. 2 MB · se recomienda fondo transparente. Las imágenes se optimizan automáticamente al subirse para mantener el sistema ágil.
5.3 Membrete de impresión
Encabezado horizontal (sugerido 1200×200 px) que encabeza todos tus documentos oficiales: reportes crediticios, contratos, constancias, SC-01, fichas y estados de obligación. Debe incluir nombre, RNC y contacto visibles. Si no subes membrete, los documentos llevan la marca SUNSCORE como autoría de procedencia.
🎨 Ejemplo: co-branding
logo.png (transparente) y membrete.png con logo, RNC, dirección y teléfono.6.Clientes y expediente
6.1 Registrar persona
Al escribir la cédula (11 dígitos), el sistema:
- Valida el formato y hace pre-chequeo en vivo: si la cédula ya existe, te avisa antes de guardar y te ofrece abrir su ficha (evita duplicados).
- Busca en el padrón JCE: si la encuentra, autocompleta nombre y marca Verificado JCE; si no, permite registro Manual.
- Bloquea la edición del nombre cuando proviene de JCE para preservar la identidad oficial del titular.
Campos del expediente: teléfono, dirección, fecha de nacimiento, empleo, ingresos mensuales, foto y documentos.
💡 Borrador automático
Si el formulario falla o recargas la página, los datos que ya habías escrito se conservan y se restauran al volver: no pierdes el trabajo de digitación.
6.2 Referencias personales (bloque F)
El Manual Operativo exige al menos 1 referencia completa (nombre + parentesco + teléfono) por cliente; el formulario permite hasta 3. Las referencias alimentan el indicador x/3 ref del panel lateral y el semáforo de calidad.
6.3 Bloque familiar (opcional)
Puedes declarar el grupo familiar del titular (cónyuge, dependientes) para análisis de capacidad de pago agregada. Es opcional y queda registrado como data complementaria del expediente.
6.4 Foto del titular optimizada
Al subir la foto, el sistema la redimensiona y comprime automáticamente y te muestra el resultado: "Foto optimizada de 3.2 MB a 180 KB". La validación de tamaño también ocurre en tu navegador antes de enviar, para darte feedback inmediato.
6.5 Ficha del cliente
- Datos personales, origen (JCE/Manual), foto y semáforo de calidad.
- Solo tus obligaciones con ese cliente (monto, balance, atraso, estado, corte, último pago).
- Chip de campos pendientes (ej. "faltan referencias") para completar el expediente.
- Acciones: SC-01 digital, ficha imprimible, documentos, complementarios.
🔒 Cédulas protegidas
Los documentos de identidad (cédula escaneada) solo pueden ser vistos y descargados por usuarios con rol administrador. En pantallas y auditoría, la cédula aparece enmascarada: 000-•••••67-8.
7.SC-01 e imprimibles oficiales
7.1 SC-01 digital (solicitud y consentimiento)
Es el formulario oficial de autorización del titular para consultar su expediente. Se completa en pantalla con firma del solicitante y queda vinculado a la consulta como evidencia.
- Datos del titular y del solicitante.
- Motivo permisible de la consulta.
- Firma digital capturada en pantalla (trazo o imagen).
- Sello de fecha, hora, usuario e IP.
7.2 SC-01 imprimible
Versión en papel con tu membrete, folio consecutivo y espacios de firma para uso en ventanilla. Ideal cuando el cliente autoriza presencialmente y luego digitalizas el proceso.
7.3 Otros imprimibles con tu membrete
| Documento | Contenido |
|---|---|
| Reporte crediticio | Score, dictamen, agregados, factores, obligaciones y complementarios |
| Ficha de cliente | Datos completos + tus obligaciones + espacios de firma |
| Estado de obligación | Detalle del préstamo + historial mensual completo |
| Constancia de consulta | Folio, fecha, usuario, motivo y score visto |
Todos los imprimibles salen también en PDF institucional con co-branding (tu membrete + sello SUNSCORE de procedencia).
8.Obligaciones
Cada préstamo, crédito o financiamiento que otorgas se registra como una obligación vinculada a tu institución y al expediente del titular.
8.1 Campos del reporte
| Campo | Descripción | Ejemplo |
|---|---|---|
| N° interno | Tu identificador único del préstamo | P-2026-00123 |
| Tipo de crédito | Categoría | Consumo, Solidario, Hipotecario… |
| Monto original / Balance | Capital inicial / saldo actual | 150000.00 / 135000.00 |
| Cuota y frecuencia | Pago periódico y cadencia | 8500.00 · MENSUAL |
| Apertura / Vencimiento / Próximo pago | Fechas del ciclo de vida | 2025-03-15 · 2027-03-15 · 2026-10-01 |
| Total cuotas / Pagadas | Progreso del plan de pagos | 24 / 6 |
| Monto vencido / Días atraso | Exposición en mora | 13500.00 / 32 |
| Periodo de corte | Mes de la foto de data (AAAA-MM) | 2026-09 |
| Fecha último pago | Último abono recibido | 2026-08-20 |
| Estado | Situación actual (ver Apéndice C) | AL_DIA, 31-60, LEGAL… |
8.2 Validaciones de coherencia
⚠️ Mora incompatible (rechazo automático)
AL_DIAoSALDADOcon días de atraso > 0 → rechazado.1-30 / 31-60 / 61-90 / 90+con 0 días de atraso → rechazado.- Periodo de corte futuro o con formato inválido → rechazado.
- Fecha de último pago futura o anterior a la apertura → rechazado.
Estas reglas protegen la calidad del score de toda la red: una mora mal declarada distorsiona el dictamen de otras instituciones.
8.3 Qué ocurre al reportar o actualizar
- Se crea o actualiza la obligación con tu
institucion_idy tubatch_idde trazabilidad. - Se escribe la foto del mes en el historial mensual inmutable.
- Se recalcula el score 300–850 del titular con todas sus obligaciones del conglomerado.
- Se generan alertas al ciudadano (nueva obligación / cambio de mora).
- Todo queda en auditoría con usuario, IP y detalle.
📝 Ejemplo: ciclo de vida de un préstamo
9.Carga masiva (2 modelos)
Sube tu cartera completa por archivo. SUNSCORE acepta dos modelos de archivo y tú eliges cuál usas en el selector antes de procesar.
9.1 Modelo Estándar (24 columnas)
Plantilla oficial SUNSCORE: cedula, nombre, telefono, direccion, fecha_nacimiento, empleo, ingresos_mensuales, numero_interno, tipo_credito, fecha_apertura, monto_original, balance_actual, cuota, frecuencia, proximo_pago, fecha_vencimiento, total_cuotas, cuotas_pagadas, monto_vencido, dias_atraso, estado, periodo_corte, fecha_ultimo_pago, credit_id. Fechas AAAA-MM-DD y números con punto decimal.
9.2 Modelo SUN Capital / Detallado (49 columnas)
Diseñado para instituciones cuyo sistema exporta el reporte operativo completo (tipo "data crédito"). Acepta el archivo tal cual lo genera tu sistema:
- Con portadas y banners: las filas de encabezado, membrete ("SUN CAPITAL E INVERSIONES", "FECHA DE CORTE…", "Datos Personales"…) se saltan automáticamente; solo se procesan filas que inician con
P(persona) oE(empresa). - Números latinos: acepta
21.000,00(punto de miles, coma decimal) y1234.56; ambos se normalizan solos. - Fechas flexibles:
22-07-2022,22/07/2022o2022-07-22. - Estatus operativo:
S→SALDADO ·N→AL_DIA ·A→tramo de mora según días desde el último pago ·L→LEGAL ·C→CASTIGADO. - Dirección compuesta: une dirección + municipio + provincia en un solo campo de expediente.
El mapa completo columna→campo está en el Apéndice B.
9.3 Flujo de procesamiento
- Eliges el modelo y subes CSV, TXT o XLSX (hasta ~10,000 filas recomendadas).
- Validación fila por fila: cédula 11 dígitos, número interno presente, montos numéricos, mora coherente, fechas válidas.
- Personas nuevas se crean (con chequeo JCE); si la cédula ya existe en la red, se reutiliza su expediente sin duplicarlo.
- Obligaciones: si el número interno ya existe en tu institución se actualiza; si no, se crea. Subir el mismo archivo dos veces no duplica: reconcilia.
- Se escribe historial mensual por obligación y se recalculan los scores afectados.
- Resultado: filas procesadas, actualizadas y errores con fila + campo + motivo + sugerencia, descargables en CSV.
⚠️ Errores típicos y su causa
- "Cédula inválida": documentos de 5–10 dígitos (RNC cortos, cédulas extranjeras) o tipeos. Corrige en la fuente o registra ese cliente manualmente.
- "Monto no numérico": celdas con texto o símbolos; deja solo dígitos y separador decimal.
- "Mora incompatible": estado AL_DIA con atraso > 0 o tramo de mora con 0 días.
9.4 Trazabilidad y compromiso
- Cada carga genera un batch_id (ej.
B20260916104522-A1B2C3) que queda en cada obligación procesada: puedes rastrear cualquier dato hasta su archivo de origen. - El widget de compromiso mensual indica si ya cargaste este mes y cuántos días faltan para la próxima ventana (1–7 hábil).
- Alerta de data vieja: a los 45 días sin carga verás aviso ámbar; a los 60 días, aviso rojo de riesgo de suspensión (SS-19) para proteger la calidad de la red.
📦 Ejemplo: carga del reporte SUN Capital
10.Calendario mensual
Vista mensual con tus compromisos operativos: ventanas de carga, vencimientos de licencia, cuotas relevantes y eventos programados.
- Navegación mes a mes con resaltado del día actual.
- Tipos de evento con color: carga (naranja), licencia (ámbar), cobranza (rojo), interno (gris).
- Alta rápida: desde cualquier módulo puedes enviar un compromiso al calendario con fecha y tipo pre-cargados (ej. "próxima carga" desde Carga masiva).
💡 Buen hábito
Agenda tu carga el día 1 hábil de cada mes. Así cumples el compromiso SS-18 antes de que la ventana cierre y tu data alimenta los scores de toda la red a tiempo.
11.Data complementaria
Información que no es un préstamo pero que aporta o resta capacidad crediticia.
11.1 Data positiva (suma)
| Tipo | Ejemplo |
|---|---|
| Aportación de capital | Aportes en cooperativa RD$50,000 |
| Plazo fijo | Certificado RD$200,000 al 8% anual |
| Ahorro | Cuenta de ahorro RD$80,000 |
| Inversión / Otro activo | Fondos, vehículos, garantías RD$150,000 |
11.2 Data negativa externa (resta)
| Tipo | Ejemplo |
|---|---|
| Cheque protestado | Cheque #1234 sin fondos |
| Demanda civil / comercial | Litigio por incumplimiento |
| Mora de servicio | Atraso Edesur/telecom 90 días |
| Otro evento | Incumplimiento de garantía |
La data positiva alimenta el factor de capital de respaldo; la negativa, el factor de eventos negativos. Los eventos se retiran/resuelven (nunca se borran): al resolverlos, el score recupera puntaje y queda el historial de qué pasó y cuándo.
🪙 Ejemplo: impacto en score
12.Consultar el buró
🔐 Consentimiento obligatorio (Ley 172-13)
Toda consulta exige declarar el consentimiento del titular y registrar motivo permisible. Puedes adjuntar la evidencia firmada (SC-01) y cada acceso queda trazado con usuario, IP, fecha/hora y score visto. El ciudadano ve en su portal quién lo consultó.
12.1 Validación de frescura (SS-09)
Antes de mostrar el reporte, el sistema verifica la edad de la data de las obligaciones. Si la información más reciente supera los 90 días, verás una advertencia de data posiblemente obsoleta para que ponderes el dictamen con precaución.
12.2 Anatomía del reporte crediticio
- Resumen ejecutivo primero: gauge del score 300–850, nivel, dictamen y agregados clave en la parte superior (decisión en 10 segundos).
- Dictamen automático: FACTIBLE score ≥ 670 y atraso ≤ 30 · REVISAR score ≥ 580 y atraso ≤ 60 · NO RECOMENDADO resto.
- Agregados del conglomerado: deuda total, créditos activos y en cuántas entidades, cuotas mensuales, mayor atraso, % historial satisfactorio, saldados.
- Factores explicados: positivos (✓) y de riesgo (⚠) en lenguaje humano.
- Obligaciones detalladas según nivel configurado por la red: reporte completo / sin entidad / solo valoración.
- Data complementaria y eventos vigentes.
- Estados de data: si alguna entidad reportante tiene data suspendida o en disputa, el reporte lo indica con banner en lugar de mostrar cifras no confiables.
12.3 Salida oficial
Botones de PDF institucional (tu membrete + sello SUNSCORE) y versión imprimible con folio consecutivo, usuario emisor y espacios de firma y sello.
🔍 Ejemplo: decisión asistida
13.Monitoreo y motor de políticas
13.1 Monitoreo de cartera
Tablero con la evolución de tu mora: distribución por tramos (AL_DIA, 1-30, 31-60, 61-90, 90+), obligaciones por vencer en los próximos 30 días y comparativo mes a mes usando el historial inmutable.
13.2 Motor de políticas
Define reglas de aprobación propias de tu institución (score mínimo, endeudamiento máximo, atraso máximo, antigüedad mínima) y el sistema las evalúa como semáforo al consultar:
- APROBAR cumple todas tus reglas.
- REVISAR cumple parcialmente: pasa a comité.
- RECHAZAR incumple reglas críticas.
Un asistente guiado te ayuda a crear tu primera política en minutos (pesos, umbrales y excepciones), sin tocar código.
14.Calidad de datos
Módulo de higiene del expediente: mide qué tan completa y confiable es tu data reportada.
- Semáforo por cliente: porcentaje de calidad según campos completos, referencias (x/3), verificación JCE y coherencia de fechas.
- Checklists operativos: listas de verificación por proceso (alta de cliente, reporte de obligación, cierre de reclamo) que dejan evidencia de cumplimiento.
- Inconsistencias detectadas: banderas automáticas (ej. mora declarada incompatible, último pago futuro) con acción de corrección en un clic.
✅ Meta recomendada
Mantén tu calidad promedio por encima de 80%. Los clientes con calidad alta generan scores más estables y menos reclamos.
15.Reclamaciones
Los ciudadanos pueden impugnar información de su expediente. Tu institución dispone de 15 días hábiles para responder.
15.1 Flujo
- El titular abre el reclamo (o tú en su nombre) con descripción y evidencia.
- Se asigna a la institución reportante de la obligación impugnada.
- Investigas y respondes: texto + nuevo estado (Corregido / Confirmado / Cerrado) + evidencia opcional.
- Si se corrige, la obligación se actualiza, el score se recalcula y el titular ve el resultado en su portal.
- Mientras un reclamo está abierto sobre una obligación, el reporte crediticio muestra un banner de registro impugnado para transparencia.
15.2 Estados
Abierto En proceso Corregido Confirmado Cerrado
📮 Ejemplo: pago no reflejado
16.Documentos y evidencias
Repositorio central vinculado a personas, obligaciones, consentimientos, reclamos y cargas.
- Tipos: cédula, autorización, contrato, pagaré, garantía, comprobante de ingresos, referencias, evidencia de reclamo, archivo de carga.
- Integridad: cada archivo guarda hash SHA-256, tipo MIME verificado y tamaño; cualquier alteración posterior se detecta.
- Optimización: imágenes y gráficos se comprimen automáticamente al subir (feedback de KB antes/después).
- Privacidad: cada institución ve solo sus documentos; las cédulas escaneadas son exclusivas de administradores.
17.Usuarios y seguridad
17.1 Roles
| Rol | Puede | No puede |
|---|---|---|
| Administrador | Todo lo operativo + usuarios, API keys, auditoría, configuración y facturación | Ver data de otras instituciones (imposible para todos) |
| Analista | Clientes, obligaciones, consultas, reclamos, documentos, calendario | Gestionar usuarios, API keys, auditoría completa, configuración |
17.2 Seguridad de acceso
- 2FA: código de 6 dígitos de app autenticadora además de la clave.
- Registro de dispositivos: cada sesión guarda navegador, sistema operativo e IP; los accesos desde dispositivo nuevo quedan marcados en auditoría.
- Bloqueo por licencia: sin licencia activa o con institución suspendida, el login se rechaza.
- Claves: mínimo 8 caracteres; el administrador puede resetear claves de su equipo.
18.Auditoría
Log inmutable y append-only de todas las acciones: nadie lo edita ni lo borra, tampoco el administrador de la red.
- Qué registra: logins (ok/fallidos), altas y cambios de clientes/obligaciones/complementarios, cargas masivas, consultas (cédula enmascarada), reclamos, documentos, usuarios, uso de API, onboarding y pagos de licencia.
- Campos: fecha/hora, usuario, acción, entidad e ID, cédula enmascarada, IP y detalle.
- Filtros y exportación: por rango de fechas y tipo de acción; exportable a CSV para cumplimiento normativo.
📜 Ejemplo: investigación de un reclamo
19.Integración por API
Conecta tu core bancario, ERP o CRM para reportar y consultar sin digitación manual.
19.1 Seguridad
- API key + secreto por institución (se muestran una sola vez al crearlas).
- Firma HMAC de cada petición + timestamp con ventana de ±5 minutos.
- Rate limiting configurable (por defecto 60 peticiones/min).
- Auditoría de cada llamada con key usada y resultado.
19.2 Endpoints
Reporta o actualiza una obligación (upsert por número interno). Genera historial mensual y recalcula score automáticamente.
Listado de obligaciones de una persona reportadas por tu institución, para sincronizar cartera local.
Expediente consolidado: score, nivel, dictamen, agregados, factores y obligaciones según nivel de detalle. Registra consentimiento y auditoría.
Reporta data positiva o eventos negativos; recalcula score.
19.3 Puesta en marcha
- Crea tu key en API Keys con nombre descriptivo y rate limit.
- Guarda key y secreto en tu cofre de credenciales.
- Tu equipo integra firma HMAC y endpoints en los flujos de alta, pago y aprobación.
- Pruebas con data de control y paso a producción.
💡 Guía técnica
Solicita la Guía Técnica de Integración (especificación completa, ejemplos JSON, cálculo de firma, colección Postman y librerías PHP/Python/JS/Java) por nuestros canales de soporte.
20.Preguntas frecuentes
¿Si subo el mismo archivo dos veces se duplica la data?
No. La carga reconcilia: personas por cédula y obligaciones por número interno. La segunda pasada actualiza lo existente; solo se añade un nuevo registro de carga y una nueva foto de score (historial).
¿Puedo subir mi Excel original con portadas y banners?
Sí, usando el modelo SUN Capital. Las filas de portada, membrete y encabezados se saltan automáticamente; solo se procesan filas P o E. Los números con punto de miles y coma decimal se normalizan solos.
¿Por qué algunas filas salen con error de cédula?
Porque el documento no es una cédula dominicana de 11 dígitos (RNC cortos, cédulas extranjeras, tipeos). Descarga el CSV de errores, corrige esas filas en la fuente y súbelas de nuevo, o registra esos clientes manualmente.
¿Qué pasa si mi licencia vence?
El panel se bloquea al iniciar sesión. Tu data no se pierde. Reporta el pago desde Facturación (o coordina por WhatsApp al +1 829 213-7370); al validarse el comprobante, la licencia se extiende y el acceso se restablece.
¿Puedo ver las obligaciones de otras instituciones sobre mis clientes?
No directamente. En Clientes ves solo lo tuyo. El consolidado se obtiene en Consultas, con consentimiento del titular y según el nivel de detalle configurado por la red.
¿El score es igual para todos?
Sí: un único score 300–850 por persona, calculado con todas sus obligaciones del conglomerado. Lo que varía por configuración es el nivel de detalle del reporte, no el score.
¿Puedo borrar una obligación reportada por error?
No se borra (inmutabilidad). Márcala SALDADO o CASTIGADO con balance 0; el historial conserva la trazabilidad.
¿Y si el cliente no está en el padrón JCE?
Se registra como Manual y entra al buró con expediente y score normales.
¿Cuándo se actualiza el score tras un pago?
Al instante: al guardar la actualización se recalcula. La próxima consulta (tuya o de otra institución) ya muestra el valor nuevo.
¿El ciudadano ve que lo consulté?
Sí: en su portal aparece institución, fecha, motivo y score visto. Por eso el consentimiento es obligatorio y se adjunta evidencia.
¿Cómo exporto este manual a PDF?
Pulsa Exportar PDF en la barra superior (o Ctrl/Cmd+P) y elige "Guardar como PDF". El documento se reorganiza solo en formato A4 con portada, índice y una sección por página.
21.Soporte y capacitación
- Guía Técnica de Integración API y colección Postman: solicitar por soporte.
- Capacitación a tu equipo (analistas, cobranza, tecnología): sesión virtual o presencial con prácticas sobre carga, consultas y reclamos.
- Webinars de novedades al publicar versiones nuevas del sistema.
22.Club de Crédito y Marketplace de Pagos
El Club de Crédito es el marketplace interno de SUNSCORE donde socios ciudadanos publican solicitudes de financiamiento y Empresas Socias como la tuya ofertan, validan pagos reportados y emiten recibos formales. Todo queda trazado, afecta el Índice SUNSCORE del socio y se audita.
💡 ¿Para qué sirve?
Elimina el crédito informal: el socio no paga por WhatsApp sin evidencia, tú no validas capturas por correo, y cada operación deja recibo con folio único, impacto en score y trazabilidad total.
22.1 Roles dentro del Club
| Rol | Acceso | Función principal |
|---|---|---|
| Empresa Socia (tú) | oportunidades.php | Ver solicitudes, enviar ofertas, validar pagos, aprobar/rechazar con motivo, generar recibos, ver préstamos activos. |
| Socio (consumidor) | mi_club.php | Publicar solicitud, aceptar/rechazar ofertas, reportar pagos con comprobante, ver recibos, pagar abonos parciales. |
| Super admin red | Panel global | Supervisión, auditoría, configuración de parámetros globales del Club. |
22.2 El tablero "Oportunidades del Club"
Al entrar al módulo Oportunidades, tu empresa ve un tablero con 5 KPIs en tiempo real:
| KPI | Qué cuenta | Color alerta |
|---|---|---|
| Oportunidades | Solicitudes activas publicadas por socios | Neutro |
| Mis ofertas | Ofertas tuyas pendientes de respuesta del socio | Ámbar |
| Préstamos activos | Préstamos aceptados en vigor | Verde |
| Vencen en 7 días | Cuotas próximas a vencer esta semana | Ámbar si > 0 |
| Pagos por validar | Comprobantes reportados por socios pendientes de tu decisión | Rojo si > 0 |
22.3 Solicitudes de préstamo del socio
El socio publica una solicitud desde su portal con:
- Tipo: consumo, vehículo, vivienda, microcrédito, comercial, tarjeta.
- Monto solicitado y plazo en meses (1–60).
- Propósito opcional (texto libre, máx. 255 caracteres).
En la pestaña Oportunidades del tablero ves la lista ordenada por fecha, con:
- Nombre del socio y cédula enmascarada (
001-•••••-9). - Índice SUNSCORE del socio como chip oscuro: te permite filtrar oportunidades de bajo riesgo en un vistazo.
- Monto, plazo, fecha de publicación y cantidad de ofertas ya recibidas.
- Chip Mi oferta pendiente si ya enviaste una sin respuesta.
🔐 Privacidad entre socios
Cada empresa ve las mismas solicitudes, pero las ofertas son privadas por institución: tu competidor no ve tus condiciones ni el socio las compara en pantalla. Solo el socio las recibe.
22.4 Ofertas de las Empresas Socias
Al pulsar Ver y ofertar en una solicitud, entras a su ficha con:
- Resumen ejecutivo: score del socio, total de compromisos activos en la red, balance, mayor atraso.
- Propósito declarado por el socio.
- Historial de tus ofertas previas a ese socio.
Desde ahí envías tu oferta con:
- Monto a aprobar (puede ser menor al solicitado).
- Tasa de interés (%) y plazo en meses.
- Cuota mensual (opcional: se calcula si la dejas vacía).
- Condiciones / mensaje para el socio (texto libre).
Al enviarla, la solicitud pasa a En revisión para todas las empresas, y se guarda en Mis ofertas (pestaña del tablero).
22.5 Mensajería interna socio ↔ empresa
Cada solicitud tiene un hilo de conversación privado entre el socio y tu empresa. Sirve para:
- Aclarar dudas antes de ofertar ("¿tiene garantía?").
- Explicar condiciones de tu oferta.
- Resolver incidentes de pagos reportados.
Cada mensaje queda trazado en auditoría con remitente, fecha/hora y texto. El socio recibe los tuyos en su portal y viceversa.
22.6 Aceptación y creación del préstamo
Cuando el socio acepta tu oferta desde su portal:
- Las demás ofertas pendientes sobre esa solicitud se rechazan automáticamente.
- La solicitud pasa a Aprobada.
- El sistema crea el préstamo activo con monto, tasa, plazo y cuota.
- Se genera el calendario de cuotas (una cuota mensual por cada mes del plazo, con fecha de vencimiento el mismo día del mes siguiente).
- Se vincula como obligación reportada al buró, impactando el score del socio.
- Tu empresa y el socio reciben notificación interna.
✅ Transparencia total
El socio ve exactamente las mismas cuotas, fechas y montos que ves tú. No hay letra chica: el calendario es idéntico en ambos portales.
22.7 Datos de cobro de la empresa
Antes del primer pago, configura en Datos de cobro tus canales oficiales. Los datos aparecen al socio automáticamente cuando va a pagar una cuota.
| Tipo | Campos | Cuándo se usa |
|---|---|---|
| Cuenta bancaria | Banco, titular, RNC/cédula, número, tipo | Transferencias y depósitos |
| Wallet cripto | Nombre, red (TRC20/BEP20), dirección | Pagos en stablecoins o BTC |
| Efectivo presencial | Nombre, dirección física, horario | Sucursales de cobro |
| Otro | Nombre y notas | Canales especiales |
El socio ve una guía automática: "Al transferir, escribe en la observación del banco: Cuota #3", para que identifiques rápido el origen del pago.
22.8 Reporte de pago con comprobante
Desde su portal, el socio puede reportar un pago en cualquier cuota pendiente o vencida:
Elige el método
Transferencia, depósito, cripto, tarjeta, efectivo presencial u otro.
Ingresa el monto reportado
Viene precargado con el saldo actual; puede reportar menos (abono parcial) o el total. Nunca puede superar el saldo pendiente.
Referencia o confirmación
Número de transferencia, hash de tx cripto, o cualquier identificador.
Sube el comprobante
Imagen (PNG/JPG/WEBP) o PDF, máximo 5 MB. Se almacena en el repositorio con hash de integridad.
Notas adicionales (opcional)
Ej. "Pagué en la sucursal de la Churchill" o "la transferencia salió del Banco X".
La cuota pasa a estado En validación y aparece en tu pestaña Validar pagos con un contador rojo.
22.9 Validación de pagos (aprobar o rechazar)
En la pestaña Validar pagos ves una tarjeta por cada comprobante reportado. La tarjeta muestra:
- Nombre y cédula enmascarada del socio.
- Chip Abono parcial o Cuota completa según el monto.
- Caja de saldos: abono acumulado previo, saldo antes y saldo después de aprobar.
- Fecha, hora, método, monto reportado, referencia y nota del socio.
- Vista previa del comprobante (imagen o PDF enlazado).
Decisiones posibles
| Acción | Requisitos | Efecto inmediato |
|---|---|---|
| Aprobar pago | Solo pulsar el botón | Acumula el monto al monto_pagado de la cuota. Si llega al total: marca Pagada y genera recibo. Si no: queda como abono parcial. |
| Rechazar | Motivo obligatorio (texto) | Marca el pago como rechazado; el socio ve el motivo y puede reintentar con comprobante corregido. |
Cada decisión se registra en auditoría con tu usuario, IP, monto, cuota, socio y motivo (si aplica).
22.10 Motivo de rechazo y reintento
Cuando rechazas un pago, el socio ve en su portal:
- La cuota con chip Rechazada.
- Recuadro rojo con el motivo exacto que escribiste.
- El botón Reportar pago habilitado de nuevo para reintentar.
✅ Cero idas y vueltas
El socio sabe exactamente por qué se rechazó su pago y corrige a la primera. Sin llamadas, sin WhatsApp, sin perder el hilo.
22.11 Recibo de pago con folio único
Cada pago aprobado genera automáticamente un recibo formal con:
- Folio único en formato
SC-YYYYMMDD-XXXXXXXX(8 caracteres hex). - Fecha y hora exactas de emisión.
- Datos del socio (nombre, cédula enmascarada, correo).
- Datos de tu empresa (nombre y RNC).
- Detalle del préstamo: monto, tasa, plazo, cuota #, vencimiento y fecha de pago.
- Método, referencia y monto recibido destacado.
- Sello visual ✓ PAGO APROBADO.
El socio lo abre desde el botón Recibo en la cuota pagada, y puede imprimir o guardar como PDF (botón nativo del navegador).
💡 Recibos para abonos parciales
Si el socio hizo un abono parcial de RD$1,000 sobre una cuota de RD$2,800, el recibo es por RD$1,000, no por el total. Cuando complete el saldo, se emite un segundo recibo por RD$1,800. Ambos quedan archivados con folios distintos.
22.12 Abonos parciales y pago de saldo
El sistema reconoce la realidad dominicana: muchos socios pagan por partes.
- Cada abono aprobado se acumula en el campo
monto_pagadode la cuota. - La cuota permanece Pendiente con caja ámbar: Abonado: RD$X · Saldo: RD$Y.
- El botón del socio cambia a Pagar saldo y precarga el valor restante.
- Al completar el total, la cuota pasa a Pagada y se emite el recibo por el último abono.
- El saldo pendiente se refleja también en la obligación reportada al buró, afectando el score del socio de forma precisa.
💰 Ejemplo: abono parcial paso a paso
22.13 Recordatorios de vencimiento
El sistema avisa a ambos actores para reducir mora involuntaria.
Para el socio (portal Mi Club)
- Cuota que vence en 3 días o menos: chip Vence en N d.
- Cuota vencida: chip Vencida.
Para la empresa (Oportunidades del Club)
- KPI "Vencen en 7 días" en el tablero principal: contador de cuotas por vencer esta semana (ámbar si > 0).
- Puedes usar esta cifra para cobranza preventiva: contactar proactivamente a socios antes del vencimiento.
22.14 Impacto en el Índice SUNSCORE
Cada comportamiento dentro del Club se refleja en el score del socio:
| Comportamiento | Efecto en el score |
|---|---|
| Cuota aprobada antes del vencimiento | ✅ Fortalece |
| Cuota aprobada después del vencimiento | ⚠️ Cuenta la demora según días |
| Abonos parciales aprobados | ✅ Suman trayectoria positiva |
| Pago rechazado y corregido a tiempo | ✅ No penaliza si se completa antes de vencer |
| Cuota sin pagar que vence | ❌ Afecta según días de demora |
✅ Trayectoria verificable
Cada cuota pagada en el Club queda como evidencia verificable de buen comportamiento: el ciudadano puede mostrar su historial SUNSCORE a cualquier empresa socia como prueba de cumplimiento, equivalente a una carta de recomendación crediticia.
22.15 Flujo completo paso a paso
Socio publica solicitud
Desde mi_club.php completa monto, plazo, tipo y propósito. Queda visible para todas las Empresas Socias.
Tu empresa envía oferta
En oportunidades.php defines monto, tasa, plazo y condiciones. Se guarda en Mis ofertas.
Socio acepta la oferta
Desde su portal, acepta. Se crea el préstamo activo con calendario de cuotas y se reporta como obligación al buró.
Socio reporta pagos
Cada mes, sube su comprobante desde mi_club.php. La cuota queda En validación.
Tu empresa valida
En Validar pagos, apruebas o rechazas con motivo. Se genera recibo con folio único o el socio reintenta.
Score y trayectoria se actualizan
Cada pago aprobado refuerza el Índice SUNSCORE del socio y deja evidencia en su trayectoria verificable.
22.16 Pestañas del tablero Empresa Socia
| Pestaña | Contenido |
|---|---|
| Oportunidades | Solicitudes activas de socios con score y monto solicitado. |
| Mis ofertas | Historial de ofertas enviadas (pendientes, aceptadas, rechazadas). |
| Préstamos y cuotas | Calendario completo de cuotas por préstamo, con abonos y saldos. |
| Validar pagos | Comprobantes pendientes de decisión y historial de validaciones. |
22.17 Buenas prácticas del Club
- Revisa oportunidades al menos 2 veces por semana: las solicitudes tienen ciclo de vida corto (30 días).
- Responde mensajes en menos de 24h hábiles: la confianza del socio es clave para que acepte tu oferta.
- Valida pagos el mismo día que se reportan: reduces ansiedad del socio y evitas vencimientos por demora tuya.
- Rechaza siempre con motivo claro y accionable: "comprobante ilegible" o "referencia no coincide con banco X" permiten corrección rápida.
- Monitorea el KPI "Vencen en 7 días": es tu mejor herramienta de cobranza preventiva.
🏆 Ejemplo completo: socio Juan
📚 Manual del socio (consumidor)
Los ciudadanos reciben su propia versión del manual al registrarse como socios. Este documento está pensado solo para Empresas Socias; si necesitas la guía para socios, solicítala al equipo de soporte.
A–D.Apéndices técnicos
Apéndice A · Glosario rápido
| Término | Definición |
|---|---|
| Expediente único | Conjunto de obligaciones y data de una persona entre todas las instituciones de la red |
| Score 300–850 | Valoración única del conglomerado con 7 factores ponderados (Apéndice D) |
| Dictamen | Recomendación automática: FACTIBLE / FACTIBLE CON CONDICIONES / NO RECOMENDADO |
| Batch ID | Identificador de cada carga masiva para trazabilidad fila→archivo |
| Periodo de corte | Mes (AAAA-MM) al que corresponde la foto de data reportada |
| SC-01 | Formulario oficial de solicitud y consentimiento del titular |
| Historial inmutable | Foto mensual por obligación que nunca se edita ni se borra |
| Club de Crédito | Marketplace interno donde socios solicitan y Empresas Socias ofertan y validan pagos |
| Folio de recibo | Código único SC-YYYYMMDD-XXXXXXXX por cada recibo de pago aprobado |
| Abono parcial | Pago de una parte de la cuota que se acumula al saldo sin cerrarla |
Apéndice B · Mapa del modelo SUN Capital (49 columnas)
| # | Columna origen | Destino en SUNSCORE |
|---|---|---|
| 1 | TIPO ENTIDAD | Filtro de fila (P/E) |
| 2–3 | NOMBRES + APELLIDOS | personas.nombre |
| 4 | CÉDULA O RNC | personas.cedula (llave) |
| 5–7 | SEXO / ESTADO CIVIL / OCUPACIÓN | empleo (ocupación) |
| 8 | CÓDIGO CLIENTE | respaldo de numero_interno |
| 9 | FECHA NACIMIENTO | personas.fecha_nacimiento |
| 11–16 | DIRECCIÓN…PROVINCIA | personas.direccion (compuesta) |
| 18–19 | TELÉFONO 1 / 2 | personas.telefono |
| 20–22 | EMPRESA / MONEDA / SALARIO | personas.empleo e ingresos_mensuales |
| 24–26 | APERTURA / VENCIMIENTO / ÚLTIMO PAGO | obligaciones.fecha_apertura / fecha_vencimiento / fecha_ultimo_pago |
| 27 | NÚMERO CUENTA | obligaciones.numero_interno y credit_id |
| 28 | ESTATUS | obligaciones.estado (S/N/A/L/C) |
| 29–30 | TIPO PRÉSTAMO / MONEDA | obligaciones.tipo_credito |
| 31–32 | CRÉDITO APROBADO / MONTO ADEUDADO | monto_original / balance_actual |
| 33 | PAGO MANDATARIO O CUOTA | obligaciones.cuota |
| 34–35 | MONTO ÚLTIMO PAGO / TOTAL ATRASO | monto_vencido y cálculo de días |
| 36–37 | TASA / FORMA DE PAGO | frecuencia |
| 38 | CANTIDAD DE CUOTAS | total_cuotas |
| 39–48 | PERIODOS DE ATRASO 1–10 | referencia de historial de mora |
| 49 | CUENTA DE REFERENCIA | trazabilidad interna |
Apéndice C · Estados y mora
| Estado | Significado | Regla de días |
|---|---|---|
| AL_DIA | Sin atraso | días = 0 |
| 1-30 | Mora temprana | 1–30 |
| 31-60 | Mora media | 31–60 |
| 61-90 | Mora mayor | 61–90 |
| 90+ | Mora severa | > 90 |
| LEGAL | Cobranza judicial | según proceso |
| REFINANCIADO | Condiciones renegociadas | según acuerdo |
| SALDADO | Cerrado por pago total | días = 0 |
| CASTIGADO | Incobrable dado de baja | > 90 |
Apéndice D · Score 300–850 (pesos por defecto)
| Factor | Peso | Qué premia / castiga |
|---|---|---|
| Historial de pagos | 35% | Puntualidad y ausencia de atrasos |
| Endeudamiento | 20% | Balance vs. montos y capacidad |
| Antigüedad | 15% | Años de historial reportado |
| Obligaciones activas | 10% | Mezcla saludable de créditos |
| Comportamiento reciente | 10% | Últimos 6 meses |
| Créditos saldados | 5% | Ciclos completados con éxito |
| Consultas recientes | 5% | Presión de crédito en el tiempo |
Bandas: 750–850 Excelente 700–749 Muy bueno 670–699 Bueno 580–669 Riesgo medio 300–579 Riesgo alto. Los pesos los ajusta exclusivamente el administrador de la red; cada cambio genera una nueva versión del modelo auditada.