Preguntas frecuentes

Respuestas a las dudas más comunes sobre cómo funciona Jaomai, agrupadas por área.

Volver al Centro de Ayuda

Captura

Captura rápida e IA asistida

La bandeja de captura sirve para "capturar primero, clasificar después": durante la caminata por el mercado, el agente saca foto y nota de voz de un proveedor o producto y sigue caminando. Más tarde — en el hotel o de vuelta en la oficina — procesa cada item para convertirlo en un proveedor o producto con todos sus campos.

Preguntas frecuentes

¿Para qué sirve la bandeja de captura?

Para no romper el flujo del recorrido. En vez de detenerse a llenar el formulario completo en cada local, el agente abre la bandeja del contenedor, saca foto, agrega una nota de voz si quiere, marca si es un proveedor o un producto, y sigue. La clasificación y completado se hacen después.

¿Cómo se procesa un item de la bandeja?

Cada item tiene una acción Procesar:

  • Si es un proveedor: el sistema abre el formulario de proveedor con los datos disponibles (foto de tarjeta, OCR si está habilitado).
  • Si es un producto: abre el formulario de producto, opcionalmente pre-llenado con sugerencias de IA si está habilitado.

Una vez guardado, el item queda resuelto y vinculado al proveedor o producto creado.

¿Puedo capturar pedidos de cotización en la bandeja?

Sí, ese es un tipo separado de item. Solo lo crean admins desde un contenedor de cotización — ver el FAQ de cotizaciones para el flujo completo.

¿La IA está activa en producción?

Hoy no. Hay dos funciones de IA y las dos están desactivadas en producción hasta que decidamos asumir su costo:

  • Reconocimiento de imágenes: análisis de fotos de productos para sugerir descripción, dimensiones, precio, etc.
  • Reconocimiento de texto: OCR sobre tarjetas de presentación de proveedores para extraer nombre, dirección, contacto.

La bandeja de captura como tal funciona sin IA — solo no aparecen las sugerencias automáticas.

¿Cómo se activan?

Desde la página de configuración de funciones de la app (solo superadmin). Una vez activadas, las sugerencias aparecen en el procesamiento de los próximos items capturados.

Si activo la IA, ¿se aplica a items viejos de la bandeja?

No automáticamente. La IA corre cuando un item se sube por primera vez. Para correr el análisis sobre un item ya capturado, hay un botón Re-analizar en la vista de procesamiento — pero solo aparece si el reconocimiento de imágenes está activo.

¿Las notas de voz se transcriben?

Por ahora no. Se guardan como audio adjunto y el agente las escucha al procesar el item. Transcripción automática es una mejora futura.

¿Quién ve la bandeja de un contenedor?

El admin de la organización y el agente asignado a ese contenedor. Los clientes finales no la ven, ni siquiera de los contenedores donde tienen marca de envío.

Disponible desde: 2026-03-21

Clientes

Links compartidos al cliente

El cliente final revisa su parte de un contenedor sin necesidad de crear cuenta: el agente le envía un link único (por WhatsApp, mail, lo que sea), y desde ahí ve sus productos, puede pedir cambios y ver el ida y vuelta con el agente. Aislamiento de datos garantizado: solo ve lo que tiene asignado por marca de envío.

🎥 Video walkthrough (es): https://jaomai.store/videos/customer_changes_es.mp4

Preguntas frecuentes

Desde la vista del contenedor, sección Links compartidos, clickeás "Crear link" y elegís el cliente. El sistema genera una URL única (no adivinable) con vencimiento configurable. Se la enviás por el medio que prefieras.

Solo los productos del contenedor que están asignados a una marca de envío de su empresa. No ve productos de otros clientes, ni totales de contenedor que no le corresponden. La página es pública (no necesita login) pero el contenido está acotado al cliente del link.

¿Puede el cliente pedir cambios desde ahí?

Sí. En cada producto puede cambiar el estado a Confirmado o Cancelado, modificar la cantidad, y dejar un comentario. La solicitud no modifica el producto inmediatamente — queda como una petición que el agente acepta o rechaza desde su lado.

¿Cómo responde el agente a una solicitud del cliente?

El agente ve una alerta amarilla en la vista del producto con la cantidad pedida y el comentario. Puede:

  • Aceptar: el sistema actualiza la cantidad o estado del producto y registra la conversación en el historial.
  • Rechazar: tiene que escribir una razón (ej: "el proveedor ya produjo las cajas, no se puede cancelar"). El cliente ve el rechazo y la razón en su próxima visita al link.

Toda la conversación queda en un historial de cambios por producto, visible para ambas partes.

Por default, 2 horas desde la creación. Cada organización puede ajustar ese vencimiento en su configuración. Los links vencidos muestran una pantalla clara con la opción de regenerar.

Sí. Desde la sección de Links compartidos del contenedor, cualquier link activo se puede desactivar manualmente — el cliente verá la pantalla de "link expirado" la próxima vez que abra la URL.

¿El cliente ve el nombre del proveedor?

Depende de la configuración. La organización puede ocultar nombres de proveedor por default, y en cada contenedor se puede sobreescribir esa decisión (mostrar siempre / ocultar siempre / usar default). Útil cuando no querés que el cliente final pueda contactar al proveedor por su cuenta.

¿Hay un video que muestre el flujo completo?

