Como realizar a integração com Shopify

1. Requisitos Preliminares

Antes de iniciar, certifique-se de que você possui:

Uma conta ativa no Shopify Partners (a criação é gratuita).
Permissão de administrador para instalar aplicativos na loja Shopify desejada.

⚠️ Alerta de Segurança: O Client Secret (Segredo do Cliente) gerado neste processo é uma credencial sensível. Nunca o compartilhe em canais públicos ou com pessoas não autorizadas.

2. Instruções de Configuração

Passo 1: Crie sua conta no Shopify Partners

Acesse o portal em accounts.shopify.com/signup e inicie a criação da sua conta.
Durante o processo de cadastro, selecione a opção "Criar novo Partner".
Quando questionado sobre o seu objetivo, selecione "Build Apps" (Criar aplicativos).
Preencha os campos restantes com os seus dados para concluir o cadastro.

Passo 2: Acesse o Dev Dashboard

Após verificar o seu e-mail de cadastro, acesse o menu lateral esquerdo do painel.
Navegue por Distribuição de apps > Todos os apps e clique no botão Visitar o Dev Dashboard.

Passo 3: Crie um novo aplicativo

Dentro do Dev Dashboard, clique no botão para Criar um novo app.
Defina um nome claro para o aplicativo (por exemplo: "Integração Yoodash").

Passo 4: Configure e publique o aplicativo

Preencha os campos de configuração da seguinte forma:

URL do app: Insira https://app.yoodash.com.br.
Escopos: Insira read_orders,read_products (sem espaços).
URLs de redirecionamento: Insira https://api.yoodash.com.br/integration/shopify-platform/callback.

Após preencher as informações, clique no botão Lançar para publicar esta versão do aplicativo.

Passo 5: Configure a distribuição do aplicativo

Volte à página inicial do Shopify Partners e acesse Distribuição de apps > Todos os apps > selecione a "Integração Yoodash" (ou o nome que você definiu).
Clique em Escolher distribuição e selecione o método Distribuição personalizada para finalizar esta etapa.
Em seguida, você precisará inserir o domínio da sua loja para gerar o link de autorização de instalação.
- Para encontrar seu domínio: Acesse o painel administrativo da sua loja em admin.shopify.com. Na página inicial (Home), o domínio da sua loja estará visível. Copie-o.
- ⚠️ Atenção ao formato do domínio: Utilize somente o formato exemplo.myshopify.com. Não inclua prefixos como https:// ou http:// , nem caminhos adicionais como /new_store ou ?param=.... (Exemplos incorretos: https://exemplo.myshopify.com ou exemplo.myshopify.com/new_store ).
Por enquanto, ignore o link gerado pelo Shopify e avance para as próximas etapas.

Passo 6: Solicite acesso completo ao histórico de pedidos

No menu lateral, acesse Solicitações de acesso da API.
Vá até a seção Ler o escopo de todos os pedidos e clique em Solicitar acesso.
No campo "Por que seu app precisa de acesso a pedidos com mais de 60 dias?", cole a seguinte justificativa padrão:
"O acesso a pedidos com mais de 60 dias é estritamente necessário para a consolidação de dados da minha loja na ferramenta de Analytics que utilizo. Sem esse histórico, a plataforma não consegue gerar relatórios precisos de vendas, comparar períodos longos ou analisar o desempenho de marketing com janelas superiores a dois meses."
Clique em Solicitar acesso. (Geralmente, essa liberação ocorre de forma automática e imediata ).
Volte para a página inicial para confirmar que o escopo foi liberado com sucesso.

Passo 7: Adicione o novo escopo à aplicação

Retorne ao Dev Dashboard, acesse o menu Versões e clique em Criar versão.
Na tela de criação, clique em Selecionar escopos, adicione o novo escopo read_all_orders e clique em Concluído.
Verifique se a lista final de escopos contém exatamente: read_all_orders,read_orders,read_products.
Estando tudo correto, clique em Lançar para que este novo escopo passe a ser exigido na instalação do App.

Passo 8: Instale o aplicativo na sua loja

Volte ao painel do Shopify Partners, localize a seção Link de instalação para lojista e clique em Gerenciar link.
Copie o link de instalação gerado e abra-o em uma nova guia do seu navegador.
Selecione a loja na qual deseja instalar o app (deve ser a mesma loja configurada no Passo 5).
Clique no botão Instalar.
Para confirmar se a instalação foi bem-sucedida, volte ao Shopify Partners, vá para a visão geral e verifique o Histórico de apps mais recente. Lá deve constar que o aplicativo foi instalado corretamente.

Passo 9: Finalize a integração no Yoodash

Retorne ao Dev Dashboard e acesse a aba Configurações.
Copie as suas credenciais (Client ID e Client Secret).
Acesse o painel do Yoodash e cole essas credenciais nos campos correspondentes para concluir a integração.