Passa al contenuto
MEDIAMAX B2B
GUIDA COMPLETA · OPERATIVITÀ E FORMAZIONE

Collega la tua attività a un catalogo prodotti più ampio e più opportunità

Documentazione commerciale, operativa e tecnica dell'API B2B, dei feed, del Catalogo Esclusivo Ampliato per i Marketplace, degli ordini Dropship e delle spedizioni.

Catalogo e stock Feed e matching Ordini API Dropship Tracking
01

Cos'è l'API e come funziona

L'API B2B di MediaMax permette di collegare un e-commerce, un ERP o un sistema interno al nostro catalogo, ai prezzi, alle giacenze, agli ordini e alle spedizioni tramite richieste HTTP autenticate.

Consultare le informazioni

Ottenere il catalogo, il dettaglio dei prodotti, i prezzi associati al cliente, lo stock e lo stato di ordini e spedizioni.

Operare in modo automatico

Creare ordini, ricevere i relativi identificativi e consultare successivamente la preparazione e il tracciamento.

Connettere Consultare il catalogo Selezionare lo SKU Creare l'ordine Preparare Seguire la consegna
Autenticazione: inviare l'intestazione HTTP-API-KEY: IL_TUO_TOKEN in ogni richiesta. La chiave deve restare sul server e non essere mai esposta in codice pubblico o nel browser.
API e Dropship: consultare le informazioni tramite API non obbliga a utilizzare Dropship. Secondo la procedura documentata, gli ordini creati tramite API operano con Dropship; verificare la configurazione di ogni cliente.
02

Catalogo e consultazione dei prodotti

Il catalogo permette di recuperare un elenco paginato e di consultare successivamente il dettaglio aggiornato di uno SKU. I dati possono includere nome, riferimento, prezzo del cliente, disponibilità, EAN, immagini e informazioni energetiche, a seconda del prodotto.

Operazione Metodo Percorso Descrizione
Catalogo GET /product/all Elenco paginato dei prodotti
Prodotto GET /product/{sku} Scheda di uno SKU

Ottenere il catalogo

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

Consultare un prodotto

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

Risposta illustrativa semplificata

                {
  "id": 12345,
  "attributes": {
    "name": "Prodotto di esempio",
    "sku": "SKU-ESEMPIO",
    "price": 199.99,
    "qty_available": 8,
    "gallery": []
  }
}
Supporto ATC: in caso di segnalazione, verificare in Odoo lo SKU, la tariffa del cliente, lo stock e la galleria del prodotto. Gli esempi sono illustrativi; lo schema completo dei campi si consulta in Swagger.
03

Feed: sincronizzazione di catalogo, prezzo e stock

I feed forniscono file da importare periodicamente in un eCommerce, un ERP o un integratore. Sono un'alternativa o un complemento all'API: consentono sincronizzazioni a lotti senza bisogno di effettuare richieste individuali per ogni prodotto.

Feed CSV

File scaricabile e importabile. Le informazioni riflettono l'ultima generazione o l'ultimo download del feed. È utile per integrazioni semplici.

API

Richieste dirette ai servizi di MediaMax e possibilità di creare ordini e consultare le spedizioni. Richiede un'integrazione tecnica.

Feed rapido di prezzo e disponibilità

Frequenza di aggiornamento consigliata: ogni 15–30 minuti, a seconda del processo di integrazione.

Campo Significato
SKU Riferimento unico del prodotto
price Prezzo del cliente IVA esclusa (prezzo di costo per la sua rivendita)
qty Quantità disponibile immediatamente
qty2 Quantità prevista con arrivo stimato in meno di 24 ore

Formato documentato: separatore di campo |; delimitatore di testo '.

Accesso ai feed: portale B2B → Il mio account → Feed. La struttura esatta e le condizioni di ciascun feed devono essere confermate con il reparto IT.
04

Catalogo Esclusivo Ampliato

PIÙ CATEGORIE · PIÙ OPPORTUNITÀ

