Integrazione di Shop Apotheke Marketplace in M2E Cloud

Questa guida ti accompagna nella configurazione di Shop Apotheke con M2E Cloud e nella gestione quotidiana dell'integrazione.

Per prima cosa, completa i passaggi richiesti da Shop Apotheke, quindi configura le impostazioni chiave in M2E Cloud una volta che la connessione è attiva.

ℹ️ Shop Apotheke è un marketplace basato su Mirakl. La maggior parte delle regole descritte di seguito si applicano anche ad altri marketplace Mirakl supportati da M2E Cloud.

Cosa succede al di fuori di M2E Cloud #

Shop Apotheke è una farmacia online europea e un marketplace incentrato sulla salute. Mette in contatto marchi e commercianti con i clienti che acquistano online prodotti sanitari, per il benessere e per la salute quotidiana.

Shop Apotheke opera attraverso diversi negozi localizzati. Ogni negozio si rivolge a un paese specifico:

• shop-apotheke.com (Germania)
• shop-apotheke.at (Austria)
• farmaline.be (Belgio)
• redcare.it (Italia)

Shop Apotheke è basato su Mirakl. Ciò significa che aderisce agli standard Mirakl per la convalida e l'elaborazione dei dati del marketplace. Queste regole sono definite dal marketplace, non da M2E Cloud.

Ciò include il modo in cui Shop Apotheke gestisce:

• contenuto dei prodotti (titoli, immagini, descrizioni, attributi)
• offerte e prezzi (prezzi, IVA, sconti)
• ordini e spedizioni (importazione degli ordini, conferma della spedizione, tracciamento)

ℹ️ Nota: Shop Apotheke non supporta i canali di vendita. Se desideri vendere in più di un Paese, devi firmare un contratto separato e completare la procedura di registrazione per ogni negozio.

A chi è adatto Shop Apotheke #

Shop Apotheke è adatto ai commercianti che vendono prodotti legati alla salute con identificatori stabili e dati chiari sui prodotti.

Le categorie tipicamente adatte includono:

• Prodotti per la salute e il benessere
• Prodotti da banco e integratori
• Cura personale e igiene
• Dispositivi medici e ottica
• Prodotti per la salute di neonati, animali domestici e per la casa

ℹ️ I prodotti farmaceutici e regolamentati potrebbero richiedere ulteriori approvazioni e documentazione. L'accesso alle categorie e le autorizzazioni di vendita sono definiti da Shop Apotheke, non da M2E Cloud.

Richiesta di un account venditore Shop Apotheke #

Prima di poter configurare Shop Apotheke in M2E Cloud, è necessario richiedere un account venditore direttamente a Shop Apotheke.

C'è un modo per iniziare la registrazione:

• Contatta Shop Apotheke via e-mail e richiedi l'onboarding

Durante la registrazione, Shop Apotheke potrebbe richiedere:

• Dettagli aziendali e informazioni IVA
• Categorie di prodotti che intendi vendere
• Un feed di prodotti di esempio da esaminare

In alcuni casi, Shop Apotheke esamina il tuo feed di prodotti prima della creazione del tuo negozio. Questo permette loro di verificare che il tuo catalogo sia conforme alle loro regole e alla loro categoria.

L'approvazione dell'account è gestita da Shop Apotheke. I tempi possono variare.

Una volta approvato il tuo account, riceverai l'accesso all'amministrazione venditori Mirakl. Questo accesso è necessario per continuare, poiché hai bisogno delle credenziali Mirakl per collegare Shop Apotheke a M2E Cloud.

ℹ️ Shop Apotheke non prevede costi di attivazione. Il costo è di €39,00 al mese. Inoltre, è prevista una commissione che varia a seconda della categoria di prodotti trattati. L'importo esatto viene concordato con il marketplace al momento della registrazione del venditore.

Cosa succede all'interno di M2E Cloud #

Una volta approvato il tuo account venditore Shop Apotheke, M2E Cloud diventa il sistema per la gestione delle operazioni quotidiane del marketplace. Funge da livello di controllo tra il tuo negozio e il marketplace Shop Apotheke.

Con M2E Cloud, gestisci Shop Apotheke da un unico posto. La piattaforma gestisce lo scambio, la convalida e la sincronizzazione dei dati, quindi non è necessario lavorare direttamente nel back-end di Mirakl per le attività di routine.

Utilizzando M2E Cloud, puoi:

• Connettiti a Shop Apotheke tramite l'API Mirakl
• Esporta i contenuti dei prodotti dal tuo negozio al marketplace
• Mappa le categorie e gli attributi richiesti
• Gestisci prezzi, IVA e sconti
• Sincronizza ordini, livelli di stock e spedizioni

