Conectar a Walmart: receber pedidos e enviar fulfillment
Copie seu Consumer ID e Private Key do Walmart Developer Portal, cole no Integration, teste, mapeie e ative.
O conector da Walmart traz pedidos do Walmart Marketplace para o OMS e devolve fulfillment e estoque à Walmart. Também traz devoluções e pode enviar atualizações de produto e estoque.
Pré-requisitos#
- Uma conta de vendedor do Walmart Marketplace.
- Acesso ao Walmart Developer Portal, com permissão para abrir My apps dessa conta.
- Alguém que possa guardar a Private Key com segurança: precisará da chave completa se reconectar ou rotacionar.
Obter credenciais#
- Vá ao Walmart Developer Portal → My apps e abra o app da sua conta do Marketplace.
- Copie o Consumer ID exibido nessa página.
- Copie a Private Key da mesma página. Está em formato PKCS#8 PEM e começa com -----BEGIN PRIVATE KEY-----: copie o texto inteiro, incluindo a primeira e a última linha.
Preencher no Integration#
- Abra Integration → Marketplace → Walmart → Nova conexão.
- Consumer ID: cole o Consumer ID copiado do Walmart Developer Portal → My apps. Os dois campos são obrigatórios.
- Private Key: cole a Private Key completa em formato PKCS#8 PEM, começando com -----BEGIN PRIVATE KEY----- e incluindo a linha de fechamento. As solicitações são assinadas com Consumer ID + Private Key; a chave é criptografada em repouso e nunca exibida.
Testar a conexão#
Clique em Testar a conexão. O teste envia uma solicitação assinada — com seu Consumer ID e Private Key — para sondar a API do Walmart Marketplace. Se passar, a Walmart aceitou a assinatura e as credenciais funcionam. Se falhar, anote o erro e veja as perguntas frequentes antes de mudar outra coisa.
Mapping / escolher modelo#
Escolha o modelo padrão da Walmart. Ele mapeia número do pedido, SKUs das linhas, quantidades, endereço de entrega e status de fulfillment. Revise a prévia antes de ativar, sobretudo se cada SKU da Walmart está vinculado ao produto OMS correto.
Ativar#
Após ativar, o Integration traz novos pedidos do Walmart Marketplace na frequência definida, traz devoluções e devolve fulfillment com rastreio, atualizações de produto e mudanças de estoque à Walmart. Acompanhe os primeiros pedidos em Runs / Logs.
Perguntas frequentes#
O teste falha com 401
A Walmart rejeitou a assinatura da solicitação de teste. A causa mais comum é uma Private Key copiada de forma incompleta ou com o formato danificado, então a assinatura não pode ser verificada.
Copie novamente a Private Key do Walmart Developer Portal → My apps e cole o texto inteiro: deve ser um PEM PKCS#8 completo, começando com -----BEGIN PRIVATE KEY----- e terminando com a linha de fechamento, sem faltar nenhum caractere. Salve e teste de novo.
O teste falha: Consumer ID não reconhecido
O campo Consumer ID está com um valor incorreto: muitas vezes foi colado outro ID em vez do Consumer ID deste app, e a Walmart não consegue associar a solicitação assinada ao seu app.
Volte ao Walmart Developer Portal → My apps, copie exatamente o Consumer ID desse app, substitua o valor na conexão, salve e teste de novo.
A conexão funcionava e agora todo teste falha
A chave ou o app do lado da Walmart não é mais válido: por exemplo, a Private Key foi revogada ou o app foi desativado no Walmart Developer Portal. Uma chave que a Walmart não aceita mais não assina solicitações, não importa como seja colada.
Gere uma nova Private Key para o app no Walmart Developer Portal, cole a nova chave completa na conexão, salve e teste de novo. Guarde a nova chave em local seguro: ela só fica totalmente visível ao ser gerada.
Conectado, mas não chegam pedidos
A conexão está bem — o teste passa — mas o Walmart Marketplace ainda não tem pedidos novos para esta conta, então não há nada para trazer.
Faça um pedido real no seu anúncio do Walmart Marketplace (ou aguarde o próximo pedido de cliente), depois execute uma extração manual e veja Runs / Logs. Pedidos novos aparecem assim que a Walmart os emite.