Più categorie. Più possibilità di vendita.

Oltre alla nostra specializzazione in smartphone e tablet, mettiamo a sua disposizione tutti i prodotti dei nostri fornitori di elettronica di consumo, cura della persona, casa e molte altre categorie.

Il Catalogo Esclusivo Ampliato include referenze non ancora pubblicate sul nostro sito web, permettendole di accedere a un catalogo molto più ampio.

Quali vantaggi offre?

Più prodotti e categorie

Amplii la sua offerta con nuove referenze dei nostri fornitori.

Accesso anticipato

Scopra i prodotti prima che siano pubblicati su mediamax.es.

Più opportunità sui marketplace

Sfrutti le referenze che dispongono già di schede sulle principali piattaforme.

Il vantaggio? Può sfruttare prodotti identificati sui marketplace, anche quando la loro scheda completa non è ancora pubblicata sul nostro sito web. Amplia la sua offerta senza attendere.
05

Feed speciale per integrazioni con i marketplace

MATCHING OTTIMIZZATO

Più varianti. Più opportunità di vendita.

Disponiamo di un feed speciale per integratori e dropshipper che facilita l'identificazione di molte più varianti di ciascuno dei nostri prodotti sui diversi marketplace.

Il suo obiettivo è migliorare il matching con le schede esistenti su piattaforme come Amazon, Miravia e altri marketplace, aumentando le possibilità di commercializzare i nostri prodotti.

Quali vantaggi offre?

Maggiore copertura

Facilita l'identificazione di più varianti di ogni prodotto.

Più corrispondenze

Aumenta le possibilità di collegare i nostri prodotti alle schede esistenti.

Integrazione ottimizzata

Permette agli integratori di sfruttare più opportunità di vendita senza duplicare i prodotti.

Il vantaggio? Lo stesso prodotto può trovare corrispondenze con molte più schede e varianti sui marketplace. Più matching, più opportunità di vendita.
06

Utenti, token e avvio

Ogni integrazione API è associata a un utente e a un indirizzo e-mail di MediaMax collegati alla configurazione commerciale e fiscale del cliente. Tale associazione influisce sulla tariffa, sui prezzi e sul trattamento di fatturazione.

Fase Responsabile / obiettivo
1. Generazione del token L'IT crea l'accesso ed effettua i test iniziali di autenticazione e configurazione
2. Consegna sicura L'IT consegna la chiave al cliente tramite un canale adeguato
3. DEMO Il cliente effettua ordini di prova e convalida il funzionamento
4. Convalida Si verificano catalogo, indirizzi, prezzi e flusso degli ordini
5. Produzione supervisionata Si attiva l'operatività reale con blocco del contatto, per verificare i primi ordini
Sicurezza: non pubblicare il token in repository, codice frontend o screenshot. Il documento descrive l'accesso a catalogo, ordini e spedizioni tramite il token; non presuppone permessi limitati per endpoint. Un token temporaneo o con restrizioni va offerto solo se l'IT conferma che è disponibile.
07

Creazione e consultazione degli ordini

Un ordine API riunisce il riferimento proprio del cliente, l'indirizzo di fatturazione, l'indirizzo di spedizione e le righe con SKU e quantità. MediaMax restituisce un identificativo che deve essere conservato insieme al riferimento originale.

Operazione Metodo Percorso
Creare ordine POST /order
Consultare per riferimento cliente GET /order/reference/{reference}
Consultare per ID MediaMax GET /order/id/{order_id}
Consultare più riferimenti GET /batch/reference

Creare ordine

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

Esempio di pedido.json

                {
  "b2b_reference": "ORDINE-CLIENTE-2026-0001",
  "order_billing_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Azienda Esempio SL",
    "email": "acquisti@example.com",
    "phone": "+34900000000",
    "street": "Via Esempio 1",
    "postcode": "03001",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES"
  },
  "order_shipping_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Azienda Esempio SL",
    "email": "logistica@example.com",
    "phone": "+34900000000",
    "street": "Via della Consegna 10",
    "postcode": "03002",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES",
    "express": 0
  },
  "order_lines": [
    {"sku": "SKU-ESEMPIO", "quantity": 1}
  ]
}