Tutti gli aggiornamenti seguono regole predefinite e vengono eseguiti automaticamente. Ciò riduce il lavoro manuale e mantiene sincronizzati il tuo negozio e il marketplace.

Requisiti prima di iniziare #

Prima di collegare Shop Apotheke a M2E Cloud, assicurati che tutti i requisiti riportati di seguito siano soddisfatti. La mancanza di uno qualsiasi di essi bloccherà le esportazioni o interromperà la sincronizzazione.

ℹ️ Si assicuri che il Suo negozio utilizzi una piattaforma supportata, come Shopify, BigCommerce, PrestaShop, ecc. Tutte le app M2E sono disponibili nell'inserzione ufficiale delle app. Ad esempio, per l'integrazione di Hygi.de su Shopify tramite M2E è necessario installare prima l'app Shopify.

È necessario disporre di:

• Un account venditore Shop Apotheke approvato
• Credenziali API Mirakl valide
• Registrazione IVA
• Prezzi dei prodotti disponibili in EUR
• Codici EAN o GTIN validi per tutti i prodotti

Sono previsti anche requisiti linguistici. Il contenuto del prodotto deve essere fornito in tedesco o italiano, a seconda del negozio online su cui vendi.

In casi specifici potrebbero essere previsti requisiti aggiuntivi:

• I prodotti elettrici ed elettronici richiedono dati WEEE o EPR
• I prodotti regolamentati e farmaceutici potrebbero richiedere identificatori e approvazioni aggiuntivi

Collegamento di Shop Apotheke a M2E Cloud #

Shop Apotheke è un marketplace basato su Mirakl che si collega a M2E Cloud tramite API.

Per avviare la connessione, è necessario disporre dell'accesso al proprio pannello di amministrazione venditore Mirakl e di una chiave API valida.

Passaggi per la connessione:

1. In M2E Cloud, apri Connetti account Mirakl.
2. Nella sezione Seleziona marketplace, scegli Shop Apotheke (usa il campo Cerca marketplace per trovarlo rapidamente).
3. Accedi al tuo Mirakl Seller Admin e genera o copia la tua chiave API.
4. Torna su M2E Cloud e incolla la chiave nel campo Chiave API.
5. Inserisci il tuo ID negozio se gestisci più negozi.
6. Fai clic su Connetti.

Dopo l’invio, M2E Cloud verifica automaticamente le credenziali. Una volta completata con successo la verifica, è possibile sincronizzare i dati dei prodotti, le offerte, gli ordini e le spedizioni.

ℹ️ Consulta le istruzioni complete per la configurazione di M2E Mirakl in questa guida.

Tra i problemi di connessione più comuni figurano:

• Utilizzo di una chiave API errata o non aggiornata
• Autorizzazioni API mancanti in Mirakl
• Tentativo di connessione prima che l’account Shop Apotheke sia stato completamente approvato

ℹ️ Se in seguito rigeneri la tua chiave API in Mirakl, dovrai aggiornarla in M2E Cloud. In caso contrario, la sincronizzazione si interromperà.

Una volta connesso: cosa succede dopo? #

Una volta attivata la connessione, è possibile configurare il comportamento di Shop Apotheke all'interno di M2E Cloud. Questa sezione illustra i principali passaggi operativi da eseguire per preparare le inserzioni e gestire la sincronizzazione continua.

1. Elencare i nuovi prodotti su Shop Apotheke #

Selezionare i prodotti che si desidera vendere ed esportarli su Shop Apotheke come nuove inserzioni del marketplace.

Durante l'esportazione, M2E Cloud può inviare:

• Contenuto del prodotto, come titoli, immagini e attributi
• Offerte di prodotti, come prezzo, IVA e disponibilità

Questo comportamento è controllato dall'attributo Strategia di esportazione. A livello generale, definisce se M2E Cloud esporta l'intero contenuto del prodotto o offre solo i dati.

✅ Utilizza M2E Cloud Policies per controllare quali dati vengono sincronizzati.

2. Collega le inserzioni esistenti sul marketplace con i prodotti del negozio #

Se i tuoi prodotti sono già presenti su Shop Apotheke e utilizzano gli stessi SKU del tuo negozio, M2E Cloud può collegarli automaticamente.

Se gli SKU non corrispondono, è possibile collegare manualmente le inserzioni utilizzando un file CSV. Il collegamento è necessario per la sincronizzazione. Indica a M2E Cloud quale negozio controlla il prezzo, le scorte e l'elaborazione degli ordini per ogni inserzione sul marketplace.

