Conectar a Etsy: receber pedidos e enviar fulfillment
Encontre seu Shop ID numérico na URL de administração da sua loja Etsy, copie a chave API no Etsy Developers, cole ambos junto com seu token de acesso OAuth no Integration, teste, mapeie e ative.
O conector da Etsy traz pedidos da sua loja Etsy para o OMS e devolve fulfillment à Etsy. Também pode enviar produtos e estoque, para que anúncios, estoque e envios fiquem sincronizados dos dois lados.
Pré-requisitos#
- Uma loja Etsy, com acesso à administração para ver a URL de administração da loja.
- Acesso a Etsy Developers → Your apps, onde é exibida a chave API (KEYSTRING) do seu aplicativo.
- Possibilidade de concluir o fluxo de autorização OAuth para essa loja: o token de acesso só é obtido após a conclusão desse fluxo.
Obter credenciais#
- Encontre seu Shop ID: abra a administração da sua loja Etsy e veja a URL de administração: o Shop ID é o ID numérico dessa URL, por exemplo 12345678. Copie apenas o número, não o nome da loja.
- Copie a chave API: vá a Etsy Developers → Your apps → copie a chave API (KEYSTRING) do seu aplicativo. Guarde-a em local seguro: você a colará no campo API key do Integration.
- Obtenha o token de acesso OAuth: conclua o fluxo de autorização OAuth da sua loja e copie o token de acesso obtido após o fluxo. Você o colará no campo OAuth access token do Integration.
Preencher no Integration#
- Abra Integration → Marketplace → Etsy → Nova conexão.
- Shop ID: preencha o ID numérico da URL de administração da sua loja Etsy, por exemplo 12345678. Não preencha o nome da loja: o campo aceita apenas o número.
- API key, obrigatório: cole a chave API (KEYSTRING) que você copiou de Etsy Developers → Your apps. É criptografada em repouso e nunca exibida.
- OAuth access token: cole o token de acesso obtido após o fluxo de autorização OAuth. Deve ser da mesma loja que o Shop ID acima: um token de outra loja não corresponderá.
Testar a conexão#
Clique em Testar a conexão. O teste verifica juntos o Shop ID, a chave API e o token de acesso OAuth, e depois mostra uma prévia em nível de documento com um pedido real, com os campos da plataforma ao lado do pedido padrão. Se a loja ainda não tiver pedidos, faça primeiro um pedido de teste na Etsy: a prévia precisa de um documento real. Se o teste falhar, anote o erro e veja a FAQ antes de mudar qualquer outra coisa.
Mapping / escolher modelo#
Escolha o modelo padrão da Etsy. Mapeia número do pedido, SKU da linha, quantidades, endereço de entrega e status de fulfillment. Revise a prévia de mapping com um pedido real antes de ativar, principalmente se cada SKU da Etsy está vinculado a um produto do OMS, para que pedidos, produtos e estoque coincidam dos dois lados.
Ativar#
Após ativar, o Integration traz pedidos novos na frequência definida, devolve fulfillment com números de rastreio à Etsy e envia mudanças de produtos e estoque à Etsy. Acompanhe os primeiros pedidos em Runs / Logs antes de deixar sem supervisão.
Perguntas frequentes#
O teste falha: loja não encontrada
O Shop ID está incorreto. O mais comum é ter preenchido o nome da loja em vez do ID numérico, então a conexão procura uma loja que não corresponde a nenhum Shop ID real.
Abra a administração da sua loja Etsy, leia o ID numérico na URL de administração (por exemplo 12345678), substitua o campo Shop ID apenas por esse número e teste novamente.
O teste falha com erro de credencial API
A chave API não corresponde ao seu aplicativo. Foi copiada incompleta, com um espaço extra, ou é a chave de outro aplicativo no Etsy Developers, então a Etsy rejeita a chamada.
Vá a Etsy Developers → Your apps, copie novamente a chave API (KEYSTRING) do aplicativo correto exatamente como exibida, cole no campo API key sem espaços extras e teste novamente.
A autorização expirou
O token de acesso OAuth não é mais válido. A autorização por trás dele expirou, então as chamadas que precisam desse token são recusadas até a loja ser autorizada novamente.
Conclua novamente o fluxo de autorização OAuth para a mesma loja, copie o novo token de acesso obtido após o fluxo, substitua o campo OAuth access token e teste novamente.
Conectado mas nenhum pedido é importado
A conexão está bem. A loja simplesmente não tem pedidos novos no intervalo de extração, então ainda não há nada para importar.
Faça um pedido de teste na sua loja Etsy, verifique se o horário está dentro do intervalo de extração, execute uma extração manual e confirme que o pedido aparece na prévia ou em Runs / Logs.