> 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-vtwonen.md).
# Configurazione di un'Api vtwonen
{% 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 %}
{% stepper %}
{% step %}
### Passo 1: Crea una nuova connessione
* Vai a **\[Il tuo progetto] > Canali**.
* Clicca **+Aggiungi nuova API**. Questo ti reindirizzerà alla pagina delle connessioni della tua azienda.
* Nella pagina delle connessioni, seleziona **+Aggiungi un nuovo collegamento.**
* Cerca il collegamento "vtwonen" sfogliando le pagine e selezionalo cliccandoci sopra.
* Aggiungi un'etichetta.
* Clicca **Crea**. Verrai reindirizzato a vtwonen per il passo successivo.
* Una volta reindirizzato, accedi usando le tue credenziali vtwonen.
Dopo aver effettuato l'accesso con successo, la connessione con vtwonen è pronta. Successivamente verrai riportato alla configurazione dell'API.
{% endstep %}
{% step %}
### Passo 2: Crea l'API
Una volta creata la connessione, devi selezionare la tua nuova connessione vtwonen e configurare le impostazioni dell'API:
* Nella **Nome** campo, inserisci un nome per la tua API.
* Scegli la **ID univoco per articolo** dal menu a tendina. Consigliamo il campo 'id'.
* Seleziona il **Lingua** per la tua API.
* Clicca **Continua** per creare la tua API vtwonen.
{% endstep %}
{% step %}
### Passo 3: Crea le tue inserzioni prodotto
Segui questi passaggi per configurare il tuo canale.
{% stepper %}
{% step %}
#### Classifica i tuoi prodotti
Per impostare i dati dei prodotti, assegna categorie ai tuoi prodotti.
* Categorizzazione prodotti tramite AI: Assegna automaticamente le categorie dei prodotti tramite il nostro algoritmo.
* Categorizzazione manuale: Assegna manualmente le categorie dei prodotti con regole personalizzate. Puoi creare filtri dettagliati per mappare ogni prodotto nella categoria corretta.
* Articoli non categorizzati: prodotti che devono ancora essere revisionati e categorizzati
[Per saperne di più sulla categorizzazione per i marketplace](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplace-fase-di-categorizzazione.md)
{% endstep %}
{% step %}
#### Imposta le regole
Le regole ti aiutano a ottimizzare rapidamente i dati dei prodotti per il marketplace su cui vuoi vendere.
* Modelli di regole: Regole comunemente usate che puoi adattare al tuo caso d'uso.
* Configurazione delle regole: Imposta regole per affinare i dati dei prodotti. Questo può includere filtrare, modificare o arricchire i campi 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/marketplace-fase-delle-regole.md)
{% endstep %}
{% step %}
#### Costruisci le tue inserzioni
Il **Build** passo è dove configuri i tuoi annunci prodotto per soddisfare i requisiti del marketplace. È un passaggio essenziale per mettere i tuoi prodotti online ed evitare errori.
Campi obbligatori e opzionali:
* **Campi obbligatori** : Richiesto per pubblicare i tuoi prodotti su questo marketplace
* **Consigliato** : Consigliato per evitare errori
* **Facoltativo** : Non richiesto per la pubblicazione
Attributi condivisi
* Gli attributi condivisi sono i campi comuni che si applicano ai tuoi prodotti, come EAN, prezzi e titoli. Questo passaggio garantisce uniformità nelle informazioni di base across i tuoi annunci.
* Usa valori statici o dinamici:
* Valori statici: valori fissi che non cambiano (es. nome del brand, produttore)
* Valori dinamici: campi che cambiano automaticamente in base ai dati collegati (es. stock, prezzi)
Attributi specifici per categoria
* Gli attributi specifici per categoria sono campi che si applicano in modo specifico alla categoria dei tuoi prodotti. Questo passaggio aiuta a perfezionare le tue inserzioni per soddisfare i requisiti di categoria del marketplace.
* Compila gli attributi specifici per la categoria selezionata (es. taglia per l'abbigliamento o dimensioni per i mobili).
{% 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/marketplace-passaggio-di-creazione.md)
{% endstep %}
{% step %}
#### Controlla la qualità della tua configurazione
Il **Qualità** Questo passo fornisce feedback sul tuo canale prima di attivarlo. Evidenzia errori obbligatori e opzionali per assicurarsi che i dati dei tuoi prodotti rispettino i requisiti per la pubblicazione sul marketplace.
* Risolvi gli errori, dando priorità prima a quelli obbligatori.
Azioni:
* **Visualizza articoli**: Visualizza i prodotti con problemi specifici.
* **Per maggiori informazioni sull’attributo e sui valori accettati, passa il cursore su .**: Reindirizza al **Build** passo per mappare le informazioni mancanti.
* **Imposta categorie**: Porta a **Passo categorie** passo per categorizzare gli articoli.
* **Mostra sorgente**: Disponibile per i campi ID. Porta a **Impostazioni** passo.
[Scopri di più sul passo Qualità per i marketplace](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplace-passaggio-qualita.md)
{% endstep %}
{% step %}
#### Anteprima prima dell'attivazione
Il **Anteprima** Il passo mostra gli attributi che hai mappato nel **Build** passo, aiutandoti a verificare che tutto sia configurato correttamente fornendo una panoramica dei tuoi prodotti e degli eventuali errori.
Filtraggio:
* Filtra per errore: clicca il **tutti** menu a tendina e seleziona se vuoi filtrare per mostrare solo i prodotti con errori, o i prodotti con un errore specifico.
* Filtra per categoria: clicca il **tutte le categorie** menu a tendina e seleziona la categoria per cui vuoi filtrare.
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 passo Anteprima per i marketplace](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplace-passaggio-vista-previa.md)
{% endstep %}
{% endstepper %}
{% endstep %}
{% step %}
### Requisiti aggiuntivi per vtwonen
Questi requisiti di attributi sono specifici per vtwonen e si applicano agli attributi nella **Build** passo.
scheda Attributi condivisi
* Classe di spedizione (classe logistica): le classi logistiche determinano i rispettivi costi di spedizione per i tuoi articoli. Inserisci la classe logistica del tuo prodotto.
* Tempo di evasione della spedizione: il tempo di evasione indica il periodo necessario fino alla consegna del pacco al corriere. Indica il tempo di spedizione in giorni.
Requisiti del titolo
I titoli dei prodotti dovrebbero essere composti dai seguenti elementi:
| | |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Marca** | Il nome del brand così come è registrato |
| **Tipo di prodotto** | La categoria del prodotto, per esempio "sofa". Deve essere scritta in minuscolo |
| **Nome della serie/prodotto** | La serie o il nome del prodotto che aiuta a identificare la variante del prodotto. Ogni parola deve essere scritta con la lettera iniziale maiuscola |
| **Attributi** | Le caratteristiche distintive del prodotto, per esempio colore, dimensioni o materiale |
* Struttura: Brand Tipo di prodotto Nome - Attributi
* Esempio: lampada a sospensione vtwonen Titan - nero.
Descrizione del prodotto
Le descrizioni dei prodotti per la tua API vtwonen dovrebbero:
* rivolgersi al cliente (“tu” e “il tuo”)
* essere scritte con un tono amichevole, utile e rispettoso
* evitare gerghi o termini tecnici, se non rilevanti per il pubblico di riferimento
* descrivere le caratteristiche del prodotto e i benefici e l'esperienza d'uso
* usare parole chiave pertinenti
* non contenere abbreviazioni
Le descrizioni dei prodotti dovrebbero consistere di quanto segue:
| | |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Descrizione breve** | Una panoramica del prodotto per mettere in evidenza le caratteristiche più importanti. HTML non consentito |
| **Punti elenco** | Le caratteristiche chiave e i benefici del prodotto. Minimo 3 e massimo 5 punti |
| **Descrizione lunga** | Informazioni dettagliate sulle caratteristiche, specifiche, materiali e modalità d'uso del prodotto. Anche consigli di styling e manutenzione. HTML consentito (grassetto e liste) |
Requisiti delle immagini
| | |
| ----------------------- | --------------------------------------------- |
| **Risoluzione minima** | 800 x 800 px |
| **Risoluzione massima** | 4472 x 4472 px |
| **Formati supportati** | JPEG, PNG, WebP, GIF |
| **Stile** | Nessuna filigrana, logo o componenti testuali |
Requisiti video
| | |
| ---------------------- | --------------------------------------------------------------------- |
| **Durata** | Tra 30 sec. e 2 min |
| **Risoluzione** | 1080p o superiore |
| **Formati supportati** | .mp4, .mov, .avi, .flv |
| **Stile** | Niente bordi, schizzi, filigrane, loghi,
etichette o prezzi
|
| {% endstep %} | |
{% step %}
### 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.
* ID prodotto del venditore per prodotti singoli/semplici: Esistono due attributi chiamati rispettivamente 'SellerArticleId' e 'SellerProductId'. 'SellerProductId' si riferisce all'ID Parent, mentre 'SellerArticleId' si riferisce agli articoli 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](https://helpcenter.channable.com/hc/en-us/articles/360012678720-Mirakl-guide-settings-and-solutions).
{% endstep %}
{% step %}
### Passo 4: Invia le tue inserzioni prodotto a vtwonen
Una volta che le tue inserzioni prodotto sono pronte, devi inviarle a vtwonen:
* Se non hai attivato il progetto, vai su **\[Il tuo progetto] > Impostazioni** e clicca **Attiva progetto**.
* In **\[Il tuo progetto] > Api**, vai su **\[La tua vtwonenAPI] > Impostazioni**.
* Clicca **Attiva API**.
* Una volta attivata l'Api, torna a **Api**.
* Clicca su **Esegui** pulsante nella colonna 'Status' per inviare le tue inserzioni prodotto a vtwonen.
{% endstep %}
{% step %}
### Passo 5: Controlla le tue inserzioni prodotto per errori
* Per controllare gli errori, vai alla **Risultato > scheda Errori**. Qui c'è l'elenco delle inserzioni prodotto che contengono errori.
* Clicca sull'errore specifico per visualizzare maggiori informazioni su cosa causa l'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 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-vtwonen.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.