Guida Mirakl: impostazioni y soluzioni

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

Poiché molti marketplace Mirakl usano la stessa configurazione, spesso hanno impostazioni, comportamento 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

---

Che cos’è mirakl_unknown_error_code e come risolverlo?

Quando si verifica questo errore, significa che il prodotto non viene riconosciuto da Mirakl. Le possibili მიზეზioni includono:

1. Dettagli del prodotto mancanti, come gli attributi specifici della categoria.

2. Le informazioni sul prodotto sono ancora in attesa, visualizzate come "Product - submission pending."

3. Errori nei dati inviati, indicati come "Product - data error" o "Product - integration error."

In breve: manca qualcosa richiesto dal marketplace oppure non è compilato correttamente.

Anche se può sembrare complesso, la soluzione spesso prevede pochi passaggi semplici:

• Categorie: Assicurati che le categorie dei tuoi prodotti siano abbinate correttamente nella fase Categorie della tua API. Se non lo sono, mappale in modo corretto.

• Build: Verifica che la fase Build della tua API sia configurata correttamente. Per esempio, un campo EAN errato collegato qui può causare errori. Correggi eventuali incongruenze.

• Attributi: Nella fase Attributi dell’API, collega ogni campo al corrispondente corretto e assicurati che i valori siano adatti alla categoria selezionata.

• Regole: Usa le regole per perfezionare ulteriormente i dati. Consulta l’articolo di supporto sul builder degli attributi per migliorare la fase Attributi nella tua API.

Una volta compilate categorie e attributi nella tua API, vai alla panoramica delle API ed esegui l’API facendo clic sul pulsante blu "Esegui ora".

Best practice e impostazioni per Mirakl

Aggiungi più valori di attributo

Se devi inserire più valori per un singolo campo attributo in un marketplace Mirakl, separa ogni valore con il simbolo pipe "|". Questa formattazione assicura che Mirakl riconosca ed 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 dal database di Mirakl.

Di solito succede quando:

• Il prodotto è ancora in elaborazione da parte di Mirakl (mostrato come Product - submission pending).

• L’importazione del prodotto non è riuscita a causa di dati obbligatori mancanti o non validi (ad esempio attributi specifici della categoria). Di solito è mostrato come Product - data error o Product - integration error.

Come risolvere

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

2. Rivedi gli altri errori relativi ai prodotti elencati.

3. Controlla il feedback dell’errore nella colonna Errore . Dove necessario, modifica i 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 Esegui per rieseguire il tuo canale.

Product - submission pending

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

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

1000: attributo obbligatorio vuoto

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

Come risolvere:

1. Nel Feedback scheda nel Risultato fase, fai clic sull’errore.

2. Fai clic sull’ID collegato nella ID colonna.

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

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

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, rivedi eventuali altri errori contrassegnati come Richiesto dal marketplace (indicati da un punto blu). Fai clic sull’ icona per maggiori informazioni/un esempio dei valori accettati.

1. Fai clic Salva.

2. Fai clic 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. Nel Feedback scheda nel Risultato fase, fai clic sull’errore.

2. Fai clic sull’ID collegato nella ID colonna.

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

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, rivedi eventuali altri errori contrassegnati come Richiesto dal marketplace (indicati da un punto blu). Fai clic sull’ icona per maggiori informazioni/un esempio dei valori accettati.

1. Fai clic Salva.

2. Fai clic 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. Nel Feedback scheda nel Risultato fase, fai clic sull’errore 2004.

2. Prendi nota dell’attributo interessato indicato nella Errori colonna, e del limite di caratteri.

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

Suggerimento: mentre sei qui, rivedi eventuali altri errori contrassegnati come Richiesto dal marketplace (indicati da un punto blu). Fai clic sull’ icona per maggiori informazioni/un esempio dei valori accettati.

1. Vai al passaggio Regola .

2. Crea una regola di lunghezza massima per il campo che stai usando, per assicurarti che rientri nel limite di caratteri. Assicurati di fare clic su Salva per applicare le modifiche.

3. Fai clic Esegui.

2006: un attributo ha un valore che non rientra tra quelli consentiti

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

Come risolvere:

1. Nel Feedback scheda nel Risultato fase, fai clic sull’errore 2006.

2. Fai clic sull’ID collegato nella ID colonna.

3. Scorri per vedere eventuali campi contrassegnati Valore non valido per [nome attributo]. Accanto ad esso, fai clic su Visualizza in build. Questo ti porterà all’attributo interessato nella Build .

4. Prendi nota del campo che hai mappato per l’attributo interessato.

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

1. Fai clic su icona accanto all’attributo interessato per visualizzare Esempio e Valori possibili.

