> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/guida-mirakl-impostazioni-y-soluzioni.md).

# Guida Mirakl: Impostazioni y soluzioni

Scopri come configurare i marketplace Mirakl y risolvere i comuni Errori del canale.

Mirakl fornisce la piattaforma su cui si basano molti marketplace, quindi questi marketplace spesso condividono Impostazioni, comportamento ed Errori comuni.&#x20;

Usa questa pagina per risolvere i problemi dei tuoi Canali Mirakl e correggere gli Errori de **Feedback** scheda en del tuo canale **Risultato** passo.

<details>

<summary><i class="fa-shop">:shop:</i> Marketplace Mirakl en Channable</summary>

* 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

</details>

***

### Aggiungi múltiples valori Para un attributo&#x20;

si un attributo accetta più di un valore, separa i valori con una pipe (`|` ). Per esempio: `cotone|poliestere`. Mirakl legge ogni valore tra le pipe come una voce separata.

### Errori comuni y Risoluzione del problema

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Errore</th><th>Cosa significa</th><th>Risoluzione del problema</th></tr></thead><tbody><tr><td><code>Offerta - prodotto non trovato</code>, o <code>mirakl_unknown_error_code</code></td><td>Il prodotto non è ancora riconosciuto dal database di Mirakl.</td><td>Segui <a href="#fix-product-not-found-errors">Correggi gli errori "product not found"</a>.</td></tr><tr><td><code>Prodotto - invio in sospeso</code></td><td>Il marketplace sta ancora elaborando il prodotto.</td><td>Aspetta, causa<a href="#download-the-non-integrated-products-report"> scarica un report dei prodotti non integrati</a> per lo Status più recente.</td></tr><tr><td><code>Prodotto - errore nei dati</code>, o <code>Errore di integrazione del prodotto</code></td><td>Il marketplace ha rifiutato i dati del prodotto.</td><td>Controlla gli altri Errori del prodotto en <strong>Feedback</strong> scheda y correggi quelli primero.</td></tr><tr><td><code>1000: L'attributo richiesto está vacío</code></td><td>Un attributo obbligatorio non è mappato, o il Campo mappato ha un valore vuoto.</td><td><a href="#fix-an-attribute-value-in-the-build-step">Mappa un Campo con valori supportati.</a>.</td></tr><tr><td><code>1001: Categoria sconosciuta fornita</code></td><td>La Categoria non corrisponde a una Categoria del marketplace, o hai inviato l'Etiqueta della Categoria invece del suo codice.</td><td>Controlla che la formattazione corrisponda ai marketplace o controlla il codice Categoria del marketplace.</td></tr><tr><td><code>1004: Categoria sconosciuta fornita</code></td><td>Una mappatura della categoria en il tuo account Mirakl sostituisce la mappatura en Channable.</td><td>Segui <a href="#remove-category-mapping-in-mirakl-error-1004">Rimuovi la mappatura della categoria en Mirakl</a>.</td></tr><tr><td><code>2004: Un attributo ha un valore troppo lungo</code></td><td>Il valore supera il limite di caratteri del marketplace.</td><td>Controlla i requisiti de il marketplace y aggiungi un <a href="https://helpcenter.channable.com/manage-improve-product-data/manage-product-and-improve-data-it/regole-modifica-in-blocco-e-arricchisci/how-to-use-actions-then-in-rules/azioni-texto/rule-action-maximum-length.md">Regla di longitud máxima</a> Para il campo mappato.</td></tr><tr><td><code>2006: Un attributo ha un valore che non è uno dei valori consentiti</code></td><td>Il valore non è en la Lista del marketplace de valori supportati.</td><td>usar le regole Para modificare il valore Para uno supportato.</td></tr><tr><td><code>2007: Il valore di un attributo non corrisponde a un'espressione regolare</code></td><td><p>Il valore è nel formato sbagliato. </p><p></p><p>Ad esempio, Carrefour Spagna richiede un EAN a 13 cifre.</p></td><td>usar le regole Para riformattare il valore.</td></tr></tbody></table>

