MDJ Ops

Total

🔴 Vencido

🟠 Hoy

🟡 Mañana

🟢 OK

	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

Datos del cambio

Zona *

Motivo *

Tipo de gestión *

Solo envío (ida) Solo retiro (vuelta) Envío + retiro

Pedido de referencia

N° Caso CRM

Sucursal *

Datos del cliente

Nombre completo *

Teléfono

Dirección

Piso / Depto

Localidad

Sub-zona CABA/GBA

Observaciones generales

Logística de envío (vacío = automático: CABA → Llegue · GBA → Blitzz)

Empresa de logística

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

	Sale Order	Order ID	Fecha compra	Canal	Seller	Courier	Cliente	Localidad	Provincia	Zona	ID Logística	Estado	Logística	Despachado	P

Compra	Despacho	Entrega	Sale Order	Order ID	Canal	Seller	Courier	Logística	Cliente	Localidad	Provincia	Zona	Resultado	P·C·D

Sale Order	Order ID	Cliente	Canal	Courier	Tipo	Observación	Estado	Resolución	Registrado	Acciones

	ID Cambio	Zona	Motivo	Tipo gestión	Sucursal	Cliente	Pedido ref.	Estado	Creado	Acciones

Código	Fecha	Cliente	Tipo	Destino	Motivo	Estado	Registrado por

Tipo	Referencia	Canal	Cliente	Qué debe volver	Logística	Fecha

	Urgencia	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

Reembolso	Order ID	Cliente	Origen	Monto	Estado	Fecha

Fecha	#ID	Título	Usuario	Adjunto	Estado

Cola de impresión

Vista previa · etiqueta código de barras

Buscá un producto para ver la previa

Seleccioná productos para agregar.

Modo: Ancho mm: Alto mm:

Precio: –

Sin precio / $0

	SKU	Nombre	Proveedor	Tipo	Código de barras	Precio	Estado	Acción	🔄 Img
Cargando…

📷

	N° Orden	Sale Order	Nº de pedido	Fecha compra	Sucursal	Canal	Seller	Cliente	Estado	Logística	P	Acciones

	Sale Order	Order ID	Fecha compra	Sucursal	Canal	Seller	Cliente	Estado	Logística	P	Acciones

Solo entregado Solo cancelado

Demorados Con posventa Con cambio Con devolución

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

🔢 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.

Cambios CABA/GBA (C)

Cambios Provincia (P)

Cambios Sucursal (T)

Devoluciones (D)

🔗 VTEX

Account

App Key

Fecha inicio

Días invoiced

Canales excluidos

🚚 Courier / Scheduler

Palabras clave Shipnow

Palabras clave VTEX Turbo

Palabras clave HOP

Palabras clave Retiro

Palabras clave Gift Card

SLAs detectados en VTEX

Hacé click en "Ver" después de sincronizar para ver los nombres de SLA que devuelve VTEX y configurar las palabras clave correctas.

Courier por defecto

Hora de corte

Hora inicio scheduler

Hora fin scheduler

Int. VTEX (min)

Int. log despachos (min)

Int. log envíos (min)

Automatizaciones

Columna "Impreso" (Todos los pedidos)

Columna "Recibido Depósito" (Todos los pedidos)

Límite exportación Excel (filas) 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.

🏪 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.

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.

Order ID

Nuevo tracking

🟠 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

Integración

External ID (Coatí)

🔵 Mercado Libre

ML1 Client ID

ML1 Client Secret

ML2 Client ID

ML2 Client Secret

Redirect URI

Fecha desde (pedidos)

ML1 (MDJ)

ML2 (TT)

📅 Calendario (feriados / días hábiles especiales)

🏪 Sucursales

Código	Nombre	Dirección	Teléfono	Estado	Acciones

🏷 Empresas logísticas

Nombre	Descripción	Tracking API	Estado	Acciones

💳 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

SKU

Nombre

Código de barras (EAN)

SKU	Nombre	Código de barras	Orden	Estado	Acciones

✉️ Notificaciones por email