Sí: el video walkthrough enlazado arriba. Recorre la creación del link, la solicitud del cliente, la aceptación y el rechazo del agente, y cómo todo queda documentado para ambas partes.

Disponible desde: 2026-04-03

Compras

Backoffice de pagos

En Reportes → Pagos a proveedores están todos los pagos de la organización en una sola lista, como los movimientos de una cuenta bancaria. Es una vista de sólo lectura: se mira, se filtra, pero no se edita. Los pagos se cargan en la página del contenedor.

Preguntas frecuentes

¿Qué muestra exactamente?

Un pago por tarjeta, del más nuevo al más viejo, con el importe y la fecha bien grandes y debajo el proveedor, el o los clientes, el o los shipping marks, el contenedor, la nota y los comprobantes. El nombre del contenedor es un link que te lleva directo al bloque de pagos de ese proveedor.

¿Por qué no puedo editar desde acá?

A propósito. Registrar un pago necesita el contexto del contenedor: qué se le compró a ese proveedor, cuál es el total, cuánto falta. Esta pantalla es para mirar el conjunto; para tocar algo, el link del contenedor te deja exactamente donde hay que tocarlo.

¿Qué pasa si no pongo ningún filtro?

Ves todos los pagos visibles de tu organización. Sin filtro no significa "sin resultados".

¿Qué filtros hay?

Rango de fechas (por fecha de pago), contenedor, proveedor, cliente y shipping mark. Se combinan entre sí: podés pedir "los pagos de este shipping mark en julio" y los dos filtros se aplican juntos.

¿Cliente y shipping mark no son lo mismo?

No, y por eso son dos filtros separados. Un cliente puede tener varios shipping marks. Para que la diferencia se vea al elegir, cada marca se lista como MARCA (Cliente).

¿Cómo sabe la app a qué cliente corresponde un pago?

Lo deduce en el momento: el pago cuelga de (contenedor, proveedor), y desde ahí llega a los productos, de los productos al shipping mark y del shipping mark al cliente. No se guarda una copia. Es más trabajo para la base pero nunca queda desactualizado si después movés productos entre marcas.

¿Y si un pago cubre productos de más de un shipping mark?

Se lista una sola vez, por el importe completo, con las dos marcas y una etiqueta cubre N shipping marks. No se parte el importe entre las marcas: nadie pagó "media transferencia", y repartirla sería inventar un dato.

Entonces, ¿el total puede quedar inflado?

Sí, y la pantalla te avisa. Cuando filtrás por cliente o por shipping mark y alguno de los pagos listados cubre varias marcas, el total aparece marcado como máximo, no como una suma limpia.

¿Por qué el total viene separado por moneda?

Porque sumar RMB con USD no significa nada. Hay una línea por código de moneda, y los pagos cuya moneda no se puede determinar (por ejemplo, cuando los productos del proveedor mezclan monedas) se muestran como número sin símbolo en vez de fingir uno.

¿Qué quiere decir "Sin shipping mark"?

Que los productos de ese proveedor en ese contenedor no tienen ninguna marca cargada. Se dice explícitamente en vez de dejar la celda vacía, para que se distinga de "no lo sabemos". Esos pagos no aparecen cuando filtrás por una marca.

¿Aparecen los contenedores de cotización?

No. Una cotización tiene precios completos y cero compromiso; no es plata que se movió.

¿Quién puede entrar?

Sólo el administrador de la organización. Los clientes no, y el superadmin de plataforma tampoco: los datos de pago son internos de cada organización, y una organización nunca ve los pagos de otra.

La lista está vacía y no entiendo por qué

Puede ser que todavía no haya pagos cargados, o que los filtros no den resultado. La pantalla te lo dice y te deja un link a los contenedores, que es donde se registran. La solapa siempre está, tenga o no movimientos.

Disponible desde: 2026-07-29

Pagos por proveedor

Dentro de cada contenedor, debajo del bloque de cada proveedor, hay un panel Pagos. Ahí ves el número de cuenta del proveedor, las distintas fuentes del valor total con la fecha de cada una, y la lista de todos los pagos que le hiciste a ese proveedor por ese contenedor: anticipo, saldo y lo que haga falta. El saldo se calcula solo.

Preguntas frecuentes

¿Dónde está el bloque de pagos?

En la vista del contenedor agrupada por proveedor, justo debajo del encabezado de cada proveedor. Aparece cerrado, mostrando el Valor total y el Saldo; lo tocás y se despliega.

¿Puedo cargar varios pagos al mismo proveedor?

Sí, y es la forma normal de usarlo: cada pago es un evento real, con su importe, su fecha, una nota opcional (por ejemplo "anticipo 30%") y sus comprobantes. Se listan del más nuevo al más viejo y cada uno se puede eliminar por separado.

¿Necesito tener la OC generada en la app para usarlo?

No. El bloque funciona aunque el contenedor no tenga ninguna orden de compra generada acá. Es a propósito: los contenedores que se cargan con el proceso ya empezado no tienen OC en la app, y el saldo tiene que funcionar igual.

¿De dónde sale el "Valor total"?

De cuatro fuentes posibles, y el bloque te muestra las cuatro con la fecha de cada una para que veas si se contradicen. Se usa la primera que esté informada, en este orden:

  1. Total ingresado a mano — lo que escribiste vos.
  2. Total de la OC emitida — el número que efectivamente se imprimió en el PDF de la orden de compra.
  3. Total de OC informado — el número que tipeaste cuando la OC vive fuera de la app.
  4. Suma de los productos — cantidad × precio unitario de los productos activos de ese proveedor.

