Integração do Shop Apotheke Marketplace na M2E Cloud

Este guia orienta você na configuração do Shop Apotheke com o M2E Cloud e na execução da integração no dia a dia.

Primeiro, conclua as etapas necessárias no Shop Apotheke e, em seguida, configure as principais definições no M2E Cloud assim que a conexão estiver ativa.

ℹ️ A Shop Apotheke é um marketplace baseado na Mirakl. A maioria das regras descritas abaixo também se aplica a outros marketplaces Mirakl suportados pela M2E Cloud.

O que acontece fora da M2E Cloud #

A Shop Apotheke é uma farmácia online europeia e um mercado focado na saúde. Ela conecta marcas e comerciantes com clientes que compram produtos de saúde, bem-estar e produtos de saúde diários online.

A Shop Apotheke opera através de várias lojas localizadas. Cada loja tem como alvo um país específico:

• shop-apotheke.com (Alemanha)
• shop-apotheke.at (Áustria)
• farmaline.be (Bélgica)
• redcare.it (Itália)

A Shop Apotheke foi criada com base na Mirakl. Isso significa que ela segue os padrões da Mirakl para validação e processamento de dados do marketplace. Essas regras são definidas pelo marketplace, não pela M2E Cloud.

Isso inclui a forma como a Shop Apotheke lida com:

• conteúdo do produto (títulos, imagens, descrições, atributos)
• ofertas e preços (preços, IVA, descontos)
• pedidos e envios (importação de pedidos, confirmação de envio, rastreamento)

ℹ️ Observação: a Shop Apotheke não oferece suporte a canais de vendas. Se você deseja vender em mais de um país, é necessário assinar um contrato separado e concluir o processo de integração para cada loja virtual.

Para quem a Shop Apotheke é adequada #

A Shop Apotheke é adequada para comerciantes que vendem produtos relacionados à saúde com identificadores estáveis e dados claros sobre os produtos.

As categorias tipicamente adequadas incluem:

• Produtos de saúde e bem-estar
• Produtos OTC e suplementos
• Cuidados pessoais e higiene
• Dispositivos médicos e ópticos
• Produtos relacionados à saúde para bebês, animais de estimação e uso doméstico

ℹ️ Os produtos farmacêuticos e regulamentados podem exigir aprovações e documentação adicionais. O acesso à categoria e as permissões de venda são definidos pela Shop Apotheke, não pela M2E Cloud.

Solicitando uma conta de vendedor na Shop Apotheke #

Antes de configurar a Shop Apotheke no M2E Cloud, você deve solicitar uma conta de vendedor diretamente à Shop Apotheke.

Você pode iniciar o processo de adaptação desta forma:

• Entre em contato com a Shop Apotheke por e-mail e solicite a integração

Durante o cadastro, a Shop Apotheke pode solicitar:

• Detalhes da empresa e informações sobre o IVA
• Categorias de produtos que você planeja vender
• Um feed de produtos de amostra para análise

Em alguns casos, a Shop Apotheke analisa o feed do seu produto antes da criação da sua loja. Isso ajuda a validar se o seu Catálogo está de acordo com as regras e o escopo da categoria.

A aprovação da conta é feita pela Shop Apotheke. Os prazos podem variar.

Assim que sua conta for aprovada, você receberá acesso ao Mirakl Seller Admin. Esse acesso é necessário para continuar, pois você precisa das credenciais do Mirakl para conectar a Shop Apotheke ao M2E Cloud.

ℹ️ A Shop Apotheke não cobra taxa de instalação. Você paga uma taxa mensal fixa de €39,00. Você também paga uma comissão que depende da categoria do seu produto. A taxa exata é acordada com o marketplace durante o registro do vendedor.

O que acontece dentro do M2E Cloud #

Assim que sua conta de vendedor na Shop Apotheke for aprovada, o M2E Cloud se tornará o sistema de gerenciamento das suas operações diárias no marketplace. Ele atua como uma camada de controle entre sua loja e o marketplace da Shop Apotheke.

Com o M2E Cloud, você gerencia a Shop Apotheke a partir de um único lugar. A plataforma lida com a troca, validação e sincronização de dados, para que você não precise trabalhar diretamente no back-end do Mirakl para tarefas rotineiras.

