> 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/import-data/import-data-it/guida-allimportazione/importa-i-tuoi-dati-prodotto/importa-tramite-un-webshop/akeneo.md).

# Akeneo

en questo articolo, scoprirai come Para importare i dati dei tuoi prodotti de Akeneo en Channable.

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> Prima di iniziare

**Ti serviranno**

* Un Account Akeneo
* si vuoi includere immagini en annunci: la condivisione integrata delle immagini en Akeneo o un'Applicazione tercero-party come TwicPics

{% hint style="info" %}
Channable supporta l'importazione integrata di immagini de Akeneo. Supportiamo ancora TwicPics se vuoi mantenere la tua Configura Actual.
{% endhint %}

**Buono Para sapersi**

* si l'importazione integrata delle immagini è abilitata en Akeneo, Channable importa le immagini come una Lista de URL.
* Akeneo offre Opciones flessibili di organizzazione. Ciò significa che diversi campi del progetto (ad es. `Descripción` ) può avere variazioni per lingue o scope diversi.
  * Per usar i dati prodotto Akeneo su Canali diversi, Channable **appiattisce questi campi** y crea un Campo per ogni combinazione univoca. Puoi identificare i campi appiattiti tramite un underscore `_` collegando le parti.

<details>

<summary>Esempio: campi Descripción suddivisi Para Account per locali diversi y scope.</summary>

<figure><img src="/files/25253a3ae677033e29bf8c1f8d9ecfc60b6991b9" alt=""><figcaption></figcaption></figure>

</details>

{% stepper %}
{% step %}

### Crear una nuova connessione en Akeneo

* Accedi Para il tuo Account Akeneo.
* Vai Para **Connessione > Impostazioni della connessione > Crear**.<br>

  <figure><img src="/files/7e276c0833914a28a353f69e4524e291e1ea87c2" alt=""><figcaption></figcaption></figure>
* Crear la tua connessione Channable:

  * Per **Etiqueta**, chiama la tua connessione "Channable".
  * Per **Codice**, questo dovrebbe essere compilato en automatico dopo aver creato la tua Etiqueta. si non lo è, compilalo con "channable".
  * Per **Tipo di flusso**, impostalo Para **Destinazione dei dati**.
  * Fai clic **Salva**. Verrai reindirizzato Para una pagina con le credenziali della tua connessione.
  * Prendi nota de tuo **ID cliente**, **Segreto**, **Nome utente** y **Password**, perché ti serviranno en un passaggio successivo.
  * Per **Permisos**, assicurati che il **Ruolo** sia impostato su **Api** y **Gruppo** sia impostato su **Connessioni Api**.

  ![Akeneo - Connessione-Impostazioni.png](/files/e1b78a5080384eb5303b98ee63115dde011e9f35)
  {% endstep %}

{% step %}

### Configura l'importazione delle immagini

si vuoi importare immagini dei prodotti, puoi usar la condivisione immagini integrata di Akeneo o TwicPics.

{% tabs %}
{% tab title="Importazione integrata delle immagini" %}
Para importare immagini senza un plugin tercero-party, abilita **Link condivisi** en Akeneo per ogni famiglia di asset che contiene le immagini che vuoi importare.

1. En Akeneo, vai a **Assets > Modifica Family > Properties**.
2. Abilita **Link condivisi** per la famiglia di asset pertinente.
3. Assicurati che le immagini dei prodotti che vuoi importare appartengano a quella famiglia di asset.

Una volta che **Link condivisi** è abilitato, Channable rileva automaticamente le immagini dalla CDN di Akeneo e le importa come una Lista di URL.
{% endtab %}

{% tab title="TwicPics" %}
Si usi già TwicPics, puoi continuare a usarlo.

1. Segui la guida alla configurazione di TwicPics per Akeneo: <https://www.twicpics.com/docs/integrations/akeneo#connect-your-pim-with-akeneo-twicpics-app>
2. Dopo aver creato il tuo Account e aver seguito i passaggi, vai a **Spazi di lavoro** y fai clic sul tuo dominio en **Domini preferiti**.
3. Assicurati di avere un percorso en cui non viene aggiunto nulla y il percorso è `/`.

Esempio: una configurazione corretta en cui 1) è il **dominio**, 2) è il **percorso**, y 3) è il **target**.

![Test Akeneo.png](/files/80b2c88b39d3f9e12280636cfae0616f532f342c)

4. Prendi nota de tuo **Dominio TwicPics**, poiché potrebbe servirti en il passaggio successivo.
   {% endtab %}
   {% endtabs %}
   {% endstep %}

{% step %}

### Crear la tua connessione Akeneo en Channable

