El Mundo del Juguete

MDJ Ops

El Mundo del Juguete — Sistema Operativo

MDJ Ops

Despachos
🗂️ Todos los pedidos
📦 Despachos
🚚 En tránsito
📋 Historial
⚠️ Posventa
🔄 Cambios 0
↩ Devoluciones
📥 Retornos 0
Reembolsos
💳 Reembolsos
Marketplace
🧾 Liquidaciones
Incidencias
🎫 Incidencias
Etiquetas
🏷️ Etiquetas
📋 Catálogo
Sucursales
🏪 Retiros en sucursal
🚚 Transferencias
⚖️ Diferencias
📥 Recepciones
🎵 Música
Logísticas
📊 Dashboard Same Day
⚠️ Pedidos a reclamar
Depósito
🏭 Turnos proveedores
Empaquetado
📦 Empaquetado
Auditoría
🧾 Auditoría de stock
📋 Auditoría del sistema
Instructivos
📖 Instructivos
Admin
⚙️ Configuración
👥 Usuarios
📦 Despachos pendientes
-
Total
-
🔴 Vencido
-
🟠 Hoy
-
🟡 Mañana
-
🟢 OK
0 pedidos seleccionados
Urgencia Sale Order Order ID Fecha compra Canal Seller Courier Cliente Localidad Provincia Zona Fecha despacho Est. logístico Logística P·C·D Acciones
Sale Order Order ID Fecha compra Canal Cliente Productos Est. logístico Total P·C·D
🔄 Nuevo Cambio
Datos del cambio
Datos del cliente
Logística de envío (automático según la zona)
Habilitar
Provincia va por SHIPNOW: creá el envío allá y pegá acá el tracking — el sistema lo sigue solo y completa el cambio al entregarse.
Productos a enviar (lo que el cliente recibe)
SKU Nombre Cant. Observación Stock local
Productos a retirar (lo que el cliente devuelve)
SKU Nombre Cant. Observación
🚚 Pedidos en tránsito
0 pedidos seleccionados
Sale Order Order ID Fecha compra Canal Seller Courier Cliente Localidad Provincia Zona ID Logística Estado Logística Despachado P
📋 Historial de pedidos
Compra Despacho Entrega Sale Order Order ID Canal Seller Courier Logística Cliente Localidad Provincia Zona Resultado P·C·D
⚠️ Posventa — Problemas
Sale Order Order ID Cliente Canal Courier Tipo Observación Estado Resolución Registrado Acciones
🔄 Cambios
ID Cambio Secuencia Zona Motivo Tipo gestión Sucursal Cliente Pedido ref. Estado Creado Confirmado Acciones
↩ Devoluciones
Código Fecha Recibida Cliente Tipo Destino Motivo Estado Registrado por
📥 Retornos al depósito
Tipo Referencia Canal Cliente Qué debe volver Logística Fecha
🗂️ Todos los pedidos
0 pedidos seleccionados
Urgencia Aurora Sale Order Order ID Fecha compra Canal Seller Courier Cliente Localidad Provincia Zona Fecha despacho Logística Impreso Rcb. Depósito Estado logístico Estado
💳 Reembolsos
Reembolso Fecha Informado por Devolución Order ID Cliente Origen Monto Estado
📧 Destinatarios del informe
Configurar destinatarios en Configuración → Reembolsos
🧾 Liquidaciones
Pedido Fecha Cliente DNI Provincia Estado Total Envío Base Comisión Neto al seller
Elegí un seller para ver el detalle.
Liquidación Seller Período Pedidos Base Comisión Neto al seller Estado
🎫 Incidencias
Fecha #ID Título Usuario Adjunto Estado
🏷️ Etiquetas y precios
Cola de impresión
Vista previa · etiqueta código de barras
Buscá un producto para ver la previa
Seleccioná productos para agregar.
Seleccioná una lista y buscá un producto.
Vista previa · etiqueta de precio
Buscá un producto para ver la previa
Cola de precios
Seleccioná productos para agregar.

Con una lectora USB: escaneá el producto y Enter. Búsqueda parcial por nombre también funciona.

