Conectar a Home Depot: receber pedidos e enviar fulfillment
Pegue a URL base da API e a API key da sua integração como fornecedor da Home Depot, cole no Integration, teste, mapeie e ative.
O conector da Home Depot traz pedidos da Home Depot para o OMS e devolve fulfillment à Home Depot. Também pode enviar atualizações de produto e estoque, para que pedidos, envios e estoque fiquem sincronizados nos dois lados.
Pré-requisitos#
- Você é fornecedor da Home Depot e sua integração como fornecedor está concluída, então a API de fornecedores já foi aberta para você.
- Você tem a URL base da API e a API key dessa integração: ambas são obrigatórias para criar a conexão.
- Você conhece seu ID de fornecedor da Home Depot. Ele é opcional e serve só como referência, mas tê-lo à mão ajuda a conferir a conexão depois.
Obter credenciais#
- Abra os materiais da sua integração como fornecedor da Home Depot e encontre o endereço da API de fornecedores. Esse endereço é sua URL base da API: copie exatamente como foi entregue, começando com https://.
- Nos mesmos materiais, encontre a API key. Copie-a inteira e guarde-a em local seguro: você a colará no Integration na próxima etapa, e ela é enviada como cabeçalho X-API-Key em cada solicitação.
- Anote seu ID de fornecedor da Home Depot dos mesmos materiais. Você só precisa dele como referência na conexão, então anote-o como aparece.
Preencher no Integration#
- Abra Integration → Marketplace → Home Depot → Nova conexão.
- URL base da API: cole o endereço da API de fornecedores da sua integração como fornecedor da Home Depot, completo e exatamente como foi entregue; por exemplo, começa com https://. Este campo é obrigatório e decide para onde vai cada solicitação, então não o encurte nem use um endereço de outro lugar.
- Chave de API: cole a API key da sua integração à API de fornecedores da Home Depot. Este campo é obrigatório. Ela é enviada como cabeçalho X-API-Key, criptografada em repouso e nunca exibida.
- ID de fornecedor: insira seu ID de fornecedor da Home Depot exatamente como aparece nos seus materiais de integração. Este campo é opcional e serve só como referência: ele rotula a conexão com seu número de fornecedor para você ver de relance a qual fornecedor ela pertence.
Testar a conexão#
Clique em Testar a conexão. O teste usa a URL base da API e a API key que você preencheu para alcançar a API de fornecedores da Home Depot e verificar se a chave é aceita. Se passar, o endereço foi alcançado e a chave funciona. Se falhar, anote o erro e veja as perguntas frequentes antes de mudar outra coisa.
Mapping / escolher modelo#
Escolha o modelo padrão da Home Depot. Ele mapeia número do pedido, SKUs das linhas, quantidades, endereço de entrega e status de fulfillment entre a Home Depot e o pedido padrão. Revise a prévia antes de ativar, sobretudo se cada SKU da Home Depot está vinculado ao produto OMS correto.
Ativar#
Após ativar, o Integration traz novos pedidos da Home Depot na frequência definida, devolve fulfillment com códigos de rastreio à Home Depot 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 API key não é aceita
A API key da conexão está incorreta: por exemplo foi copiada incompleta, ou não é a chave da sua integração à API de fornecedores da Home Depot. A chave é enviada como cabeçalho X-API-Key em cada solicitação, então uma chave que a Home Depot não reconhece falha na entrada toda vez.
Volte aos materiais da sua integração como fornecedor da Home Depot, copie de novo a API key inteira e cole no campo Chave de API da conexão. Salve e teste de novo.
O teste nem alcança a API
A URL base da API da conexão está incorreta. Este campo recebe o endereço da API de fornecedores da sua própria integração como fornecedor da Home Depot: se o que você colou está encurtado, digitado errado ou é um endereço de outro lugar, as solicitações vão para o lugar errado ou para lugar nenhum, e o teste falha antes mesmo de a API key ser verificada.
Volte aos materiais da sua integração como fornecedor da Home Depot e copie de novo o endereço da API de fornecedores inteiro, exatamente como foi entregue, e substitua por ele a URL base da API da conexão. Salve e teste de novo.
O ID de fornecedor da conexão não coincide
O ID de fornecedor foi digitado errado, então a referência da conexão aponta para um número de fornecedor diferente do que a Home Depot lhe deu na integração. A conexão ainda pode ser salva, mas o rótulo confunde quando você confere depois a qual fornecedor os pedidos pertencem.
Confira o ID de fornecedor nos materiais da sua integração como fornecedor da Home Depot e corrija o campo ID de fornecedor para coincidir exatamente. Se não tiver certeza do número, limpe o campo — ele é opcional e só de referência — depois salve e teste de novo.
Conectado, mas não chegam pedidos
A conexão está bem — o teste passa — mas a Home Depot ainda não emitiu pedidos novos para o seu fornecedor, então não há nada para trazer.
Aguarde o próximo pedido da Home Depot para o seu fornecedor, depois execute uma extração manual e veja Runs / Logs. Pedidos novos aparecem assim que a Home Depot os emite.