Contenedores
Videos tutoriales
Los videos se reproducen si la carpeta media/ está disponible en el servidor.
¿Para qué sirve este módulo?
El módulo Ingreso contenedor gestiona importaciones agrupadas en un contenedor: productos del proveedor extranjero, costos logísticos (flete, aduana, seguro, etc.) y la recepción final que ingresa mercancía al inventario con el costo real (CPP).
- Crear contenedores con proveedor, asesor, sucursal destino y fecha estimada de llegada.
- Registrar productos con cantidades, costos unitarios y descuentos.
- Asociar gastos en borrador (no contabilizados hasta recibir).
- Seguir el envío con estados: Pendiente → En tránsito → En puerto → En camino → Recibido.
- Recibir contenedor: suma stock, calcula CPP, convierte gastos borrador en egresos del módulo Gastos y genera comprobante contable.
- Exportar adhesivos, importar ítems por CSV y consultar historial de cambios.
Relación con otros módulos
| Acción | Módulo |
|---|---|
| Planificar importación, ítems, gastos logísticos y recepción con CPP | Ingreso contenedor (este módulo) |
| Compras locales / órdenes de compra sin logística de contenedor | Órdenes de compra → Compras |
| Gastos reales (flete, aduana…) después de recibir el contenedor | Gastos (egresos generados al recibir) |
| Datos del proveedor de importación | Proveedores |
| Stock y costo promedio de productos | Productos / Inventario |
| Comprobante contable de la recepción | Contabilidad (automático al recibir) |
Flujo habitual: Contenedor → ítems + gastos borrador → avanzar estados → Recibir contenedor → inventario actualizado + egresos en Gastos.
Inicio rápido
- Menú lateral → Ingreso contenedor → icono Listado.
- Filtre por sucursal si aplica → Buscar.
- Icono Add → seleccione proveedor, comprador, fecha estimada → Enviar.
- En el detalle: busque productos por nombre o código → confirme cantidades y costos.
- Sección Gastos asociados → Agregar Gasto (quedan en borrador).
- Actualice el estado (clic en la etiqueta de estado) según avance del envío.
- Revise totales y columnas de gasto unitario → Recibir contenedor con # documento del proveedor.
- Consulte egresos generados en Gastos y stock en Productos.
Listado y filtros
En Listado verá una tabla con:
- # — número del contenedor.
- Estado — etiqueta de color según el avance.
- Proveedor, Asesor, Valor, Fecha, Fecha estimada, Sucursal.
- Ver — botón amarillo abre el detalle .
- Eliminar — solo visible si el contenedor está en estado Pendiente; borra el registro por completo.
Filtro superior: seleccione Sucursal y pulse Buscar. Desde el Dashboard puede llegar al listado ya filtrado por estado.
El icono + en la tarjeta del listado también lleva a Add.
Estados del contenedor
| Estado | Significado | Editar ítems / gastos | Siguientes permitidos |
|---|---|---|---|
| Pendiente | Contenedor creado; se cargan productos y gastos. | Sí | En tránsito, Anulado |
| En tránsito | Embarque salió del país de origen. | Sí | En puerto, Anulado |
| En puerto | Llegó al puerto; desaduanaje o trámites. | Sí | En camino, Anulado |
| En camino | En ruta hacia la sucursal destino. | Sí | Recibido (vía recepción), Anulado |
| Recibido | Mercancía ingresada al inventario. Estado final. | No | — |
| Anulado | Importación cancelada. Estado final. | No | — |
- Clic en la etiqueta de estado (detalle) abre el modal Cambiar estado. Recibido no aparece en ese modal: la recepción se hace con el botón Recibir contenedor.
- Solo se admiten saltos a los estados siguientes de la tabla (más Anulado desde cualquier estado previo a Recibido).
- Recibido y Anulado no permiten editar productos ni agregar gastos.
Conceptos clave
Contenedor
Encabezado de la importación: proveedor, asesor (comprador), sucursal destino, fechas, nota y estado. El valor mostrado en listados corresponde al total de productos .
Ítems (productos)
Cada línea: variante, cantidad, costo unitario, descuento, columnas de gasto distribuido y total de línea.
Gastos borrador vs egresos reales
Mientras el contenedor no está recibido, los gastos (flete, aduana, etc.) se guardan como borrador: aparecen en la tabla con badge Borrador y no generan comprobante en Gastos. Al Recibir contenedor, el sistema los convierte en egresos reales del módulo Gastos (enlace al detalle del egreso).
CPP — Costo con gastos incluidos
Costo unitario real por producto después de repartir los gastos del contenedor. En pantalla verá Gasto unitario y el total de línea incluyendo ese costo.
Crear contenedor
- Icono Add .
- En Buscar Proveedor complete:
- Proveedor — obligatorio.
- Comprador — empleado responsable.
- Sucursal — visible si su usuario es multisucursal.
- Fecha estimada — llegada prevista (obligatoria).
- Fecha de la compra, # Factura, Tipo compra — opcionales según su operación.
- Enviar — el contenedor queda en estado Pendiente y abre el detalle.
Si el proveedor no existe, use Nuevo Proveedor en el mismo formulario.
Detalle del contenedor
Desde el listado, botón Ver (amarillo) → ficha de detalle del contenedor.
Encabezado
- Número de contenedor y estado (clic para cambiar).
- Datos de sucursal y proveedor. Icono de editar junto al proveedor solo en Pendiente.
- Menú desplegable: adhesivos Excel, importar, historial de cambios.
Resumen numérico
# productos, descuento, total productos, total gastos, gasto por producto y total general (cuando hay gastos).
Nota
Icono de lápiz junto a Nota → modal para observaciones internas.
Agregar y editar productos
Disponible mientras el contenedor no esté Recibido ni Anulado.
Agregar por búsqueda
- Campo Cantidad (por defecto 1).
- Nombre o Código → botón verde (flecha) abre modal de variantes/cantidades.
- Confirme precio y cantidad en el modal.
Nuevo producto
Botón Nuevo producto (amarillo) si la referencia aún no existe en catálogo.
Importar CSV
Botón Importar — carga masiva desde archivo plano (use la plantilla que ofrece el sistema).
Editar / eliminar línea
Columnas Editar (amarillo) y Eliminar (rojo) en cada fila. Al modificar ítems, los gastos distribuidos se recalculan.
Columnas útiles: Costo unitario, Total costo, Gasto unitario, Total gas, Total, Descuento.
Gastos asociados (borrador)
Sección Gastos Asociados en el detalle. Texto de ayuda en pantalla: se guardan en borrador hasta recibir el contenedor.
- Agregar Gasto — abre formulario completo de egreso (proveedor del gasto, motivo, valor, forma de pago, etc.).
- El gasto aparece en la tabla con estado Borrador.
- Acciones en borrador: Ver, Editar, Eliminar.
Puede agregar gastos en estados Pendiente hasta En camino.
Tras Recibir contenedor, los mismos conceptos pasan al módulo Gastos como egresos reales (Pendiente / Pagado según forma de pago). Desde ahí puede ver detalle con el botón azul .
Distribución de gastos y CPP
Los gastos del contenedor se reparten proporcionalmente a la cantidad de unidades (no al valor de cada producto).
Fórmulas en pantalla:
- Gasto por unidad = Total gastos ÷ Total unidades del contenedor
- Gasto de la línea = Gasto por unidad × Cantidad del ítem
- CPP (costo final unitario) ≈ Costo unitario + Gasto por unidad
Ejemplo: Total gastos $600.000; ítem A 100 uds, ítem B 200 uds (300 uds total). Gasto/unidad = $2.000. Ítem A recibe $200.000 de gasto; ítem B $400.000.
El resumen inferior muestra Total Gastos, Gasto por producto (promedio por unidad) y Total General (productos + gastos).
Cambiar estado
- En el detalle, clic en la etiqueta de estado (badge con icono de intercambio).
- Modal Cambiar Estado del Contenedor: elija nuevo estado y opcionalmente un motivo.
- Cambiar Estado — el sistema valida que la transición sea permitida.
Para anular, seleccione estado Anulado en este mismo modal (no disponible si ya está Recibido).
Los cambios quedan registrados en Historial de cambios (menú desplegable del detalle).
Recibir contenedor
Sección Recibir contenedor (parte inferior del detalle), visible mientras el contenedor no esté Recibido ni Anulado.
- Revise ítems, gastos borrador y columnas de gasto unitario.
- Complete Asesor y # Documento (factura o documento del proveedor).
- Recibir contenedor (botón verde).
Al confirmar, el sistema:
- Incrementa inventario en la sucursal del contenedor por cada producto.
- Actualiza costos usando el CPP (costo + gastos distribuidos).
- Genera comprobante contable automático (cuenta compra, IVA, cuenta por pagar al proveedor).
- Convierte cada gasto borrador en egreso real del módulo Gastos.
- Marca el contenedor como procesado (ya no permite editar ítems ni gastos).
Anular y eliminar
Eliminar (listado)
Solo en estado Pendiente. Botón rojo en columna Eliminar → confirma y borra el contenedor vacío o en preparación. No ingresa inventario.
Anular (detalle)
Modal Cambiar estado → elija Anulado. Disponible en cualquier estado excepto Recibido y Anulado. Los gastos borrador asociados se anulan en cascada. No hay ingreso a inventario.
No confunda Eliminar (solo pendiente, borra registro) con Anulado (cancelación formal con historial).
Acciones del detalle (menú y extras)
| Acción | Descripción |
|---|---|
| Adhesivos | Export Excel de etiquetas para productos del contenedor. |
| Adhesivos con talla color | Variante de etiquetas incluyendo talla y color. |
| Adhesivos con importación | Etiquetas con datos de importación (peluches / formato extendido). |
| Importar | Carga CSV de ítems al contenedor. |
| Historial de cambios | Auditoría de modificaciones (estados, notas, etc.). |
| Cambiar proveedor | Solo estado Pendiente (icono lápiz junto al nombre). |
| Editar nota | Observaciones visibles en el detalle impreso. |
Dashboard
Icono Dashboard: tarjetas con cantidad de contenedores en cada estado (Pendiente, En tránsito, En puerto, En camino, Recibido, Anulado).
Cada tarjeta enlaza al Listado filtrado por ese estado. Incluye tabla de últimos contenedores registrados.
Estadísticas
Icono Estadísticas: gráficos por rango de fechas de contenedores agrupados por estado, sucursal y proveedor. Use los filtros de fecha y Buscar para acotar el período.
Preguntas frecuentes
Ejemplos prácticos
Ejemplo 1 — Importación con flete y aduana
- Add → proveedor China S.A. → sucursal Principal → fecha estimada 2026-07-15.
- Agregar 500 uds producto A ($8.000 c/u) y 500 uds producto B ($12.000 c/u).
- Gastos borrador: Flete $2.000.000 + Aduana $1.000.000 → total $3.000.000 → $3.000/unidad (1.000 uds).
- Estados: Pendiente → En tránsito → En puerto → En camino.
- Recibir contenedor con # factura IMP-2026-042 → inventario + CPP $11.000 (A) y $15.000 (B).
Ejemplo 2 — Corrección antes de embarcar
- Contenedor Pendiente con proveedor equivocado → editar proveedor (lápiz) antes de cambiar estado.
- Eliminar línea duplicada con botón rojo en la tabla de productos.
Ejemplo 3 — Cancelar embarque
- Contenedor En tránsito que no continuará → Cambiar estado → Anulado + motivo.
- Verificar que gastos borrador quedaron anulados; no hay movimiento de inventario.
Buenas prácticas
- Registre todos los gastos del embarque (flete, seguro, aduana, bodegaje) antes de recibir para un CPP correcto.
- Mantenga el estado alineado con la logística real (tránsito, puerto, camino).
- Use fecha estimada al crear para planificar recepciones en bodega.
- Revise columnas Gasto unitario y Total general antes de Recibir contenedor.
- Guarde el # documento del proveedor al recibir; facilita conciliación con Compras y contabilidad.
- Importe CSV solo con la plantilla oficial para evitar errores de referencia.
- Consulte Historial de cambios ante diferencias de inventario o costo.
- No duplique contenedores para el mismo embarque; use un solo registro por contenedor físico.