Ingresá un nombre o código para consultar.
📋
Seleccioná una lista para ver los productos.
Vista previa · etiqueta cambio de precios
Seleccioná un producto para ver la previa
Cola de impresión
Seleccioná productos para agregar.
📋 Gestión Cambio de Precios ▼

Cargá el Excel de cambio de precios para habilitar el botón temporal a todos los usuarios. El archivo debe tener columnas CODIGO, DETALLE y columnas de precios tipo AHORA LISTA 1, AHORA LT 7, etc.

📜 Historial de cambios
Cargando…
📋 Catálogo de productos
Precio: –
SKU Cód. prov. Nombre Proveedor Tipo Código de barras Precio Estado Acción 🔄 Img
Cargando…
📥 Recepciones de mercadería
PedidoSucursalProveedor SKU Pedidas Recibidas Pendientes EstadoCreado
Cargando…
RecepciónRemitoSucursalProveedor / Depósito UnidadesEstadoERPCreada
Cargando…
🚚 Transferencias a sucursal
Un archivo por local, con el nombre REPARTO SUC NN - DD-MM-AA. De ahí salen la sucursal y la fecha.
IdentificadorOrdenSucursalFecha RenglonesPedido PreparadoEstadoArchivo
Cargando…
🏪 Retiros en sucursal
📷
0 pedidos seleccionados
N° Orden Sale Order Nº de pedido Fecha compra Sucursal Canal Seller Cliente Estado Logística P Acciones
0 pedidos seleccionados
Sale Order Order ID Fecha compra Sucursal Canal Seller Cliente Estado Logística P Acciones
Sale Order Order ID Fecha compra Sucursal Canal Cliente Estado N° Orden P·C·D Entregado / Cancelado Acciones
Código Fecha Order ID Tipo Sucursal Estado Registrado por
ID Cambio Motivo Tipo gestión Sucursal Cliente Pedido ref. Estado Creado Acciones
⚙️ Configuración

🔢 Numeración de cambios y devoluciones

Cargá el último número usado de cada serie (sin el prefijo): el próximo registro toma el siguiente. El sistema nunca baja de lo ya usado en la base — solo avanza.

🧾 Remitos — puntos de venta

Un remito es un comprobante: se emite como 0000-00000000, punto de venta de 4 dígitos y número de 8. Cada serie lleva su numeración propia, y el número que se carga acá es el punto de venta, no el correlativo.

Datos fiscales del remito. Es el comprobante que lleva el chofer y que presenta ante un control, así que lo que falte acá falta en el papel. El remito de transferencias se emite como letra R, código 91, sin CAI (autoimpresor), en dos ejemplares.

Origen del traslado — COT de ARBA
El mismo domicilio de arriba pero desglosado, que es como lo pide ARBA: calle y número separados, código postal, localidad y provincia. La provincia es de un solo carácter según la tabla oficial — Buenos Aires es B, Capital Federal C, Córdoba X, Santa Fe S — y al menos una punta del traslado tiene que ser B o ARBA lo rechaza. Se carga aparte porque el campo de arriba es libre y partirlo con una regla automática falla el día del camión parado.
🔗 VTEX
🚚 Courier / Scheduler
Hacé click en "Ver" después de sincronizar para ver los nombres de SLA que devuelve VTEX y configurar las palabras clave correctas.
Separados por coma. Se despachan y archivan como entregados solos al vencer su fecha de despacho — es para couriers sin integración que, si no, se acumulan como activos para siempre. Sacar uno de la lista significa que alguien tiene que despacharlos a mano. Vacío = ninguno.
Si el resultado supera este límite, la exportación se rechaza para proteger el servidor. Default: 2.000. Podés subir hasta 5.000 con filtros de fecha acotados.
🧾 ERP Presea (Web Service)

Conexión al Web Service del ERP. Cada método del catálogo define un tipo de operación (consulta de stock, boleta contado, etc.) con su template de payload. Toda invocación se registra con un unique_id propio: ante un corte, el reintento usa el mismo ID y Presea devuelve el resultado del proceso previo sin duplicar comprobantes. La URL contiene el token: no se loguea nunca completa.

Guardá la configuración antes de probar.


              
Métodos del catálogo
MétodoDescripciónTimeoutEstadoAcciones
Abrí la sección para cargar…
Últimas invocaciones
#FechaMétodoUnique IDOrigenInt.Resultado
—
🚚 Logística automática por zona

