Guida Mirakl: impostazioni e soluzioni

Questa guida spiega come risolvere problemi comuni e seguire le best practice quando gestisci un marketplace Mirakl con Channable.

Mirakl non gestisce direttamente il proprio marketplace. Fornisce invece l’infrastruttura che altri usano per creare e gestire il loro.

Poiché molti marketplace Mirakl usano la stessa configurazione, spesso hanno impostazioni, comportamenti e problemi comuni simili.

Marketplace Mirakl in Channable

• Decathlon

• Fnac

• Leroy Merlin

• fonQ

• Darty

• Bricoman

• Mediamarkt

• Conforama

• Carrefour Francia/Spagna

• Manor

• PcComponentes

• Maxeda Brico&Praxis

• Leen Bakker

• ePrice

• Douglas

• Galeries Lafayette

• Home24

• Sprinter

• Showroomprive

• Hornbach

• Conrad

• Vtwonen

• Galeries Lafayette

---

Best practice e impostazioni per Mirakl

Aggiungi valori multipli per un attributo

Se devi inserire più valori per un singolo campo attributo per un Marketplace Mirakl, separa ogni valore con il simbolo pipe "|". Questo formato garantisce che Mirakl riconosca e elabori correttamente ogni voce separata.

Errori comuni di Mirakl e come risolverli

Offerta - prodotto non trovato

Questo errore si verifica quando l’EAN di un prodotto non viene riconosciuto nel database Mirakl.

Di solito succede quando:

• Il prodotto è ancora in fase di elaborazione da parte di Mirakl (visualizzato come Prodotto - invio in attesa).

• L’importazione del prodotto è fallita a causa di dati obbligatori mancanti o non validi (per esempio, attributi specifici di categoria). Di solito è mostrato come Prodotto - errore dati o Prodotto - errore integrazione.

Come risolvere

1. Nella Risultato fase del tuo canale marketplace Mirakl, vai alla Feedback scheda.

2. Rivedi altri errori elencati relativi ai prodotti.

3. Controlla il feedback dell’errore nella Errore colonna. Dove necessario, correggi i tuoi dati usando regole.

4. Rivedi e mappa gli attributi contrassegnati come obbligatori nella Build fase. Controlla l’ icona e i tooltip per vedere i valori accettati.

5. Fai clic su Esegui per rieseguire il tuo canale.

Prodotto - invio in attesa

Questo errore si verifica quando il marketplace sta ancora elaborando le informazioni sul tuo prodotto.

Per le informazioni di stato più aggiornate, scarica un report dei prodotti non integrati in Mirakl.

1000: Attributo obbligatorio vuoto

Un attributo obbligatorio per questo marketplace non è stato mappato o ha un valore vuoto.

Come risolvere:

1. Nella Feedback scheda nella Risultato fase, clicca sull’errore.

2. Clicca sull’ID collegato nella ID colonna.

3. Scorri per vedere eventuali campi contrassegnati Mappatura mancante per [inserire attributo].

4. Fai clic su Visualizza in build. Questo ti indirizzerà all’attributo interessato nella Build fase.

5. Mappa il campo mancante. Se non hai un campo con valori accettati, puoi creare un nuovo campo e compilarlo usando regole.

Suggerimento: mentre sei qui, controlla eventuali altri errori rimasti contrassegnati come Richiesto dal marketplace (indicato da un punto blu). Clicca sull’ icona per maggiori informazioni/un esempio di valori accettati.

1. Fai clic su Salva.

2. Fai clic su Esegui.

1001: Categoria fornita sconosciuta

Il valore della categoria fornito non corrisponde a una categoria del marketplace, oppure è stata fornita un’etichetta invece del codice.

Come risolvere:

1. Nella Feedback scheda nella Risultato fase, clicca sull’errore.

2. Clicca sull’ID collegato nella ID colonna.

3. Fai clic su Visualizza in build. Questo ti indirizzerà all’attributo interessato nella Build fase.

4. Mappa il campo mancante. Se non hai un campo con valori accettati, puoi creare un nuovo campo e compilarlo usando regole.

Suggerimento: mentre sei qui, controlla eventuali altri errori rimasti contrassegnati come Richiesto dal marketplace (indicato da un punto blu). Clicca sull’ icona per maggiori informazioni/un esempio di valori accettati.