Configuración SMTP (Gmail)

Cuenta Gmail

Contraseña de aplicación

Notificaciones activas (global) Desactivar esto apaga todas las notificaciones sin perder la configuración

📦 Despachos y envíos Activo

🏪 Sucursales Activo

🗺️ Administrar Zonas

Zonas

Códigos Postales

CP	Localidad	Zona

🛍 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.

Destinatarios (separados por coma)

🎁 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.

Vigente desde

Vigente hasta

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

Host

Puerto

Usuario

Contraseña

⚙️ Sincronizaciones

Sync 1 — Precios Códigos de barras + Listas

▸

Nombre del sync

Etiqueta del botón manual

📁 Códigos de barras (cod_barras.xlsx → tabla de productos/SKUs)

Ruta del archivo en el FTP

💰 Listas de precios (lista01.xlsx, lista07.xlsx, etc. → tabla de precios)

Cargando listas...

Horarios de ejecución automática (hora Argentina — aplica a ambos syncs)

Sync 2 — Catálogo productos.xlsx → tabla catálogo

▸

Nombre del sync

Etiqueta del botón manual

Ruta del archivo en el FTP

Horarios de ejecución automática (hora Argentina)

Sync 3 — Imágenes FTP Subida automática cada hora

▸

Directorio destino en el FTP

ℹ️ Este sync se ejecuta automáticamente cada hora en punto. No tiene horarios configurables.

🩺 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.

Order ID

🔍 Diagnóstico ML API

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

Canal

ID del pedido

ID logístico (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.

Canal

ID del pedido

🔗 Middleware interno

📤 Conexión saliente (MDJ Ops → WMS) ● Sin configurar

URL del webhook

Secret (X-MDJ-Ops-Secret)

📣 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.

PACKED — El paquete fue embalado. Actualiza número de bulto y datos físicos (peso, volumen, cantidad de bultos). DISPATCHED — El paquete fue despachado desde el depósito. Informativo para envíos; habilita el auto-tránsito de retiros (abajo).

🚀 Automatizaciones WMS

Auto-packed: pasar retiros a "Preparado" al recibir PACKED
Cuando el WMS informa PACKED de un retiro en sucursal (pendiente/en preparación), el pedido pasa automáticamente a Preparado con trazabilidad. Requiere el evento PACKED habilitado arriba. Auto-tránsito: pasar retiros a "En tránsito" al recibir DISPATCHED
Cuando el WMS informa el DISPATCHED de un retiro en sucursal, el pedido pasa automáticamente a En tránsito (salió del depósito hacia la tienda), con trazabilidad. Los envíos a domicilio no se tocan: sus estados los manejan las logísticas. Requiere el evento DISPATCHED habilitado arriba. Remito automático por email a cada sucursal (cada 2 horas)
Cada 2 horas, los retiros en tránsito que aún no fueron informados se agrupan por sucursal y se envía a cada tienda un email con solo sus pedidos (mismo numerador que el remito manual). Requiere el email de cada sucursal cargado en Config → Sucursales (o usuarios de la sucursal con email). La impresión del remito deja de ser necesaria.

🧪 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.

Activar sincronización automática

Secret (X-MDJ-Ops-Secret)

Intervalo de sincronización

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.

📋 Cola de notificaciones

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

Fecha	Módulo	Mensaje

🏭 Gestión Proveedores

Proveedor	Activo	Depósito

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

📦 Puntos de Recogida VTEX

Filtrar por tag

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.

Nombre	Username	Email	Rol	Sucursal	Estado	Acciones

Seleccioná un período para ver el dashboard

Materiales rápidos

Picks de hoy

—

Fecha/hora	Material	SKU	Cant.	Origen	Usuario
Seleccioná un período para ver el historial

Cargando…

🔢 Numeración de cambios y devoluciones

Zonas

Códigos Postales

Importar CPs desde Excel/CSV

Nueva Integración Avenida

Logs de sincronización

📥 Importar histórico — TIENDA BNA

Exportar a Excel

Detalle