Ir al contenido
MEDIAMAX B2B
GUÍA COMPLETA · FUNCIONAMIENTO Y FORMACIÓN

Conecta tu negocio con más catálogo y más oportunidades

Documentación comercial, operativa y técnica de la API B2B, los feeds, el Catálogo Exclusivo Ampliado para Marketplaces, los pedidos Dropship y las expediciones.

Catálogo y stock Feeds y matching Pedidos API Dropship Tracking
01

Qué es la API y cómo funciona

La API B2B de MediaMax permite conectar una tienda online, ERP o sistema interno con nuestro catálogo, precios, existencias, pedidos y expediciones mediante peticiones HTTP autenticadas.

Consultar información

Obtener catálogo, detalle de producto, precios asociados al cliente, stock y estado de pedidos y expediciones.

Operar de forma automática

Crear pedidos, recibir sus identificadores y consultar posteriormente su preparación y seguimiento.

Conectar Consultar catálogo Seleccionar SKU Crear pedido Preparar Seguir entrega
Autenticación: enviar la cabecera HTTP-API-KEY: TU_TOKEN en cada petición. La clave debe mantenerse en el servidor y nunca exponerse en código público o navegador.
API y Dropship: consultar información por API no obliga a utilizar Dropship. Según el procedimiento documentado, los pedidos creados mediante la API operan con Dropship; revisar la configuración de cada cliente.
02

Catálogo y consulta de productos

El catálogo permite recuperar un listado paginado y consultar después el detalle actualizado de un SKU. Los datos pueden incluir nombre, referencia, precio del cliente, disponibilidad, EAN, imágenes e información energética, según el producto.

Operación Método Ruta Descripción
Catálogo GET /product/all Listado paginado de productos
Producto GET /product/{sku} Ficha de un SKU

Obtener catálogo

                curl --request GET \
  --url 'https://www.mediamax.es/api/product/all?pag=1&max=25' \
  --header 'HTTP-API-KEY: TU_TOKEN' \
  --header 'Accept-Language: es'

Consultar un producto

                curl --request GET \
  --url 'https://www.mediamax.es/api/product/SKU-DE-EJEMPLO' \
  --header 'HTTP-API-KEY: TU_TOKEN'

Respuesta ilustrativa simplificada

                {
  "id": 12345,
  "attributes": {
    "name": "Producto de ejemplo",
    "sku": "SKU-DE-EJEMPLO",
    "price": 199.99,
    "qty_available": 8,
    "gallery": []
  }
}
Soporte ATC: ante una incidencia, comprobar en Odoo el SKU, la tarifa del cliente, el stock y la galería del producto. Los ejemplos son ilustrativos; el contrato completo de campos se consulta en Swagger.
03

Feeds: sincronización de catálogo, precio y stock

Los feeds proporcionan archivos para importar periódicamente a un eCommerce, ERP o integrador. Son una alternativa o complemento a la API: permiten sincronizaciones por lotes sin necesidad de realizar consultas individuales por producto.

Feed CSV

Archivo descargable e importable. La información refleja la última generación o descarga del feed. Es útil para integraciones sencillas.

API

Consultas directas a los servicios de MediaMax y posibilidad de crear pedidos y consultar expediciones. Requiere integración técnica.

Feed rápido de precio y disponibilidad

Frecuencia de actualización recomendada: cada 15–30 minutos, según el proceso de integración.

Campo Significado
SKU Referencia única del producto
price Precio del cliente sin IVA (precio de coste para su reventa)
qty Cantidad de disponibilidad inmediata
qty2 Cantidad prevista con llegada estimada en menos de 24 horas

Formato documentado: separador de campos |; delimitador de texto '.

Acceso a feeds: portal B2B → Mi Cuenta → Feeds. La estructura exacta y las condiciones de cada feed deben confirmarse con IT.
04

Catálogo Exclusivo Ampliado

MÁS CATEGORÍAS · MÁS OPORTUNIDADES

Más categorías. Más posibilidades de vender.

