Este guia explica como ligar e gerir o mercado Shop Apotheke utilizando o M2E Mirakl Connect.
A Shop Apotheke é uma farmácia online e um mercado dedicado à saúde com sede na Europa. Funciona na plataforma Mirakl, o que significa que segue as normas da Mirakl no que diz respeito a dados de produtos, ofertas, preços e processamento de pedidos.
O M2E Mirakl Connect permite-lhe gerir o Shop Apotheke diretamente a partir da sua loja. Após a ligação, poderá:
- sincronizar produtos e ofertas,
- atualizar preços e stock,
- importar e processar pedidos,
- enviar confirmações de rastreio e envio,
- e monitorizar o estado das listagens e os resultados da validação.
ℹ️ A maioria dos passos descritos neste guia também se aplica a outras plataformas de comércio eletrónico da Mirakl compatíveis com o M2E Mirakl Connect.
Fora do M2E Mirakl Connect #
A Shop Apotheke liga marcas e comerciantes a clientes que compram online produtos de saúde, bem-estar e produtos de higiene pessoal. O mercado opera várias lojas online localizadas, cada uma direcionada a um país específico:
- shop-apotheke.com (Alemanha)
- shop-apotheke.at (Áustria)
- farmaline.be (Bélgica)
- redcare.it (Itália)
ℹ️ A Shop Apotheke não suporta contas multicanal no âmbito de um único contrato. Se pretender vender em vários países, terá de celebrar um contrato separado e concluir o processo de integração para cada loja online.
Quem deve optar pela Shop Apotheke? #
A Shop Apotheke é mais adequada para comerciantes que vendem produtos relacionados com a saúde, com identificadores claros e dados de produto estruturados.
As categorias mais comuns incluem:
- produtos de saúde e bem-estar,
- produtos de venda livre e suplementos,
- artigos de higiene e cuidados pessoais,
- dispositivos médicos e produtos óticos,
- produtos de saúde para bebés, animais de estimação e uso doméstico.
ℹ️ Os itens farmacêuticos e os itens sujeitos a regulamentação podem exigir aprovações e documentação adicionais. O acesso às categorias e as autorizações de venda são definidos pela Shop Apotheke.
Custos de venda na Shop Apotheke #
Vender na Shop Apotheke implica:
- Taxa mensal: 39,00 €
- Comissão: varia consoante a categoria do produto e o acordo comercial
- Taxa de ativação: nenhuma
As taxas de comissão são acordadas durante o registo do vendedor e dependem da estrutura de categorias do mercado.
Requisitos técnicos #
Antes de iniciar a configuração, certifique-se de que os seguintes requisitos estão cumpridos:
- Está registado para efeitos de IVA nos países onde pretende vender.
- Os seus produtos têm códigos EAN ou GTIN válidos.
- Os dados dos produtos estão completos e cumprem as regras de conteúdo da Shop Apotheke.
- As definições de envio estão claramente definidas.
- Está autorizado a vender nas categorias selecionadas.
Os produtos que não cumpram as normas do marketplace podem ser rejeitados durante a validação.
Solicitar conta de vendedor e acesso #
Antes de ligar a Shop Apotheke ao M2E Mirakl Connect, deve solicitar uma conta de vendedor diretamente junto do marketplace.
Durante o processo de aprovação, a Shop Apotheke poderá solicitar:
- dados da empresa e do número de identificação fiscal,
- informações sobre as categorias que pretende vender,
- um exemplo de feed de produtos para análise.
Em alguns casos, a Shop Apotheke analisa o seu Catálogo antes de criar a sua loja. Isto garante que os seus produtos correspondem ao âmbito da categoria e às regras de conformidade.
A aprovação é gerida pela Shop Apotheke. Os tempos de processamento podem variar.
Após a aprovação, terá acesso ao portal Mirakl Seller Admin. Este acesso é necessário para continuar. Necessitará das suas credenciais Mirakl e da chave API para ligar a Shop Apotheke ao M2E Mirakl Connect.
No M2E Mirakl Connect #
Para gerir a Shop Apotheke a partir do M2E, ligue a sua conta de vendedor Mirakl utilizando uma chave API. Esta ligação permite que o M2E troque dados de produtos, ofertas e pedidos com o marketplace em tempo real.
Após a ligação, o M2E sincroniza:
- Produtos e ofertas
- Preços e quantidades em stock
- Pedidos e estados dos pedidos
- Detalhes de rastreio e atualizações de envio
Como ligar a Shop Apotheke #
Pode integrar a Shop Apotheke com a sua loja Adobe Commerce (Magento) através do M2E Mirakl Connect. A configuração segue o fluxo padrão utilizado para todos os mercados baseados no Mirakl.
Passos de configuração:
- Instale a extensão M2E Mirakl Connect e aprove as permissões necessárias.
- Inicie sessão na sua conta M2E ou crie uma nova.
- Adicione a sua conta do mercado Shop Apotheke utilizando o seu URL da API Mirakl e a chave da API.
- Associe os produtos Magento às listagens correspondentes da Shop Apotheke.
- Ative a sincronização de inventário para manter os níveis de stock precisos.
- Configure a importação de pedidos para que os pedidos da Shop Apotheke apareçam no Magento e sejam automaticamente deduzidos do inventário.
Assim que a configuração estiver concluída, o seu Catálogo, stock e pedidos permanecerão sincronizados entre o Magento e a Shop Apotheke.
✅ Para obter instruções detalhadas, consulte o Guia do Utilizador do M2E Mirakl Connect
Gestão quotidiana #
Uma vez estabelecida a ligação, a maioria das ações ocorre automaticamente.
Controla os produtos no Magento. O M2E envia atualizações de stock e preços para a Shop Apotheke. Os pedidos são sincronizados de volta para o Magento sem necessidade de introdução manual.
A sua equipa processa os pedidos do marketplace da mesma forma que os pedidos do site – sem fluxos de trabalho adicionais.
Configuração da sincronização de produtos #
Tem duas opções:
- Criar novas listagens (em breve). Utilize os dados do Magento para publicar produtos na Shop Apotheke. O M2E mantém os preços e as quantidades atualizados.
- Ligar listagens existentes. Se já existirem listagens, associe-as aos produtos do Magento. A associação é obrigatória. Indica ao M2E qual o item do Magento que controla cada oferta. Depois disso, o stock e os preços permanecem automaticamente alinhados.
Gestão de produtos e políticas de sincronização #
No M2E Mirakl Connect, o controlo dos produtos na Shop Apotheke é gerido através de políticas.
Uma política funciona como um conjunto de regras. Define a forma como se aplicam as atualizações de preços, a sincronização de stock e as configurações de pedidos.
Esta abordagem simplifica a gestão do Catálogo. Em vez de configurar os produtos individualmente, atribui-se uma política a vários itens. O M2E gere-os então de acordo com as mesmas regras.
Utilização diária das políticas:
- As políticas controlam a forma como as informações do Magento são transferidas para a Shop Apotheke, incluindo quantidade, preço e estado da listagem.
- A edição de uma política atualiza instantaneamente todos os produtos atribuídos.
- Pode criar várias políticas para corresponder a diferentes objetivos de vendas ou grupos de produtos.
- As políticas são geridas a partir da secção Configuração ou diretamente nas listagens de produtos.
Gestão de categorias #
Categorias precisas são fundamentais para a visibilidade na Shop Apotheke.
O M2E Mirakl Connect permite-lhe atribuir e atualizar categorias de forma eficiente. Pode rever o mapeamento de categorias a qualquer momento para se adequar aos requisitos do marketplace. Um mapeamento adequado reduz os erros de validação e garante que os produtos sejam apresentados nas secções corretas.
Gestão de pedidos #
O processamento de pedidos é automatizado assim que a integração estiver ativa.
Os pedidos da Shop Apotheke são importados para o Magento sem necessidade de introdução manual. Pode geri-los utilizando o fluxo de trabalho habitual da sua loja.
A criação automática de pedidos pode ser ativada nas definições da conta. Quando ativada, são gerados pedidos no Magento para cada nova transação da Shop Apotheke. A criação manual de pedidos continua disponível, se necessário.
Esta configuração mantém a gestão de pedidos centralizada e organizada.
No lado do mercado Shop Apotheke #
Quando exporta produtos e ofertas a partir do M2E Mirakl Connect, a Shop Apotheke realiza a validação final do seu lado. Todas as verificações são executadas no Mirakl. Estas regras pertencem ao mercado e não podem ser modificadas no M2E.
Funcionalidades do mercado Shop Apotheke #
A Shop Apotheke suporta um conjunto específico de funcionalidades do Mirakl.
Suportados
- Conteúdo do produto
- Ofertas de produtos
- Pedidos
- Cancelamentos por parte do comerciante
- Devoluções por parte do comerciante
- Mapeamento de transportadoras
- Formatação HTML
- Vários locais de stock
- Pacotes
- Carregamento de faturas
- Liquidações
Não suportados
- Relações automáticas
- Variações de produto (tamanho ou cor)
- Produtos recondicionados
- Reajustamento de preços
- Cancelamentos do mercado
- Devoluções do mercado
- Envios geridos pelo mercado
- Serviços de fulfillment do mercado
- Canais de vendas
ℹ️ Todas as lojas online por país seguem a mesma estrutura básica de funcionalidades. No entanto, os requisitos de integração podem variar consoante o país.
Requisitos relativos aos produtos e às ofertas #
Para publicar produtos com sucesso, deve cumprir as regras de validação tanto da Shop Apotheke como da Mirakl. Os campos obrigatórios devem estar preenchidos e formatados corretamente.
Dados obrigatórios do produto
- EAN ou GTIN. Este é o identificador principal do produto. Códigos em falta ou inválidos impedem a publicação.
- Título do produto. Apenas texto simples com um comprimento máximo de 100 caracteres. Não inclua quantidades nem tags HTML.
- Imagem principal. É necessário um fundo branco e um formato quadrado. Formatos aceites: JPG, PNG, WEBP. Resolução mínima: 450 × 450 px, mas a resolução recomendada é 1000 × 1000 px. Tamanho máximo do ficheiro: 5 MB.
- Marca deve refletir a marca oficial do produto.
- Quantidade e unidade. A unidade deve ser selecionada a partir de valores predefinidos, tais como g, ml ou l. A quantidade pode incluir até três valores separados por “x”.
- Atributos específicos da categoria. Os atributos obrigatórios dependem da categoria selecionada. Todos os campos obrigatórios devem ser preenchidos corretamente.
Dados opcionais do produto
- Imagens adicionais
- Descrições curtas e longas
- Características do produto e instruções de utilização
- Variações agrupadas por um código comum
- Atributos regulamentares, tais como PZN ou WEEE, quando aplicável
Os campos opcionais continuam a ser validados. Valores incorretos podem impedir a exportação.
Configuração de ofertas, preços e IVA #
Os preços devem seguir as regras do Mirakl. Uma configuração incorreta bloqueia a publicação da oferta.
- IVA. É necessária uma taxa de IVA válida para cada produto.
- Moeda. Apenas o EUR é aceite.
- Descontos e promoções. A Shop Apotheke suporta a lógica de descontos do Mirakl.
- Preços v1 utiliza Preço com desconto, Data de início do desconto e Data de fim do desconto. O preço com desconto deve ser sempre inferior ao preço base.
- Preços v2 utiliza Preço de referência como preço original e Preço como valor com desconto. O Preço e o Preço de referência não podem ser idênticos.
- Descontos por quantidade requerem um limite de quantidade igual a 1 ou mais.
- O formato da data deve seguir as regras da Mirakl: AAAA-MM-DD HH:MM:SS, em UTC.
Se os dados de preços forem inválidos, as ofertas não serão publicadas.
Envio, rastreio e atributos Mirakl #
As plataformas de comércio eletrónico Mirakl exigem atributos adicionais, dependendo da categoria e das configurações logísticas.
Exemplos comuns incluem:
- Prazo de entrega é o número de dias entre a realização dos pedidos e o envio.
- Classe logística determina o tratamento da entrega. Códigos aceites: klein, mittel, groß, extragroß.
- Requisitos de rastreamento. Um número de rastreamento e um URL de rastreamento são obrigatórios para todas as remessas. O mapeamento da transportadora é opcional, mas recomendado.
- Atributos Eco e EPR aplicam-se a produtos sujeitos a regulamentos ambientais. Estes podem incluir taxas ecológicas ou IDs de registo do produtor.
Todos os atributos obrigatórios devem ser mapeados corretamente para que a exportação seja bem-sucedida.
FAQ #
Por que é que o meu produto não está listado? #
A maioria dos problemas com as listagens resulta de erros de validação. As causas mais comuns incluem:
- EAN em falta ou inválido
- Imagem que não cumpre as regras de formato
- Atributos obrigatórios não mapeados
- Número de IVA em falta
- Configuração incorreta dos preços
A Shop Apotheke suporta descontos? #
Os descontos são suportados através da lógica de preços do Mirakl. Estão disponíveis tanto o Pricing v1 como o Pricing v2.
✅ Se precisar de ajuda com a configuração ou se tiver problemas com a validação, contacte a equipa de apoio do M2E.
