1 / 20
← → para navegar  |  ESC para overview
Documento de Requerimientos v1.1

Moraworld Imports
Sistema de Casillero Internacional

Arquitectura de Software · Requerimientos Funcionales · Flujos de Usuario y Sistema

Fecha6 de mayo de 2026
Versión1.1
EstadoBorrador
NormativaISO/IEC 27001 · SENAE
02 / 20
Identidad
Las empresas

Dos empresas, un ecosistema

Operación transfronteriza legalmente constituida en Ecuador y EE.UU.

🇪🇨
Moraworld Imports S.A.S.
Constituida bajo las leyes de Ecuador.
Representante legal en Cuenca.
RUC activo · Permisos SENAE vigentes.
Ecuador · S.A.S. · SENAE
🇺🇸
Mora Global Import LLC
Registrada en el estado de New Jersey, EE.UU.
Bodega operativa en:
150 N Day St, City of Orange, NJ 07050
New Jersey · LLC · NJ 07050
03 / 20
Resumen Ejecutivo
¿Qué construimos?

El problema que resolvemos

🏭

La bodega en EE.UU.

Bodega física en 150 N Day St, NJ 07050. Cada cliente recibe una Suite personalizada como dirección de entrega en tiendas online.

  • Dirección Suite: EC-XXXXX
  • Asignación automática al registrarse
  • Verificación física de peso y dimensiones
  • Fotos del paquete sincronizadas al portal
🛃

La logística a Ecuador

El sistema gestiona el reenvío, el cálculo de impuestos y la declaración automática ante la SENAE.

  • Calculadora SENAE integrada (categorías 4x4, B, C, D)
  • Declaración Simplificada (DSI) automática
  • Tracking ID único por paquete
  • Notificaciones por WhatsApp, SMS y correo
B2C
Casillero Personal
Compras pequeñas · Flujo automatizado
B2B
Carga Pesada / Pallets
Importación mayorista · Cotización especial
04 / 20
Arquitectura
Arquitectura de Software

Multi-Tenant · ISO/IEC 27001

🌐 INTERNET (HTTPS / TLS 1.3)
▼
⚡ Load Balancer / API Gateway
▼
Tenant A
Empresa 1
Tenant B
Empresa 2
Tenant N
Empresa N
▼
🗄️ PostgreSQL · Schema aislado por Tenant
Frontend
Next.js / React
SSR · SEO optimizado
Backend
Node.js + NestJS
REST / GraphQL
Seguridad
OAuth 2.0 + MFA
JWT · AES-256 · WAF
05 / 20
Seguridad
Seguridad de la Información

Controles ISO/IEC 27001:2022

A.5 PolíticasPolítica de uso aceptable, manejo de datos y retención
A.9 AccesoAutenticación MFA obligatoria, RBAC por roles
A.6 OrganizaciónRoles definidos, segregación de funciones estricta
A.10 CriptografíaTLS 1.3 en tránsito · AES-256 en reposo
A.8 ActivosInventario de datos personales y de paquetes (LOPDP)
A.12 OperacionesLogs de auditoría inmutables, monitoreo continuo (SIEM)
A.14 DesarrolloSDLC seguro, revisiones de código, OWASP Top 10
A.16 IncidentesProceso de gestión y notificación de incidentes
A.7 RRHHProcedimientos de onboarding/offboarding de usuarios
A.18 CumplimientoDeclaración aduanera automática conforme a SENAE
06 / 20
Roles
Sistema de Roles

6 roles, acceso diferenciado

👑
Super Admin
Acceso total. Gestiona tenants, usuarios y configuración global
🏢
Admin Empresa
Administra su tenant: usuarios, tarifas, bodegas, reportes
📦
Operador Bodega
Verifica, pesa, fotografía y despacha paquetes en NJ
🛃
Agente Aduanero
Revisa y aprueba declaraciones antes de enviar a la SENAE
🧑‍💻
Cliente Final
Usuario ecuatoriano. Registra compras y da seguimiento
🎧
Soporte
Visualiza info de clientes y paquetes. Sin modificaciones
07 / 20
Permisos
Matriz de Acceso

¿Quién puede hacer qué?

Acción Super Admin Admin Bodega Aduanero Cliente Soporte
Ver dashboard✅✅✅✅✅✅
Crear / editar usuarios✅✅❌❌❌❌
Configurar tarifas✅✅❌❌❌❌
Registrar compra❌❌❌❌✅❌
Ver mis paquetes❌❌❌❌✅✅
Verificar en bodega❌❌✅❌❌❌
Confirmar peso/dims.❌❌✅❌❌❌
Generar DSI (aduana)❌❌❌✅❌❌
Enviar datos a SENAE✅✅❌✅❌❌
Logs de auditoría✅✅❌❌❌❌
08 / 20
Módulos
Módulos del Sistema

8 módulos integrados

🌐

Landing Page