Además de nuestra especialización en móviles y tablets, ponemos a tu alcance todos los productos de nuestros proveedores en electrónica de consumo, cuidado personal, hogar y muchas otras categorías.

El Catálogo Exclusivo Ampliado incluye referencias que todavía no están publicadas en nuestra web, permitiéndote acceder a un catálogo mucho más extenso.

¿Qué ventajas ofrece?

Más productos y categorías

Amplía tu oferta con nuevas referencias de nuestros proveedores.

Acceso anticipado

Descubre productos antes de que estén publicados en mediamax.es.

Más oportunidades en marketplaces

Aprovecha referencias que ya disponen de fichas en las principales plataformas.

¿La ventaja? Puedes aprovechar productos identificados en marketplaces, incluso cuando su ficha completa todavía no esté publicada en nuestra web. Amplías tu oferta sin esperar.
05

Feed especial integraciones marketplaces

MATCHING OPTIMIZADO

Más variantes. Más oportunidades de venta.

Disponemos de un feed especial para integradores y dropshippers que facilita la identificación de muchas más variantes de cada uno de nuestros productos en los diferentes marketplaces.

Su objetivo es mejorar el matching con las fichas existentes en plataformas como Amazon, Miravia y otros marketplaces, aumentando las posibilidades de comercializar nuestros productos.

¿Qué ventajas ofrece?

Mayor cobertura

Facilita la identificación de más variantes de cada producto.

Más coincidencias

Aumenta las posibilidades de vincular nuestros productos con fichas existentes.

Integración optimizada

Permite a los integradores aprovechar más oportunidades de venta sin duplicar productos.

¿La ventaja? Un mismo producto puede encontrar coincidencias con muchas más fichas y variantes en los marketplaces. Más matching, más oportunidades de venta.
06

Usuarios, tokens y puesta en marcha

Cada integración API se asocia a un usuario y correo de MediaMax vinculados a la configuración comercial y fiscal del cliente. Esa asociación influye en la tarifa, los precios y el tratamiento de facturación.

Fase Responsable / objetivo
1. Generación de token IT crea el acceso y realiza pruebas iniciales de autenticación y configuración
2. Entrega segura IT facilita la clave al cliente por un canal adecuado
3. DEMO El cliente realiza pedidos de prueba y valida el funcionamiento
4. Validación Se revisan catálogo, direcciones, precios y flujo de pedidos
5. Producción supervisada Se habilita la operativa real con bloqueo de contacto para revisar los primeros pedidos
Seguridad: no publicar el token en repositorios, código frontend ni capturas. El documento describe acceso a catálogo, pedidos y envíos con el token; no presupone permisos limitados por endpoint. Un token temporal o restringido solo debe ofrecerse si IT confirma que está disponible.
07

Creación y consulta de pedidos

Un pedido API reúne la referencia propia del cliente, la dirección de facturación, la dirección de envío y las líneas con SKU y cantidad. MediaMax devuelve un identificador que debe conservarse junto con la referencia original.

Operación Método Ruta
Crear pedido POST /order
Consultar por referencia cliente GET /order/reference/{reference}
Consultar por ID MediaMax GET /order/id/{order_id}
Consultar varias referencias GET /batch/reference

Crear pedido

                curl --request POST \
  --url 'https://www.mediamax.es/api/order' \
  --header 'HTTP-API-KEY: TU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data @pedido.json

Ejemplo de pedido.json

                {
  "b2b_reference": "PEDIDO-CLIENTE-2026-0001",
  "order_billing_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Empresa Ejemplo SL",
    "email": "compras@example.com",
    "phone": "+34900000000",
    "street": "Calle Ejemplo 1",
    "postcode": "03001",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES"
  },
  "order_shipping_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Empresa Ejemplo SL",
    "email": "logistica@example.com",
    "phone": "+34900000000",
    "street": "Avenida de Entrega 10",
    "postcode": "03002",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES",
    "express": 0
  },
  "order_lines": [
    {"sku": "SKU-DE-EJEMPLO", "quantity": 1}
  ]
}

