# Come configurare un canale Miravia

Miravia è un marketplace spagnolo che fonde l'ecommerce tradizionale con la creazione di contenuti. Permette ai clienti di scoprire e acquistare una gamma di prodotti, con un focus su moda, bellezza e articoli lifestyle.

In questo articolo imparerai come configurare un canale Miravia in Channable per creare, gestire e mettere in lista i prodotti su Miravia.

***

### **Prima di iniziare** <a href="#h_01k1z2v46a02s6sdbkm31k77ys" id="h_01k1z2v46a02s6sdbkm31k77ys"></a>

**Avrai bisogno di:**

* Un account venditore Miravia con solo **una regione (Spagna)** abilitata

**Considerazioni importanti**

* Attualmente, Channable supporta solo l'invio di **un prezzo per articolo**.
* Italia e Portogallo attualmente non sono regioni supportate
* L'attivazione della funzione di multi-prezzificazione in Miravia potrebbe causare incoerenze nei prezzi che possono influire sui tuoi margini di profitto.

### **Passo 1: Crea un canale Miravia** <a href="#h_01k1z1a9mhfyybvybfjy7gpqep" id="h_01k1z1a9mhfyybvybfjy7gpqep"></a>

1. In Channable, vai a **Progetti > \[Il tuo progetto] > Canali**.
2. Clicca **+ Crea canale**.
3. Nella barra di ricerca, inserisci “Miravia” e seleziona **Miravia**.
4. Imposta le opzioni del canale:
   1. Per **Nome**, dai al tuo canale un nome descrittivo.
   2. Per **ID univoco per articolo**, seleziona il campo contenente gli ID dei tuoi prodotti.
   3. Per **Lingua**, seleziona la lingua dei dati prodotto.
   4. Per **Utilizza gruppo di regole principali**, seleziona un gruppo di regole master da applicare al canale (se ne hai uno).
5. Clicca **Salva**.

### **Passo 2: Crea gli annunci prodotto** <a href="#h_01k1z1a9mvbm6n7tzy9cdeja8h" id="h_01k1z1a9mvbm6n7tzy9cdeja8h"></a>

### **Requisiti aggiuntivi per Miravia** <a href="#h_01k1z1fw2dbynae6fa7kv4cm2d" id="h_01k1z1fw2dbynae6fa7kv4cm2d"></a>

La sezione seguente descrive i requisiti specifici e le considerazioni per creare gli annunci prodotto per Miravia.

#### **Attributi condivisi** <a href="#h_01k1z1fw2edg4sxpz5vmxgvnmd" id="h_01k1z1fw2edg4sxpz5vmxgvnmd"></a>

<details>

<summary><strong>sezione Articolo</strong></summary>

**ID gruppo articolo**&#x20;

Questo campo viene usato per raggruppare più articoli variante in un unico annuncio. Se non ci sono varianti multiple, seleziona l'ID unico dell'articolo per il campo item\_group\_id.

</details>

<details>

<summary><strong>Spedizione</strong></summary>

**Campi obbligatori**

Assicurati che tutti i campi relativi alla spedizione, come peso, lunghezza e contenuto, siano completati con valori maggiori di 0 e con non più di 2 decimali. Se i valori sono sconosciuti, impostali a 1 usando una regola.\
&#x20;

**Consegna da parte del venditore**&#x20;

Imposta questa opzione su “Sì” solo con autorizzazione preventiva da parte di Miravia; altrimenti impostala su “No” per evitare errori.&#x20;