Consultare più riferimenti

                curl --request GET \
  --url 'https://www.mediamax.es/api/batch/reference?pag=1&max=25&references=ORDINE-001&references=ORDINE-002' \
  --header 'HTTP-API-KEY: IL_TUO_TOKEN'
Prevenzione dei duplicati: b2b_reference deve essere unica. Se una chiamata POST /order fallisce o scade, verificare prima se l'ordine è stato creato prima di riprovare. Evitare reinvii automatici alla cieca.
ATC: individuare in Odoo l'ordine tramite il riferimento del cliente o il suo identificativo e verificare le righe e gli indirizzi.
08

Dropship: preparazione e documentazione

In Dropship, MediaMax prepara e spedisce gli ordini per conto del cliente, utilizzando la configurazione dell'account per la documentazione e l'etichettatura. Secondo la procedura descritta, gli ordini inviati tramite API utilizzano questa modalità.

Configurazione dell'account

  • Dropship attivato.
  • Logo e dati dell'account corretti.
  • Indirizzo logistico del mittente.

Documentazione della spedizione

  • Packing o dichiarazione del contenuto.
  • Logo e dati visualizzati.
  • Etichetta con mittente corretto.
Convalida obbligatoria: verificare il mittente, il packing, il logo e la documentazione prima di rilasciare i primi ordini reali.
09

Spedizioni, tracking e consegna

Un ordine può generare una o più spedizioni. Ciascuna può avere un proprio riferimento di picking, vettore, tracking e stato logistico.

Operazione Metodo Percorso
Consultare una spedizione per picking GET /packing/show/reference/{reference}
Consultare le spedizioni di un ordine Odoo GET /packing/show/order/odoo/{odoo_reference}

Consultare una spedizione per riferimento

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

Risposta illustrativa semplificata

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

Consultare tutte le spedizioni dell'ordine

                curl --request GET \
  --url 'https://www.mediamax.es/api/packing/show/order/odoo/S00000' \
  --header 'HTTP-API-KEY: IL_TUO_TOKEN'
ATC: se un cliente non riceve dati corretti, verificare in Odoo il riferimento di picking, lo stato, il vettore, il tracking e se l'ordine è stato suddiviso in più spedizioni.
10

Supervisione dei primi ordini

Il passaggio da DEMO a produzione richiede di supervisionare le prime operazioni per confermare che l'integrazione funzioni con dati reali. Si utilizza un blocco del contatto per controllare il trasferimento del picking fino al completamento della verifica.

Conclusione: una volta confermata l'operatività, si rimuove il blocco del contatto e il cliente prosegue con il flusso normale.
11

Riferimento rapido, supporto e risorse

Riepilogo delle operazioni

Necessità Endpoint
Elenco del catalogo GET /product/all
Dettaglio SKU GET /product/{sku}
Creare ordine POST /order
Cercare per riferimento GET /order/reference/{reference}
Cercare per ID GET /order/id/{order_id}
Cercare più ordini GET /batch/reference
Consultare il picking GET /packing/show/reference/{reference}
Spedizioni dell'ordine GET /packing/show/order/odoo/{odoo_reference}

Documentazione tecnica

Swagger API B2B ↗

Fonte di riferimento per i campi completi, i modelli di risposta, le validazioni e gli errori.

Accesso e supporto

Feed: Il mio account → Feed nel portale B2B.

Richieste di accesso e questioni tecniche: it@mediamax.es.

Nota sull'ambito: questa guida riproduce e riorganizza la documentazione fornita, includendo il catalogo ampliato e il feed speciale. Gli endpoint non sono stati verificati in tempo reale e non sono stati aggiunti schemi di risposta né campi non documentati. Per le integrazioni di produzione prevale il contratto vigente di Swagger.