Consultar varias referencias

                curl --request GET \
  --url 'https://www.mediamax.es/api/batch/reference?pag=1&max=25&references=PEDIDO-001&references=PEDIDO-002' \
  --header 'HTTP-API-KEY: TU_TOKEN'
Prevención de duplicados: b2b_reference debe ser única. Si falla o expira una llamada POST /order, consultar primero si se creó el pedido antes de reintentarlo. Evitar reenvíos automáticos ciegos.
ATC: localizar en Odoo el pedido por la referencia del cliente o su identificador y verificar las líneas y direcciones.
08

Dropship: preparación y documentación

En Dropship, MediaMax prepara y envía los pedidos en nombre del cliente, utilizando la configuración de la cuenta para documentación y etiquetado. Según el procedimiento descrito, los pedidos cursados por API utilizan esta modalidad.

Configuración de cuenta

  • Dropship habilitado.
  • Logo y datos de cuenta correctos.
  • Dirección logística del remitente.

Documentación del envío

  • Packing o declaración del contenido.
  • Logo y datos mostrados.
  • Etiqueta con remitente adecuado.
Validación obligatoria: revisar el remitente, el packing, el logo y la documentación antes de liberar los primeros pedidos reales.
09

Expediciones, tracking y entrega

Un pedido puede generar una o varias expediciones. Cada una puede tener su propia referencia de picking, transportista, tracking y estado logístico.

Operación Método Ruta
Consultar una expedición por picking GET /packing/show/reference/{reference}
Consultar expediciones de un pedido Odoo GET /packing/show/order/odoo/{odoo_reference}

Consultar expedición por referencia

                curl --request GET \
  --url 'https://www.mediamax.es/api/packing/show/reference/WH%2FOUT%2F00000' \
  --header 'HTTP-API-KEY: TU_TOKEN'

Respuesta ilustrativa simplificada

                {
  "code": "200",
  "status": "success",
  "data": {
    "id": 4567,
    "attributes": {
      "reference": "WH/OUT/00000",
      "tracking": "TRACKING-DE-EJEMPLO",
      "status": "done"
    }
  }
}

Consultar todas las expediciones del pedido

                curl --request GET \
  --url 'https://www.mediamax.es/api/packing/show/order/odoo/S00000' \
  --header 'HTTP-API-KEY: TU_TOKEN'
ATC: si un cliente no recibe datos correctos, verificar en Odoo referencia de picking, estado, transportista, tracking y si el pedido se ha dividido en varias expediciones.
10

Supervisión de los primeros pedidos

El paso de DEMO a producción requiere supervisar las primeras operaciones para confirmar que la integración funciona con datos reales. Se utiliza un bloqueo de contacto para controlar la transferencia del picking hasta completar la revisión.

Finalización: una vez confirmada la operativa, se retira el bloqueo de contacto y el cliente continúa con el flujo normal.
11

Referencia rápida, soporte y recursos

Resumen de operaciones

Necesidad Endpoint
Listar catálogo GET /product/all
Detalle SKU GET /product/{sku}
Crear pedido POST /order
Buscar por referencia GET /order/reference/{reference}
Buscar por ID GET /order/id/{order_id}
Buscar varios pedidos GET /batch/reference
Consultar picking GET /packing/show/reference/{reference}
Expediciones del pedido GET /packing/show/order/odoo/{odoo_reference}

Documentación técnica

Swagger API B2B ↗

Fuente de referencia para los campos completos, modelos de respuesta, validaciones y errores.

Acceso y soporte

Feeds: Mi Cuenta → Feeds en el portal B2B.

Solicitudes de acceso y cuestiones técnicas: it@mediamax.es.

Nota de alcance: esta guía reproduce y reorganiza la documentación facilitada, incorporando el catálogo ampliado y el feed especial. No se han verificado en vivo los endpoints ni se han añadido esquemas de respuesta o campos no documentados. Para integraciones de producción, prevalece el contrato vigente de Swagger.