Fai riferimento a [“Consegna da parte di Miravia”](https://helpcenter.channable.com/hc/en-us/articles/9900447518866-How-do-I-use-Delivery-by-Miravia-through-Channable) per maggiori informazioni.\
&#x20;

**Valori predefiniti**

&#x20;Se i valori di spedizione sono sconosciuti, impostali tutti a 1 usando una regola.

</details>

<details>

<summary><strong>Immagini</strong> </summary>

**Collegamento immagini**

&#x20;Collega il/i campo/i contenente le tue immagini nell' **Immagini** attributo.

**Requisiti delle immagini**

&#x20;Attieniti ai rigidi requisiti di Miravia sia per l'URL che per l'immagine stessa. La non conformità genererà un errore "Could not upload image due to: .. E302: "Description of error"" nel **Risultati** mirakl\_unknown\_error\_code - "Il prodotto non esiste"&#x20;

</details>

#### **Attributi per categoria** <a href="#h_01k1z254sqgm6s0n0jrvwa49gp" id="h_01k1z254sqgm6s0n0jrvwa49gp"></a>

<details>

<summary><strong>requisiti DSA</strong></summary>

**Passo 1: Registra i dettagli del produttore e della persona responsabile**

1. Nel tuo **seller central di Miravia** account, vai a **Gestione informazioni del produttore**.
2. Nella **Informazioni sul produttore** nella scheda, fornisci i dettagli del produttore e clicca **Invia**.
3. Miravia genererà un ID produttore. Conserva questo ID, perché ti servirà nel passaggio successivo.
4. Clicca su **Informazioni sulla persona responsabile nell'UE** mirakl\_unknown\_error\_code - "Il prodotto non esiste"
5. Fornisci i dettagli della persona responsabile nell'UE. Clicca **Invia**.
6. Miravia genererà un ID della persona responsabile nell'UE. Conserva questo ID, perché ti servirà nel passaggio successivo.

&#x20;

**Passo 2: Fornisci i tuoi ID in Channable**

1. In **\[il tuo canale Miravia]**, vai al **Build** passo.
2. Clicca su **Attributi per categoria** scheda e seleziona una categoria. Apparirà un elenco di attributi specifici per la categoria.
3. Per **Persona responsabile UE**, clicca il campo e incolla/compila l'ID delle informazioni della persona responsabile nell'UE.
4. Per **Informazioni sul produttore**, clicca il campo e incolla/compila il tuo ID produttore.
5. Clicca **Salva**.
6. Ripeti questa operazione per ogni categoria.

{% hint style="info" %}
**Nota:** Se lavori con più produttori o persone responsabili, dovrai [creare un nuovo campo di progetto](https://channable-test.gitbook.io/channable-test-docs/getting-started/fields-in-channable/map-and-add-fields#add-a-new-project-field), popolarlo con una [regola](https://channable-test.gitbook.io/channable-test-docs/manage-improve-product-data/rules-bulk-edit-and-enrich/using-rules)e mapparlo invece di inserire l'ID manualmente.
{% endhint %}

</details>

<details>

<summary><strong>Regolamenti generali sulla sicurezza dei prodotti (GPSR)</strong></summary>

I venditori devono indicare se il prodotto ha avvertenze di sicurezza. Se sì, i seguenti attributi devono essere compilati:

**Il prodotto ha un'avvertenza di sicurezza?**

Se "Sì", assicurati di aggiungere le informazioni di sicurezza necessarie nel **Contenuto dell'avvertenza di sicurezza** attributo.

**Contenuto dell'avvertenza di sicurezza**

Fornisci qui il contenuto dell'avvertenza di sicurezza.

**Foto del pacchetto/etichetta (UE)**&#x20;

Devi fornire un'etichetta del prodotto che includa i dettagli necessari. Ogni articolo deve inoltre includere una foto con l'etichetta.&#x20;

L'etichetta fisica del pacchetto deve contenere:

* Informazioni sul produttore (e sulla persona responsabile UE, se il produttore non ha sede nell'UE)
* Informazioni di identificazione del prodotto
* Eventuali marchi o avvertenze di sicurezza

**Certificazioni di conformità del prodotto**

Alcuni attributi compaiono solo se il tuo prodotto appartiene a determinate categorie. Questi attributi ti permettono di inviare certificazioni rilevanti, come certificati CE e rapporti di test.&#x20;

* **Certificato CE**
* **Certificato ECE**
* **Certificato CPNP**
* **Rapporto di test RoHS:** Verifica se i prodotti elettronici sono conformi alle normative sulle sostanze nocive.
* **Rapporto REACH:** Conferma che le sostanze chimiche nei prodotti rispettano le norme UE lungo la filiera.
* **Certificato di registrazione BPR:** Dimostra l'approvazione per l'uso di prodotti antibatterici secondo le leggi UE.
* **Rapporto di prova sui materiali a contatto con alimenti (FCM) nell'UE:** Conferma che i materiali sono sicuri per il contatto con alimenti nell'UE.\
  &#x20;

Per alcune categorie sono richiesti anche rapporti di prova specifici, come:

* **Documento PIF:** File completo con le informazioni necessarie per la vendita di cosmetici nell'UE.
* **Rapporto di prova EMC/LVD:** Convalida la conformità alle regole sulla sicurezza elettromagnetica.
* **Rapporto di prova EMC:** Verifica che un prodotto non provochi interferenze elettromagnetiche.
* **Rapporto di prova EN71:** Dimostra che i giocattoli sono sicuri secondo gli standard UE.
* **Rapporto di prova R44:** Certifica che i seggiolini per bambini rispettano le regole di sicurezza ONU.
* **Rapporto di prova per prodotti da costruzione:** Conferma che i materiali da costruzione rispettano gli standard UE.
* **Rapporto di prova MDR:** Dimostra che i dispositivi medici seguono le normative UE.
* **Rapporto di prova per succhietti (EN1400:2013):** Verifica che i succhietti siano sicuri secondo le norme UE.
* **Rapporto di prova DPI:** Garantisce che i dispositivi di protezione individuale rispettino gli standard UE.
* **EN62115:** Garantisce che i giocattoli elettrici siano sicuri.
* **Rapporto di prova RED:** Conferma che i dispositivi wireless rispettano la Direttiva sulle apparecchiature radio.\
  &#x20;

</details>

### **Passo 3: Connetti a Miravia** <a href="#h_01k1z1a9mqwqjhskvvh19mmbw1" id="h_01k1z1a9mqwqjhskvvh19mmbw1"></a>

Per inviare i tuoi annunci a Miravia, devi connettere il tuo canale al tuo account venditore Miravia.&#x20;

{% hint style="warning" %}
**Importante:** Collegare l’account non cambierà nulla: eventuali annunci esistenti rimarranno identici fino all’attivazione.
{% endhint %}

1. Accedi al tuo account venditore Miravia.
2. In **\[il tuo canale Miravia]**, vai su **Impostazioni**.
3. Alla voce **Account venditore collegato**, clicca **Seleziona account venditore**.&#x20;
4. Seleziona un account venditore esistente, oppure clicca **+ Aggiungi nuovo collegamento** per aggiungere un nuovo account venditore.
   1. Se aggiungi un nuovo account venditore:
      1. Per **Etichetta**: Assegna un nome alla connessione del tuo account venditore.
      2. Clicca **Connetti con Miravia**.&#x20;
5. Ti reindirizzeremo a Miravia per eseguire il login al tuo account e accettare le autorizzazioni richieste.&#x20;
6. Ti verrà chiesto di confermare diverse autorizzazioni. Compila i dettagli richiesti e clicca **Autorizza**.&#x20;

### **Passo 4: Invia i tuoi annunci prodotto a Miravia** <a href="#h_01k1z1a9nfken0bd7n66x9a99f" id="h_01k1z1a9nfken0bd7n66x9a99f"></a>

1. Seleziona il **Impostazioni** in **\[il tuo canale Miravia]**.
2. Clicca **Attiva API**.
3. Clicca **Salva**.
4. Clicca **Esegui** per inviare i tuoi annunci prodotto a Miravia.

### **Passo 5: Controlla le tue inserzioni prodotto per errori** <a href="#h_01k1z1a9nhw2avz6csgb79sj85" id="h_01k1z1a9nhw2avz6csgb79sj85"></a>

Vai al **Risultato** passo e clicca sulla **scheda Feedback. Questa pagina mostra tutti gli errori di elaborazione presenti nei dati dei tuoi prodotti in un dato momento.** Risoluzione degli errori:&#x20;

#### **Non tutti gli errori impediscono la pubblicazione dei prodotti. Raccomandiamo di seguire i passaggi e usare la tua** <a href="#h_01k1z1a9njmrahvb0s1k99mazz" id="h_01k1z1a9njmrahvb0s1k99mazz"></a>

Importante: non tutti gli errori impediscono la pubblicazione dei prodotti. Ti consigliamo di seguire i passaggi e di usare la scheda Successi come fonte di verità.

1. In **Descrizione**, clicca il numero ID e scorri. Dovresti vedere un avviso evidenziato in rosso nella sezione dove si è verificato l’errore. Passa il cursore sull’avviso per maggiori informazioni.
2. In **Se l’errore è un errore di mappatura, clicca**Visualizza in build
   1. per essere indirizzato all’attributo che devi mappare/ri-mappare, evidenziato in blu. **Per maggiori informazioni sull’attributo e sui valori accettati, passa il cursore su .** Risolvi l’errore.
   2. Ripeti per gli errori rimanenti.
3. Ripeti questo intero passo per
4. Ripeti per gli errori rimanenti. Quando sei pronto, esegui di nuovo il canale cliccando **Esegui**.

Errori comuni e soluzioni **", clicca sul nome dell’errore. Questo ti porta a una panoramica dei prodotti che presentano quell’errore.** mirakl\_unknown\_error\_code - "Il prodotto non esiste" <br>

### Errori comuni di Miravia

<details>

<summary>CHK_SKU_PROPS_DUPLICATE</summary>

Descrizione: Questo errore si verifica quando stai cercando di inserire in lista prodotti con lo stesso SKU (ad es. una camicia con diverse opzioni di taglia), ma Miravia non riesce a distinguere tra i diversi tipi.

Per elencare un prodotto con più SKU, devi creare varianti specifiche (ad es. taglia diversa, colore) in modo che siano distinguibili tra loro.

Ogni variante deve essere unica all'interno del suo gruppo. Per esempio, se una camicia rossa è disponibile nella taglia M, deve essere l'unica variante con quella combinazione in quel gruppo.

Soluzione: Assicurati che i prodotti che condividono lo stesso SKU base siano in gruppi che contengano combinazioni uniche per ciascuna variante.

</details>

<details>

<summary>EAN_code</summary>

Questo errore può essere causato da una di tre possibilità:

* Prodotto senza EAN: Apparirà un messaggio che indica che manca un campo obbligatorio.

![EAN mancante immagine](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/8tT6HoIw0reQDd8847om/28578180708882)

* EAN già usato da un altro SKU nel tuo negozio: i codici EAN devono essere unici per ogni prodotto. Potresti vedere questo errore anche con il nome: THD\_IC\_ERR\_F\_IC\_INFRA\_SPU\_036 o con il codice errore 4142. Per questa opzione non è richiesta alcuna azione, poiché l'errore si risolverà da solo entro un massimo di 24 ore.

![EAN immagine duplicata](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/cu6JlH3z2wBDHv6ux42w/28578180709650)

* THE\_FIELD\_OF\_EAN\_CODE\_HAS\_AN\_ERROR\_PLEASE\_CHECK: Indica che il formato dell'EAN non è valido. Apporta le correzioni necessarie.

</details>

<details>

<summary>THD_IC_ERR_F_IC_SERVICE_EDIT_002</summary>

Descrizione: Non è consentita la modifica concorrente del prodotto.

Possibili cause:

* Prodotto soggetto a promozione: Questo prodotto è idoneo per una promozione offerta da Miravia, durante la quale i dati del prodotto sono congelati per garantire che soddisfino i criteri della promozione. Non è richiesta alcuna azione.
* Stai tentando di aggiornare le informazioni di un gruppo di prodotti mentre contemporaneamente cerchi di aggiungere una nuova variazione.

Soluzione: Escludi la nuova variante che vuoi aggiungere, esegui il canale per aggiornarla e includi la nuova variante nella tua esecuzione successiva (dopo aver verificato che le altre varianti non presentino errori).

</details>
