Conectar a Best Buy: receber pedidos e enviar fulfillment
Copie sua API Key do Best Buy Mirakl Seller Portal, cole no Integration, teste, mapeie e ative: entram pedidos e voltam fulfillment, produto e estoque.
O conector da Best Buy traz pedidos da Best Buy para o OMS e devolve fulfillment à Best Buy, além de enviar atualizações de produto e estoque. Uma conexão usa uma API Key.
Pré-requisitos#
- Uma conta de vendedor da Best Buy que possa entrar no Best Buy Mirakl Seller Portal.
- Permissão para abrir a página API Key a partir do seu nome de usuário, no canto superior direito desse portal.
- Alguém que possa guardar a API Key com segurança: precisará da chave completa se reconectar ou substituí-la.
Obter credenciais#
- Entre no Best Buy Mirakl Seller Portal e clique no seu nome de usuário, no canto superior direito.
- Abra API Key a partir desse menu.
- Clique em Generate / Copy e copie a API Key completa. Se ainda não houver chave, gere uma primeiro e depois copie.
Preencher no Integration#
- Abra Integration → Marketplace → Best Buy → Nova conexão.
- API key: cole a API Key que você copiou do Best Buy Mirakl Seller Portal. É o único campo de credenciais e é obrigatório. É criptografada em repouso e nunca exibida.
Testar a conexão#
Clique em Testar a conexão. O teste usa sua API Key para trazer uma página de pedidos da Best Buy e verificar se a chave funciona. Se passar, a Best Buy aceitou a chave e devolveu essa página de pedidos. Se falhar, anote o erro e veja as perguntas frequentes antes de mudar outra coisa.
Mapping / escolher modelo#
Escolha o modelo padrão da Best Buy. Ele mapeia número do pedido, SKUs das linhas, quantidades, endereço de entrega e status de fulfillment entre a Best Buy e o pedido padrão. Revise a prévia antes de ativar, sobretudo se cada SKU da Best Buy está vinculado ao produto OMS correto.
Ativar#
Após ativar, o Integration traz novos pedidos da Best Buy na frequência definida, devolve fulfillment à Best Buy e envia atualizações de produto e estoque. Acompanhe os primeiros pedidos em Runs / Logs.
Perguntas frequentes#
O teste falha: a API Key é rejeitada
A API Key está incorreta ou foi revogada, então a Best Buy não a aceita quando o teste traz uma página de pedidos.
Gere uma nova API Key no Best Buy Mirakl Seller Portal → seu nome de usuário (canto superior direito) → API Key → Generate / Copy, cole a nova chave completa na conexão, salve e teste de novo.
O teste falha logo depois de colar a chave
A chave foi copiada de forma incompleta: falta uma parte, então o valor colado não corresponde à API Key do Best Buy Mirakl Seller Portal.
Volte ao Best Buy Mirakl Seller Portal → seu nome de usuário (canto superior direito) → API Key → Copy, copie a chave de novo por inteiro, substitua o valor na conexão, salve e teste de novo.
Conectado, mas não chegam pedidos
A conexão está bem — o teste passa — mas a Best Buy ainda não tem pedidos novos para sua conta, então não há nada para trazer.
Confirme no Best Buy Mirakl Seller Portal que um pedido novo apareceu, depois execute uma extração manual e veja Runs / Logs. Pedidos novos aparecem assim que a Best Buy os emite.
SKUs aparecem como não mapeados
O SKU do canal ainda não está vinculado a um produto no OMS, então pedidos com esse SKU não podem ser associados a um produto.
Abra a aba de pendentes em Product Mapping, vincule cada SKU do canal a um produto do OMS e depois veja o próximo pedido trazido em Runs / Logs.