> 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-le-bhv-marais.md).

# Configurazione di un'Api Le BHV Marais

{% 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.&#x20;
{% endhint %}

{% hint style="info" %}
**Nota:** I codici EAN, il titolo e la descrizione sono obbligatori per Le BHV Marais. Assicurati che rispettino i requisiti della piattaforma; altrimenti non sarà possibile creare inserzioni per i tuoi prodotti.
{% endhint %}

Le BHV Marais offre un'ampia gamma di prodotti in categorie come moda, bellezza, arredamento e gastronomia. La loro API è basata su una piattaforma Mirakl. Assicurati di avere un account Mirakl attivo per iniziare a integrare e inviare le tue inserzioni prodotto a Le BHV Marais.

{% stepper %}
{% step %}

### Aggiungi una nuova connessione Le BHV Marais

Se hai un account Mirakl Le BHV Marais, vai su Connessioni > Aggiungi collegamento. Clicca su “+ Aggiungi nuovo collegamento” per visualizzare la schermata dove puoi scegliere Le BHV Marais.

Inserisci l'etichetta per la tua connessione, ad esempio Le BHV Marais. Poi clicca su "Connetti con Le BHV Marais". Verrai reindirizzato all'ambiente dove potrai effettuare il login con le credenziali Mirakl. Dopo il login verrai reindirizzato su Channable, dove la connessione sarà disponibile.

| ![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/B6Z6qg1UbV8XYZNOlLut/18689582208658) | ![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/qUV4p1uEweDOQxM5eQT4/18692518536722) |
| ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| {% endstep %}                                                                                           |                                                                                                         |

{% step %}

### Aggiungi una nuova API Le BHV Marais in Channable

Ora vai alla panoramica Api nel tuo progetto. Clicca su Aggiungi nuova Api, seleziona la connessione Le BHV Marais che hai appena creato e assegna un nome alla nuova Api.

Seleziona il campo che vuoi usare come ID univoco per articolo (consigliamo il campo 'id') e la lingua per le categorie (attualmente disponibili francese e inglese GB).

Clicca su “Continua” per completare la creazione della nuova Api Le BHV Marais.
{% endstep %}

{% step %}

### Crea i tuoi annunci prodotto in Channable

Una volta creata l'Api Le BHV Marais, configura i dati prodotto seguendo i passaggi Api qui sotto.

{% 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.&#x20;
{% endstep %}

{% step %}

#### Build - Attributi condivisi

Gli Attributi condivisi sono attributi che si applicano a tutti i tuoi Ítems, come prezzo y stock.&#x20;

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 %}

\
![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/1J6LXGV3CDKgKL7KsHls/18689857763858)

* Classe di spedizione: Le classi logistiche per Le BHV Marais sono disponibili come valori statici nel campo “Shipping class”. Le classi di spedizione sono configurate per ogni venditore con il tuo Onboarding Manager di Le BHV Marais.
* Codice evento: Un codice univoco usato per identificare le offerte relative a promozioni commerciali specifiche. Il tuo Account Manager presso Le BHV Marais fornirà questo codice prima di ogni evento promozionale; inseriscilo nell'attributo Event code.
* Contributo copia privata: In Francia, i venditori devono indicare l'importo della tassa "copie-privée" in euro per gli articoli applicabili (ad es. supporti vergini).
* Eco-contributi: Se operi in Francia, aggiungi gli eco-contributi alle tue offerte. Consulta l'elenco delle categorie EPR disponibili in [questo articolo](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/configurazione-delle-eco-contribuzioni-mirakl.md).
* Canale vendite private: Per usare prezzi differenti per i clienti fedeltà sul canale 'vp', è abilitata la tariffazione specifica per canale (Private Sales Channel). Per abilitarla, segui i passaggi in [questo articolo](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/marketplace-mirakl/configurazione-dei-canali-di-vendita-mirakl.md).\
  [![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/c9FoySzqHCbyDmAHwdmx/18690051403922)](https://helpcenter.channable.com/hc/article_attachments/18690051403922)

{% 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 Le BHV Marais in Channable, assicurati di compilare i [attributi di categoria](/list-advertise/list-and-advertise-it/vendi-sui-marketplace/inizia-con-i-marketplace/marketplace-passaggio-di-creazione.md) nel passaggio Build&#x20;

* GPSR - Contact du Fabricant: Inserisci il numero di telefono del produttore.
* GPSR - Personne Responsable Ue: Inserisci il nome della persona responsabile nell'UE.
  {% endstep %}

{% step %}

### Invia i tuoi dati prodotto a Le BHV Marais

Attiva il progetto andando su Impostazioni > Impostazioni progetto e cliccando Attiva progetto. Poi torna alla panoramica Canali e apri “Il nome della tua Api Le BHV Marais > Impostazioni” e attiva l'Api selezionando “Attiva Api”.

Dopo l'attivazione, clicca sul pulsante “Esegui” per inviare le tue inserzioni prodotto a Le BHV Marais.
{% endstep %}

{% step %}

### Controlla i tuoi annunci per errori

Dopo aver inviato le tue inserzioni prodotto a Le BHV Marais, vai alla scheda Anteprima della tua Api Le BHV Marais. Filtra per "error" per vedere quali inserzioni hanno errori e non sono state pubblicate. Clicca su un errore specifico per vedere più informazioni sulla causa.
{% endstep %}
{% endstepper %}

<details>

<summary>Buone pratiche</summary>

* 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: Ci sono due attributi chiamati '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).

</details>


---

# 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-le-bhv-marais.md?ask=<question>&goal=<endgoal>
```

`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.
