> 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/bol/pubblica-items-su-bol/come-para-configurare-arriba-un-canale-bol/setting-up-product-listing-variant-families-for-bol.md).

# Raggruppa le varianti di prodotto in famiglie per bol

Scopri come configurare arriba il tuo canale bol, Para che bol raggruppi le varianti di prodotto, come le dimensioni o i colori, in un'unica pagina prodotto.

On bol, una famiglia di prodotti è un gruppo di varianti de lo stesso prodotto. Per esempio, una T-shirt en quattro taglie y tre colori può essere una sola famiglia, così i clienti scelgono una taglia y un colore en una singola pagina prodotto invece de cercare ogni variante.

En Pedido Para configurare il tuo canale bol così che le varianti siano raggruppate en famiglie su bol, segui i passaggi qui sotto.

### Prima di iniziare

**Ti servirà**

* Un canale bol
* Un EAN univoco per ogni variante&#x20;
* Un Campo en i tuoi dati prodotto con lo stesso valore per ogni variante en una famiglia (ad es. `ítem_group_id` o `ID genitore` )

**Buono a sapersi**

* Una famiglia può avere arriba Para 70 prodotti.&#x20;
  * si invii di più, bol non restituisce un errore, ma non pubblica tutti de loro.
* Bol non invia Feedback sulle famiglie, quindi i problemi di raggruppamento non vengono mostrati en **Risultato** passaggio.&#x20;
  * Para risolvere i problemi, controlla le tue famiglie en il tuo Account Vendedor bol.
* I valori sono sensibili alle maiuscole e minuscole. si una variante ha `Grigio` y un altro ha `grigio`, bol li considera valori diversi y potrebbe dividere la famiglia.
* Para rimuovere una variante de una famiglia, usar il tuo bol Vendedor Account. Non puoi farlo en Channable.

***

{% stepper %}
{% step %}

### Controlla che le tue varianti siano idonee

Bol raggruppa le varianti in una famiglia solo quando tutti i seguenti criteri de validità sono soddisfatti:

* Sono en la stessa Categoria di prodotto. Bol assegna la Categoria in base all'EAN.
* Hanno lo stesso valore per `Marchio`. Per libri, musica y film, bol utilizza `Autore` o `Artista` invece.
* Hanno valori diversi per le caratteristiche distintive della Categoria. Le caratteristiche distintive sono uno o due attributi che bol utilizza per distinguere le varianti en una Categoria, come `Taglia` y `Colore` per l'abbigliamento o `Numero di scarpa` per le scarpe.
  {% endstep %}

{% step %}

### Mappa l'ID della variante

Bol raggruppa le varianti che condividono lo stesso ID della variante di prodotto (bol lo chiama codice famiglia).

1. En il **Build** passo, vai Para la **Attributi per categoria** scheda.
2. Selecciona la Categoria a cui appartengono le tue varianti.
3. Verifica che gli attributi delle caratteristiche distintive, come **Taglia** o **Colore**, siano mappati Para campi che hanno un valore per ogni variante.
4. Verifica che **Marchio** sia mappato Para un campo con lo stesso valore per ogni variante della famiglia.
5. Per **ID della variante di prodotto**, seleziona il campo che ha lo stesso valore per ogni variante en una famiglia, come `ítem_group_id`.
6. Fai clic **Salva**.
7. Ripeti questi passaggi per ogni Categoria.

{% hint style="info" %}
Para velocizzare arriba il processo, fai clic **Mappatura automatica dei campi** dopo aver configurato una categoria. Questo mapperà gli attributi non mappati in base alle tue mappature precedenti y configurazioni simili.
{% endhint %}

Ogni famiglia ha bisogno del proprio ID. si due prodotti diversi condividono un ID, bol può raggrupparli nella stessa famiglia.
{% endstep %}

{% step %}

### Esegui il tuo canale y controlla le tue famiglie

1. en **\[il tuo canale bol]**, fai clic su **Esegui**.
2. Attendi che bol Para elabori i tuoi annunci. Questo può tomar un po' di tiempo.
3. en il tuo account Vendedor bol, vai Para **I miei articoli** y apri un prodotto de la famiglia.
4. Verifica che tutti i suoi varianti compaiano nella pagina prodotto.

Per ulteriori informazioni su come funziona l'aggiunta delle famiglie Para Bol.com dal lato di bol, leggi [il loro articolo](https://developers.bol.com/deliver-product-variants-families-in-bulk/). Contiene anche una tabella di esempio y un Q\&A.

#### Se le tue varianti non sono raggruppate <a href="#if-your-variants-arent-grouped" id="if-your-variants-arent-grouped"></a>

| Ciò che vedi                                          | Probabile causa                                                                                         | Risoluzione del problema                                                                                                                                                                                                                                         |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Non viene creata nessuna famiglia                     | **ID della variante di prodotto** non è mappato, o la Categoria non ha caratteristiche distintive       | <p>Assicurati <strong>ID della variante di prodotto</strong> è stato mappato per quella Categoria, y il Campo di progetto ha valori per quegli Ítems. </p><p></p><p>Se la categoria non ha caratteristiche distintive, bol non può creare famiglie per essa.</p> |
| Le varianti vengono visualizzate en famiglie separate | I valori del brand o delle caratteristiche distintive differiscono per ortografia o maiuscole/minuscole | Fai corrispondere esattamente i valori all'interno della famiglia, ad esempio con una Regla che imposta un'unica ortografia.                                                                                                                                     |
| Alcune varianti sono mancanti de famiglia             | La famiglia ha più di 70 prodotti                                                                       | Dividi la famiglia en gruppi più piccoli, ciascuno con il proprio **ID della variante di prodotto**.                                                                                                                                                             |
| Due prodotti diversi vengono raggruppati insieme      | Condividono lo stesso **ID della variante di prodotto**                                                 | Assegna a ogni famiglia un ID univoco.                                                                                                                                                                                                                           |
| {% endstep %}                                         |                                                                                                         |                                                                                                                                                                                                                                                                  |
| {% endstepper %}                                      |                                                                                                         |                                                                                                                                                                                                                                                                  |

### Rimuovi una variante de una famiglia <a href="#remove-a-variant-from-a-family" id="remove-a-variant-from-a-family"></a>

si bol raggruppa una variante nella famiglia sbagliata, rimuovila en il tuo Account Vendedor bol:

1. Vai Para **I miei articoli** y Selecciona il prodotto.
2. Fai clic **Modifica le varianti**.
3. Fai clic **Scollega** accanto alla variante che vuoi Para rimuovere.

Per maggiori dettagli, vedi [la documentazione di bol sulle famiglie di prodotti](https://api.bol.com/retailer/public/Retailer-API/v10/functional/retailer-api/product-families.html).


---

# 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/bol/pubblica-items-su-bol/come-para-configurare-arriba-un-canale-bol/setting-up-product-listing-variant-families-for-bol.md?ask=<question>&goal=<user_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.
