Pendiente

Revisar la fuente oficial del Res. 175/2022, su fecha de publicación y la frecuencia de revisión. Ver D-207 en producto/decisiones-vigentes.md.

Categorías y aduana¶

Visión funcional y operativa

Este documento describe cómo el sistema IslaBox modela las categorías aduaneras (15 categorías operativas, sus flags, los mensajes al usuario y al operador) y qué debe mostrar el módulo informativo de aduana al usuario. La normativa completa de la Aduana de Cuba (Res. 175/2022) —límites, exenciones, aranceles, capítulos por artículo— está en Normativa aduanal de Cuba.

Catálogo de categorías de producto¶

Categorías disponibles para clasificar los paquetes al momento de reportar una compra. Cada categoría tiene reglas operativas definidas.

Matriz operativa por categoría¶

Categoría	Aceptado	Requiere factura	Requiere revisión	Nivel de riesgo	Permite aéreo	Permite marítimo	Mensaje al usuario	Mensaje al operador
Ropa	Sí	No	No	Bajo	Sí	Sí	"Sin restricciones especiales"	Sin nota
Calzado	Sí	No	No	Bajo	Sí	Sí	"Sin restricciones especiales"	Sin nota
Accesorios	Sí	No	No	Bajo	Sí	Sí	"Sin restricciones especiales"	Sin nota
Alimentos	Condicional	No	Sí	Alto	No	Sí	"Alimentos: verificar restricciones vigentes"	Revisar estado del alimento, fecha de caducidad
Aseo	Sí	No	No	Medio	Sí	Sí	"Productos de aseo: verificar restricciones"	Sin nota
Medicamentos	Condicional	Sí	Sí	Alto	No	Sí	"Medicamentos: requieren receta o documentación"	Verificar documentación; puede requerir autorización adicional
Insumos médicos	Condicional	Sí	Sí	Alto	No	Sí	"Insumos médicos: verificar documentación requerida"	Documentación obligatoria; puede requerir autorización adicional
Electrónicos	Sí	No	Sí	Medio	Sí	Sí	"Electrónicos: pueden ser objeto de revisión aduanera"	Fotografiar y documentar estado al recibir
Hogar	Sí	No	No	Bajo	Sí	Sí	"Sin restricciones especiales"	Sin nota
Herramientas	Sí	No	No	Bajo	Sí	Sí	"Sin restricciones especiales"	Sin nota
Piezas y accesorios	Sí	No	No	Bajo	Sí	Sí	"Sin restricciones especiales"	Sin nota
Juguetes	Sí	No	No	Bajo	Sí	Sí	"Sin restricciones especiales"	Sin nota
Miscelánea	Sí	No	Sí	Medio	Sí	Sí	"Categoría miscelánea: verificar si aplica a artículo específico"	Revisar artículo específico; puede requerir reclasificación
Otros	Condicional	No	Sí	Alto	Condicional	Sí	"Esta categoría requiere revisión; proporcione descripción detallada"	Solicitar descripción; revisar si aplica restricción
Restringido	No	N/A	N/A	Prohibido	No	No	"Este artículo no puede ser enviado"	No recibir; registrar como restringido

Columnas de la matriz¶

Columna	Significado
Aceptado	Sí = se acepta normalmente. Condicional = se acepta con documentación. No = no se acepta.
Requiere factura	El usuario debe subir comprobante de compra
Requiere revisión	Operador revisa manualmente antes de consolidar
Nivel de riesgo	Bajo / Medio / Alto / Prohibido
Permite aéreo	Se puede enviar por vía aérea
Permite marítimo	Se puede enviar por vía marítima
Mensaje al usuario	Texto que ve el usuario cuando selecciona esta categoría
Mensaje al operador	Nota interna que ve el operador al recibir un paquete de esta categoría

Categorías administrables

Este catálogo se actualiza desde Django Admin. Cada cambio queda registrado en audit_logs.

Origen normativo de las categorías

Los flags de cada categoría (accepted, requires_invoice, requires_review, risk_level, allows_air, allows_sea, duty_percentage) se derivan de la Resolución 175/2022 de la Aduana de Cuba. Ver el mapeo categoría app → capítulo normativo en la sección 6 del documento normativo.

Módulo informativo de aduana¶

El módulo de aduana explica al usuario, en lenguaje simple, los siguientes temas:

Contenido mínimo¶

El módulo informativo de aduana de la app debe mostrar, en lenguaje simple, los siguientes temas. La fuente normativa de cada uno está en Normativa aduanal de Cuba:

