OpenJack › Conectores › Marketplaces Mirakl

Comércio eletrónico · Mirakl

Marketplaces Mirakl

Pergunte ao Claude pelas suas encomendas, stock, pagamentos e mensagens de clientes na Worten, Carrefour, Leroy Merlin, Decathlon e em qualquer outro marketplace Mirakl.

Liga o Claude à sua conta de vendedor em qualquer marketplace com tecnologia Mirakl (Worten, Carrefour, Leroy Merlin, Decathlon, Conforama, Maisons du Monde e muitos outros) em modo só de leitura. Liste e filtre encomendas e abra uma com as suas linhas, comissões e reembolsos; consulte as suas ofertas, encontre stock baixo e compare o seu preço com outros vendedores por SKU ou EAN; acompanhe devoluções; leia as faturas, linhas de transação e pagamentos do marketplace; leia mensagens de clientes e do operador; e obtenha um resumo de vendas de qualquer período com receita, comissão, reembolsos, líquido e SKUs principais. Nomes, emails, telefones e moradas dos clientes são ocultados (só a cidade e o país são mostrados). Nada é alguma vez aceite, enviado, reembolsado, alterado de preço ou respondido.

O que pode perguntar

Que encomendas estão à espera de aceitação ou envio na Worten neste momento?Resumo de vendas de outubro: receita, comissão do marketplace, reembolsos e os meus 10 SKUs principaisQue ofertas minhas têm 5 unidades ou menos em stock?Sou o vendedor mais barato para o EAN 9312432012041?Que mensagens de clientes ainda aguardam a minha resposta?Quanto me pagou o marketplace nos últimos ciclos de faturação e quanto ficou em comissões?

Ferramentas e preços

13 ferramentas

FerramentaO que fazPor chamada
mirakl_shop_infoPerfil da loja: estado, avaliação, taxa de aceitação, número de ofertas e encomendas, KYC e saldos de pagamento0,01 €
mirakl_list_ordersEncomendas filtradas por estado, data de criação ou atualização, canal ou incidente (100 por página)0,01 €
mirakl_get_orderUma encomenda com todas as linhas: SKU, quantidade, preços, envio, comissão, reembolsos, seguimento0,01 €
mirakl_list_offersAs suas ofertas com SKU, EAN, preço, desconto, stock e estado ativo (100 por página)0,01 €
mirakl_low_stock_offersTodas as ofertas com stock igual ou abaixo de um limite, da menor para a maior0,025 €
mirakl_lookup_productUm produto por SKU da loja, SKU do produto ou EAN: a sua oferta e o preço de todos os vendedores0,01 €
mirakl_list_returnsPedidos de devolução com estado, RMA, motivo, quantidades e seguimento0,01 €
mirakl_list_invoicesDocumentos contabilísticos emitidos pelo marketplace com totais, comissões e estado de pagamento0,01 €
mirakl_list_transactionsLinhas de transação (valores de encomendas, comissões, reembolsos, taxas, pagamentos) com totais por tipo0,01 €
mirakl_list_billing_cyclesCiclos de faturação e pagamentos: valor transferido, estado do pagamento e principais totais0,01 €
mirakl_list_threadsConversas com clientes e com o operador, incluindo as que aguardam a sua resposta0,01 €
mirakl_get_threadUma conversa com todas as mensagens (contactos do cliente ocultos)0,01 €
mirakl_sales_summaryEncomendas, unidades, receita, comissão, reembolsos e líquido de um período, por estado, mês e SKU principal0,05 €

Só é cobrado quando a chamada é bem-sucedida. Listar as ferramentas é gratuito.

Como ligar

Adicione-o ao Claude

Crie uma conta OpenJack e copie a sua chave de ligação em a sua conta.
No Claude, abra «Settings → Connectors → Add custom connector» e cole https://mirakl.openjack.dev/mcp.
Clique em «Connect». Na página de ligação, introduza a sua chave de ligação e as suas credenciais de Mirakl. São verificadas em tempo real e guardadas encriptadas.

Requisitos

FAQ

Que marketplaces funcionam?

Qualquer marketplace que funcione com Mirakl e dê uma chave de API aos vendedores, como Worten, Carrefour, Leroy Merlin (ADEO), Decathlon, Conforama, Maisons du Monde e muitos outros. Cada marketplace tem o seu próprio endereço Mirakl: use o que vê no navegador quando entra no back office de vendedor. Ligue cada marketplace separadamente.

Onde encontro a chave de API?

No back office de vendedor clique no seu nome de utilizador (canto superior direito) → My user settings → API Key e gere ou copie a chave. Gerar uma chave nova invalida a anterior, por isso outras ferramentas que a usem vão precisar da nova chave. Trate-a como uma palavra-passe.

O Claude pode aceitar encomendas, alterar preços ou responder a clientes?

Não. Todas as ferramentas são só de leitura. O conector nunca aceita nem recusa encomendas, não envia, não reembolsa, não altera ofertas, preços ou stock e não envia mensagens.

O que acontece aos dados pessoais dos meus clientes?

Nomes, emails, números de telefone e moradas dos clientes são removidos antes de chegarem ao Claude; só a cidade e o país de entrega são mantidos. Emails e números de telefone escritos dentro das mensagens também são ocultados. Nada é guardado nem registado.

Como é contada a receita no resumo de vendas?

Só as encomendas aceites pela loja (de WAITING_DEBIT a CLOSED) contam como vendas; as recusadas, canceladas e ainda por aceitar aparecem por estado mas não na receita. Os reembolsos e a comissão devolvida sobre eles são subtraídos para obter o líquido. Os valores incluem ou excluem impostos conforme a configuração do marketplace, ou como pedir.

Há limites?

A Mirakl devolve no máximo 100 itens por página e cada marketplace define limites horários por API (a API de linhas de transação permite no máximo 60 chamadas por hora; a consulta de preços da concorrência cerca de 5 por minuto). O resumo de vendas lê até 3 000 encomendas e a pesquisa de stock baixo até 2 000 ofertas por chamada, e indicam quando o resultado foi truncado.

Também no OpenJack