> 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-worten.md). # Configurazione di un'Api Worten {% 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 %} Worten è un'azienda digitale, con 240 negozi fisici, focalizzata su Portogallo e Spagna. Vende elettrodomestici, prodotti IT, telecomunicazioni, audio e video ed entertainment; più di recente ha iniziato a offrire anche giocattoli, cosmetici, living & health, sport, libri, casa & decorazione, fai-da-te & giardino e perfino prodotti per animali domestici. {% stepper %} {% step %} ### Aggiungi una nuova connessione Worten L'API di Worten utilizza la piattaforma Mirakl, quindi avrai bisogno di un account Mirakl per iniziare a inviare i tuoi annunci prodotto a Worten. Quando hai un account Mirakl per Worten, vai in "Connessioni > Aggiungi collegamento". Clicca su "+ Aggiungi nuovo collegamento" e vedrai una schermata dove puoi selezionare Worten. Compila l'etichetta per il collegamento, ad esempio Worten. Poi clicca su "Connetti con Worten". Verrai reindirizzato all'ambiente in cui potrai effettuare il login con le credenziali Mirakl. Dopo il login verrai reindirizzato in Channable dove la connessione sarà disponibile. | [![Worten add connection.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/qS7k0idbxNmv3qxOzy3Y/13880231501842)](https://helpcenter.channable.com/hc/article_attachments/13880231501842) | [![Mirakl API - Worten.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/H6DtQzh3lM5W81aJ8gjf/21020603799314)](https://helpcenter.channable.com/hc/article_attachments/21020603799314) | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | {% endstep %} | | {% step %} ### Aggiungi una nuova API Worten in Channable Ora vai alla panoramica delle API nel tuo progetto. Clicca su "+ Aggiungi nuova API", seleziona la connessione Worten appena creata e assegna un nome alla nuova API.
Seleziona il campo che vuoi usare per **ID univoco per articolo** (consigliamo il campo 'id), e il **Lingua** in cui fai le categorizzazioni e imposti gli attributi. Clicca su "Continua" per terminare la creazione della nuova API Worten. {% hint style="warning" %} Importante: Worten offre l'opzione di definire canali di vendita nella nostra API. Se vuoi saperne di più sui canali o su come configurarli, segui i passaggi in [questo articolo](https://helpcenter.channable.com/hc/en-us/articles/11883675662482). Configurare API Worten separate per paesi diversi usando la stessa connessione non funzionerà, perché queste API si sovrascriveranno a vicenda. {% endhint %} {% endstep %} {% step %} ### Crea i tuoi annunci prodotto in Channable Una volta creata l'API Worten, puoi configurare 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 %} {% hint style="warning" %} Rispetto ad altre API Mirakl, Worten non ha un 'title' nella fase di build. Esiste un “Product Name Pt” che Worten impone come obbligatorio e un “Product Name Es” nella sezione Attributi dell'API. La descrizione per entrambe le lingue deve essere compilata nella fase di build. {% endhint %} {% hint style="success" %} **Suggerimento:** Passa il mouse sopra :circle-question: per ulteriori informazioni sui requisiti specifici del campo. {% endhint %} {% stepper %} {% step %} Nella fase di build trovi anche la scheda Sales channels dove puoi inserire le informazioni di prezzo per ciascun canale di vendita separato su Worten. Maggiori informazioni su questi canali di vendita sono disponibili qui: [Configurazione dei canali di vendita Mirakl](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/configurazione-dei-canali-di-vendita-mirakl.md) {% endstep %} {% endstepper %} {% endstep %} {% step %} ### Requisiti GPSR e DSA L'Unione Europea (UE) ha introdotto nuovi [Requisiti GPSR e DSA](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/cosa-devi-fare-para-essere-conforme-al-gpsr-y-al-dsa.md) per le piattaforme online, inclusi i marketplace. Per la tua API Worten in Channable, assicurati di compilare lo specifico per categoria **Attributi per categoria** scheda nel **Build** passaggio: * **Indirizzo email della persona responsabile nell'UE:** Inserisci l'indirizzo email della persona responsabile nell'UE. * **Indirizzo postale della persona responsabile nell'UE:** Fornisci l'indirizzo postale della persona responsabile nell'UE. * **Nome della persona responsabile nell'UE:** Inserisci il nome della persona responsabile nell'UE. {% hint style="info" %} Questi attributi sono obbligatori per rispettare gli obblighi UE legati a GPSR e DSA per i marketplace. {% endhint %} {% endstep %} {% step %} ### Invia i tuoi prodotti a Worten Ci siamo quasi: i tuoi annunci prodotto sono pronti per essere inviati. Se non hai ancora attivato il progetto, vai alle impostazioni del progetto nella barra a sinistra e clicca su "attiva progetto". Poi torna alla panoramica delle API e vai in "Il nome della tua API Worten > Impostazioni", dove attivi l'API selezionando "Attiva API". Dopo aver completato questo passaggio, torna alla panoramica delle API e clicca il pulsante blu "Esegui" per inviare i tuoi annunci prodotto a Worten. {% endstep %} {% step %} ### Controlla i tuoi annunci per errori Dopo aver inviato gli annunci prodotto a Worten, vai nella scheda Risultati della tua API Worten. Imposta il filtro su 'errore'. Ora puoi vedere quali annunci prodotto hanno errori e non sono stati pubblicati. Clicca su un errore specifico per vedere più informazioni sulla causa. Se hai risolto alcuni errori modificando impostazioni o informazioni prodotto, riesegui l'API Worten per vedere i nuovi risultati. {% endstep %} {% endstepper %} ### Buone pratiche {% hint style="info" %} 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. {% endhint %} {% hint style="info" %} ID prodotto del venditore per prodotti singoli/semplici: esistono due attributi chiamati 'SellerArticleId' e 'SellerProductId'. 'SellerProductId' si riferisce all'ID Parent, mentre 'SellerArticleId' si riferisce alle varianti. Per i prodotti singoli entrambi gli attributi devono essere compilati con lo stesso valore. {% endhint %} Per maggiori informazioni sugli errori del marketplace Mirakl, how-to e best practice, consulta [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/configurazione-di-unapi-worten.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.