> 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/winkelstraat.nl/configurazione-arriba-di-unapi-winkelstraat.nl.md). # Configurazione arriba di un'Api Winkelstraat.nl Winkelstraat.nl è una piattaforma online che offre un'ampia gamma di moda di lusso e di designer proveniente da oltre 600 brand di fascia alta. Propone articoli esclusivi da boutique premium nei Paesi Bassi e in Belgio. In questo articolo spieghiamo come configurare un'API di Winkelstraat.nl in Channable. {% stepper %} {% step %} ### Preparazione * Richiedi le credenziali API di Winkelstraat.nl: per Winkelstraat ti servono un Client ID e una chiave Secret per creare una connessione API valida. Per ottenere queste credenziali, richiedile inviando una e-mail a . Quando avrai ricevuto le credenziali da Winkelstraat, potrai creare la connessione API in Channable. {% endstep %} {% step %} ### Crea una nuova connessione Per creare una nuova connessione a Winkelstraat.nl, segui i passaggi seguenti: * Vai alla pagina API all'interno del tuo progetto e clicca "+Aggiungi nuova API". Verrai reindirizzato alla pagina delle connessioni della tua azienda. ![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/qkOsnxzmBjmUExvSNvPB/20018659142034) * Nella pagina delle connessioni, seleziona "+Aggiungi un nuovo collegamento". * Cerca la connessione 'Winkelstraat.nl'. Dopo averla trovata, fornisci le seguenti informazioni: * Etichetta * Client ID * Secret * Clicca "Connetti con Winkelstraat.nl" — la connessione verrà quindi convalidata e creata. {% endstep %} {% step %} ### Crea l'Api Scegli la tua nuova connessione Winkelstraat.nl e continua a configurare la tua API. * Configura le impostazioni dell'Api: * Assegna un nome alla tua Api * Scegli l'ID univoco per articolo (consigliato: il campo 'id') * Seleziona la lingua della tua Api ![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/fq0AfyO3uUYY8cug9hV5/20018659145746) * Clicca "Continua" per creare la nuova API di Winkelstraat.nl. {% endstep %} {% step %} ### Crea i tuoi annunci prodotto Segui questi sotto-passaggi sequenziali per preparare e mappare i dati dei prodotti per Winkelstraat.nl. #### Classifica i tuoi prodotti Assegna le categorie ai tuoi prodotti usando una delle seguenti opzioni: * Categorizzazione prodotti con AI: assegna automaticamente le categorie dei prodotti tramite un algoritmo. * Categorizzazione manuale: assegna manualmente le categorie usando regole e filtri personalizzati. * Articoli non categorizzati: prodotti che richiedono ancora revisione e categorizzazione. [Per saperne di più sulla categorizzazione per i marketplace](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplaces-fase-di-categorizzazione.md) #### Imposta le regole Le regole aiutano a perfezionare e ottimizzare i dati dei prodotti per il marketplace. * Modelli di regole: regole predefinite che puoi adattare. * Configurazione delle regole: filtra, modifica o migliora i campi dati per soddisfare i requisiti del marketplace. [Leggi di più sull’utilizzo delle regole per i marketplace](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplaces-fase-delle-regole.md) #### Costruisci le tue inserzioni Il passaggio Build è dove configuri i tuoi annunci per soddisfare i requisiti del marketplace. * Campi obbligatori: Richiesti per inserire i tuoi prodotti su questo marketplace. * Consigliato: Raccomandato per evitare errori. * Facoltativo: Non richiesto per la pubblicazione. Attributi condivisi: campi comuni tra i prodotti (es. EAN, prezzi, titoli). * Usa valori statici o dinamici: * Valori statici: valori fissi (es. brand). * Valori dinamici: cambiano in base ai dati collegati (es. stock, prezzi). Attributi specifici per categoria: campi che si applicano solo a una determinata categoria (es. taglia per abbigliamento). Compila gli attributi specifici per la categoria selezionata. {% hint style="success" %} **Suggerimento:** Clicca **Auto-map fields** per mappare automaticamente usando le informazioni provenienti dagli altri tuoi canali o da altre configurazioni simili. [Scopri di più](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/mappatura-automatica-dei-campi-per-marketplace-api.md). {% endhint %} [Scopri di più sul passo Build per i marketplace](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplaces-fase-di-creazione.md) #### Controlla la qualità della tua configurazione Il passaggio Quality fornisce feedback prima dell'attivazione. Evidenzia le problematiche obbligatorie e quelle opzionali. * Risolvi gli errori, dando priorità prima a quelli obbligatori. Azioni disponibili: * Visualizza articoli: Vedi i prodotti con problemi specifici. * Visualizza in build: Reindirizza al passaggio Build per mappare le informazioni mancanti. * Imposta categorie: Vai al passaggio Categorie per categorizzare gli articoli. * Mostra sorgente: disponibile per i campi ID, reindirizza a Impostazioni. [Scopri di più sul passaggio Quality](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplaces-fase-di-qualita.md) #### Anteprima prima dell'attivazione Il passaggio Preview mostra gli attributi mappati in Build e indica gli errori potenziali. Filtraggio: * Filtra per errore: usa il menu a tendina Tutti per mostrare solo i prodotti con errori o tipi di errore specifici. * Filtra per categoria: usa il menu a tendina Tutte le categorie per filtrare per categoria. Prima di continuare: * Controlla gli attributi condivisi: Assicurati che tutti gli attributi condivisi obbligatori siano compilati. * Controlla gli attributi specifici della categoria: Assicurati che tutti gli attributi obbligatori della categoria siano compilati. * Controlla la presenza di errori: Correggi eventuali campi evidenziati in rosso. [Scopri di più sul passaggio Preview](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplaces-fase-di-qualita.md) {% endstep %} {% step %} ### Requisiti aggiuntivi per Winkelstraat.nl Le informazioni seguenti sono specifiche per Winkelstraat.nl. #### Scheda articolo * L'ID del gruppo di articoli è obbligatorio: solitamente chiamato 'item\_group\_id' o 'parent\_id'. * EAN non obbligatorio: l'EAN non è attualmente richiesto per l'accettazione degli articoli, ma Winkelstraat lo consiglia fortemente. #### Scheda Attributi per categoria * Immagini e descrizione: questi campi sono obbligatori e devono essere compilati nella scheda Attributi per categoria. #### Informazioni aggiuntive * Rimozione dei prodotti dalla piattaforma: non è possibile rimuovere completamente i prodotti dal tuo account Winkelstraat. Invece, imposta lo stock del prodotto a '0' per disattivarlo sulla piattaforma. Per eliminare i tuoi prodotti, inviali nuovamente con lo stock impostato a '0'. {% endstep %} {% step %} ### Invia i tuoi annunci di prodotto a Winkelstraat.nl * Se il tuo progetto non è attivato, vai alle Impostazioni progetto (menu a sinistra) e clicca "Attiva progetto". * Nella panoramica delle API, apri \[La tua API di Winkelstraat.nl] > Impostazioni e clicca "Attiva API". * Torna alla panoramica API e clicca il pulsante blu "Esegui ora" per inviare i tuoi annunci di prodotto a Winkelstraat.nl. {% endstep %} {% step %} ### Controlla i tuoi annunci per errori * Vai alla pagina Risultato dell'API > scheda Feedback per vedere quali annunci di prodotto hanno errori. * Clicca su un elemento specifico per vedere informazioni dettagliate sulla causa dell'errore. {% endstep %} {% endstepper %} --- # 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/winkelstraat.nl/configurazione-arriba-di-unapi-winkelstraat.nl.md?ask=&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.