Pública, SEO, calculadora, WhatsApp flotante, legalidad

Público
👤

Portal Cliente

Casillero Suite, pre-alerta, registro por URL o manual, fotos

Cliente
🏭

Portal Bodega NJ

Recepción, verificación, peso real, fotos, despacho

Operador
⚙️

Portal Admin

Dashboard, métricas, tarifas, reportes, auditoría

Admin
🛃

Módulo SENAE

DSI automática, cálculo impuestos, WebService oficial

Aduanero
📍

Tracking

ID único EC-YYYYMMDD-XXXXXX, 11 estados, visible sin login

Todos
📄

Pre-alerta

Aviso previo + carga de factura PDF/imagen + tracking vendedor

Cliente
🚢

Carga Pesada B2B

Pallets, INEN, cotización especial, DAI

Mayorista
09 / 20
Tracking
Sistema de Tracking

11 estados · ID único por paquete

Formato: EC-YYYYMMDD-XXXXXX  |  Ej: EC-20260506-082341

REGISTRADO
01
EN_TRANSITO_BODEGA
02
RECIBIDO_BODEGA
03
EN_VERIFICACION
04
VERIFICADO
05
DECLARACION_ADUANERA
06
EN_TRANSITO_ECUADOR
07
EN_ADUANA_ECUADOR
08
LISTO_ENTREGA
09
ENTREGADO ✓
10
INCIDENCIA ⚠
11

Notificaciones automáticas al cliente en cada cambio de estado · WhatsApp · SMS · Email

10 / 20
Flujo de Usuario
Flujo del Cliente Final

Del click en Amazon a la puerta en Ecuador

1
Accede a la Landing Page y se registra (correo + MFA)
↓
2
Sistema asigna automáticamente: 150 N Day St, Suite EC-XXXXX, Orange NJ 07050
↓
3
Compra en Amazon/eBay/Walmart usando esa dirección Suite como destino
↓
4
⚡ PRE-ALERTA (opcional): carga tracking vendedor + factura PDF → La bodega se prepara
↓
5A
🔗 Pega el enlace de Amazon → Sistema extrae: nombre, precio, peso, imagen
5B
✏️ Ingreso manual: nombre, valor ($USD), tienda, peso estimado
↓
6
Sistema calcula costo total con desglose SENAE · Cliente ACEPTA y PAGA en línea
↓
7
🎉 Tracking ID generado · Notificaciones automáticas hasta entrega en Ecuador
11 / 20
Flujo de Usuario
Flujo del Operador de Bodega NJ

Verificación y despacho en bodega

1
Inicia sesión en el Portal de Bodega · Ve paquetes esperados con pre-alertas
↓
2
Llega paquete físico → Escanea código de barras o busca por tracking manual
↓
3
Confirma recepción → Estado: RECIBIDO_BODEGA · Pesa y mide · Toma fotos
↓
4A
✅ Sin discrepancia → Estado: VERIFICADO · Asigna a despacho
4B
⚠️ Discrepancia >10% → Notifica Admin y cliente · Ajuste de cobro
↓
5
Asigna a envío consolidado o individual · Genera orden de despacho a Ecuador
12 / 20
Flujo de Usuario
Flujo del Agente Aduanero

De la bodega a la SENAE

1
Ve paquetes con estado VERIFICADO · Revisa descripción, valor declarado y fotos
↓
2A
✅ Valor ≤ $400 y ≤ 4 kg → Proceso 4x4 simplificado · DSI automática
2B
⚠️ Supera límite → Notifica cliente · Proceso de importación formal (DAI)
↓
3
Sistema genera la Declaración Simplificada de Importación (DSI) automáticamente
↓
4
Agente REVISA y APRUEBA · Sistema envía DSI al WebService oficial de la SENAE
↓
5
🎉 SENAE devuelve número de autorización · Estado: DECLARACION_ADUANERA · Notificación al cliente
13 / 20
Flujo B2B
Flujo Importador Mayorista (B2B)

Carga Pesada · Pallets · INEN

1
Importador accede a la sección "Carga Pesada / Pallets" en la Landing Page
↓
2
Llena formulario de cotización especial: tipo de mercancía, peso, pallets, valor
↓
3
⚠️ Verificación INEN: calzado, textiles, electrónicos requieren certificación previa
↓
4
Equipo Moraworld prepara cotización · La envía por correo y WhatsApp
↓
5
Importador acepta → Se crea expediente con ID de seguimiento B2B propio
↓
6
🚢 Coordinación de embarque · DAI o DAS · Seguimiento hasta entrega en Ecuador
14 / 20
Flujo del Sistema
Flujo del Sistema

Registro por enlace de Amazon