Qué transportista toma un envío cuando nadie eligió uno a mano. Aplica a cambios, devoluciones y pedidos cargados manualmente. Los pedidos de VTEX no pasan por acá: ahí el transportista viene en el nombre del método de envío (SLA) y se asigna solo.

Solo se listan las logísticas activas. Si desactivás una que esté elegida acá, la asignación automática deja de funcionar para esa zona y queda registrado en el log de errores — acordate de cambiarla antes.

📥 Recepciones de mercadería

Ingreso de mercadería a las sucursales, de proveedores externos y de transferencias del depósito. Las equivalencias de cada local con Presea —empresa, sucursal, depósito, talonario y lista de precios— se cargan sucursal por sucursal en Gestión de sucursales, más abajo en esta misma pantalla, porque son distintas en cada local.

Cada remito recibido viaja al ERP como un comprobante propio (recep_snp), y las transferencias internas como transferencia_ed. Ambos métodos se administran en la tarjeta 🧾 ERP Presea (Web Service).

🚨 Vigía del sistema

Batería de chequeos de salud que corre cada 10 minutos y crea una incidencia automática cuando algo se degrada en silencio (ingesta frenada, cola del WMS trabada, disco al límite, etc.). Los chequeos críticos además mandan email. Cada episodio genera UNA incidencia: al resolverla, si el problema vuelve, se crea otra. Cuando un chequeo vuelve a dar bien, su incidencia se cierra sola con un comentario —muchas condiciones son transitorias y se arreglan antes de que alguien las mire—. Importa además porque una incidencia abierta tapa el episodio siguiente del mismo chequeo.

Guardá la configuración antes de probar.
📋 Pickeos Google Sheets

Lee el sheet de pickeos del depósito (una hoja por courier, compartido como "cualquiera con el enlace: lector") y asigna automáticamente la logística a cada pedido que matchea por tracking. El pickeo pisa la logística ya asignada y registra el cambio en los eventos del pedido. Cuando el archivo se haga pesado, armá uno nuevo con la misma estructura y cambiá solo el link acá.

Nombre exacto de la hoja, columna donde está el tracking limpio y logística que se asigna. Si no elegís logística, se intenta por nombre igual al de la hoja.
Guardá la configuración antes de probar o ejecutar.
🏪 Sellers Externos

Definí qué courier se asigna automáticamente a cada seller externo del marketplace VTEX. Por ejemplo: para el seller Piñata → courier PIÑATA. El sistema usará este mapeo al importar nuevos pedidos de ese seller. Acá también se configuran las condiciones de liquidación: el porcentaje de comisión que se queda El Mundo del Juguete y si se calcula sobre el total del pedido (envío incluido) o solo sobre los productos.

Cargando…
🔗 Integraciones Logísticas

Configurá las credenciales de cada integración de tracking. Todas las integraciones de tipo Lightdata comparten el mismo driver y se usan para el courier VTEX TURBO. Agregar un nuevo proveedor Lightdata = agregar una nueva fila aquí.

Cargando…

📥 Importar DIDs Lightdata (corrección masiva)

Subí un Excel con dos columnas: order_id y did (o id_logistica). Sirve para asignar o corregir el DID de Lightdata en pedidos VTEX TURBO que no se resolvieron automáticamente. El scheduler tomará los DIDs en el próximo ciclo.

🔧 Herramientas

✏️ Actualizar número de tracking

Actualizá manualmente el número de tracking de un pedido activo o del historial.

🟠 Integraciones Avenida (Coatí)

Conectá canales de venta que usan la plataforma Coatí a través de la agencia AVENIDA. El sistema sincroniza automáticamente los cambios de estado de los pedidos hacia Coatí cada 5 minutos. Los pedidos ingresan al sistema con el canal configurado (ej: TIENDA BNA).

Cargando…

Consultar pedido en Coatí por External ID

