Conectar a BigCommerce: receber pedidos e enviar fulfillment

Copie seu Store hash e Access Token de BigCommerce Configurações → API, cole no Integration, teste, mapeie e ative.

O conector da BigCommerce traz pedidos da sua loja BigCommerce para o OMS e devolve fulfillment à BigCommerce. Também pode enviar atualizações de produto e estoque, para que pedidos, envios e estoque fiquem sincronizados nos dois lados.

Pré-requisitos#

• Uma loja BigCommerce, com acesso a Configurações → API dessa loja.
• Permissão para criar uma conta de API em BigCommerce → Configurações → API.
• A conta de API precisa ter os escopos Orders, Products e Inventory: sem eles o conector não consegue trazer pedidos nem enviar atualizações de produto e estoque.

Obter credenciais#

1. Na BigCommerce, vá a Configurações → API e crie uma conta de API.
2. Ao criar a conta, certifique-se de incluir os escopos Orders, Products e Inventory: o conector precisa dos três.
3. Copie o Access Token dessa conta de API e guarde-o em local seguro: você o colará no Integration na próxima etapa.
4. Encontre o Store hash no caminho de API dessa conta de API. O caminho é como https://api.bigcommerce.com/stores/abc123def/v3: a parte depois de /stores/ é o Store hash, neste exemplo abc123def. Copie só essa parte.

Preencher no Integration#

1. Abra Integration → Marketplace → BigCommerce → Nova conexão.
2. Store hash: cole apenas o hash da loja do caminho de API, por exemplo abc123def. Não cole a URL completa: este campo recebe só o hash, e é ele que identifica a qual loja a conexão pertence.
3. Access token: cole o Access Token que você copiou da conta de API em BigCommerce → Configurações → API. Os dois campos são obrigatórios. O token é criptografado em repouso e nunca exibido.

Testar a conexão#

Clique em Testar a conexão. O teste usa o Store hash e o Access Token que você preencheu para alcançar sua loja BigCommerce e verificar se as credenciais funcionam. Se passar, a loja foi encontrada e o token foi aceito. Se falhar, anote o erro e veja as perguntas frequentes antes de mudar outra coisa.

Mapping / escolher modelo#

Escolha o modelo padrão da BigCommerce. Ele mapeia número do pedido, SKUs das linhas, quantidades, endereço de entrega e status de fulfillment entre a BigCommerce e o pedido padrão. Revise a prévia antes de ativar, sobretudo se cada SKU da BigCommerce está vinculado ao produto OMS correto.

Ativar#

Após ativar, o Integration traz novos pedidos da BigCommerce na frequência definida, devolve fulfillment com códigos de rastreio à BigCommerce 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: o token não é aceito

O Access Token da conexão está incorreto ou não é mais válido: por exemplo foi copiado incompleto, ou a conta de API da qual ele veio não é mais a que está em uso. A BigCommerce não aceita um token que não reconhece, então toda solicitação falha na entrada.

Vá a BigCommerce → Configurações → API, abra sua conta de API, copie de novo o Access Token inteiro e cole no campo Access token da conexão. Salve e teste de novo.

A sincronização é bloqueada: falta um escopo na conta de API

As credenciais alcançam a loja, mas a conta de API não recebeu todos os escopos de que o conector precisa. Sem o escopo Orders os pedidos não podem ser trazidos; sem Products ou Inventory, as atualizações de produto e estoque não podem ser enviadas.

Vá a BigCommerce → Configurações → API e verifique a conta de API: certifique-se de que Orders, Products e Inventory estão todos incluídos. Se criar uma nova conta de API com os escopos certos, copie também o Access Token dela para a conexão. Salve e teste de novo.

O teste não encontra a loja

O campo Store hash está com um valor incorreto. A causa mais comum é colar o caminho de API completo ou a URL completa no campo em vez de só o hash, ou usar o hash de outra loja: de qualquer forma, a conexão aponta para uma loja que a BigCommerce não consegue associar ao seu token.

Vá a BigCommerce → Configurações → API, abra sua conta de API e veja o caminho de API dela: copie só a parte depois de /stores/, por exemplo abc123def de https://api.bigcommerce.com/stores/abc123def/v3. Substitua o Store hash da conexão por esse valor, salve e teste de novo.

Conectado, mas não chegam pedidos

A conexão está bem — o teste passa — mas sua loja BigCommerce ainda não tem pedidos novos, então não há nada para trazer.

Faça um pedido na sua loja BigCommerce (ou aguarde o próximo pedido de cliente), depois execute uma extração manual e veja Runs / Logs. Pedidos novos aparecem assim que a loja os emite.