1. En Channable, apri il progetto en cui vuoi importare i dati dei tuoi prodotti.
2. Vai Para **Configura > Importa** y fai clic su **+ Scegli il metodo di importazione**. Selecciona **Akeneo**.
3. Fai clic **Aggiungi nuova connessione** o Selecciona una connessione esistente.
4. Inserisci le informazioni richieste:
   * Per **Etiqueta**, assegna al canale di importazione un nome descrittivo, ad esempio Akeneo.
   * Per **URL Akeneo**, inserisci il tuo [URL del webshop Akeneo](#user-content-fn-1)[^1]. Rimuovi eventuali barre finali `/`. L'URL deve terminare con un'estensione di dominio, come `.com`.

     <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><h4>Esempio</h4><p>si il tuo URL era <code>www.channable.com/</code>, dovresti rimuovere la barra finale <code>/</code> y inserisci <code>www.channable.com</code>.</p></div>
   * Per **ID cliente**, compila en il **ID cliente** come hai notato prima.
   * Per **Segreto client**, compila en il **Segreto** come hai notato prima.
   * Per **Nome utente**, compila en il **Nome utente** come hai notato prima.
   * Per **Password**, compila en il **Password** come hai notato prima.
   * Si usar TwicPics, compila en **Dominio TwicPics** con il dominio che hai annotato en passaggio precedente.
5. Fai clic **Connetti con Akeneo**. Questo ti porta Para le Impostazioni di importazione.
   * Per **Nombre**, assegna al tuo import Akeneo un nome descrittivo, ad esempio Akeneo FR.
   * Per **Scegli la lingua**, Selecciona la lingua en cui si trovano i dati del tuo prodotto.
6. Fai clic **Esegui importazione**. Verrai reindirizzato Para la **Import Mappatura** pagina Para mappare le informazioni dei tuoi prodotti.
   {% endstep %}

{% step %}

#### Mappa i dati dei tuoi prodotti Para i campi del progetto <a href="#map-your-product-data-to-project-fields" id="map-your-product-data-to-project-fields"></a>

Dopo aver eseguito l'importazione, ti ritrovi alla **Import Mappatura** pagina. Mostra i campi de Akeneo, come `prezzo`, `Descripción`, y `titolo`.

en questo passaggio, abbini quei campi importati Para i campi standard del progetto di Channable. Channable associa automaticamente la maggior parte dei campi, ma dovresti rivederli y modificarli prima di importarli.

{% hint style="success" %}
Para saperne di più su come funziona la Mappatura di importazione en Channable? Leggi il nostro [guida dedicata alla Mappatura](/get-started/get-started-space-it/per-iniziare/campi-en-channable/mappatura-dei-campi-en-channable.md).
{% endhint %}

<img src="https://helpcenter.channable.com/~gitbook/image?url=https%3A%2F%2F3042294697-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZa0iYflHeXmKWGnfFMAN%252Fuploads%252F6yCsJmSm5pdTTF5DwdNZ%252Finstructor_7u6jffr8fr7ks9ag5d1bwagc1_public_1751372530_mapping-manual.1751372530671.gif%3Falt%3Dmedia%26token%3D4c93b04d-5365-4863-93ed-21aee5e5fbf8&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=e6bd0d47&#x26;sv=2" alt="" height="720" width="1575">

1. **Confronta y regola la Mappatura.**
   * Rivedi il tuo **Campi dati importati** rispetto alle corrispondenze di Channable **Campi del progetto**. si un Campo è stato abbinato in modo errato, clicca sul Campo, Para Selecciona un altro Campo.
2. **Controlla y correggi i tipi di Campo.**
   * Controlla che il Tipo di Campo corretto sia assegnato Para i campi del tuo progetto. si un Campo ha il Tipo sbagliato, fai clic **Modifica** accanto Para il Campo, Selecciona il Tipo corretto en il menu a discesa, y fai clic **Salva e importa**.
3. **Excluir campi (Facoltativo).**
   * Para excluir un Campo de essere incluso en i dati del tuo prodotto, fai clic sulla casella di controllo en **excluir de importazione** colonna per quel Campo.
4. Una volta Finito di fare la Mappatura, fai clic su **Salva e importa** Para iniziare a importare i dati prodotto Akeneo.

{% hint style="info" %}
Controlla la **Status** colonna en **Configura** Para controllare l'avanzamento dell'importazione. I tuoi dati prodotto sono completamente importati quando lo Status è **Finito**.
{% endhint %}
{% endstep %}

{% step %}

### Rivedi i tuoi Ítems importati

Dopo che i dati dei prodotti hanno Finito di essere importati:

* Vai **Panoramica** Para visualizzare i tuoi prodotti importati.
* Fai clic su un ítem Para vedere informazioni dettagliate.

Sei pronto a partire! I tuoi Ítems sono pronti da usar Para Crear y Ottimizzare Feed, Marketplace, Shopping Ads y altro en Channable.
{% endstep %}
{% endstepper %}

[^1]: Puoi trovarlo nel Pannello attività di Akeneo.


---

# 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/import-data/import-data-it/guida-allimportazione/importa-i-tuoi-dati-prodotto/importa-tramite-un-webshop/akeneo.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.