1. Fai clic su Salva.

2. Fai clic su Esegui.

2004: Un attributo ha un valore troppo lungo

Il campo mappato per questo attributo deve essere inferiore al limite di caratteri specificato.

Come risolvere:

1. Nella Feedback scheda nella Risultato nella fase, clicca sull’errore 2004.

2. Annota l’attributo interessato indicato nella Errori colonna e il limite di caratteri.

3. Vai alla Build fase e controlla quale campo hai mappato per l’attributo interessato.

Suggerimento: mentre sei qui, controlla eventuali altri errori rimasti contrassegnati come Richiesto dal marketplace (indicato da un punto blu). Clicca sull’ icona per maggiori informazioni/un esempio di valori accettati.

1. Vai alla Regola fase.

2. Crea una regola lunghezza massima per il campo che stai usando per assicurarti che rientri nel limite di caratteri. Ricordati di cliccare Salva per applicare le modifiche.

3. Fai clic su Esegui.

2006: Un attributo ha un valore che non è tra i valori consentiti

Questo errore si verifica quando il campo che hai mappato contiene un valore non accettato.

Come risolvere:

1. Nella Feedback scheda nella Risultato nella fase, clicca sull’errore 2006.

2. Clicca sull’ID collegato nella ID colonna.

3. Scorri per vedere eventuali campi contrassegnati Valore non valido per [nome attributo]. Accanto a esso, clicca Visualizza in build. Questo ti indirizzerà all’attributo interessato nella Build fase.

4. Annota il campo che hai mappato per l’attributo interessato.

Suggerimento: mentre sei qui, controlla eventuali altri errori rimasti contrassegnati come Richiesto dal marketplace (indicato da un punto blu).

1. Clicca sull’ icona accanto all’attributo interessato per vedere Esempio e Valori possibili.

2. Usa regole per aggiornare o creare un nuovo campo di progetto con i valori accettati. Ricordati di cliccare Salva per applicare le modifiche.

   1. Se crei un nuovo campo di progetto, ricordati di rimapparlo nella Build fase su quel nuovo campo.

3. Fai clic su Esegui.

2007: Un valore dell’attributo non corrisponde a una espressione regolare

Questo errore si verifica se il valore nell’attributo non è nel formato previsto.

Come risolvere:

1. Nella Feedback scheda nella Risultato nella fase, clicca sull’errore 2007.

2. Clicca sull’ID collegato nella ID colonna.

3. Scorri per vedere eventuali campi contrassegnati Valore non valido per [nome attributo]. Accanto a esso, clicca Visualizza in build. Questo ti indirizzerà all’attributo interessato nella Build fase.

4. Annota il campo che hai mappato per l’attributo interessato.

Suggerimento: mentre sei qui, controlla eventuali altri errori rimasti contrassegnati come Richiesto dal marketplace (indicato da un punto blu).

1. Clicca sull’ icona accanto all’attributo interessato per vedere Esempio e Valori possibili.

2. Usa regole per aggiornare o creare un nuovo campo di progetto con i valori accettati. Ricordati di cliccare Salva per applicare le modifiche.

   1. Se crei un nuovo campo di progetto, ricordati di rimapparlo nella Build fase su quel nuovo campo.

3. Fai clic su Esegui.

Report errori Mirakl

Puoi scaricare diversi report di errori in Mirakl per investigare vari errori. Li trovi tutti sotto Catalog > Product imports.

• Report errori file di origine: Mostra cosa non va nel tuo file sorgente o nel formato. I dati mostrati saranno esattamente gli stessi feedback che appaiono nel tuo canale marketplace in Channable.

• Report prodotti non integrati (consigliato): Ti dice cosa il marketplace ha rifiutato/stà revisionando dopo che il tuo invio è stato elaborato.

  • Usare quando: Hai eseguito con successo il tuo canale, ma vedi errori ‘Prodotto - invio in attesa’.

• Report prodotti aggiunti: Conferma quali prodotti/righe sono stati integrati con successo

  • Usare quando: Vuoi la prova di ciò che è live, o riconciliare ciò che è stato creato rispetto a quanto inviato.

Come scaricare un report dei prodotti non integrati