La que está en uso lleva la etiqueta En uso.

¿Por qué el total de la OC no cambia si saco un producto de la orden?

Porque queda congelado en el momento en que se generó el PDF. El papel que tiene el proveedor dice un número; si después movés productos, la suma en vivo cambia pero la OC no. Por eso se guardan los dos y se muestran los dos.

¿Qué diferencia hay entre "Total de la OC emitida" y "Total de OC informado"?

El primero lo pone la app sola cuando generás la OC. El segundo lo escribís vos, y sirve sólo cuando la OC nunca se emitió desde acá. Si el campo está vacío no significa "cero": significa que nadie informó un número.

¿El número de cuenta es de este contenedor o del proveedor?

Del proveedor. Es la cuenta actual de ese negocio y se usa en todos los contenedores; el bloque lo aclara arriba del campo. La fecha al lado muestra cuándo fue la última vez que el número cambió, porque en China las cuentas rotan seguido y conviene re-verificarlas antes de cada pago. Volver a guardar la misma cuenta no mueve esa fecha.

¿Quién puede editar el número de cuenta?

Un administrador. Los agentes lo ven en el bloque, pero no lo editan: como la cuenta es del proveedor, un cambio ahí cambia el destino del dinero en todos los contenedores que le compran a ese negocio. Los totales y los pagos de cada contenedor sí los carga el agente.

Si el proveedor cambia de cuenta, ¿se reescriben los pagos viejos?

No. Cada pago guarda una copia de la cuenta a la que efectivamente fue. Cambiar la cuenta del proveedor afecta a los pagos futuros, nunca a los que ya registraste.

¿Por qué el campo Importe aparece con un número gris?

Es sólo una referencia (el saldo pendiente), no un valor cargado. Si guardás sin escribir nada, no se registra ningún pago: un número sugerido que se guarda solo convertiría "no informado" en "informado", que es exactamente lo que queremos evitar.

¿Cómo cargo el comprobante?

En el formulario de cada pago, con Tomar Foto (cámara del celular) o Subir Archivos. Podés cargar varios; se ven como miniaturas debajo del pago y cada uno se puede abrir en grande o eliminar con la crucecita.

¿Cómo se calcula el saldo?

Saldo = Valor total − suma de todos los pagos registrados. Se muestra en la barra del bloque (incluso cerrado) y al lado del botón de agregar pago.

¿Los clientes ven esta información?

No. Los pagos son internos: los usuarios con rol cliente no ven el bloque ni pueden modificarlo, ni siquiera entrando por la URL directa.

¿Dónde veo todos los pagos juntos?

En Reportes → Pagos a proveedores. Ver la FAQ del backoffice de pagos.

Disponible desde: 2026-07-29

Órdenes de Compra (OCs) por proveedor

Cada contenedor genera una OC activa por proveedor: se agrupan automáticamente todos los productos de ese proveedor dentro del contenedor en un único PDF, listo para enviar al taller. Cuando cambian los productos, la OC se marca como desactualizada y un click la regenera con la versión más reciente.

Preguntas frecuentes

¿Cómo genero una OC?

Desde la vista del contenedor agrupada por proveedor, cada bloque tiene un botón Generar OC. Al clickearlo, el sistema arma un PDF con todos los productos confirmados de ese proveedor en este contenedor: referencia, descripción, cantidad, precio unitario, CBM, peso, fotos y etiqueta del cartón.

¿Puedo tener más de una OC abierta para el mismo proveedor en un contenedor?

No. Hay una sola OC activa por proveedor en cada contenedor. Si ya existe una OC activa, "Generar OC" abre la regeneración en lugar de duplicar. Las versiones anteriores a una regeneración quedan archivadas como histórico.

¿Por qué la OC aparece "desactualizada"?

Porque algún producto cambió después de la última generación. Cualquier modificación a los datos del producto la marca como desactualizada — no solo la cantidad, también descripción, precio, CBM, peso, medidas, color, talla, marca, material o el texto de la etiqueta del cartón. Vas a ver un cartelito Desactualizada sobre la OC y un botón para regenerarla.

¿Cómo regenero una OC desactualizada?

Desde el bloque del proveedor o desde la página del proveedor (que también lista sus OCs recientes), clickeás el botón de regenerar. El PDF nuevo reemplaza al anterior como OC activa; la versión vieja queda como histórico.

¿Qué muestra la OC además de los datos del producto?

  • Encabezado con logo, nombre y dirección de tu organización (configurables en Mi Cuenta → Empresa).
  • Marca de envío del cliente con su diamante.
  • Etiqueta del cartón con texto editable y pictogramas de manipulación: este lado arriba, mantener seco, no pisar, símbolo de reciclar. Editar la etiqueta también marca la OC como desactualizada.
  • Medidas del cartón (ancho × alto × profundidad) para que el embalaje se decida en el taller sin tener que volver a consultar.

¿Dónde encuentro las OCs de un proveedor?

En la página del proveedor, debajo de la sección de productos, aparece la lista de sus OCs recientes con filtro Activas / Todas. Desde la vista agrupada de productos del contenedor también hay un acceso directo a esa página.

¿Hay un equivalente para enviar al cliente final (no al proveedor)?