Usando o M2E Cloud, você pode:

• Conecte a Shop Apotheke através da API Mirakl
• Exporte o conteúdo dos produtos da sua loja para o mercado
• Mapeie categorias e atributos necessários
• Gerencie preços, IVA e descontos
• Sincronize pedidos, níveis de estoque e remessas

Todas as atualizações seguem regras predefinidas e são executadas automaticamente. Isso reduz o trabalho manual e mantém sua loja e o marketplace sincronizados.

Requisitos antes de começar #

Antes de conectar a Shop Apotheke ao M2E Cloud, certifique-se de que todos os requisitos abaixo sejam atendidos. A falta de qualquer um deles bloqueará as exportações ou interromperá a sincronização.

ℹ️ Certifique-se de que a sua loja funciona numa plataforma compatível, como o Shopify, o BigCommerce, o PrestaShop, etc. Todas as aplicações M2E estão disponíveis nas listagens oficiais de aplicações. Por exemplo, a integração do Hygi.de no Shopify pela M2E requer a instalação prévia da aplicação do Shopify.

Você deve ter:

• Uma conta de vendedor aprovada na Shop Apotheke
• Credenciais válidas da API Mirakl
• Registro de IVA
• Preços dos produtos disponíveis em euros
• Códigos EAN ou GTIN válidos para todos os produtos

Também se aplicam requisitos linguísticos. O conteúdo do produto deve ser fornecido em alemão ou italiano, dependendo da loja em que você vende.

Em casos específicos, podem se aplicar requisitos adicionais:

• Os produtos elétricos e eletrônicos exigem dados WEEE ou EPR
• Os produtos regulamentados e relacionados com farmácias podem exigir identificadores e aprovações adicionais

Conectando a Shop Apotheke à M2E Cloud #

A Shop Apotheke é um marketplace baseado na Mirakl. Você pode conectá-lo à M2E Cloud usando o Mirakl Connect Single Sign-On.

Para iniciar a conexão, você precisa ter acesso ao seu Mirakl Seller Admin e uma chave API válida.

Etapas da conexão:

1. Faça login no seu Mirakl Seller Admin.
2. Gere ou copie sua chave API.
3. No M2E Cloud, abra a seção Conectar conta Mirakl.
4. Cole a chave API.
5. Selecione Shop Apotheke na lista suspensa de marketplaces Mirakl.
6. Insira seu ID da loja se você gerenciar várias lojas.
7. Confirme a conexão.

Após o envio, o M2E Cloud valida automaticamente as credenciais. Quando a validação é bem-sucedida, os dados do produto, ofertas, pedidos e remessas podem ser sincronizados.

ℹ️ Consulte as instruções completas para a configuração do M2E Mirakl neste guia.

Problemas comuns de conexão incluem:

• Utilização de uma chave API incorreta ou desatualizada
• Falta de permissões API no Mirakl
• Tentativa de conexão antes da conta Shop Apotheke estar totalmente aprovada

ℹ️ Se você regenerar sua chave API no Mirakl posteriormente, deverá atualizá-la no M2E Cloud. Caso contrário, a sincronização será interrompida.

Depois de conectado: o que acontece a seguir? #

Depois que a conexão estiver ativa, você configura como a Shop Apotheke se comporta dentro do M2E Cloud. Esta seção aborda as principais etapas operacionais que você executa para preparar listagens e gerenciar a sincronização contínua.

1. Liste novos produtos na Shop Apotheke #

Selecione os produtos que deseja vender e exporte-os para a Shop Apotheke como novas listagens no marketplace.

Durante a exportação, o M2E Cloud pode enviar:

• Conteúdo do produto, como títulos, imagens e atributos
• Ofertas do produto, como preço, IVA e disponibilidade

Esse comportamento é controlado pelo atributo Estratégia de exportação. Em um nível geral, ele define se o M2E Cloud exporta o conteúdo completo do produto ou apenas oferece dados.

✅ Use Políticas da M2E Cloud para controlar quais dados são sincronizados.

2. Vincule listagens existentes no mercado aos produtos da loja #

Se seus produtos já existem na Shop Apotheke e usam os mesmos SKUs da sua loja, o M2E Cloud pode vinculá-los automaticamente.