Nota: questo è un report dettagliato che può impiegare diversi giorni per essere generato da Mirakl. Per questioni urgenti, contatta il team di supporto di Mirakl.

1. Accedi al tuo account Mirakl.

2. Vai a Catalog > Product Imports.

1. Nella colonna Nome file, individua quali elementi sono stati importati da Channable e i relativi timestamp.

2. Per quegli elementi, clicca Vedi dettagli per visualizzare le informazioni di importazione più recenti.

1. Fai clic su Scarica accanto a Report prodotti non integrati per scaricare automaticamente il report degli errori.

Nota: Il file è un CSV. Se usi Microsoft Excel o Google sheet, potrebbe essere necessario trasformare/importare il file per visualizzarlo.

1. Apri il file nel tuo software.

2. Controlla la Errori colonna per vedere lo specifico(i) errore(i) per ogni elemento.

3. Correggi quello che puoi in base alla descrizione dell’errore. Mirakl riceve questo feedback dal marketplace.

Se non sei sicuro del significato della descrizione, contatta il marketplace per maggiori informazioni.

Controlla lo stato del prodotto in Mirakl

I prodotti sulla piattaforma hanno tre stati principali:

• Validazione

• Accettazione

• Sincronizzazione

Combinazioni di questi producono vari meta status.

1. Nel tuo backend Mirakl, vai a Catalog > Catalog Manager. Vedrai una panoramica di tutti i tuoi articoli.

2. Nella Aggiornamenti prodotto colonna, clicca per maggiori informazioni su cosa significa un certo stato.

3. Per visualizzare una descrizione più dettagliata, apri la pagina del prodotto e clicca .

Suggerimento: usa i filtri per visualizzare gli stati in blocco.

I prodotti sulla piattaforma hanno tre stati principali: validazione, accettazione e sincronizzazione. Le combinazioni di questi producono vari meta status.

Stati del Catalog Manager di Mirakl

Stato	Meta stato	Descrizione
Validazione	Dati validi	I dati del prodotto sono conformi ai requisiti del Marketplace.
	Dati non validi	I dati del prodotto non sono conformi ai requisiti del Marketplace.
	Media in attesa	I media (immagini, video, documenti) dei dati prodotto non sono ancora stati processati dalla piattaforma Mirakl.
	Non calcolato	Quando il Marketplace attiva la validazione dei dati prodotto per un canale, gli stati di validazione dei prodotti non vengono ricalcolati automaticamente. In questo caso, questi prodotti ottengono lo stato "Non calcolato" per il canale specifico. Diverse azioni possono innescare il ricalcolo dello stato di validazione di un prodotto: - Dopo la ricostruzione dei Product Data Sheets - quando modifichi il Product Data Sheet sorgente e queste modifiche si riflettono nel Master Product Data Sheet - quando modifichi un Master Product Data Sheet Tutti i nuovi prodotti ottengono lo stato di validazione appropriato per ogni canale attivato.
Accettazione	Nuovo	Il prodotto è nuovo e il Marketplace deve accettarlo o rifiutarlo.
	Modifiche richieste	Il tuo Marketplace ha rifiutato il prodotto a causa di problemi di qualità dei dati. Devi aggiornare i tuoi prodotti prima che il Marketplace revisioni nuovamente il prodotto. Puoi vedere il motivo del rifiuto passando il cursore del mouse sul punto interrogativo (?)
	Verifica in corso	Ti è stato chiesto di aggiornare un prodotto o dei prodotti. Sono state effettuate modifiche. I marketplace devono ora decidere se accettare o rifiutare il prodotto/i prodotti.
	Accettato	Il tuo Marketplace ha accettato il prodotto.
	Rifiutato	Il tuo Marketplace ha rifiutato il prodotto. Puoi vedere il motivo del rifiuto passando il cursore del mouse sul punto interrogativo (?)
Sincronizzazione	Sincronizzato	Il prodotto è integrato nella piattaforma del Marketplace.
	Non sincronizzato	Il prodotto non è integrato nella piattaforma del Marketplace.
	Errore di sincronizzazione	Si è verificato un errore durante l’integrazione del prodotto.

Per maggiori informazioni sugli stati Mirakl, puoi visitare il loro centro assistenza.