# Come Para configurare arriba un canale Hornbach Hornbach è una catena tedesca di bricolage specializzata in articoli per la casa, il giardino e il fai da te. In questo articolo scoprirai come configurare un canale Hornbach per creare, aggiornare e gestire le tue inserzioni Hornbach in Channable. *** ### :memo-circle-check: **Prima di iniziare** **Ti serviranno** * [Un account Mirakl](https://www.miraklconnect.com/) * L'approvazione per pubblicare su Hornbach\* * Un progetto in Channable con i tuoi prodotti importati * Prodotti con codici EAN **Buono a sapersi** * Attualmente Hornbach supporta la pubblicazione solo in **Germania**. * \*Il team partnership di Hornbach esamina tutte le richieste di pubblicazione sulla piattaforma. Puoi inviare una richiesta tramite il loro [modulo Marketplace Partner](https://forms.office.com/pages/responsepage.aspx?id=A5acU4BjPEKnDAGs1pyR1RoFDihP4cxKtIE31LhHMH9URUJFSTVPV0VKNEswQjVHN0lLVzdGME5QMy4u\&route=shorturl). * Hornbach utilizza la piattaforma Mirakl * Alcuni attributi possono essere obbligatori anche se non sembrano pertinenti al tuo caso specifico (ad esempio, un attributo per aggiungere un titolo in spagnolo quando vendi solo in Germania). Puoi lasciare questi attributi non mappati. ### **Passaggio 1: crea un canale Hornbach** 1. In Channable, vai alla **Progetti > \[Il tuo progetto] > Canali**. 2. Nella barra di ricerca, inserisci “Hornbach” e seleziona **Hornbach**. {% hint style="info" %} **Nota:** Se non compare, fai clic su **Cancella** per reimpostare i filtri. {% endhint %} 3. Configura le impostazioni del canale: 1. Per **Nome**, assegna un nome al canale. 2. Per **ID univoco per articolo**, seleziona un campo che contenga i codici EAN dei tuoi prodotti (ad es. `ean`, `id`) 3. Per **Lingua**, scegli la lingua in cui sono presenti i dati dei prodotti. 4. Per **Utilizza gruppo di regole principali**, puoi impostare un gruppo di regole, se ne hai già uno da applicare al canale. 5. Per **Status**, lascia l'API disattivata per ora. 4. Fai clic su **Salva**. ### **Passaggio 2: crea le inserzioni dei prodotti** Segui questi sotto-passaggi per configurare il canale. **Categorie dei prodotti** Configura i dati dei prodotti assegnando categorie ai tuoi prodotti. * **Categorizzazione intelligente:** Assegna automaticamente le categorie dei prodotti usando il nostro algoritmo. * **Categorizzazione manuale:** Assegna manualmente le categorie dei prodotti con regole personalizzate. Puoi creare filtri dettagliati per associare ogni prodotto alla categoria corretta. * **Elementi non categorizzati:** Prodotti che devono ancora essere verificati e categorizzati. **Configura le regole** Le regole ti aiutano a ottimizzare rapidamente i dati dei prodotti per il marketplace di destinazione. * **Modelli di regole:** Regole usate di frequente che puoi adattare e personalizzare in base alle tue esigenze. * **Configurazione delle regole:** Configura regole per perfezionare i dati dei prodotti. Con le regole puoi filtrare, modificare e/o migliorare i campi dati per soddisfare i requisiti del marketplace. **Crea le inserzioni** Il **Build** è il passaggio in cui configuri le inserzioni dei prodotti in modo che corrispondano ai requisiti del marketplace. È un passaggio essenziale per pubblicare i prodotti e prevenire errori. * **Campi obbligatori:** Necessari per pubblicare i prodotti su questo marketplace * **Consigliato:** Suggerito per evitare errori {% hint style="warning" %} **Importante:** Alcuni attributi possono essere obbligatori anche se non sembrano pertinenti al tuo caso specifico (ad esempio, un attributo per aggiungere un titolo in spagnolo quando vendi solo in Germania). Puoi lasciare questi attributi non mappati. {% endhint %} **Attributi condivisi** Gli attributi condivisi sono i campi comuni che si applicano a tutti i prodotti, come EAN, prezzi e titoli. Mappare gli attributi condivisi garantisce informazioni sui prodotti uniformi e coerenti in tutte le inserzioni. Usa valori statici o dinamici: * **Valori statici:** Valori fissi che non cambiano (ad es. nome del marchio, produttore). * **Valori dinamici:** Campi che si aggiornano automaticamente in base ai dati collegati (ad es. stock, prezzi). **Attributi specifici della categoria** Gli attributi specifici della categoria sono campi che si applicano in modo specifico alle categorie dei prodotti. Questo passaggio ti aiuta a rifinire le inserzioni per soddisfare i requisiti della categoria del marketplace. Compila gli attributi specifici della categoria selezionata (ad es. la taglia per l'abbigliamento o le dimensioni per i mobili). {% hint style="success" %} **Suggerimento:** Fai clic su **Mappatura automatica dei campi** per mappare automaticamente usando le informazioni provenienti dagli altri canali o da configurazioni simili.[ Scopri di più](https://channable-test.gitbook.io/channable-test-docs/list-advertise/list-on-marketplaces/auto-map-fields-for-marketplaces-apis). {% endhint %} **Best practice per i marketplace Mirakl** Aggiunta di più valori di attributo: separa più valori in un attributo con il simbolo pipe "|" per un rilevamento e un'elaborazione corretti. ID prodotto del venditore per prodotti singoli/semplici: esistono due attributi chiamati SellerArticleId e SellerProductId. SellerProductId è l'ID padre, mentre SellerArticleId si riferisce agli articoli variante. Per i prodotti singoli, sia SellerArticleId sia SellerProductId devono essere compilati con lo stesso valore. Per ulteriori informazioni sugli errori del marketplace Mirakl, le procedure e le best practice, consulta[ la nostra guida dedicata](https://helpcenter.channable.com/hc/en-us/articles/360012678720-Mirakl-guide-settings-and-solutions). #### **Controlla la qualità della configurazione** Il **Qualità** fornisce feedback sul canale prima che tu lo attivi. Evidenzia gli errori obbligatori e facoltativi per assicurarti che i dati dei prodotti soddisfino i requisiti per la pubblicazione sul marketplace. Risolvi gli errori, dando priorità prima a quelli obbligatori. Azioni: * **Visualizza articoli:** Mostra i prodotti con problemi specifici. * **Visualizza in build:** Reindirizza al **Build** passaggio per mappare le informazioni mancanti. * **Imposta categorie:** Porta al **Categorie** passaggio per categorizzare gli articoli. * **Mostra origine:** Disponibile per i campi ID. Porta al passaggio **Impostazioni** . [Scopri di più sul passaggio Qualità per i marketplace](https://helpcenter.channable.com/hc/en-us/articles/19452435834642-Marketplaces-Quality-step) #### **Anteprima prima dell'attivazione** Il **Anteprima** mostra gli attributi mappati nel **Build** passaggio, aiutandoti a verificare se tutto è configurato correttamente e fornendo una panoramica dei prodotti e dei potenziali errori. Filtro: * **Filtra per errore:** Fai clic sul menu a discesa **Tutti** e seleziona se vuoi filtrare per mostrare solo i prodotti con errori oppure i prodotti con un errore specifico. * **Filtra per categoria:** Fai clic sul menu a discesa **Tutte le categorie** e seleziona la categoria per cui vuoi filtrare. [Scopri di più sul passaggio Anteprima per i marketplace](https://helpcenter.channable.com/hc/en-us/articles/19452509593746-API-s-Preview-step) **Prima di continuare:** * **Rivedi gli attributi condivisi:** Assicurati che tutti gli attributi condivisi obbligatori siano compilati. * **Rivedi gli attributi specifici della categoria:** Assicurati che tutti gli attributi specifici della categoria obbligatori siano compilati. * **Controlla gli errori:** Correggi tutti i campi evidenziati in rosso. \ ### **Requisiti aggiuntivi per Hornbach** **Soddisfa i requisiti GPSR e DSA** L'Unione Europea (UE) ha introdotto nuovi[ requisiti GPSR e DSA](https://helpcenter.channable.com/hc/en-us/articles/22175644897042) per le piattaforme online, tra cui Hornbach. Per rispettare questi requisiti, dovrai fornire informazioni per almeno gli attributi **Produttore** e **Operatore economico** elencati nella sezione **Informazioni generali sulla sicurezza del prodotto** nel **Build** . \ ### **Passaggio 3: connetti Hornbach tramite Mirakl** Per inviare le tue inserzioni a Hornbach, devi collegare il canale al tuo account Mirakl Connect. **Importante:** Collegare l'account non cambierà nulla: tutte le inserzioni esistenti resteranno esattamente uguali finché non attiverai il canale. 1. Accedi al tuo account Mirakl Connect. 2. In **\[il tuo canale Hornbach]**, vai a **Impostazioni**. 3. In **Account venditore collegato**, fai clic su **Seleziona account venditore**. 4. Seleziona un account venditore esistente oppure fai clic su **+ Aggiungi nuovo collegamento** per aggiungere un nuovo account venditore. 1. Se aggiungi un nuovo account venditore: 1. Per **Etichetta**: assegna un nome al collegamento dell'account venditore. Serve solo a identificare il collegamento all'interno di Channable. 2. Fai clic su **Connetti con Hornbach**. Verrai reindirizzato a Mirakl per accedere al tuo account. Questo serve a verificare la connessione e a garantire che Channable possa pubblicare i prodotti per te. Dopo l'accesso riuscito, la connessione sarà pronta e verrai riportato al canale. ### **Passaggio 4: attiva il canale** Una volta che le inserzioni dei prodotti sono pronte, puoi inviarle a Hornbach: 1. Seleziona il **Impostazioni** passaggio in **\[il tuo canale Hornbach]** e fai clic su **Attiva API**. 2. Fai clic su **Salva**. 3. Fai clic su **Esegui** per inviare le inserzioni dei prodotti a Hornbach. ### **Passaggio 5: controlla e correggi gli errori delle inserzioni** Vai al passaggio **Risultato** e fai clic sulla scheda **Feedback** . Questa pagina mostra tutti i possibili errori di elaborazione presenti nei dati dei prodotti in un determinato momento. #### **Risoluzione degli errori:** 1. In **Descrizione**, fai clic sul nome dell'errore. Verrai portato a una panoramica dei prodotti con quell'errore. 2. In **ID**, fai clic sul numero ID e scorri. Dovresti vedere un riquadro evidenziato in rosso nella sezione in cui si è verificato l'errore. Passa il mouse sul riquadro per maggiori informazioni. 1. Se l'errore è un errore di mappatura, fai clic su **Visualizza in build** per essere indirizzato all'attributo che devi mappare/rimappare, evidenziato in blu. 2. Per maggiori informazioni sull'attributo e sui valori accettati, passa il mouse su . 3. Risolvi l'errore. #### **Errori e soluzioni comuni** #### **mirakl\_unknown\_error\_code** Questo errore indica un gruppo di errori che di solito si verifica quando Mirakl non riesce a identificare l'EAN di un prodotto nel database Mirakl. Questo significa che il prodotto è nuovo per Mirakl oppure che mancano attributi necessari per essere riconosciuto come prodotto. **Soluzione**: 1. **Controlla le categorie:** Nel **Categorie** passaggio, verifica che le categorie dei prodotti siano associate correttamente. Se non lo sono, prenditi un momento per mappatele in modo accurato. Per istruzioni dettagliate su questo processo,[ consulta il nostro articolo sulla mappatura delle categorie](https://helpcenter.channable.com/hc/en-us/articles/360020365580-What-are-categories-in-Channable). 2. **Controlla la mappatura:** Nel **Build** passaggio, controlla i campi mappati e correggi tutto ciò che sembra mappato in modo errato. Puoi usare le regole per creare e compilare nuovi campi. Dopo aver controllato sia le categorie sia gli attributi mappati, fai clic su **Esegui** per eseguire di nuovo il canale. --- # Agent Instructions: 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: ``` GET https://helpcenter.channable.com/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/come-para-configurare-arriba-un-canale-hornbach.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.