#### Più informazioni

<details>

<summary>Correggi gli errori "product not found"</summary>

**Prodotto non trovato** Errori significano che Channable ha inviato un'offerta per un prodotto che non esiste nel catalogo del marketplace.&#x20;

en la **Feedback** scheda, spesso appaiono come `Offerta - prodotto non trovato` o `mirakl_unknown_error_code`, con il messaggio "Il prodotto non esiste."

Di solito succede per uno de questi motivi:

* L'identificatore del prodotto è sbagliato. Per esempio, `EAN` è mappato al Campo sbagliato.
* Il marketplace sta ancora elaborando il prodotto. L'errore viene mostrato come `Prodotto - invio in sospeso`.
* Il prodotto non ha superato la convalida perché gli attributi richiesti mancano o non sono validi, quindi il marketplace non l'ha Crear. L'errore viene mostrato come `Prodotto - errore nei dati` o `Errore di integrazione del prodotto`.

Ogni marketplace ha il proprio catalogo. Un prodotto che è attivo su un marketplace Mirakl può comunque essere assente su un altro.

**Para risolvere l'errore:**

1. Nel tuo canale **Risultato** passaggio, vai alla **Feedback** scheda.
2. Controlla se gli stessi prodotti hanno errori di attributo, come `1000` o `2006`. Se sì, correggili primero. Vedi [**Correggi un valore di attributo en Build** passaggio](#fix-an-attribute-value-in-the-build-step).
3. en la **Build** passaggio, controlla che il **EAN** attributo sia mappato Para il campo che contiene i tuoi EANs.
4. en la **Categoria** passaggio, verifica che le tue categorie siano mappate Para le categorie del marketplace, y che gli Attributi per categoria siano compilati en la **Attributi per categoria** scheda en la **Build** passo.
5. Fai clic **Esegui**.
6. Se l'errore cambia Para `Prodotto - invio in sospeso`, attendi che il marketplace Para elaborare il prodotto. Per lo Status più recente, [**scarica un report dei prodotti non integrati**](#download-the-non-integrated-products-report).

Se non puoi fornire un attributo richiesto, contatta il marketplace. Il marketplace può approvare un prodotto anche quando alcuni attributi richiesti mancano.

</details>

<details>

<summary>Correggi un valore dell'attributo en il passaggio Build</summary>

Segui questi passaggi per i seguenti Errori:  `1000`, `1001`, `2004`, `2006`, y `2007`.

1. Nel tuo canale **Risultato** passaggio, vai alla **Feedback** tab y fai clic sull'errore.
2. en la **ID** colonna, fai clic su un ID prodotto.
3. Scorri y trova l'attributo contrassegnato **Mappatura mancante per "\[attribute]"** o **Valore non valido per "\[attribute]"**, causa fai clic **Visualizza en build**.&#x20;
   1. Per gli errori 2004, annota il limite di caratteri mostrato en la **Errori** colonna.
4. Accanto all'attributo, fai clic sull'icona info Para vedere **Esempio** y **Valori possibili**.
5. Correggi il campo mappato:
   * Se l'attributo non è mappato, mappa un campo che contiene valori accettati.
   * Se il valore non è accettato, usar le regole Para cambiarlo en un valore accettato. Per le categorie, usar il codice della categoria, non l'etichetta.
   * si il valore è troppo lungo, aggiungi una Regla di longitud máxima al Campo mappato.
   * si il valore è en il formato sbagliato, usar le regole per riformattarlo.
6. si non hai un Campo con valori supportati, [Crear un nuovo Campo, compilalo usando le regole, y mappalo Para l'attributo](https://helpcenter.channable.com/list-advertise/list-and-advertise-it/elenca-su-canali/completa-i-dati-degli-attributi-mancanti.md) en il **Build** passo.
7. Fai clic **Salva**.
8. Fai clic **Esegui**.

{% hint style="info" %}

#### Nota

Mentre sei en il **Build** passaggio, controlla gli altri attributi contrassegnati **Richiesto dal marketplace** (punto blu) y mappali.
{% endhint %}

</details>

<details>

<summary>Rimuovi la mappatura della categoria en Mirakl (errore 1004)</summary>

Errore `1004` significa che una Mappatura di Categoria en il tuo Account Mirakl sostituisce la Mappatura di Categoria en Channable. Rimuovi la Mappatura Mirakl così che si applichino le Categorie di Channable.&#x20;

1. en il tuo Account Mirakl, vai Para **Impostazioni > Mappatura del catalogo**.
2. Sotto **La struttura del mio catalogo**, clicca **Radice**, causa fai clic **Categoria**.
3. Fai clic **Categoria** di nuovo, causa fai clic **Rimuovi la Mappatura**.
4. en Channable, apri il tuo canale y fai clic **Esegui**.

</details>

### Scarica i report degli Errori di Mirakl <a href="#download-mirakl-error-reports" id="download-mirakl-error-reports"></a>

I report di Mirakl mostrano cosa il marketplace ha rifiutato o sta ancora esaminando. Puoi usar i report per indagare diversi Errori. Li troverai en il tuo Account Mirakl sotto **Catalogo > Importazioni di prodotti**.

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Report</th><th>Cosa mostra</th><th>Usalo quando</th></tr></thead><tbody><tr><td>Report dei prodotti non integrati <mark style="color:$info;">(Consigliato)</mark></td><td>Prodotti che il marketplace ha rifiutato o sta ancora esaminando dopo aver elaborato il tuo import.</td><td>Il tuo canale è stato eseguito, ma i prodotti mostrano <code>Prodotto - invio in sospeso</code> o errori dei dati.</td></tr><tr><td>Report errori del file target</td><td>Problemi con il contenuto o il formato del file di importazione. Corrisponde al Feedback en Channable.</td><td>Vuoi lo stesso Feedback al di fuori di Channable.</td></tr><tr><td>Report dei prodotti aggiunti</td><td>Prodotti integrati con successo dal marketplace.</td><td>Vuoi Para confermare quali prodotti sono attivi.</td></tr></tbody></table>

<details>

<summary><i class="fa-download">:download:</i> Scarica il report dei prodotti non integrati</summary>

{% hint style="info" %}
Mirakl può tomar diversi días per generare questo report. Se è urgente, contatta l'assistenza Mirakl.
{% endhint %}

1. Accedi Para il tuo Account Mirakl.
2. Vai Para **Catalogo > Importazioni di prodotti**.
3. Trova i file di importazione che Channable ha inviato. I loro nomi iniziano con `channable_Crear_update_`.
4. Accanto Para il file più recente, fai clic su **Visualizza i dettagli**.
5. Accanto Para **Report dei prodotti non integrati**, clicca **Scarica**.

<figure><img src="https://3029115931-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8GepmoSonQRG6RnHOxJ%2Fuploads%2FfC22oIB7wjoXwQkYyZMK%2Fimage.png?alt=media&amp;token=8ea429d0-3f5e-458d-abd0-616875e5108a" alt=""><figcaption></figcaption></figure>

6. Apri il file CSV. si usi Microsoft Excel o Google Sheets, potresti dover importare il file Para usarlo invece de aprirlo.
7. en la **Errori** colonna, leggi l'errore per ogni prodotto.
8. Correggi gli Errori en Channable, causa fai clic **Esegui**.

{% hint style="warning" %}
Il marketplace scrive queste descrizioni degli errori. si una non è chiara, contatta il marketplace Para Mirakl o Channable.
{% endhint %}

</details>

### Controlla lo Status del prodotto en Mirakl <a href="#check-product-status-in-mirakl" id="check-product-status-in-mirakl"></a>

Ogni prodotto en Mirakl ha uno status di convalida, uno status di accettazione y uno status di sincronizzazione. Controlla tutti de essi Para vedere dove un prodotto è bloccato.

1. en il tuo Account Mirakl, vai Para **Catalogo > Catalog Manager**.
2. en la **Status del prodotto** colonna, fai clic <i class="fa-circle-info">:circle-info:</i> accanto a uno Status Para vedere cosa significa.&#x20;
3. Per uno stato dettagliato, apri la pagina del prodotto y fai clic <i class="fa-circle-question">:circle-question:</i>.

{% hint style="warning" icon="lightbulb" %}
Para visualizzare gli stati en massa, usar i filtri, ad esempio **Status del prodotto**.

<img src="https://3029115931-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8GepmoSonQRG6RnHOxJ%2Fuploads%2FHrIY9o1Y0Tx5zcOKVLOK%2Fimage.png?alt=media&amp;token=fc756c34-cadb-4fdd-81b1-f19615b020ab" alt="" data-size="original">
{% endhint %}

| Status           | Meta Status                | Cosa significa                                                                                                                                                                                                                                     |
| ---------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Convalida        | Dati validi                | I dati del prodotto soddisfano i requisiti del marketplace.                                                                                                                                                                                        |
| Convalida        | Dati non validi            | I dati del prodotto non soddisfano i requisiti del marketplace.                                                                                                                                                                                    |
| Convalida        | Media en attesa            | Mirakl non ha ancora elaborato le immagini, i video o i documenti del prodotto.                                                                                                                                                                    |
| Convalida        | Non calcolato              | Il marketplace ha attivato la convalida dei dati, ma Mirakl non ha ancora ricalcolato lo Status di questo prodotto. Mirakl lo ricalcola quando le schede dati del prodotto vengono ricostruite o quando i dati del prodotto cambiano.              |
| Accettazione     | Nuovo                      | Il prodotto è nuovo. Il marketplace deve accettarlo o rifiutarlo.                                                                                                                                                                                  |
| Accettazione     | Modifiche richieste        | Il marketplace ha rifiutato il prodotto a causa de Problemi di Qualità dei dati. Aggiorna il prodotto così il marketplace può rivederlo di nuovo. Para vedere il motivo, passa il mouse sopra <i class="fa-circle-question">:circle-question:</i>. |
| Accettazione     | In attesa di verifica      | Hai aggiornato i dati del prodotto inviati en qualche modo. Ora il marketplace deve decidere se accettare o rifiutare le tue modifiche.                                                                                                            |
| Accettazione     | Accettato                  | Il marketplace ha accettato il prodotto.                                                                                                                                                                                                           |
| Accettazione     | Rifiutato                  | Il marketplace ha rifiutato il prodotto. Para vedere il motivo, passa il mouse sopra <i class="fa-circle-question">:circle-question:</i>.                                                                                                          |
| Sincronizzazione | Sincronizzato              | Il prodotto è integrato nel marketplace.                                                                                                                                                                                                           |
| Sincronizzazione | Non sincronizzato          | Il prodotto non è integrato nel marketplace.                                                                                                                                                                                                       |
| Sincronizzazione | Errore di sincronizzazione | Si è verificato un errore durante l'integrazione del prodotto.                                                                                                                                                                                     |

{% hint style="warning" %}

#### L'accettazione è distinta de la convalida.&#x20;

Il marketplace esamina i prodotti en il proprio flusso di lavoro, quindi un ítem può avere **Dati validi** y mostrare ancora **Nuovo** o **Modifiche richieste**.&#x20;

Se lo stato di accettazione non cambia dopo aver corretto i dati, contatta il marketplace.
{% endhint %}

Per saperne di più su questi status, vedi [Centro Aiuto di Mirakl](https://help.mirakl.net/bundle/sellers/page/topics/Mirakl/mcm/seller/mcm_statuses_provider.htm).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/guida-mirakl-impostazioni-y-soluzioni.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
