> 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-fonq.md).
# Configurazione di un'Api fonQ
{% hint style="warning" %}
Nota: Questo articolo presume che tu abbia già pubblicizzato i tuoi prodotti su fonQ. Se sei nuovo alla pubblicità su fonQ, assicurati di sapere [come aggiungere codici EAN sconosciuti a fonQ](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/guida-mirakl-impostazioni-y-soluzioni.md). I codici EAN sono obbligatori per fonQ. Assicurati di avere codici EAN validi per tutti i tuoi prodotti, altrimenti non sarà possibile creare inserzioni per i tuoi prodotti.
{% endhint %}
{% 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 %}
Puoi saltare ai passaggi dettagliati qui sotto:
{% stepper %}
{% step %}
### Passo 1: Aggiungi una nuova connessione fonQ
L’API di fonQ utilizza la piattaforma Mirakl, quindi avrai bisogno di un account Mirakl per iniziare a inviare le tue inserzioni prodotto a fonQ.
Quando hai un account Mirakl fonQ, vai su Connessioni > Aggiungi collegamento. Clicca su "+ Aggiungi nuovo collegamento" e seleziona fonQ. Compila l’etichetta per la tua connessione (per esempio: fonQ). Poi clicca su "Connetti con fonQ". Verrai reindirizzato all’ambiente dove puoi effettuare il login con le credenziali Mirakl. Dopo il login verrai riportato in Channable dove la connessione sarà disponibile.
| | |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [](https://helpcenter.channable.com/hc/article_attachments/7742486167570) | [](https://helpcenter.channable.com/hc/article_attachments/7742427569426) |
| {% endstep %} | |
{% step %}
### Passo 2: Crea una nuova API fonQ in Channable
Vai alla panoramica delle API nel tuo progetto e clicca "+ Aggiungi nuova API". Seleziona la connessione fonQ che hai creato e assegna un nome alla nuova API.
[](https://helpcenter.channable.com/hc/article_attachments/19237523625874)
Seleziona il campo che vuoi usare come ID univoco per articolo (consigliamo il campo 'id') e il Paese in cui vuoi vendere. Puoi anche aggiungere qui un gruppo di Regole Master se lo desideri. Clicca Continua per completare la creazione della nuova API fonQ.
Differenza tra un'Offer e un Product nell’API fonQ:
* Offer: Un’offerta include solo i campi della fase Build dell’API.
* Product: Un prodotto contiene più informazioni rispetto a un’offerta (come la categorizzazione e gli attributi compilati) ed è necessario quando gli articoli sono sconosciuti a fonQ.
{% hint style="info" %}
Nota: fonQ NL accetta SOLO submission di Product per negozi con sede nei Paesi Bassi. Se il tuo negozio non è un negozio NL, dovresti inviare offer non categorizzando i tuoi dati.
{% endhint %}
Se i tuoi prodotti non sono conosciuti da fonQ e non hai un negozio NL, dovrai creare un negozio NL e configurare un’API Product per prodotti sconosciuti (categorizarli e inviarli al negozio NL). Una volta accettati, puoi configurare una seconda API per creare offer BE, ma questo potrebbe anche creare offerte nello store NL; per evitarlo potresti dover cancellare l’API NL una volta che i prodotti sono stati accettati.
{% endstep %}
{% step %}
### Passo 3: Crea le tue inserzioni prodotto in Channable
Dopo aver creato l’API fonQ puoi impostare i dati dei prodotti seguendo i passaggi dell’API:
{% stepper %}
{% step %}
#### Passo categorie
Ti consigliamo di provare prima a inviare i prodotti senza categorizzarli. Se fonQ conosce già i codici EAN dei tuoi prodotti, non sarà necessario fare questo passaggio. Se i prodotti non sono ancora conosciuti, vedrai il seguente errore nella fase Anteprima dell’API: ["mirakl\_unknown\_error\_code"](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/guida-mirakl-impostazioni-y-soluzioni.md).
{% endstep %}
{% step %}
#### Regole
Crea [diverse regole](/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 prodotto.
{% endstep %}
{% step %}
#### Build
Qui trovi il nostro modello preimpostato per le inserzioni prodotto. Compilalo cliccando su un campo e selezionando il valore con cui vuoi riempirlo (per esempio, imposta il campo Title per mostrare il titolo del prodotto). Quando hai finito, clicca Salva in fondo allo schermo.
{% hint style="success" %}
**Suggerimento:** Passa il mouse sopra :circle-question: per ulteriori informazioni sui requisiti specifici del campo.
{% endhint %}
[](https://helpcenter.channable.com/hc/article_attachments/15230232201106)
{% 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 fonQ in Channable, assicurati di compilare la scheda attributi per categoria nella fase Build:
* Adres Marktdeelnemer: Fornisci l’indirizzo completo del produttore o importatore.
* Email Marktdeelnemer: Inserisci l’indirizzo email del produttore o importatore.
* Naam Marktdeelnemer: Fornisci il nome del produttore o importatore.
* Telefoon Marktdeelnemer: Fornisci un numero di telefono valido del produttore o importatore.
{% endstep %}
{% step %}
### Passo 4: Invia i tuoi dati prodotto a fonQ
Se non hai attivato il progetto, vai su Impostazioni progetto nel menu a sinistra e clicca Attiva progetto. Poi torna alla panoramica Canali, apri "Il nome della tua API fonQ > Impostazioni" e attiva l’API selezionando "Attiva API". Dopo l’attivazione, clicca il pulsante blu "Esegui" per inviare le tue inserzioni prodotto a fonQ.
{% endstep %}
{% step %}
### Passo 5: Controlla le tue inserzioni prodotto per errori
Dopo aver inviato le tue inserzioni a fonQ, vai alla scheda Anteprima della tua API fonQ e clicca su Errori. Potrai vedere quali inserzioni hanno errori e non sono state create. Clicca su un errore specifico per vedere più informazioni.
{% endstep %}
{% endstepper %}
### Buone pratiche
Clicca per espandere le best practice
* 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 '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.
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-fonq.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.