Se os SKUs não corresponderem, você pode vincular as listagens manualmente usando um arquivo CSV. A vinculação é necessária para a sincronização. Ela informa ao M2E Cloud qual loja controla o preço, o estoque e o processamento de pedidos para cada listagem do marketplace.

3. Mapear categorias e atributos necessários #

O mapeamento de categorias é obrigatório. Cada produto deve ser atribuído a uma categoria da Shop Apotheke antes de poder ser exportado.

Esta etapa abrange:

• Escolher a categoria correta da Shop Apotheke
• Escolher atributos de conteúdo, como descrições e características do produto
• Mapear atributos, como campos relacionados ao IVA e preços

Depois de mapeados, o M2E Cloud usa esses mapeamentos para sincronizar os dados de acordo com as políticas ativas.

✅ Para saber como os dados se movem entre os sistemas, consulte o guia de políticas de sincronização.

4. Configure as regras de preços e moedas #

Todos os preços enviados à Shop Apotheke devem ser em euros. O IVA é obrigatório e deve ser definido por produto.

O comportamento dos preços é gerenciado por meio das Políticas de Venda no M2E Cloud. Essas políticas controlam como os preços base, descontos e regras de quantidade são aplicados.

Você pode criar várias políticas de venda para lidar com diferentes grupos de produtos, regras de preços ou mercados.

5. Configure as definições de pedidos e o mapeamento de status #

As políticas de pedidos definem como os pedidos da Shop Apotheke são tratados dentro do M2E Cloud e da sua loja.

Isto inclui:

• Quando os pedidos são importados
• Como a Shop Apotheke mapeia os status dos pedidos para os status da loja
• Como as confirmações de envio são enviadas de volta para o marketplace

O mapeamento correto evita conflitos de status e mantém os dados dos pedidos consistentes.

6. Configure regras de envio, entrega e processamento de faturas #

O comportamento do envio é controlado por meio de políticas de envio.

Para a Shop Apotheke, você deve fornecer um código de rastreamento e uma URL de rastreamento para todas as remessas. O mapeamento da transportadora é opcional, mas recomendado, pois melhora a visibilidade do rastreamento no mercado.

Aqui você configura:

• Transportadoras e métodos de envio disponíveis
• Como as remessas são confirmadas
• Como os números de rastreamento são sincronizados

7. Monitore as listagens e resolva problemas #

Após a configuração, você pode monitorar o comportamento das listagens diretamente no M2E Cloud.

Usando a página Listagens, você pode:

• Verifique o status da exportação e da validação
• Analise os comentários e erros do marketplace
• Corrija problemas de mapeamento, preços ou conteúdo sem desativar o canal

Isso permite que você mantenha listagens ativas e resolva problemas rapidamente.

💡 Consulte a documentação do M2E para entender como funcionam a listagem e o gerenciamento de pedidos.

O que acontece no back-end do marketplace? #

Depois que os produtos e ofertas são exportados do M2E Cloud, toda a validação final e o processamento acontecem no lado da Shop Apotheke. Essas regras são aplicadas pelo marketplace por meio do Mirakl e não podem ser alteradas no M2E Cloud.

Compreender essas limitações ajuda a evitar rejeições silenciosas e listagens atrasadas.

Recursos do marketplace da Shop Apotheke #

A Shop Apotheke oferece suporte a um conjunto definido de recursos do marketplace Mirakl.

Suportado

• Conteúdo do produto
• Ofertas de produtos
• Pedidos
• Cancelamentos do comerciante
• Devoluções do comerciante
• Mapeamento da transportadora
• Formatação HTML
• Vários locais de estoque
• Pacotes
• Uploads de faturas
• Liquidações

Não compatível

• Relações automáticas
• Variações de produtos (tamanho ou cor)
• Produtos recondicionados
• Reavaliação de preços
• Cancelamentos no marketplace
• Devoluções no marketplace
• Remessas
• Serviços de atendimento no marketplace
• Canais de vendas

ℹ️ Cada loja nacional segue o mesmo conjunto de recursos básicos, mas as regras de integração podem variar.

Requisitos do produto e da oferta #

Para a listagem de produtos com sucesso, todos os campos obrigatórios devem seguir as regras de validação da Shop Apotheke e da Mirakl.