🔵 Mercado Libre
ML1 (MDJ)
ML2 (TT)
📅 Calendario (feriados / días hábiles especiales)
🏪 Sucursales
CódigoNombreDirecciónTeléfonoERP PreseaEstadoAcciones
🚛 Vehículos
La flota con la que salen las transferencias. El depósito elige la patente de esta lista al despachar, y es la que viaja al COT de ARBA: por eso se elige y no se tipea — ARBA valida la patente y un cero por una O rechaza el archivo entero. Los vehículos no se borran, se desactivan: una transferencia vieja apunta al suyo.
PatenteDescripciónAcopladoEstadoAcciones
🏷 Empresas logísticas
NombreDescripciónTracking APIEstadoAcciones
💳 Reembolsos — Destinatarios del informe

Emails que recibirán el informe de reembolsos autorizados al presionar "Enviar informe" en la sección Reembolsos.

📦 Materiales de empaquetado
Agregar material
SKUNombreCódigo de barrasOrdenEstadoAcciones
✉️ Notificaciones por email
Configuración SMTP (Gmail)
Desactivar esto apaga todas las notificaciones sin perder la configuración
🔔 Avisos de pedidos y recepciones:
Pedido emitido a la sucursal · recepción esperando autorización a Compras · devuelta y autorizada al local con la observación · recordatorio de recepciones abiertas hace más de 2 h. Fuera de ese horario el aviso igual aparece en la campana al instante: lo único que espera a la apertura es el correo. El recordatorio insiste en pantalla cada media hora, pero por mail sale solo a las 2 h y a las 4 h. Para que el mail llegue, la sucursal necesita su casilla cargada en Config → Sucursales (o usuarios de esa sucursal con email). Los avisos de Compras van al mail de cada usuario con el permiso autorizar_recepcion.
🏪 Avisos a sucursales:
📦 Despachos y envíos
🏪 Sucursales
🔄 Cambios
↩ Devoluciones y Reembolsos
🗺️ Administrar Zonas
Zonas
Códigos Postales
CP Localidad Zona

No hay códigos postales configurados. Agregá uno o importá desde Excel/CSV.

🛍 Informe de bolsas (retiros)
Al entregar cada retiro, el operador registra las bolsas utilizadas (códigos 70 a 74). Todos los lunes a las 08:00 se envía un mail con el detalle del período en un Excel adjunto (columnas Fecha / Local / Código / Cantidad). Si se revierte una entrega, su registro de bolsas se elimina automáticamente.
🎁 Convenio Cargill
Padrón de empleados con envío/retiro bonificado por única vez. El scheduler matchea los pedidos VTEX por DNI dentro de la ventana de vigencia, les asigna el courier Envio Cargill y notifica al middleware (evento pedido.envio_cargill) para que Aurora muestre esa leyenda como operador logístico.
DNI Nombre Email Hijos Beneficio Pedido
🔌 Sincronización FTP
⏰ Los horarios se ingresan en hora Argentina (GMT-3). El sistema los aplica directamente sin conversión.
🔐 Credenciales globales
⚙️ Sincronizaciones
Sync 1 — Precios Códigos de barras + Listas
▸
📁 Códigos de barras (cod_barras.xlsx → tabla de productos/SKUs)
💰 Listas de precios (lista01.xlsx, lista07.xlsx, etc. → tabla de precios)
Cargando listas...
Sync 2 — Catálogo productos.xlsx → tabla catálogo
▸
Sync 3 — Imágenes FTP Subida automática cada hora
▸
ℹ️ Este sync se ejecuta automáticamente cada hora en punto. No tiene horarios configurables.
Sync 4 — Notas de venta NOTAS.XLSX → tabla notas_fiscales
▸
ℹ️ El archivo trae una ventana de los últimos 3 días. Nada se borra: lo que no viene está fuera de la ventana, no desapareció.
🩺 Diagnóstico de sincronizaciones
Cargando diagnóstico...
📦 Catálogo de productos

Catálogo completo desde PRODUCTOS/productos.xlsx. Se sincroniza automáticamente a las 9:00 y 15:00 (todos los días). Las imágenes se obtienen desde VTEX y se suben al FTP de forma incremental (solo las pendientes). Mantené presionado el nombre de un producto en cualquier pedido para ver su foto.

🗂️ Descarga y API de imágenes

Descargá todas las imágenes cacheadas como un ZIP, o consultá el manifiesto JSON para integrar con sistemas externos. Ambos endpoints aceptan autenticación por X-API-Key.