Sí: la proforma por proveedor (PDF y Excel) y el export del contenedor completo agrupado por proveedor. Este último puede anonimizar los grupos para compartir con el cliente sin revelar quién es cada proveedor.

¿Quién puede generar y regenerar OCs?

Cualquier usuario con acceso al contenedor (admin o agente asignado). Los clientes finales no acceden al flujo de OCs.

Disponible desde: 2026-04-26

Contenedores

Cierre del contenedor

Cuando el contenedor se carga y se sella, hay datos que antes había que anotar por fuera de la app: el número del sello, la fecha de cargue, las observaciones, y las fotos del contenedor vacío, del contenedor lleno y del sello puesto. Ahora todo eso se registra en la app y sale en un reporte de cargue en PDF de una página.

Preguntas frecuentes

¿Dónde se carga?

En la página del contenedor hay un botón Cierre del contenedor. Te lleva a una pantalla pensada para el celular: los tres grupos de fotos, cada uno con su botón de cámara, más el número de sello, la fecha de cargue y las observaciones. Guardás todo de una sola vez.

Si el cierre ya tiene algo cargado, el botón muestra un tilde verde.

¿Puedo sacar las fotos en varias tandas?

Sí. Cada vez que guardás, las fotos nuevas se suman a las que ya había: no reemplazan nada. Si te faltó una foto del contenedor lleno, entrás de nuevo, la sacás y guardás.

Para borrar una foto puntual, tocá la crucecita roja arriba a la derecha de la miniatura.

¿Por qué tres grupos de fotos y no uno solo?

Porque el reporte los muestra separados y etiquetados: contenedor vacío, contenedor lleno, sello de seguridad. Si mañana hay un reclamo, esa separación es la que cuenta la historia — cómo llegó el contenedor, cómo quedó cargado, y con qué sello se cerró.

¿La fecha de cargue es la misma que la de despacho?

No necesariamente, y por eso son dos campos distintos. La fecha de cargue es el día que se llenó el contenedor; la fecha de despacho es la del embarque. Pueden coincidir o no.

¿El número de sello va en las observaciones?

No hace falta: tiene su propio campo, porque el reporte lo imprime en el encabezado junto al número de contenedor y la naviera. Las observaciones de carga quedan para todo lo demás que quieras dejar anotado.

¿Dónde bajo el reporte?

En el menú verde de descargas del contenedor está Reporte de cargue (PDF), y también hay un botón directo arriba de la pantalla de cierre.

¿Qué trae el reporte?

El encabezado con los datos del embarque (D.O., número de despacho, número de contenedor, sello, naviera, clase de contenedor, puertos y fecha de cargue), el shipping mark dibujado en un rombo, las fotos agrupadas por tipo y las observaciones de carga. Los campos que estén vacíos no se imprimen, para que no parezca un formulario a medio llenar.

¿Puedo sacar el reporte de un solo cliente?

Sí. Si filtrás por shipping mark en la página del contenedor, el reporte respeta ese filtro y sale con esa marca. Sin filtro salen todas las marcas del contenedor.

¿El reporte muestra datos del proveedor?

No, ninguno. Ni el nombre ni el teléfono ni el número de local. El reporte es sobre el contenedor, no sobre la mercadería, así que no hay nada del proveedor para filtrar. Hay tests automáticos que lo verifican.

Los datos de embarque salen vacíos, ¿dónde los cargo?

En el formulario de edición del contenedor, sección Envío y logística (número de contenedor, despacho, naviera, puertos). En la pantalla de cierre los ves a la derecha como referencia, con un acceso directo para editarlos si sos administrador.

¿Qué pasa si paso el contenedor a "Sellado" sin cargar el cierre?

Te avisa que falta el número de sello o las fotos del contenedor lleno, pero te deja seguir igual. Es un recordatorio, no un bloqueo: a veces el número de sello llega por WhatsApp un rato después.

¿El cliente puede cargar el cierre?

No. Un usuario con rol cliente puede ver el contenedor pero no registrar ni borrar el cierre.

¿Los datos del cierre salen también en el Excel?

El número de sello, la fecha de cargue y las observaciones sí, en el encabezado del Excel del contenedor. Las fotos del cierre no: esas viven en el reporte de cargue en PDF.

Disponible desde: 2026-07-30

Vista Tareas del contenedor

La pestaña Tareas en la página de un contenedor muestra solo los productos que necesitan atención y, para cada uno, qué hay que hacer ahora mismo. Es el atajo cuando entrás a un contenedor y querés saber "¿qué tengo pendiente acá?" sin recorrer todos los productos.

Preguntas frecuentes

¿Dónde la encuentro?

En la página del contenedor, arriba de la lista de productos, hay tres pestañas: Agrupado, Plano y Tareas. Las dos primeras son las dos formas de mirar los productos (todos juntos o agrupados por proveedor). Tareas filtra y reordena para mostrar solo lo accionable.

¿Qué cuenta como "tarea"?

Cada producto cae en una de estas categorías, en orden de prioridad:

  1. Confirmar — el producto está en estado pendiente; falta confirmar con el proveedor.
  2. Regenerar OC — el producto está confirmado pero su OC quedó desactualizada (se hicieron cambios después de emitirla). Hay que reemitir.
  3. Pedir — el producto está confirmado pero todavía no tiene número de orden de compra asignado.
  4. Seguimiento — la fecha estimada de producción ya pasó y todavía no llegó al depósito. Hay que averiguar con el proveedor.
  5. Completar — el producto llegó al depósito pero le faltan datos finales (peso, medidas o foto de recepción).

