Conectar a Lowe's: receber pedidos e enviar fulfillment
Encontre a URL base da API da Mirakl na documentação da API do seu portal de vendedor Mirakl da Lowe's, copie sua chave de API em nome de usuário → API Key, cole as duas no Integration, teste, mapeie e ative.
O conector da Lowe's traz pedidos da sua loja no marketplace da Lowe's para o OMS pela Mirakl e devolve fulfillment à Lowe's. Também pode enviar atualizações de produto e estoque, para que pedidos, envios e estoque fiquem sincronizados nos dois lados. Uma conexão aponta para um único ambiente Mirakl da Lowe's: a URL base da API e a chave de API precisam pertencer a esse mesmo ambiente.
Pré-requisitos#
- Uma conta de vendedor do marketplace da Lowe's, com acesso ao portal de vendedor Mirakl da Lowe's dessa loja.
- Permissão no portal de vendedor Mirakl para ver a documentação da API e gerar uma chave de API para o seu usuário: o conector se autentica com essa chave.
- Seu próprio ambiente Mirakl da Lowe's pronto para copiar: a URL base da API é específica do seu ambiente e não é a mesma para todos os marketplaces Mirakl, então não pegue emprestado o endereço de outra loja Mirakl.
Obter credenciais#
- Entre no portal de vendedor Mirakl da Lowe's e abra a documentação da API do seu portal de vendedor. Encontre lá a URL raiz da API: ela é como https://<your-env>/api. Copie o endereço completo exatamente como exibido para o seu ambiente.
- No mesmo portal de vendedor, clique no seu nome de usuário no canto superior direito e depois abra API Key.
- Na página API Key, escolha Generate New Key se você ainda não tem uma chave, ou Copy para copiar a que já tem. Guarde a chave em local seguro: você a colará no Integration na próxima etapa, e ela é enviada como valor do cabeçalho Authorization em cada solicitação.
Preencher no Integration#
- Abra Integration → Marketplace → Lowe's → Nova conexão.
- URL base da API da Mirakl: cole a URL raiz da API que você encontrou na documentação da API do seu portal de vendedor Mirakl da Lowe's, por exemplo https://<your-env>/api. Cole apenas o endereço do seu próprio ambiente da Lowe's: um endereço de outra instância Mirakl vai alcançar o marketplace errado, mesmo que o formato pareça certo.
- Chave de API: cole a chave de API que você copiou do portal de vendedor Mirakl da Lowe's → seu nome de usuário (canto superior direito) → API Key. Este campo é obrigatório, é enviado como valor do cabeçalho Authorization, é criptografado em repouso e nunca exibido.
Testar a conexão#
Clique em Testar a conexão. O teste usa a URL base da API da Mirakl e a chave de API que você preencheu para alcançar seu ambiente Mirakl da Lowe's e verificar se a chave é aceita como cabeçalho Authorization. Se passar, o endereço alcançou o ambiente certo e a chave funciona. Se falhar, anote o erro e veja as perguntas frequentes antes de mudar outra coisa: a maioria das falhas vem da chave ou de a URL base apontar para a instância Mirakl errada.
Mapping / escolher modelo#
Escolha o modelo padrão da Lowe's. Ele mapeia número do pedido, SKUs das linhas, quantidades, endereço de entrega e status de fulfillment entre a Lowe's (Mirakl) e o pedido padrão, e carrega os campos de produto e estoque usados ao enviar atualizações. Revise a prévia antes de ativar, sobretudo se cada SKU da Lowe's está vinculado ao produto OMS correto.
Ativar#
Após ativar, o Integration traz novos pedidos da Lowe's na frequência definida, devolve fulfillment com códigos de rastreio à Lowe's e envia atualizações de produto e estoque. Acompanhe os primeiros pedidos em Runs / Logs antes de deixar sem supervisão.
Perguntas frequentes#
O teste falha: a chave de API não é aceita
A chave de API da conexão está incorreta ou não é mais válida: por exemplo foi copiada incompleta, pertence a outro usuário, ou uma nova chave foi gerada e a antiga guardada na conexão não é mais a atual. Como a chave é enviada como cabeçalho Authorization em cada solicitação, a Mirakl rejeita toda solicitação na entrada quando não reconhece a chave.
Vá ao portal de vendedor Mirakl da Lowe's, clique no seu nome de usuário no canto superior direito → API Key e copie a chave atual inteira — ou escolha Generate New Key se precisar de uma nova — e cole no campo API key da conexão. Salve e teste de novo.
O teste falha ou alcança a loja errada: a URL base da Mirakl está incorreta
O campo de URL base da API da Mirakl está com um endereço que não pertence ao seu ambiente da Lowe's. A causa mais comum é colar o endereço de outra instância Mirakl: outro marketplace ou outro ambiente que também roda na Mirakl. Esse endereço pode parecer perfeitamente válido, mas aponta para outro lugar, então sua chave de API da Lowe's não combina lá e o teste não alcança sua loja da Lowe's.
Vá ao portal de vendedor Mirakl da Lowe's e abra de novo a documentação da API do seu portal de vendedor. Copie a URL raiz da API exibida lá para o seu ambiente — ela é como https://<your-env>/api — substitua a URL base da API da Mirakl da conexão por esse endereço exato, salve e teste de novo. Não reutilize um endereço copiado de outra loja Mirakl.
Conectado, mas não chegam pedidos
A conexão está bem — o teste passa — mas sua loja da Lowe's ainda não tem pedidos novos, então não há nada para trazer.
Verifique primeiro o portal de vendedor Mirakl da Lowe's para confirmar se um pedido novo foi realmente emitido para sua loja. Se foi, execute uma extração manual e veja Runs / Logs. Se o portal também não mostrar pedido novo, aguarde o próximo pedido de cliente: pedidos novos aparecem no Integration assim que a Lowe's os emite.