Qué entra como envío no comercial — definición práctica para el usuario
Límites por valor y/o peso — 500 USD de tope para envíos, 1 kg = 10 USD, 30 USD/3 kg exentos
Exenciones aplicables — beneficio 2026 para alimentos/aseo/medicamentos/insumos médicos (200 USD/20 kg)
Categorías frecuentes — las más usadas y sus implicaciones
Cómo se calcula de forma general — fórmula valor gravado × 30 %
Artículos restringidos o problemáticos — qué NO enviar o qué requiere cuidado (MINCOM, IACC, plantas eléctricas > 900 W, armas neumáticas, drones)
Advertencia — la autoridad aduanera puede reclasificar un envío en cualquier momento

Contenido detallado por sección¶

Sección del módulo	Datos que muestra	Fuente normativa
Envío no comercial	Definición + reglas de no reiteración, no diversidad, etc.	Normativa — sección 3
Límites y exenciones	Tabla con viajero / envío / beneficio 2026	Normativa — sección 1
Calculadora rápida	Fórmula + ejemplos 3/10/20/50 kg	Normativa — sección 2
Artículos restringidos	Lista derivada de `risk_level = prohibited/high` y permisos especiales	Normativa — Cap. 3, 4, 5, 8
Cambios 2026	Beneficio alimentos/aseo/medicamentos, aumento de 200 a 500 USD	Normativa — sección 4

Glosario sugerido¶

Término	Definición simplificada
Costo logístico	Lo que se paga por mover el paquete (almacén, envío, entrega)
Costo de servicio	Lo que se paga por servicios adicionales (inspección, reempaque, etc.)
Pago de aduana	Lo que cobra la autoridad aduanera por permitir la entrada del producto
Valor aduanero	Valor que Aduana asigna al envío (peso × 10 USD/kg en misceláneas)
Arancel	Porcentaje sobre el valor gravado (30 % en envíos generales)
Franquicia	Exención total o parcial que aplica al viajero
Consolidación	Agrupar varios paquetes en un solo envío
Prealerta	El reporte anticipado que hace el usuario antes de que llegue el paquete
Conciliación	Proceso de asociar un paquete físico con un reporte del usuario
MINCOM	Ministerio de las Comunicaciones (Cuba). Autoriza equipos de radio, teléfonos satelitales, etc.
IACC	Instituto de Aeronáutica Civil de Cuba. Autoriza drones y aeronaves no tripuladas

Actualización obligatoria

Este contenido debe tener fecha de actualización y fuente normativa interna cargada por el administrador. Las reglas de aduana cambian y el sistema debe reflejar la versión vigente. La fecha de la última versión de la norma debe ser visible al usuario.

Campos de aduana por paquete¶

Campo	Ubicación	Descripción
`customs_category_id`	`physical_packages`	Categoría aduanera asignada (FK a las 15 categorías operativas)
`customs_value`	`physical_packages`	Valor declarado para aduana (USD)
`customs_amount`	`physical_packages`	Monto pagado en aduana por el paquete (USD)
`customs_amount_total`	`shipments`	Monto total de aduana pagado por el envío (suma de los paquetes)
`requires_invoice`	`customs_categories`	Si la categoría requiere factura
`risk_level`	`customs_categories`	low / medium / high / prohibited
`allows_air`	`customs_categories`	Si se puede enviar por aire
`allows_sea`	`customs_categories`	Si se puede enviar por mar
`duty_percentage`	`customs_categories`	Porcentaje de arancel aplicable (típicamente 30 %)
`reference_value_usd`	`customs_categories`	Valor de referencia según Res. 175/2022 (cuando aplique por unidad)
`unit_of_measure`	`customs_categories`	Unidad del valor de referencia (unidad, kg, m, m², L, juego, kit)
`quantity_limit`	`customs_categories`	Tope orientativo por envío (2, 3, 5, 10, etc. según capítulo)
`requires_special_permit`	`customs_categories`	Si requiere MINCOM, IACC u otra autorización

Cálculo del arancel

El monto de aduana por paquete se calcula como:

customs_amount = (customs_value − exención_aplicable) × duty_percentage / 100

La exención por defecto es 30 USD (3 kg) para envíos generales, o hasta 200 USD/20 kg si el envío contiene exclusivamente alimentos/aseo/medicamentos/insumos médicos (beneficio 2026). Ver la fórmula completa en Normativa — sección 2.