Conteúdo do produto (obrigatório)

Cada produto deve incluir os seguintes dados:

• EAN ou GTIN. Usado como o principal identificador do produto. Códigos inválidos ou ausentes bloqueiam a listagem de produtos.
• Título do produto
  • Apenas texto simples
  • Comprimento máximo: 100 caracteres
  • Quantidades e tags HTML não são permitidas.
• Imagem principal
  • Fundo branco
  • Formato quadrado
  • Formatos suportados: JPG, PNG, WEBP
  • Resolução mínima: 450 × 450 px. Resolução recomendada: 1000 × 1000 px
  • Tamanho máximo do arquivo: 5 MB.
• Marca. Deve corresponder à marca real do produto.
• Quantidade e unidade
  • A unidade deve ser selecionada entre valores fixos, como g, ml ou l
  • A quantidade suporta até três valores separados por um “x”.
• Atributos específicos da categoria. Os campos obrigatórios dependem da categoria selecionada e devem ser mapeados corretamente.

Conteúdo do produto (opcional)

Você pode melhorar a qualidade da listagem fornecendo dados adicionais:

• Imagens adicionais
• Descrições longas e curtas
• Características do produto e instruções de uso
• Variações usando um código de grupo
• Campos regulatórios, como PZN ou WEEE, quando aplicável

Os campos opcionais continuam a ser validados. Valores incorretos podem bloquear as exportações.

Ofertas, preços e regras de IVA #

Os preços e os impostos seguem as regras da Mirakl e devem ser configurados corretamente.

• O IVA é obrigatório. Cada produto deve incluir uma taxa de IVA válida.
• Moeda. A Shop Apotheke aceita apenas euros.

Descontos e promoções

A Shop Apotheke suporta a lógica de descontos da Mirakl.

• Preços v1 utiliza Preço com desconto, Data de início do desconto e Data de término do desconto. O preço com desconto deve ser inferior ao preço base.
• Preços v2 utiliza Preço de exercício como preço normal e Preço como valor com desconto. O Preço e o Preço de exercício não podem ser iguais.
• Os descontos por volume exigem um limite de quantidade superior a 1.
• A formatação da data deve seguir o formato Mirakl: AAAA-MM-DD HH:MM:SS, em UTC.

A configuração incorreta dos preços impede que as ofertas sejam publicadas.

Atributos específicos de envio, rastreamento e Mirakl #

Os mercados Mirakl dependem de muitos outros atributos. Você deve mapear os atributos necessários para sua categoria.

Exemplos típicos incluem:

• Prazo de entrega. Define quantos dias se passam antes do envio.
• Classe logística. Controla o manuseio da entrega. Os códigos válidos do marketplace são: klein, mittel, groß, extragroß.
• Requisitos de rastreamento. Um código de rastreamento e um URL de rastreamento são necessários para todas as remessas. O mapeamento da transportadora é opcional, mas recomendado.
• Atributos ecológicos e EPR. Atributos opcionais se aplicam a produtos sujeitos a regulamentações ambientais. Isso inclui contribuições ecológicas e IDs de registro do produtor.

FAQ #

Por que meu produto não está listado? #

A maioria dos problemas de listagem é causada por erros de validação do marketplace. Os motivos mais comuns incluem EANs ausentes, imagens inválidas, atributos obrigatórios não mapeados, IVA ausente ou preços incorretos.

Onde posso ver os erros de validação do marketplace? #

Se nenhum erro aparecer no M2E Cloud, verifique o back-end do Mirakl.

Vá para Catálogo → Importações de produtos e baixe o relatório de produtos não integrados para obter feedback detalhado.

A Shop Apotheke oferece descontos e promoções? #

Os descontos são oferecidos por meio das regras de preços do Mirakl. Tanto o Preços v1 quanto o Preços v2 são oferecidos.

As faturas são necessárias para os pedidos da Shop Apotheke? #

Os requisitos de fatura dependem da sua configuração. Em alguns casos, as faturas do comerciante são opcionais. Em outros, uma fatura deve ser anexada antes da confirmação do envio.

✅ Se precisar de ajuda com a configuração ou tiver problemas de validação, entre em contato com a equipe de suporte da M2E Cloud.