> 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/configurazione-di-unapi-manor.md). # Configurazione di un'Api Manor Manor (Mirakl) — Guida di configurazione {% hint style="info" %} **Aggiornamento dell’interfaccia utente:** C’è una nuova pagina di selezione del canale e una Panoramica per **Feed** y **Marketplace** (in precedenza chiamati API)! Alcune immagini e istruzioni potrebbero non essere aggiornate. {% endhint %} {% hint style="warning" %} **Importante:** I codici EAN sono obbligatori per Manor. Assicurati di avere codici EAN validi per tutti i tuoi prodotti, altrimenti non sarà possibile creare annunci prodotto per i tuoi articoli. {% endhint %} {% stepper %} {% step %} ### Aggiungi una nuova connessione Manor L’API Manor utilizza la piattaforma Mirakl, quindi avrai bisogno di un account Mirakl per iniziare a inviare i tuoi annunci prodotto a Manor. Quando hai un account Mirakl Manor, vai a "Connessioni > Aggiungi collegamento". Clicca su "+ Aggiungi nuovo collegamento" e vedrai una schermata dove puoi selezionare Manor. Compila l’etichetta per la tua connessione (per esempio: Manor), poi clicca su "Connetti con Manor". Verrai reindirizzato all’ambiente dove potrai effettuare il login con le credenziali Mirakl. Dopo il login verrai riportato a Channable dove la connessione sarà disponibile. | | | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [![New\_connection\_-\_Manor.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/jtC8nX6XnyAga9Uzq3TV/7647187429650)](https://helpcenter.channable.com/hc/article_attachments/7647187429650) | [![Sing\_in\_Mirakl\_-\_Oauth.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/KNSGpmWuCtrYOnKSucnx/7647182828946)](https://helpcenter.channable.com/hc/article_attachments/7647182828946) | | {% endstep %} | | {% step %} ### Crea una nuova API Manor in Channable Vai alla panoramica delle Api nel tuo progetto. Clicca su "+ Aggiungi nuova Api", seleziona la connessione Manor appena creata e assegna un nome alla nuova Api. [![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/BAkCvcSk5HTHSJQsA6JL/19237568656018)](https://helpcenter.channable.com/hc/article_attachments/19237568656018) Seleziona il campo che vuoi usare per **ID univoco per articolo** (consigliamo il campo 'id), e il **Lingua**. Dovrai selezionare la lingua che vuoi usare per l’Api poiché in Svizzera ci sono 3 lingue ufficiali tra cui scegliere (tedesco, francese e italiano). Dopo aver scelto un nome, clicca sul pulsante "Continua" per creare la tua nuova API Manor. {% endstep %} {% step %} ### Crea i tuoi annunci prodotto in Channable Una volta creata l’Api Manor, configura i dati prodotto seguendo i passaggi dell’Api. {% stepper %} {% step %} #### Categorie Per creare le tue inserzioni di prodotto, i tuoi prodotti devono avere una categoria. Aggiungi categorie ai tuoi prodotti usando la [Genera categorie](/manage-improve-product-data/manage-product-and-improve-data-it/categorizza-i-prodotti/crear-categorie-di-prodotto/usar-la-funzione-genera-categorie.md) o [Crear nuove categorie da zero](/manage-improve-product-data/manage-product-and-improve-data-it/categorizza-i-prodotti/crear-categorie-di-prodotto/aggiungi-categorie-in-modo-manuale.md). {% endstep %} {% step %} #### Regole Crear [regole diverse](/manage-improve-product-data/manage-product-and-improve-data-it/regole-modifica-in-blocco-e-arricchisci/utilizzo-delle-regole.md) per Ottimizzare le tue inserzioni di prodotto. {% endstep %} {% step %} #### Build - Attributi condivisi Gli Attributi condivisi sono attributi che si applicano a tutti i tuoi Ítems, come prezzo y stock. 1. Inizia a usare Map fields per associare i campi agli attributi indicati come obbligatori dal marketplace. 2. Controlla gli attributi rimanenti e usa Map fields per associare i campi a quelli rilevanti per la tua attività. 3. Clicca **Salva**. {% endstep %} {% step %} #### Build - Attributi per categoria Gli attributi di categoria sono attributi che si applicano agli Ítems di categorie specifiche, come le informazioni sulla batteria per gli Ítems elettronici, o le informazioni sulle taglie per l’abbigliamento. 1. Inizia a usare Map fields per associare i campi agli attributi indicati come obbligatori dal marketplace. 2. Controlla gli attributi rimanenti e usa Map fields per associare i campi a quelli rilevanti per la tua attività. 3. Clicca **Salva**. {% endstep %} {% endstepper %} {% endstep %} {% step %} ### Invia i tuoi dati prodotto a Manor Se non hai attivato il progetto, vai alle impostazioni del progetto sul lato sinistro dello schermo e clicca su 'attiva progetto'. Poi torna al Canale e vai al tuo canale Manor > Impostazioni, e attiva il canale selezionando "Attiva Api". Da lì, clicca **Esegui** per inviare i tuoi annunci. {% endstep %} {% step %} ### Controlla i tuoi annunci per errori Dopo aver inviato i tuoi annunci prodotto a Manor, vai alla scheda Anteprima della tua Api Manor. Clicca/filtra su 'errore'. Potrai vedere quali annunci prodotto hanno errori e non sono stati creati su Manor. Clicca su un errore specifico per vedere più informazioni. {% endstep %} {% endstepper %} ### Buone pratiche * Aggiunta di più valori di attributo: quando aggiungi più valori in un campo attributo per i marketplace Mirakl, separa ogni valore con il simbolo pipe "|" per garantire la corretta individuazione e gestione. * Seller's Product ID per prodotti singoli/semplici: ci sono due attributi chiamati rispettivamente 'SellerArticleId' e 'SellerProductId'. 'SellerProductId' si riferisce all’ID del Parent, mentre 'SellerArticleId' si riferisce alle varianti. Per i prodotti singoli, entrambi gli attributi devono essere compilati con lo stesso valore. Per maggiori informazioni sugli errori del marketplace Mirakl, how-to e best practice, consulta [la nostra guida dedicata](/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/configurazione-di-unapi-manor.md?ask=&goal= ``` `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.