Los productos ya entregados y sin pendientes no aparecen en esta vista.

¿En qué orden aparecen?

Las destacadas (productos marcados con la estrella ⭐) van primero, luego ordenadas por prioridad de tarea (de confirmar a completar), después por proveedor, después por referencia. Así, lo que vos marcaste como urgente sale arriba.

¿Qué hace el botón de la derecha?

Es la acción que corresponde a la tarea. Para "Regenerar OC", el botón emite la nueva OC en el momento. Para las demás, te lleva al producto para que hagas el cambio (por ejemplo, confirmar o completar datos).

¿Las contadores arriba qué muestran?

Un resumen rápido: cuántos productos hay en cada categoría de tarea ("3 confirmar · 2 regenerar OC · 5 pedir…"). Útil para saber de un vistazo si el contenedor está al día o tiene mucha cola.

¿Y si no hay nada pendiente?

Aparece un mensaje verde: "No pending tasks — all products are ordered and on track". Significa que todos los productos del contenedor están confirmados, con OC vigente, no se demoraron y, si llegaron, ya tienen datos completos.

¿Esto reemplaza la pestaña Agrupado?

No. Tareas es para foco operativo (qué hay que hacer ahora). Agrupado es para revisar el contenido completo del contenedor por proveedor (precios, cantidades, totales). Usá la pestaña que corresponda al momento.

¿La vista cambia entre dispositivos / usuarios?

La columna de proveedor y la de OC se ocultan en pantalla chica. La vista por sí misma es la misma para cualquier usuario con acceso al contenedor (admin u operador asignado).

Disponible desde: 2026-05-19

Ciclo de vida del contenedor

Cada contenedor pasa por una serie de estados desde que el comprador empieza a planificarlo hasta que el envío llega a destino. El sistema usa esos estados para mostrar el contenedor en el panel correcto y para habilitar ciertas acciones (por ejemplo, subir fotos del precintado o registrar fecha de despacho).

🎥 Video walkthrough (es): https://jaomai.store/videos/container_lifecycle_es.mp4

Preguntas frecuentes

¿Cuáles son los estados de un contenedor?

En orden:

  1. Planificación — el agente carga productos, sube fotos, define precios. Es el estado inicial.
  2. Pedido — los productos están confirmados; se generan OCs por proveedor.
  3. Carga — la mercadería se está recibiendo en bodega para consolidar el contenedor.
  4. Sellado — el contenedor está cerrado, con foto de precinto.
  5. En tránsito — el contenedor zarpó; se registra fecha de despacho.
  6. Entregado — llegó a destino.

Más un estado especial: Cancelado, que sale del flujo normal pero conserva los datos.

¿Cómo cambio de estado?

Desde la página del contenedor hay un botón de transición de estado que ofrece las opciones válidas según el estado actual. El sistema valida que el contenedor cumpla los requisitos antes de avanzar (por ejemplo, no podés ir a "Sellado" sin haber cargado productos).

¿Hay un panel separado para cada estado en el dashboard?

Sí. El Panel de Control agrupa los contenedores por estado: Cotizaciones, Planificación, Pedido, Carga, Sellado, En tránsito, Entregado (y opcionalmente Cancelados con un toggle). Esto permite escanear de un vistazo qué hay que atender en cada etapa.

¿Puedo cancelar un contenedor en cualquier estado?

Sí. Desde la edición del contenedor, hay un botón Cancelar contenedor disponible en cualquier estado. Cancelar no borra los datos, solo cambia el estado a Cancelado y los excluye de los totales. Reactivar también está disponible desde la misma vista — el contenedor vuelve a Planificación.

¿Qué pasa si elimino un contenedor?

Eliminación es soft delete: el contenedor desaparece de la vista, pero los datos se conservan en la base. Un superadmin puede recuperarlo desde la pantalla de Admin. Los productos, proveedores y marcas de envío también se borran lógicamente, no físicamente.

¿Qué son los tipos de contenedor y para qué sirven?

Cada contenedor tiene un tipo (por ejemplo "40ft High Cube") con un volumen máximo y peso máximo. Cuando los productos cargados superan esos límites, la app muestra una advertencia visual en el header del contenedor: "Sobrecarga de volumen / peso". No bloquea, pero alerta para que ajustes la carga.

¿Y los contenedores compartidos? ¿Qué cambia?

Un contenedor compartido es uno donde varias marcas de envío conviven (varios clientes en un mismo container). Se marca con un flag al crear el contenedor. En estos casos, los límites de volumen/peso son opcionales (cada cliente puede tener un cap personal o ninguno) y los productos se agrupan por marca de envío en los exports.

¿Quién puede transicionar estados?

El admin de la organización y el agente asignado al contenedor. Los clientes finales y los contenedores de cotización tienen un flujo separado que no usa estos estados.

¿Hay un video que muestre el ciclo entero?

Sí: container_lifecycle_es.mp4. Recorre la creación de un contenedor desde Planificación hasta Entregado, mostrando qué cambia en cada estado y qué acciones se habilitan.

Disponible desde: 2025-09-21

Cotizaciones

Cotizaciones agente ↔ comprador