3. Mappa delle categorie e degli attributi richiesti #

La mappatura delle categorie è obbligatoria. Ogni prodotto deve essere assegnato a una categoria Shop Apotheke prima di poter essere esportato.

Questo passaggio comprende:

• Selezione della categoria Shop Apotheke corretta
• Scelta degli attributi dei contenuti, come descrizioni e caratteristiche dei prodotti
• Mappatura degli attributi, come i campi relativi all'IVA e ai prezzi

Una volta mappati, M2E Cloud utilizza queste mappature per sincronizzare i dati in base alle politiche attive.

✅ Per sapere come i dati si spostano tra i sistemi, vedi la guida alla politica di sincronizzazione.

4. Configurare le regole relative ai prezzi e alle valute #

Tutti i prezzi inviati a Shop Apotheke devono essere espressi in euro. L'IVA è obbligatoria e deve essere definita per ogni singolo prodotto.

Il comportamento dei prezzi è gestito tramite le politiche di Vendita in M2E Cloud. Queste politiche controllano come vengono applicati i prezzi base, gli sconti e le regole quantitative.

È possibile creare più politiche di Vendita per gestire diversi gruppi di prodotti, regole di prezzo o mercati.

5. Configurare le impostazioni degli ordini e la mappatura dello stato #

Le politiche sugli ordini definiscono come vengono gestiti gli ordini Shop Apotheke all'interno di M2E Cloud e del tuo negozio.

Ciò include:

• Quando gli ordini vengono importati
• Come Shop Apotheke associa gli stati degli ordini agli stati del negozio
• Come le conferme di spedizione vengono rinviate al marketplace

Una mappatura corretta previene i conflitti di stato e mantiene coerenti i dati degli ordini.

6. Imposta le regole di spedizione, consegna e gestione delle fatture #

Il comportamento di spedizione è controllato attraverso le politiche di spedizione.

Per Shop Apotheke, è necessario fornire un codice di tracciamento e un URL di tracciamento per tutte le spedizioni. La mappatura del corriere è facoltativa ma consigliata, in quanto migliora la visibilità del tracciamento sul marketplace.

Qui è possibile impostare:

• Vettori disponibili e metodi di spedizione
• Come vengono confermate le spedizioni
• Come vengono sincronizzati i numeri di tracciamento

7. Monitorare le inserzioni e risolvere i problemi #

Dopo la configurazione, è possibile monitorare il comportamento delle inserzioni direttamente in M2E Cloud.

Utilizzando la pagina Inserzioni, è possibile:

• Controlla lo stato di esportazione e convalida
• Esamina i feedback e gli errori del marketplace
• Risolvi i problemi relativi alla mappatura, ai prezzi o ai contenuti senza disattivare il canale

Ciò consente di mantenere attive le inserzioni e risolvere rapidamente eventuali problemi.

💡 Consulta la documentazione M2E per capire come funzionano la gestione delle inserzioni e degli ordini.

Cosa succede nel back-end del marketplace? #

Dopo che i prodotti e le offerte sono stati esportati da M2E Cloud, tutte le operazioni di convalida e elaborazione finali avvengono da parte di Shop Apotheke. Queste regole sono applicate dal marketplace tramite Mirakl e non possono essere modificate in M2E Cloud.

Comprendere queste limitazioni aiuta a evitare rifiuti silenziosi e ritardi nelle inserzioni.

Funzionalità del marketplace Shop Apotheke #

Shop Apotheke supporta una serie definita di funzionalità del marketplace Mirakl.

Supportato

• Contenuto del prodotto
• Offerte di prodotti
• Ordini
• Annullamenti da parte dei commercianti
• Resi da parte dei commercianti
• Mappatura dei corrieri
• Formattazione HTML
• Posizioni multiple delle scorte
• Pacchetti
• Caricamento delle fatture
• Liquidazioni

Non supportato

• Relazioni automatiche
• Variazioni di prodotto (dimensioni o colore)
• Prodotti ricondizionati
• Rivalutazione
• Annullamenti sul marketplace
• Resi sul marketplace
• Spedizioni
• Servizi di evasione ordini sul marketplace
• Canali di vendita

ℹ️ Ogni vetrina nazionale presenta le stesse caratteristiche fondamentali, ma le regole di accesso possono variare.

Requisiti relativi ai prodotti e alle offerte #

Per poter elencare correttamente i prodotti, tutti i campi obbligatori devono rispettare le regole di convalida di Shop Apotheke e Mirakl.