🔄 Resetear fechas ML COLECTA/FLEX

Limpia la caché de fechas de despacho para pedidos ML COLECTA y FLEX, forzando que la próxima sync obtenga las fechas directamente desde la API de ML.
Usá esto cuando los pedidos muestren una fecha incorrecta (ej: sábado en lugar de lunes).

🧹 Limpiar pedidos duplicados ML

Elimina pedidos de Mercado Libre duplicados que comparten el mismo ID logístico (shipping_id). Ocurre cuando ML no devuelve el pack_id al momento del sync y el mismo envío queda registrado como dos pedidos separados. Afecta pedidos activos y historial. Esta limpieza también se ejecuta automáticamente con cada sync de VTEX.

📋 Completar datos de contacto faltantes

Re-consulta VTEX para todos los pedidos que tengan email, teléfono o DNI nulos y completa los datos. Solo pisa campos que estén vacíos — no sobreescribe datos ya existentes. Ejecutar después de un deploy que agrega la columna dni o cuando haya pedidos sin datos de contacto.

🔍 Diagnóstico VTEX API

Consultá la API de VTEX directamente para ver el JSON crudo de un pedido específico.


            
🔍 Diagnóstico ML API

Consultá la API de MercadoLibre directamente para ver el JSON crudo de un pedido o envío.


            
⚖️ Diagnóstico Reclamos ML

Consultá los reclamos de MercadoLibre asociados a un pedido. Devuelve la lista de reclamos, el detalle del primero y su conversación completa.


            
🔗 Middleware interno
📤 Conexión saliente (MDJ Ops → WMS) ● Sin configurar
Vacío: se usa tso.cancelar.
Vacío: se usa pedido.cancelado, el mismo de cualquier pedido.

📥 Eventos del WMS que no se aplicaron

Lo que el WMS nos mandó y no cambió nada: un evento filtrado por configuración, un identificador que no coincide con ningún pedido ni transferencia, o un aviso de preparación sin artículos. Si una transferencia no avanza, acá se ve si el WMS habló o no — antes había que buscarlo en los logs del servidor.

RecibidoIdentificadorEventoMotivoDetalle
Tocá "Ver" para cargar…

📣 Eventos salientes (MDJ Ops → WMS)

MDJ Ops notifica automáticamente al WMS cuando ocurren los siguientes eventos. Se envían como POST a la URL configurada arriba con el header X-MDJ-Ops-Secret. Los reintentos se gestionan con backoff automático (1 min → 5 min → 15 min) y se persisten en la cola de abajo.

pedido.cancelado automático

Se dispara cuando un pedido es cancelado, ya sea manualmente por un operador (desde Despachos o Sucursales) o automáticamente por el scheduler al detectar el estado cancelado en VTEX/ML.

Payload: {"event":"pedido.cancelado","event_id":"evt_<order_id>_<ts>","order_id":"..."}


📥 Endpoint entrante (WMS → MDJ Ops)

El WMS debe llamar a estos endpoints con una X-API-Key válida. Las API Keys se gestionan en 🔑 API Keys.

PUT

Body: {"bulto":"EMPQ-12345","cantidad_bultos":3,"peso_kg":25.5,"volumen_m3":0.75,"estado":"PACKED"}

POST

Body: {"evento":"PACKED","detalle":{...}} — Header: X-API-Key: <tu_key>


⚙️ Eventos habilitados

Activá los eventos que MDJ Ops debe procesar cuando el WMS los informa al endpoint entrante.

⏳ Avisos de Aurora esperando su pedido
🚀 Automatizaciones WMS

🧪 Prueba de conexión

Envía un evento pedido.cancelado de prueba al middleware con el order_id que indiques. Usá un pedido real cancelado para verificar que el middleware lo recibe y lo mapea correctamente.


📡 Integración Producteca (consulta num_compro)

MDJ Ops consulta periódicamente al middleware EMDJ para obtener el num_compro (ID Producteca) de cada pedido y lo almacena localmente. El scheduler dispara cada 10 min; el campo de intervalo controla cada cuánto se lanza efectivamente la consulta.

Estado: cargando…
Respuesta cruda del middleware:

              
📂 Importar num_compro desde CSV