El comprador crea solicitudes de cotización con foto y descripción dentro de un contenedor marcado como cotización, y el agente las responde caminando el mercado y registrando productos con proveedor y precio. Las respuestas quedan agrupadas bajo cada solicitud, ordenadas por precio, para que el comprador compare y elija.

🎥 Video walkthrough (2:13, español): https://jaomai.store/videos/agent_quote_es.mp4

Preguntas frecuentes

¿Qué es un contenedor de cotización?

Es un contenedor que se usa solo para pedir precios — no es un pedido en firme. Aparece en el panel Cotizaciones del tablero, separado de los contenedores en planificación. Se crea con el botón "+" en ese panel.

¿Cómo solicito una cotización?

Abrís el contenedor de cotización y en la sección Solicitudes de cotización clickeás + Nueva solicitud. Subís foto(s) si tenés, escribís una descripción de qué necesitás cotizar (por ejemplo, "Mochila escolar negra resistente al agua, 25 litros aprox.") y guardás. Cada solicitud queda como una tarjeta independiente.

¿Quién crea las solicitudes y quién las responde?

  • Solicitudes: las crea el comprador. Representan lo que el cliente final está pidiendo cotizar.
  • Respuestas: las cargan los agentes asignados al contenedor. Cada respuesta es un producto con proveedor, referencia, precio y foto.

¿Cómo responde el agente a una solicitud?

Desde la tarjeta de la solicitud, el botón Cotizar abre el formulario de nuevo producto ya enlazado a esa solicitud. El agente registra al proveedor, la referencia, precio unitario, medidas, etc., y guarda. La respuesta queda asociada automáticamente a la solicitud original.

¿Puede haber más de una respuesta por solicitud?

Sí, esa es la idea. El agente puede traer varias propuestas de proveedores distintos para la misma solicitud. La tarjeta mostrará "3 cotizaciones" y listará los precios. El comprador puede comparar de un vistazo.

¿Cómo elijo entre las cotizaciones recibidas?

Las respuestas aparecen ordenadas de menor a mayor precio debajo de cada solicitud, con el número de tienda del proveedor y la referencia del producto. Hacés click en cualquiera para abrir el detalle.

¿Cuándo paso de cotización a pedido real?

Todavía no automáticamente — el paso "convertir cotización en pedido en firme" es una iteración prevista. Por ahora, una vez decididas las cotizaciones ganadoras, el comprador crea un contenedor de pedido nuevo y carga ahí los productos elegidos.

¿Qué ven los agentes que no están asignados a este contenedor?

Nada. Cada agente solo ve los contenedores que tiene asignados. Las solicitudes y cotizaciones de otros agentes no son visibles entre sí.

¿Hay un video que muestre el flujo completo?

Sí: el video walkthrough enlazado arriba (2:13 min., en español). Recorre las 10 escenas: comprador crea la solicitud → agente la cotiza dos veces con proveedores distintos → comprador ve ambas respuestas ordenadas por precio.

Disponible desde: 2026-05-02

Importación

Importación de productos desde Excel

Desde la página de un contenedor podés cargar todos los productos de una vez subiendo una planilla Excel — con las fotos incrustadas directamente en las celdas. Útil cuando el agente prefiere preparar el listado completo en planilla antes de cargarlo.

Preguntas frecuentes

¿Dónde está la importación?

En la vista del contenedor, sección de productos, hay un acceso a Importar productos. Bajás una plantilla desde esa misma página, la completás y la subís.

¿Tengo que usar la plantilla descargable o cualquier Excel sirve?

Tenés que usar la plantilla. El sistema valida los nombres de las columnas y rechaza la importación si faltan columnas obligatorias. La plantilla está pre-formateada con los anchos correctos y un ejemplo de fila para que veas qué se espera en cada campo.

¿Qué columnas son obligatorias?

Cuatro: supplier_name, product_reference, units_per_carton y unit_price.

El resto son opcionales: shipping_mark, description, sample_photo (imagen embebida), box_reference, unit_type, carton_count, currency, estimated_cbm, width_cm, height_cm, depth_cm, weight_kg, color, size, material, brand, label, order_number, order_date, delivery_date.

¿Cómo se cargan las fotos? ¿URL? ¿archivo?

Pegando la imagen directamente en la celda de la columna sample_photo. El importador extrae la imagen embebida y la asocia al producto que corresponde a esa fila. Una sola imagen por producto en la importación; podés agregar más después desde la edición.

¿Qué pasa si el proveedor no existe todavía?

La importación lo busca por nombre entre los proveedores de tu organización. Si no existe, esa fila falla con un error de "proveedor no encontrado" y el resto de la planilla sigue procesándose. Tenés que crear los proveedores nuevos antes de importar (manualmente o uno por uno desde el formulario de producto).

¿La marca de envío se identifica por nombre o por número?

Por nombre exacto, y solo se aceptan marcas de envío ya asignadas al contenedor. Si la columna está vacía y el contenedor tiene una sola marca asignada, el sistema usa esa por default. Si hay varias y la columna queda vacía, la fila falla con un mensaje claro.

¿Qué pasa si una fila duplica un producto que ya existe en el contenedor?

Se reporta como duplicado (no se crea nada), con un link al producto existente para que el agente decida si editar el original o cambiar la referencia. La regla es la misma que en la carga uno a uno: proveedor + referencia única dentro del contenedor.

Si una fila falla, ¿se cancela toda la importación?