Contenuto del prodotto (obbligatorio)

Ogni prodotto deve includere i seguenti dati:

• EAN o GTIN. Utilizzato come identificativo principale del prodotto. I codici non validi o mancanti bloccano l'inserzione.
• Titolo del prodotto
  • Solo testo semplice
  • Lunghezza massima: 100 caratteri
  • Non sono consentite quantità e tag HTML.
• Immagine principale
  • Sfondo bianco
  • Formato quadrato
  • Formati supportati: JPG, PNG, WEBP
  • Risoluzione minima: 450 × 450 px. Risoluzione consigliata: 1000 × 1000 px
  • Dimensione massima del file: 5 MB.
• Marca. Deve corrispondere alla marca effettiva del prodotto.
• Quantità e unità
  • L'unità deve essere selezionata tra valori fissi quali g, ml o l
  • La quantità supporta fino a tre valori separati da una “x”.
• Attributi specifici della categoria. I campi obbligatori dipendono dalla categoria selezionata e devono essere mappati correttamente.

Contenuto del prodotto (facoltativo)

È possibile migliorare la qualità dell'inserzione fornendo dati aggiuntivi:

• Immagini aggiuntive
• Descrizioni lunghe e brevi
• Caratteristiche del prodotto e istruzioni per l'uso
• Variazioni utilizzando un codice di gruppo
• Campi normativi come PZN o WEEE, ove applicabile

I campi facoltativi vengono comunque convalidati. Valori errati possono bloccare le esportazioni.

Regole relative a offerte, prezzi e IVA #

I prezzi e le imposte seguono le regole Mirakl e devono essere configurati correttamente.

• L'IVA è obbligatoria. Ogni prodotto deve includere un'aliquota IVA valida.
• Valuta. Shop Apotheke accetta solo EUR.

Sconti e promozioni

Shop Apotheke supporta la logica degli sconti Mirakl.

• Il prezzo v1 utilizza il prezzo scontato, la data di inizio dello sconto e la data di fine dello sconto. Il prezzo scontato deve essere inferiore al prezzo base.
• Il prezzo v2 utilizza il prezzo di esercizio come prezzo normale e il prezzo come valore scontato. Il prezzo e il prezzo di esercizio non possono essere uguali.
• Gli sconti all'ingrosso richiedono una soglia di quantità superiore a 1.
• La formattazione della data deve seguire il formato Mirakl: AAAA-MM-GG HH:MM:SS, in UTC.

Una configurazione errata dei prezzi impedisce la pubblicazione delle offerte.

Spedizione, tracciamento e attributi specifici di Mirakl #

I marketplace Mirakl si basano su molti altri attributi. È necessario mappare quelli richiesti per la propria categoria.

Esempi tipici includono:

• Tempi di consegna. Definisce quanti giorni trascorrono prima della spedizione.
• Classe logistica. Controlla la gestione della consegna. I codici marketplace validi sono: klein, mittel, groß, extragroß.
• Requisiti di tracciabilità. Per tutte le spedizioni sono richiesti un codice di tracciabilità e un URL di tracciabilità. La mappatura del corriere è facoltativa ma consigliata.
• Attributi Eco ed EPR. Gli attributi facoltativi si applicano ai prodotti soggetti a normative ambientali. Questi includono i contributi eco e gli ID di registrazione del produttore.

FAQ #

Perché il mio prodotto non è presente nell'elenco delle inserzioni? #

La maggior parte dei problemi relativi alle inserzioni è causata da errori di convalida del marketplace. Tra i motivi più comuni figurano EAN mancanti, immagini non valide, attributi richiesti non mappati, IVA mancante o prezzi errati.

Dove posso vedere gli errori di convalida del marketplace? #

Se non vengono visualizzati errori in M2E Cloud, controlla il back-end di Mirakl.

Vai su Catalogo → Importazioni prodotti e scarica il rapporto Prodotti non integrati per un feedback dettagliato.

Shop Apotheke supporta sconti e promozioni? #

Gli sconti sono supportati tramite le regole di determinazione dei prezzi Mirakl. Sono supportate sia la versione 1 che la versione 2.

Sono necessarie fatture per gli ordini Shop Apotheke? #

I requisiti di fatturazione dipendono dalla configurazione. In alcuni casi, le fatture dei commercianti sono facoltative. In altri, è necessario allegare una fattura prima della conferma della spedizione.

✅ Se hai bisogno di aiuto con la configurazione o riscontri problemi di convalida, contatta il team di assistenza M2E Cloud.