Descargá el archivo de notas de venta del middleware y subilo aquí. El sistema asigna el num_compro a cada pedido buscando por order_id y pack_id (ML).

📤 Endpoint de consulta disponible para sistemas externos
GET
Parámetros: ?order_id=X o ?num_compro=Y — Autenticado con X-API-Key. Devuelve fecha_despacho, estado_logistico y num_compro.

⚠ 0 evento(s) que el WMS nunca recibió

Mirá cada uno antes de decidir. Reintentar lo vuelve a mandar; descartar lo saca de la cola para siempre y deja el motivo anotado. Un evento viejo puede haber dejado de corresponder —una transferencia que después se cerró, un pedido resuelto por otro lado— y reenviarlo le crearía trabajo al depósito.

Order ID Evento Cuándo Motivo del rechazo
📋 Cola de notificaciones — últimos 30
Order ID Evento Estado Intentos Fecha / Error
Sin eventos registrados
🔑 API Keys — Acceso externo
Nombre Clave Permisos Estado Último uso Acciones
💡 Recomendaciones automáticas
Nombre Condiciones Mensaje Estado Acciones
📊 Rendimiento del servidor
Abrí esta sección para ver las métricas en tiempo real.
🔴 Log de errores del sistema
FechaMóduloMensaje
🏭 Gestión Proveedores
Total activos: — En BRASIL: — Mudado: —
Proveedor Activo Depósito Cód. ERP Plazo (días) Descuentos

Los cambios se guardan al presionar Guardar cambios. Para que aparezcan nuevos proveedores del catálogo usá Sincronizar catálogo.

📦 Puntos de Recogida VTEX
ID Nombre Estado Ciudad Tags
No se encontraron puntos de recogida con ese filtro.

El Excel exportado tiene la estructura exacta que VTEX espera para importación masiva. Podés editarlo (ej: cambiar IsActive a false) y reimportarlo desde el panel de VTEX → Inventario y envíos → Puntos de recogida → Importar.

👥 Gestión de usuarios
NombreUsernameEmailRolSucursalEstadoAcciones
📊 Dashboard Same Day
Seleccioná un período para ver el dashboard
⚠️ Pedidos a reclamar
TipoSale OrderOrder IDCliente CanalLogísticaTracking LocalidadEstadoMotivo Marcado
Cargando…
🎵 Música
🏭 Turnos de proveedores
⚖️ Diferencias en tránsito
TransferenciaLocalArtículo SalióLlegó En tránsito EstadoPresea
Cargando…
📖 Instructivos
📦 Empaquetado
Materiales rápidos
Picks de hoy
—
Apuntá al código de barras
Fecha/horaMaterialSKU Cant.OrigenUsuario
Seleccioná un período para ver el historial
🧾 Auditoría de stock
FechaTipoReferenciaOrder IDSucursal ClienteProductosEstadoAcción
Cargando…
📋 Auditoría del sistema
Cargando…
Importar CPs desde Excel/CSV

El archivo debe tener columnas: CP, Localidad, Zona. La primera fila debe ser el encabezado.

Nueva Integración Avenida

Se guardará en mayúsculas. Debe coincidir con el canal en los pedidos.
Courier asignado a cada pedido de este canal. Se guarda en mayúsculas.

Gmail — Importación automática de ventas
Cuenta Gmail que recibe las notificaciones de Tienda BNA.
Generá una clave de aplicación en Seguridad de Google. No uses tu contraseña de Gmail.

Logs de sincronización

FechaOrder IDEstado enviadoResultadoRespuesta

📥 Importar histórico — TIENDA BNA

Pegá los External IDs de Coatí (uno por línea). El sistema consultará Coatí y Shipnow por cada ID y mostrará un preview antes de importar. Máximo 200 IDs por vez.

Formato simple: external_id — Para corregir order_id y limpiar tracking: external_id:nuevo_order_id (ej. 2569143:BNA2458814)
(re-consulta Shipnow, corrige order_id y limpia id_logistica incorrecta)
External IDOrder IDClienteLocalidadProds.EstadoDetalle

Exportar a Excel

Seleccioná el formato de exportación:


Incluye 2 días extra hacia atrás y sincroniza ML antes de exportar.

Detalle