No. El importador procesa fila por fila e informa al final cuántas se crearon, cuántas fallaron y cuántas eran duplicados. Podés corregir las fallas en el Excel y volver a importarlo — las exitosas anteriores quedan, las duplicadas se siguen reportando como tales.

¿La importación hace lo mismo que la carga manual de un producto?

Sí — ese es el principio. Las validaciones son las mismas que el formulario rápido de producto. Si una columna obligatoria está vacía, falla la fila. Si algún número está mal formateado, también. No es más permisivo por venir de Excel.

¿La importación reconoce productos que ya existen en otros contenedores?

Todavía no. Esa detección está prevista como próxima iteración. Por ahora el aviso "ya tenés este producto en otro contenedor" funciona solo en la creación uno a uno desde el formulario.

Tengo una caja consolidada con varios productos distintos (repackaged). ¿Cómo la cargo?

Cuando varios productos viajan reempacados en una misma caja (por ejemplo 700 fundas que son 3 referencias distintas en un solo cartón de ~0,12 m³), la caja ocupa un solo espacio y pesa una sola vez. Para cargarla:

  1. Poné el mismo box_reference en todas las filas de esa caja (ej. CTN-001). Ese código es lo que agrupa los productos en una misma caja.
  2. Repetí el mismo volumen (estimated_cbm o width_cm/height_cm/depth_cm), el mismo weight_kg y el mismo carton_count (normalmente 1) en todas las filas de la caja — son valores de la caja, no de cada producto.
  3. La foto va una sola vez, en la primera fila de la caja.
  4. La cantidad (units_per_carton) sí es propia de cada producto: cada fila lleva sus piezas.

El sistema cuenta el volumen, el peso y los cartones una sola vez por caja (por box_reference), aunque el valor se repita en cada fila. La cantidad y el importe siguen sumándose por producto. En el listado del contenedor los productos quedan ordenados por caja y luego por referencia, así cada caja se ve junta.

¿Y el proveedor, si la planilla del proveedor no lo trae?

Si solo manejás la parte logística y hay un intermediario que se encarga de la cotización/compra/recepción, registrá todo bajo ese intermediario: poné su nombre en supplier_name en todas las filas.

Disponible desde: 2026-04-26

Productos

Mover productos entre contenedores

Cuando un cliente te pide enviar algunas referencias consolidadas en un contenedor distinto al que ya tenías armado, no hace falta volver a cargar los productos. Desde el listado de Productos, seleccioná las referencias que se van a mudar y movelas en un solo paso al contenedor destino — existente o nuevo.

Preguntas frecuentes

¿Quién puede mover productos en lote?

Solo los administradores de la organización. Los agentes y los clientes finales no ven los checkboxes ni la barra de acción.

¿Cómo selecciono varios productos?

En el listado de Productos (/products), al lado de cada fila hay un checkbox. Marcá los que querés mover. Aparece una barra fija abajo con el contador de seleccionados y el botón Mover a contenedor. El checkbox del encabezado selecciona todo lo visible.

¿Puedo mover productos de contenedores distintos al mismo tiempo?

No. La selección tiene que venir de un solo contenedor de origen. Si mezclás, el sistema rechaza el movimiento. Filtrá por contenedor antes para asegurarte de que todos los seleccionados son del mismo.

¿Puedo crear el contenedor destino sobre la marcha?

Sí — y es justamente el caso "consolidado". El modal te da dos opciones: mover a un contenedor existente o crear uno nuevo. Si elegís crear uno nuevo, ingresás el nombre (por ejemplo "Consolidado ACME") y se crea como contenedor compartido (permite varias marcas de envío conviviendo).

¿Qué pasa con el código de barras y las fotos del producto?

Se mantienen. El producto es el mismo, solo cambia el contenedor al que pertenece. El EAN, las fotos de muestra, el proveedor, el cliente y la marca de envío siguen al producto.

¿Y la marca de envío? ¿Hay que asignarla en el contenedor destino?

No. Cuando movés un producto, su marca de envío queda automáticamente vinculada al contenedor destino (si no estaba ya). Así aparece en los filtros y formularios del nuevo contenedor sin pasos extra.

Tenía una OC emitida para esos productos. ¿Qué pasa?

La OC original queda en el contenedor de origen, pero el sistema la marca como pendiente de reemisión (badge "Necesita regenerar"). Esto es así porque los productos que estaban listados ya no están en ese contenedor — la OC impresa ya no refleja la realidad. Reemiti la OC en el contenedor de origen cuando confirmes los productos que quedaron.

El modal te avisa antes de mover: muestra una lista con las OCs activas que se van a marcar como pendientes, con número y proveedor.

¿El producto sigue con el número de OC viejo después del movimiento?

No. Al moverse, los campos purchase_order, order_number y order_date del producto se limpian. El producto llega al contenedor destino "sin OC", listo para ser incluido en una nueva OC cuando corresponda.

¿Qué pasa con la solicitud de cotización (si el producto venía de una)?

Se desvincula. El hilo original de cotización queda en el contenedor de origen donde el cliente lo creó. El producto movido es ahora una referencia confirmada del nuevo contenedor.

¿Se borra el contenedor de origen si se vacía?

No. Aunque movieras todos los productos afuera, el contenedor de origen sigue existiendo (vacío). Si no lo necesitás más, podés cancelarlo o eliminarlo manualmente desde su pantalla.

¿Queda registro de la operación?

