> 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/come-para-configurare-arriba-un-canale-leroy-merlin-o-bricoman.md).

# Come Para configurare arriba un canale Leroy Merlin o Bricoman

Leroy Merlin è un noto marketplace online per il miglioramento della casa, il fai-da-te e il giardinaggio. Bricoman è un negozio di materiali per la casa e ferramenta dello stesso gruppo (ADEO) specializzato in materiali da costruzione, accessori, materiali di fissaggio e attrezzi professionali.

In questo articolo imparerai come configurare un canale Leroy Merlin per creare, aggiornare e gestire gli annunci su Leroy Merlin e/o Bricoman in Channable.

***

### Prima di iniziare

**Ti servirà**

* [Un account Mirakl Connect](https://www.miraklconnect.com/)
* Un progetto in Channable con prodotti importati

**Buono a sapersi**

* Puoi creare annunci solo per le regioni Leroy Merlin Francia, Italia, Spagna e Portogallo
* Puoi creare annunci solo per Bricoman Francia.
* Leroy Merlin utilizza la piattaforma Mirakl. Questo significa che hai bisogno di un account Mirakl per inviare i tuoi annunci prodotto a Leroy Merlin.
* Alcuni attributi possono essere obbligatori anche se non sembrano rilevanti per la tua situazione specifica (es. un attributo per aggiungere un titolo in spagnolo quando vendi solo in Germania). Puoi lasciarli non mappati.

{% stepper %}
{% step %}

### Connetti a Leroy Merlin/Brico tramite Mirakl

1. Nel tuo account Channable, vai su Canali e cerca Leroy merlin o Maxeda Brico.\
   Nota: se non appare, clicca Cancella per resettare i filtri.
2. Cliccaci sopra e seleziona + Aggiungi nuovo collegamento.
3. A Connetti con, clicca Leroy merlin / Maxeda Brico.
   * Per Etichetta, mantieni il nome così com'è oppure cambialo. Serve solo per identificare il tuo canale Leroy Merlin in Channable.
4. Clicca Connetti con Leroy merlin / Connetti con Maxeda Brico.

Verrai reindirizzato a Mirakl per accedere al tuo account Mirakl. Questo autentica la connessione in modo che Channable possa pubblicare i prodotti per te.

Dopo aver effettuato l'accesso con successo, la connessione sarà pronta e verrai riportato alla configurazione del canale.
{% endstep %}

{% step %}

### Configura il tuo canale Leroy Merlin/Bricoman

1. Clicca \[la tua connessione Leroy merlin] / \[la tua connessione Bricoman].
2. Configura le impostazioni del canale:
   * Nome: assegna un nome al tuo canale.
   * ID univoco per articolo: seleziona un campo che contenga i codici ID dei tuoi prodotti (es. `id`)
   * Lingua: scegli la lingua in cui sono i dati dei tuoi prodotti.
   * Utilizza gruppo di regole principali: (opzionale) imposta un gruppo di regole se ne hai già uno da applicare al canale.
   * Status: lascia l'API disattivata per ora.
3. Clicca Salva.

{% hint style="info" %}
Nota: non puoi configurare canali Leroy Merlin diversi per paesi differenti usando la stessa connessione. Se vuoi vendere in più regioni da un unico canale, dovrai configurare[ Canali di vendita](mailto:undefined).
{% endhint %}
{% endstep %}

{% step %}

### Crea gli annunci dei prodotti

Questo passaggio include categorizzazione, regole e mappatura (Build).

#### Classifica i tuoi prodotti

Organizza i dati prodotto assegnando categorie rilevanti ai tuoi prodotti.

**Copia categorie da un altro canale**

1. Nella **Passo categorie** passo, vai alla **Categorizzazione manuale** mirakl\_unknown\_error\_code - "Il prodotto non esiste"
2. Clicca **Copia categorie**. Nella finestra pop-up, seleziona un progetto da cui copiare le categorie.
3. Clicca **Copia qui**.

**Genera categorie usando i campi del progetto**

1. Nella **Passo categorie** clicca **Categorizzazione manuale** mirakl\_unknown\_error\_code - "Il prodotto non esiste"
2. Clicca **Genera categorie**. A **Imposta il campo di categoria**, seleziona il campo che contiene le categorie dei tuoi prodotti (spesso `categoria`).
3. Clicca **Salva**.
4. Se ti rimangono prodotti senza categoria, continua con **Generazione categorie manuale**.

**Generazione categorie manuale**

1. Nella **Passo categorie** passo, clicca il **Articoli non categorizzati** mirakl\_unknown\_error\_code - "Il prodotto non esiste"
2. Controlla i tuoi articoli per identificare pattern comuni su cui filtrare (es. “elettrico” nel titolo).
3. Clicca **Categorizzazione manuale** e seleziona **Aggiungi categoria**.
4. Crea una regola per assegnare categorie in blocco (es. Se il titolo contiene "elettrico" → imposta categoria \[seleziona la categoria pertinente]).
5. Clicca **Salva**.
6. Clicca Articoli dopo nel footer per vedere quanti articoli sono stati interessati.
7. Ripeti fino a quando sei soddisfatto.

#### Imposta le regole

Le regole aiutano a ottimizzare i dati prodotto per il tuo canale.

* [Modelli di regole](https://channable-test.gitbook.io/channable-test-docs/manage-improve-product-data/rules-bulk-edit-and-enrich/using-rules/rule-templates): regole comunemente usate che puoi adattare e personalizzare.

#### Costruisci le tue inserzioni

Il **Build** il passo dove configuri i tuoi annunci prodotto per rispettare i requisiti del marketplace.

* **Campi obbligatori**: richiesto per inserire i tuoi prodotti su questo marketplace
* **Consigliato**: suggerito per evitare errori
* **Facoltativo**: non richiesto per l'inserimento

{% hint style="info" %}
Importante: alcuni attributi possono essere obbligatori anche se non sembrano rilevanti per la tua situazione (es. un attributo per aggiungere un titolo in spagnolo quando vendi solo in Germania). Puoi lasciare questi attributi non mappati.
{% endhint %}

#### **Attributi condivisi**

* Campi comuni tra i prodotti: EAN, prezzi, titoli.
* Usa valori statici o dinamici:
  * **Valori statici:** valore fisso (es. nome del brand)
  * **Valori dinamici**: campi che si aggiornano automaticamente (es. stock, prezzi)

#### **Attributi specifici per categoria**

* Attributi che si applicano specificamente a categorie selezionate (es. taglia per abbigliamento, dimensioni per mobili).

### Best practice per i marketplace Mirakl

* Aggiunta di valori multipli per attributo: separa i valori multipli in un attributo con il simbolo pipe "|" per una corretta rilevazione e elaborazione.
* ID prodotto del venditore per prodotti singoli/semplici:
  * Ci sono due attributi: `SellerArticleId` e `SellerProductId`. `SellerProductId` è l'ID parent, mentre `SellerArticleId` si riferisce agli articoli variante.
  * Per i prodotti singoli, entrambi `SellerArticleId` e `SellerProductId` devono essere compilati con lo stesso valore.

[Altro su Mirakl ](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/guida-mirakl-impostazioni-y-soluzioni.md)
{% endstep %}

{% step %}

### Informazioni aggiuntive / requisiti per Leroy Merlin / Bricoman

#### Requisiti GPSR

L'UE ha introdotto requisiti GPSR e DSA per le piattaforme online, inclusi i marketplace.

Per essere conformi (flusso di lavoro di esempio):

* Nel passo Build, vai su Attributi condivisi.
* Scorri fino alla sezione Regolamento generale sulla sicurezza dei prodotti (GPSR).
* Mappa gli attributi GPSR ai tuoi dati prodotto:
  * Se le informazioni sulla sicurezza del prodotto si applicano a tutti i prodotti: clicca Manuale e incolla le informazioni di sicurezza.
  * Se variano per prodotto: crea un campo di progetto, aggiungi le informazioni tramite una regola, poi [mappa il campo di progetto](/get-started/get-started-space-it/per-iniziare/campo-en-channable/mappa-y-aggiungi-campo.md) (Campo di progetto > \[campo contenente le informazioni sulla sicurezza del prodotto]).
* Clicca Salva.

#### Classe di spedizione

La classe di spedizione è indicata opzionale da Mirakl, ma è richiesta per pubblicare su Leroy Merlin.

Importante: assicurati che la tua classe di spedizione corrisponda alle impostazioni nel tuo account Leroy Merlin (Il mio account > Impostazioni > Spedizione)

* In \[il tuo canale Leroy Merlin], vai al passo Build.
* Nella sezione Articolo, seleziona il menu a tendina accanto a Shipping class e mappa un valore statico per il tipo di pacco (Valori statici > \[IL TUO TIPO DI SPEDIZIONE]).
* Clicca Salva.

Nota: il tipo di pacco predefinito di Leroy Merlin è INIT.

Classi di spedizione disponibili:

| Codice   | Etichetta                        | Descrizione                                                                                                       |
| -------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| XXXS     | Classe logistica XXXS            | Pacchi fino a 5kg. Dimensione massima: 34 cm. Circonferenza massima (lunghezza+larghezza+profondità): 86 cm       |
| XXS      | Classe logistica XXS             | Pacchi fino a 10kg. Dimensione massima: 50 cm. Circonferenza massima: 117 cm                                      |
| XSXXS    | Classe logistica XXS-XS          | Pacchi fino a 15kg. Dimensione massima: 94 cm. Circonferenza massima: 187 cm                                      |
| XS       | Classe logistica XS              | Pacchi fino a 15kg. Dimensione massima: 100 cm. Circonferenza massima: 150 cm                                     |
| INIT     | Classe logistica S (predefinita) | Pacchi fino a 30kg. Dimensione massima: 94 cm. Circonferenza massima: 187 cm                                      |
| SM       | Classe logistica S-M             | Pacchi fino a 50kg. Dimensione massima: 150 cm. Circonferenza massima: 200 cm                                     |
| M        | Classe logistica                 | Colli voluminosi fino a 110kg. Dimensione massima: 200 cm. Circonferenza massima: 400 cm. Volume massimo: 3 m³    |
| L        | Classe logistica                 | Colli voluminosi fino a 250kg. Dimensione massima: 450 cm. Circonferenza massima: 600 cm. Volume massimo: 11 m³   |
| LXL      | Classe logistica                 | Colli voluminosi fino a 1000kg. Dimensione massima: 500 cm. Circonferenza massima: 750 cm. Volume massimo: 20 m³  |
| XL       | Classe logistica                 | Colli voluminosi fino a 2000kg. Dimensione massima: 600 cm. Circonferenza massima: 1000 cm. Volume massimo: 30 m³ |
| Outsized | Classe logistica                 | Colli voluminosi più pesanti di 2000kg o che superano le dimensioni, la circonferenza e il volume massimi         |
| FREE     | Spedizione gratuita              | Classe logistica per spedizione gratuita                                                                          |

#### Tempi medi di spedizione

* In \[il tuo canale Leroy Merlin], vai al passo Build.
* Nella sezione Articolo, seleziona il menu a tendina accanto a Lead time to ship e seleziona il tempo in giorni che impieghi per spedire un ordine (Valori statici > \[tempo in giorni]).
* Clicca Salva.

#### Sales channels

Alcuni marketplace Mirakl permettono di definire canali di vendita per personalizzare gli annunci prodotto per mercati/regioni diversi (es. prezzi diversi per canale).

* Puoi usare un campo di progetto per impostare dinamicamente Attivo/Disattivo per prodotto per ogni [canale di vendita](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/configurazione-dei-canali-di-vendita-mirakl.md).&#x20;

<figure><img src="/files/4d01d52cd7f9962bf6b307f202293ad2bce91273" alt=""><figcaption></figcaption></figure>

#### Solo per storefront francesi - Eco-contributi

Se la tua azienda opera in Francia, devi aggiungere le eco-contribuzioni alle tue offerte sul marketplace. Vedi le [categorie EPR](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/configurazione-di-mirakl-eco-contributions.md).
{% endstep %}

{% step %}

### Attiva il tuo canale

1. Se il tuo progetto non è attivato, vai su \[il tuo progetto] > Impostazioni e clicca Attiva progetto.
2. In \[il tuo canale Leroy Merlin], vai al passo Impostazioni e clicca Attiva API.
3. Clicca Salva.
4. Clicca X per tornare alla pagina panoramica del canale.
5. Clicca Esegui ora per inviare i tuoi annunci prodotto a Leroy Merlin e/o Bricoman.
   {% endstep %}

{% step %}

### Revisiona e correggi gli errori degli annunci

* Vai al **Risultato** passo e clicca il **scheda Feedback. Questa pagina mostra tutti gli errori di elaborazione presenti nei dati dei tuoi prodotti in un dato momento.** scheda. Qui vengono mostrati gli errori di elaborazione presenti nei tuoi dati prodotto.
* Non tutti gli errori impediscono la pubblicazione. Usa il **", clicca sul nome dell’errore. Questo ti porta a una panoramica dei prodotti che presentano quell’errore.** ID

#### Non tutti gli errori impediscono la pubblicazione dei prodotti. Raccomandiamo di seguire i passaggi e usare la tua

* In Descrizione, clicca il nome dell'errore per vedere i prodotti interessati.
* In ID, clicca il numero ID e scorri. Un richiamo evidenziato in rosso mostra dove si è verificato l'errore. Passa il mouse sul richiamo per maggiori dettagli.
* Se l'errore è di mappatura, clicca Visualizza in build per andare all'attributo da mappare/rimappare (evidenziato in blu).
* Per maggiori informazioni su un attributo e i valori accettati, passa il mouse sull'icona info.
* Risolvi l'errore e ripeti per gli errori rimanenti. Quando sei pronto, clicca Esegui ora.

Puoi controllare i prodotti pubblicati con successo nella scheda Successi.
{% endstep %}
{% endstepper %}

### Errori comuni e soluzioni

<details>

<summary>Controlla le categorie: Nel</summary>

Questo errore si verifica tipicamente quando Mirakl non riesce a identificare l'EAN di un prodotto nel database Mirakl — il prodotto potrebbe essere nuovo su Mirakl o mancare di attributi necessari per essere riconosciuto.

Se rimangono errori, verifica i dati dei prodotti per assicurarti che rispettino la policy delle regole d’oro di Maxeda.

* Controlla le tue categorie: nel passo Categorie, assicurati che le categorie prodotto siano [correttamente abbinate](/manage-improve-product-data/manage-product-and-improve-data-it/categorizza-i-prodotti.md).&#x20;
* Controlla la mappatura: nel passo Build, verifica i campi mappati e correggi eventuali mappature errate. Usa le regole per creare e popolare nuovi campi.

Dopo le modifiche, clicca Esegui ora per far girare nuovamente il tuo canale.

</details>

<details>

<summary>Per risolvere, rimuovi qualsiasi mappatura di categoria esistente da Mirakl.</summary>

Questo si verifica quando gli articoli vengono inviati con categorie che non corrispondono alle categorie di Mirakl. Qualsiasi mappatura esistente in Mirakl sovrascriverà la mappatura delle categorie in Channable.

Soluzione: rimuovi la mappatura delle categorie esistente da Mirakl.

1. Nel tuo account Mirakl Connect, vai su Impostazioni > Mappatura catalogo.\
   ![](/files/5366473086c800293a4c817aedfb96296fb14408)
2. A Struttura del mio catalogo, clicca Root e seleziona Categoria per aprire la mappatura relativa alle categorie.
3. Clicca nuovamente Categoria e seleziona Rimuovi mappatura.\
   ![](/files/fe50b3d64d1005223aff06f244e29482d1db1467)
4. Torna a \[il tuo canale Leroy Merlin] in Channable e clicca Esegui ora.

La discrepanza di categoria dovrebbe essere risolta.

</details>

Per maggiori dettagli sugli errori Mirakl, guide e best practice, vedi: [Guida Mirakl: Impostazioni y soluzioni](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/guida-mirakl-impostazioni-y-soluzioni.md)


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/come-para-configurare-arriba-un-canale-leroy-merlin-o-bricoman.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