2. Usa regole per aggiornare o creare un nuovo campo progetto con i valori accettati. Assicurati di fare clic su Salva per applicare le modifiche.

   1. Se crei un nuovo campo progetto, assicurati di rimapparlo nella Build fase a quel nuovo campo.

3. Fai clic Esegui.

2007: il valore di un attributo non corrisponde a un’espressione regolare

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

Come risolvere:

1. Nel Feedback scheda nel Risultato fase, fai clic sull’errore 2007.

2. Fai clic sull’ID collegato nella ID colonna.

3. Scorri per vedere eventuali campi contrassegnati Valore non valido per [nome attributo]. Accanto ad esso, fai clic su Visualizza in build. Questo ti porterà all’attributo interessato nella Build .

4. Prendi nota del campo che hai mappato per l’attributo interessato.

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

1. Fai clic su icona accanto all’attributo interessato per visualizzare Esempio e Valori possibili.

2. Usa regole per aggiornare o creare un nuovo campo progetto con i valori accettati. Assicurati di fare clic su Salva per applicare le modifiche.

   1. Se crei un nuovo campo progetto, assicurati di rimapparlo nella Build fase a quel nuovo campo.

3. Fai clic Esegui.

Report di errore Mirakl

Puoi scaricare diversi report di errore in Mirakl per analizzare i vari problemi. Li trovi tutti sotto Catalogo > Importazioni prodotto.

• Report errori del file sorgente: Mostra cosa non va nel file sorgente o nel formato. I dati visualizzati mostreranno esattamente lo stesso feedback che appare nel tuo canale marketplace in Channable.

• Report prodotti non integrati (consigliato): Ti dice cosa il marketplace ha rifiutato o sta controllando dopo l’elaborazione dell’invio.

  • Da usare quando: Hai eseguito con successo il canale, ma vedi errori "Product - submission pending".

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

  • Da usare quando: Vuoi una prova di ciò che è attivo, oppure riconciliare ciò che è stato creato rispetto a ciò che è stato inviato.

Come scaricare un report dei prodotti non integrati

Nota: si tratta di un report dettagliato che Mirakl potrebbe impiegare diversi giorni a generare. Per questioni urgenti, contatta il team di supporto di Mirakl.

1. Accedi al tuo account Mirakl.

2. Vai a Catalogo > Importazioni prodotto.

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

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

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

Nota: Il file è in formato CSV. Se usi Microsoft Excel o Fogli Google, potresti dover trasformare/importare il file per visualizzarlo.

1. Apri il file nel tuo software.

2. Controlla la colonna Errori per vedere gli errori specifici di ciascun elemento.

3. Risolvi ciò che puoi in base alla descrizione dell’errore. Mirakl riceve questo feedback dal marketplace.

Se non sei sicuro di cosa significhi la descrizione, contatta il marketplace per maggiori informazioni.

Controlla lo stato del prodotto in Mirakl

I prodotti sulla piattaforma hanno tre stati principali:

• Convalida

• Accettazione

• Sincronizzazione

Le combinazioni di questi generano vari meta-stati.

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

2. Nel Aggiornamenti prodotto colonna, fai clic su per maggiori informazioni su cosa significa un determinato stato.

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

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

I prodotti sulla piattaforma hanno tre stati principali: Convalida, Accettazione e Sincronizzazione. Le combinazioni di questi generano vari meta-stati.

Stati di Mirakl Catalog Manager

Status	Meta-stato	Descrizione
Convalida	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 contenuti multimediali (immagini, video, documenti) dei dati del prodotto non sono ancora stati elaborati dalla piattaforma Mirakl.
	Non calcolato	Quando il marketplace attiva la convalida dei dati prodotto per un canale, gli stati di convalida dei prodotti non vengono ricalcolati automaticamente. In questo caso, questi prodotti ricevono lo stato "Non calcolato" per il canale specificato. Diversi azioni possono attivare il ricalcolo dello stato di convalida di un prodotto: - Dopo la ricostruzione dei fogli dati prodotto - quando modifichi il foglio dati prodotto sorgente e queste modifiche vengono riflesse nel foglio dati prodotto master - quando modifichi un foglio dati prodotto master Tutti i nuovi prodotti ottengono lo stato di convalida appropriato per ciascun 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 riveda di nuovo il prodotto. Puoi vedere il motivo del rifiuto passando il mouse sul punto interrogativo (?)
	In attesa di verifica	Ti è stato chiesto di aggiornare uno o più prodotti. Le modifiche sono state apportate. Ora i marketplace devono 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 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 di Mirakl, puoi visitare il loro centro assistenza.