Sí. Se guarda un evento product.bulk_moved en la bitácora con el contenedor origen, el destino, los IDs de los productos movidos y las OCs que quedaron marcadas como pendientes.

Disponible desde: 2026-05-19

Detección de productos repetidos entre contenedores

Cuando el agente vuelve a encontrar en el mercado un producto que ya cargó en un contenedor anterior — misma tienda, misma referencia — el sistema lo reconoce automáticamente y le ofrece traer los datos del último para no tener que retipear todo. Es memoria institucional entre viajes.

Preguntas frecuentes

¿Si vuelvo a cargar un producto que ya cargué en otro contenedor, el sistema lo reconoce?

Sí. En el formulario de "Nuevo producto", apenas elegís al proveedor y escribís la referencia, aparece debajo del campo un aviso azul:

ℹ️ Ya tenés este producto en CONT-2025-014 (hace 3 meses) 2 foto(s) en la captura anterior [📋 Copiar datos del último]

El aviso es solo informativo. Si lo ignorás, podés seguir cargando el producto desde cero.

¿Qué hace exactamente "Copiar datos del último"?

  • Llena automáticamente los campos vacíos: descripción, precio, unidades por caja, CBM, peso, medidas, marca, etc.
  • Si ya escribiste algo en un campo, no se sobreescribe — tu trabajo manual se respeta.
  • También trae las fotos del producto anterior, salvo que ya hayas subido fotos propias.

¿Qué pasa si intento crear el mismo producto dos veces en el mismo contenedor?

El sistema lo rechaza con un error claro: la combinación de proveedor más referencia debe ser única dentro del contenedor — es la misma SKU duplicada y deberías editar el producto existente en vez de crear otra fila.

¿Otros agentes pueden ver mis datos a través de este reconocimiento?

No. Cada agente solo ve productos de los contenedores que tiene asignados. Si trabajás en el contenedor A y otro agente trabaja en el contenedor B, el sistema nunca te muestra avisos basados en el contenedor B.

¿Y entre organizaciones distintas?

Cero contacto. Una organización nunca ve datos de otra, ni siquiera para reconocer productos.

¿Los clientes finales acceden a esta función?

No. El reconocimiento es solo para staff (administradores y agentes). Los clientes finales no participan de este flujo.

¿En la importación masiva (Excel) también funciona esta detección?

Todavía no. Está previsto como próxima iteración. Por ahora la importación masiva sigue las mismas reglas que la carga uno a uno (rechaza duplicados dentro del contenedor), pero no ofrece "copiar del último" automáticamente.

Disponible desde: 2026-05-07

Roles

Rol de agente

El rol de agente es para colaboradores externos que trabajan en el mercado por cuenta de un comprador. Tienen acceso acotado a contenedores específicos: pueden cargar productos, generar OCs y responder cotizaciones, pero no ven el catálogo global de la organización ni los datos de otros agentes.

Preguntas frecuentes

¿Cómo creo un usuario agente?

Como admin, vas a Configuración → Usuarios → Nuevo con el rol "Agente". El formulario te deja, en el mismo paso, asignar uno o más contenedores existentes al agente. También te genera un email + contraseña para que se loguee. Una vez creado, el agente recibe el contenedor en su Panel de Control la próxima vez que entra.

¿Cómo le asigno un contenedor a un agente que ya existe?

Desde la edición del contenedor (campo Agente asignado), elegís al agente del combo. O desde la edición del usuario agente, marcás los contenedores que querés asignarle.

Solo los admins pueden asignar o reasignar agentes.

¿Qué ve un agente en su Panel de Control?

Solo los contenedores que tiene asignados. Los demás contenedores de la organización son invisibles para él, incluso los de cotización.

¿Qué puede hacer un agente dentro de un contenedor que tiene asignado?

  • Crear, editar y eliminar productos.
  • Crear nuevos proveedores en el momento (con "+ Nuevo proveedor" en el formulario de producto).
  • Generar OCs por proveedor.
  • Responder solicitudes de cotización en contenedores de cotización.
  • Ver la bandeja de captura del contenedor y procesar items.
  • Subir fotos de productos.

¿Qué no puede hacer un agente?

  • Acceder a las páginas globales de proveedores, clientes o marcas de envío de la organización (lo redirigen al Panel de Control).
  • Ver contenedores de otros agentes — ni siquiera por URL directa.
  • Crear nuevos contenedores.
  • Crear o gestionar usuarios.
  • Ver datos de otra organización.

¿Por qué cuando busca un proveedor solo ve algunos?

Para no exponerle el catálogo completo de la organización, el buscador de proveedores del agente está acotado a los proveedores visibles: aquellos que ya tienen al menos un producto en alguno de sus contenedores asignados. Si encuentra un proveedor nuevo en el mercado, usa "+ Nuevo proveedor" en el formulario de producto y el sistema crea ese proveedor (o lo reusa silenciosamente si ya existía con el mismo número de tienda).

¿Puede ver qué productos cargó otro agente en otro contenedor?

No. El reconocimiento cruzado de productos está acotado por agente: cada uno solo recibe avisos basados en sus propios contenedores asignados. No hay cruce de información entre agentes.

¿Puede un agente ser cliente al mismo tiempo?

No. Cada usuario tiene un único rol. Si la misma persona necesita acceder como cliente y como agente, hoy son dos cuentas separadas.

Disponible desde: 2026-05-01