# Guida Mirakl: impostazioni e 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.
:shop: 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. [![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/IE9hp5pWJka6o7jGhIo3/19168742250514)](https://helpcenter.channable.com/hc/article_attachments/19168742250514) 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](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products) 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](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/per-iniziare-con-i-marketplace/marketplace-passaggio-build), 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](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). 4. Rivedi e mappa gli attributi contrassegnati come obbligatori nella **Build** fase. Controlla l’ :circle-info: 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](#how-to-download-a-non-integrated-products-report).
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](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/getting-started/fields-in-channable/map-and-add-fields) e compilarlo usando [regole](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). {% hint style="success" %} Suggerimento: mentre sei qui, rivedi eventuali altri errori contrassegnati come **Richiesto dal marketplace** (indicati da un punto blu). Fai clic sull’ :circle-info: icona per maggiori informazioni/un esempio dei valori accettati. {% endhint %} 6. Fai clic **Salva**. 7. 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](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/getting-started/fields-in-channable/map-and-add-fields) e compilarlo usando [regole](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). {% hint style="success" %} Suggerimento: mentre sei qui, rivedi eventuali altri errori contrassegnati come **Richiesto dal marketplace** (indicati da un punto blu). Fai clic sull’ :circle-info: icona per maggiori informazioni/un esempio dei valori accettati. {% endhint %} 5. Fai clic **Salva**. 6. 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. {% hint style="success" %} Suggerimento: mentre sei qui, rivedi eventuali altri errori contrassegnati come **Richiesto dal marketplace** (indicati da un punto blu). Fai clic sull’ :circle-info: icona per maggiori informazioni/un esempio dei valori accettati. {% endhint %} 4. Vai al passaggio **Regola** . 5. Crea una [regola di lunghezza massima](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/how-to-use-actions-then-in-rules/rule-action-maximum-length) per il campo che stai usando, per assicurarti che rientri nel limite di caratteri. Assicurati di fare clic su **Salva** per applicare le modifiche. 6. 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. {% hint style="success" %} Suggerimento: mentre sei qui, rivedi eventuali altri errori contrassegnati come **Richiesto dal marketplace** (indicato da un punto blu). {% endhint %} 4. Fai clic su :circle-info: icona accanto all’attributo interessato per visualizzare Esempio e Valori possibili. 5. Usa [regole](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) 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. 6. 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. {% hint style="success" %} Suggerimento: mentre sei qui, rivedi eventuali altri errori contrassegnati come **Richiesto dal marketplace** (indicato da un punto blu). {% endhint %} 4. Fai clic su :circle-info: icona accanto all’attributo interessato per visualizzare Esempio e Valori possibili. 5. Usa [regole](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) 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. 6. 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.
:download: Come scaricare un report dei prodotti non integrati {% hint style="info" %} 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. {% endhint %} 1. Accedi al tuo account Mirakl. 2. Vai a **Catalogo** > **Importazioni prodotto**.
3. Nella colonna Nome file, trova quali elementi sono stati importati da Channable e i relativi timestamp. 4. Per quegli elementi, fai clic su **Vedi dettagli** per visualizzare le informazioni di importazione più recenti.
5. Fai clic **Scarica** accanto a **Report prodotti non integrati** per scaricare automaticamente il report degli errori.
{% hint style="info" %} **Nota:** Il file è in formato CSV. Se usi Microsoft Excel o Fogli Google, potresti dover trasformare/importare il file per visualizzarlo. {% endhint %} 6. Apri il file nel tuo software. 7. Controlla la colonna **Errori** per vedere gli errori specifici di ciascun elemento. 8. 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 :circle-info: 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 :circle-question:.
{% hint style="success" %} Suggerimento: usa i filtri per visualizzare gli stati in blocco. {% endhint %} 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](https://help.mirakl.net/bundle/sellers/page/topics/Mirakl/mcm/seller/mcm_statuses_provider.htm).