Modelo de datos
Toda la información que el sistema debe recoger desde el inicio, organizada por entidad.
Datos del usuario
El usuario se registra en dos fases. Ver Verificación de identidad (KYC) para el detalle completo del proceso.
Fase 1 — Registro inicial
Datos mínimos para crear la cuenta. Rápidos de completar, sin fricciones.
| Campo |
Notas |
| Nombre completo |
Nombre y apellido |
| Correo electrónico |
Con verificación por enlace |
| Teléfono |
Con verificación por SMS/OTP |
| Contraseña |
Con requisitos mínimos de seguridad |
Tras el registro inicial
El usuario recibe su identificador único y puede ver la dirección del casillero, acceder a tutoriales y compartir su código de referido. No puede gestionar envíos hasta aprobar el KYC.
Fase 2 — Datos de verificación KYC
Requeridos antes del primer envío. La verificación es manual en el MVP.
| Campo |
Notas |
| Tipo de documento |
Pasaporte, carné de identidad, licencia de conducir |
| Número de documento |
|
| Foto del documento — frente |
Clara, sin reflejos |
| Foto del documento — reverso |
Si el documento tiene reverso con datos |
| Selfie con el documento |
Rostro del usuario sosteniendo el documento |
| Dirección de residencia en Cuba |
Domicilio declarado |
| Provincia y municipio |
|
| Estado del KYC |
Sin iniciar / En revisión / Aprobado / Rechazado |
Datos del remitente en Estados Unidos
| Campo |
Notas |
| Nombre completo |
|
| Teléfono |
|
| Correo electrónico |
Opcional |
| Dirección completa |
|
| Ciudad |
|
| Estado |
|
| ZIP Code |
|
| Relación con el envío |
Quién es y por qué envía |
| Observaciones |
|
Datos del destinatario en Cuba
| Campo |
Notas |
| Nombre completo |
|
| Carné de identidad o documento |
Si aplica |
| Teléfono principal |
|
| Teléfono alterno |
|
| Dirección completa |
|
| Provincia |
|
| Municipio |
|
| Referencias de entrega |
Puntos de referencia para el repartidor |
| Vínculo con el usuario |
Si no es la misma persona |
Datos del casillero
| Campo |
Notas |
| Dirección completa |
|
| Teléfono del casillero |
|
| Horario de recepción |
|
| Instrucciones especiales |
|
| Formato exacto de nombre e identificador |
Cómo debe aparecer en la etiqueta |
Datos de compra
| Campo |
Notas |
| Tienda |
Amazon, SHEIN, Temu, otro |
| Número de orden |
|
| Tracking |
|
| Transportista local |
UPS, USPS, FedEx, etc. |
| Valor declarado |
|
| Moneda |
USD por defecto |
| Categoría |
Del catálogo interno |
| Descripción del producto |
|
| Cantidad |
|
| Evidencia de compra |
Foto o captura |
| Enlace del producto |
URL de la tienda |
| Vendedor o seller |
Si aplica |
Datos logísticos
| Campo |
Notas |
| Fecha estimada de llegada al almacén |
|
| Fecha de recepción real |
|
| Peso real |
|
| Dimensiones |
|
| Fotos del paquete recibido |
|
| Estado del embalaje |
|
| Consolidación sí/no |
|
| ID del consolidado o envío agrupado |
|
| Guía maestra / lote / valija |
|
| Días en almacén |
Calculado |
| Fecha límite de almacenaje sin recargo |
|
| Cargos por almacenaje |
Si aplica |
Datos de servicios adicionales
| Campo |
Notas |
| Inspección visual solicitada |
Sí / No |
| Prueba funcional solicitada |
Sí / No |
| Detalle de la prueba a realizar |
Qué se debe verificar |
| Resultado de la prueba |
|
| Evidencia fotográfica o video |
|
| Reempaque solicitado |
Sí / No |
| Devolución solicitada |
Sí / No |
| Motivo de devolución |
|
| Estado de la devolución |
|
| Costo de servicio aplicado |
|
Datos de aduana
| Campo |
Notas |
| Categoría aduanera |
|
| Valor referencial |
|
| Peso computable |
|
| Observaciones de inspección |
|
| Monto estimado a pagar |
|
| Monto final |
|
| Estado aduanero |
|
Datos del programa de referidos y niveles
Información necesaria para gestionar la red de referidos, los niveles y las ventanas de actividad.
Perfil de referidos del usuario
| Campo |
Notas |
| Código de referido propio |
Código único para compartir y captar referidos |
| Código de referido usado al registrarse |
Si fue referido por otro usuario |
| ID del usuario que lo refirió |
FK al usuario referidor |
| Nivel actual |
1, 2 o 3 — calculado dinámicamente |
| Fecha de última evaluación de nivel |
Cuándo se recalculó por última vez |
| Total de referidos históricos |
Contador total, incluidos los expirados |
| Referidos activos en este momento |
Solo los que están en ventana vigente |
| Lb totales reales acumuladas por su red |
Para cálculo del pool y del nivel |
Datos de cada referido individual
Para cada persona que el usuario refirió, se registra:
| Campo |
Notas |
| ID del referido (usuario referido) |
FK al usuario referido |
| Fecha de registro del referido |
Desde esta fecha corre la ventana de 180 días |
| Fecha de vencimiento de ventana |
Fecha de registro + 180 días |
| Estado de la ventana |
Activa / Expirada |
| Lb reales enviadas por el referido en ventana |
Solo lb pagadas con dinero real |
| ¿Cumple mínimo de lb para el nivel del referidor? |
Booleano calculado |
| Pool generado para el referidor |
Crédito total generado dentro de la ventana |
El crédito es la unidad de incentivo del programa. No es dinero, no es retirable.
| Campo |
Notas |
| Balance de crédito disponible |
Saldo actual usable |
| Crédito acumulado total histórico |
Para referencia y auditoría |
| Crédito usado total histórico |
Para referencia |
| Crédito expirado total histórico |
Para referencia |
| Origen del crédito |
Pool de referidos Nivel 1/2/3 o pool de fidelidad |
| Fecha de acreditación |
Cuándo se generó |
| Fecha de vencimiento |
Fecha límite de uso |
| Estado |
Disponible / Usado / Expirado |
Datos de cada movimiento de crédito
| Campo |
Notas |
| Tipo de movimiento |
Acreditación / Uso / Expiración / Conversión a tarjeta |
| Monto |
Valor del movimiento |
| Saldo resultante |
Balance después del movimiento |
| Referencia |
ID del envío, ID del referido, o ID de tarjeta |
| Fecha y hora |
Timestamp del movimiento |
| Descripción |
Texto explicativo legible |
Las tarjetas son la forma de materializar el crédito en descuentos concretos.
| Campo |
Notas |
| ID de la tarjeta |
Único |
| Denominación |
$50 / $100 / $150 |
| Usuario emisor |
Quién la emitió (puede ser diferente al receptor) |
| Usuario receptor |
A quien se le asignó la tarjeta |
| Origen |
Convertida desde crédito propio / Beneficio de fidelidad |
| Crédito usado para emitirla |
Si aplica |
| Fecha de creación |
|
| Fecha de vencimiento |
Hereda la del crédito original, no se extiende |
| Estado |
Disponible / Aplicada / Vencida |
| Envío al que se aplicó |
FK al envío, si fue usada |
| Fecha de uso |
|
Registro del pool calculado para trazabilidad y auditoría.
| Campo |
Notas |
| ID del envío generador |
FK al envío que generó el pool |
| Libras reales del envío |
Base de cálculo |
| Ganancia neta por libra |
Configurado en tarifas |
| Pool total generado |
50% de la ganancia neta |
| Pool asignado a Nivel 1 |
50% del pool (si aplica) |
| Pool asignado a Nivel 2 |
30% del pool (si aplica) |
| Pool asignado a Nivel 3 |
20% del pool (si aplica) |
| Pool libre (no consumido por red) |
Diferencia |
| Pool de fidelidad otorgado |
30% del pool libre |
| Fecha de cálculo |
|