1
Cliente pega URL del producto de Amazon en el portal
↓
2
Sistema llama Amazon SP-API (o scraping) · Extrae: nombre, precio, peso, imagen
↓
3
Pre-llena el formulario automáticamente con los datos extraídos
↓
4
Sistema calcula: flete + seguro 2% + FODINFA 0.5% + IVA 15% + Arancel por categoría
↓
5
Muestra desglose completo al cliente · Cliente confirma y paga en línea
↓
6
✅ Tracking ID generado · Correo de confirmación · Estado → REGISTRADO
15 / 20
Calculadora SENAE
Cálculo de Impuestos

Categorías SENAE · Fórmulas

Régimen 4×4
0% Arancel
Hasta 4 envíos/año · máx. $400 · máx. 4 kg · Proceso simplificado automático
Categoría B
10%
Bienes de consumo general fuera del régimen 4×4 · + FODINFA + IVA
Categoría C
20%
Textiles, calzado, artículos del hogar · + FODINFA + IVA
Categoría D
0–15%
Electrónicos, telecomunicaciones · Puede requerir certificación INEN
// Peso a cobrar Peso_final = MAX(peso_real, (largo × ancho × alto) / 139) // Costos Flete = Peso_final × $3.50/lb Seguro = valor_declarado × 0.02 FODINFA = valor_declarado × 0.005 Arancel = valor_declarado × % categoría IVA = (valor + FODINFA + Arancel) × 0.15 TOTAL = Flete + Seguro + FODINFA + Arancel + IVA
16 / 20
Flujo del Sistema
Flujo de Notificaciones

Notificaciones automáticas multicanal

1
Cambio de estado del paquete en base de datos
↓
2
Sistema detecta el evento y activa el motor de notificaciones
↓
3
Envío paralelo a todos los canales configurados del usuario
↓
4
Log de auditoría inmutable registra el evento con timestamp UTC
✉️
Correo electrónicoDetalle completo del estado · SendGrid / SES
💬
WhatsApp Business APIMensaje directo al número del cliente
📱
SMSResumen corto · SMS Gateway API
🔔
Push (portal web)Notificación en tiempo real en el dashboard
17 / 20
Integraciones
Integraciones Externas

9 integraciones clave

🛒
Amazon SP-APIREST API · Datos del producto
🛃
WebService SENAESOAP / REST · Declaraciones DSI/DAI
💳
Pasarela de PagosREST API · Stripe / PayPhone
💬
WhatsApp BusinessREST API · Notificaciones + Soporte
✉️
Email (SendGrid/SES)SMTP / REST · Notificaciones
📱
SMS GatewayREST API · Notificaciones cortas
🚚
Courier (FedEx/DHL)REST API · Estado físico del envío
🏭
Software de BodegaREST API · Sync estados en tiempo real
🏷️
Normas INENREST / Web · Certificaciones
18 / 20
Calidad
Requerimientos No Funcionales

Calidad y Rendimiento

Disponibilidad99.9% uptime (SLA garantizado)
Tiempo de respuesta{"<"} 2 segundos para operaciones normales
EscalabilidadMulti-tenant · preparado para múltiples empresas y miles de usuarios
SeguridadISO/IEC 27001 · OWASP Top 10 · TLS 1.3 · AES-256 · MFA obligatorio · WAF
Accesibilidad100% web · responsive mobile-first · accesible desde cualquier dispositivo
RespaldoBackups automáticos diarios · retención mínima 90 días
RecuperaciónRTO {"<"} 4 horas · RPO {"<"} 1 hora
AuditoríaTodos los eventos registrados con trazabilidad completa e inmutable
Multi-idiomaEspañol (clientes Ecuador) · Inglés (operadores NJ)
Zona horariaEST (New Jersey) y ECT (Ecuador) — mostrado según ubicación del usuario
19 / 20
Estructura Web
Navegación del Sitio

Estructura de rutas

Área Pública

/ Landing Page principal
/como-funciona
/calculadora
/tarifas
/quienes-somos
/casillero/como-usar · calculadora · registro
/carga-pesada/como-funciona · cotizacion · inen
/tracking ← sin login

Área Autenticada

/portal/dashboard
/portal/mi-casillero 📦
/portal/pre-alerta 📄
/portal/mis-paquetes 🔍
/portal/calculadora 💰
/portal/perfil
/admin/usuarios · tarifas · reportes
/bodega/paquetes · verificacion
20 / 20
Resumen

Un sistema completo, seguro y escalable

Diseñado para crecer con Moraworld Imports desde el primer día.

🏗️

Arquitectura Multi-Tenant ISO 27001

👥

6 roles con permisos granulares

📦

8 módulos integrados

🔁

5 flujos de usuario documentados

🛃

Integración directa con SENAE

📍

11 estados de tracking en tiempo real

🔗

9 integraciones externas

💰

Calculadora SENAE (4x4, B, C, D)

🌐

100% web · mobile-first · responsive

ISO/IEC 27001 SENAE Autorizado Cumplimiento INEN LOPDP Ecuador Multi-Tenant

Moraworld Imports S.A.S. · Mora Global Import LLC · v1.1 · Mayo 2026