Escopo
Esta base de conhecimento visa orientar como realizar a configuração da integração Shopify através da rotina [R10 - Meu e-Commerce].
Parâmetros utilizados
Para a integração Shopify é necessário que os parâmetros [1113 - Tipo de Modelo do E-Commerce] abaixo estejam configurados. A configuração é realizada na rotina [R29 - Parâmetros por empresa] como exemplo a baixo:
Configuração de um novo e-Commerce
Para cadastrar um novo e-Commerce, basta abrir a rotina [R10 - Meu E-Commerce], clicar em Novo E-Commerce.
Dados obrigatórios:
| Campo | Descrição |
| URL API | URL para utilização da API da loja |
| Token | Token para autenticar e autorizar solicitações. |
O "Token" é um código de autorização que representa a loja do e-commerce. Para obter esse código, basta criar um "app de desenvolvimento" na própria Shopify e informá-lo aqui, juntamente com a URL da API.
URL da API (https://[seudomínio.myshopify.com]/admin/api/2024-04/graphql.json):
Logo abaixo a imagem da rotina [R10 - Meu -Commerce] para preenchimento das informações
Dados obrigatórios:
- Nome do e-Commerce;
- Estabelecimento principal;
- Tabela de preço;
- Estrada/Saída;
- Estabelecimentos/Depósitos;
- URL API;
- Token.
As informações dos produtos enviados (preços, estoque, etc...) serão as informações que estão relacionadas com os valores informados nesses campos.
Sincronização dos Produtos
Para a realização da sincronização dos produtos com o e-Commerce é preciso estar habilitada a opção "Participa da Integração com e-Commerce?" na rotina [R135 - Itens/Estabelecimento] como exemplo a baixo:
| As opções sinalizadas acima definem se o item participará da integração com a plataforma e se, durante as sincronizações, a descrição e a descrição detalhada serão atualizadas. Essa flag passa a valer a partir da segunda integração do item, considerando que, na primeira, todas as informações devem ser enviadas. Quando a opção de atualização está desmarcada, as descrições do item no e-commerce são mantidas inalteradas. Essas opções devem ser habilitadas no item correspondente ao estabelecimento que participa da integração com o e-commerce, conforme as configurações definidas na [R10 - Meu E-Commerce]. |
O campo "Localização Shopify" corresponde ao identificador de um local cadastrado na Shopify. Os depósitos configurados para compor um mesmo local devem possuir a mesma localização informada nesse campo.
Por exemplo, se os depósitos A e B fazem parte do local "Centro" na Shopify, a identificação da localização do local Centro deve ser informada em ambos os depósitos. Além disso, os depósitos precisam estar marcados como ativos para que sejam considerados na integração de estoque.
Para achar o código do local na Shopify, basta ir em Configurações > Locais.
Clique no local,
O ID do local pode ser encontrado no final da URL:
Com esse ID em mãos, basta inseri-lo no campo correspondente e ativar a opção 'Fornece Estoque?'. 
A sincronização dos produtos possui um intervalo de 15 minutos para envio de produtos novos ou modificados, é possível visualizar os detalhes na [R10 - Meu E-Commerce] na aba de Produtos, poderá acompanhar detalhes de sincronização ou mensagens de erro caso houver para melhor apoio ou orientação do suporte, como imagem abaixo:
Importante:
- Para que os produtos sejam sincronizados, eles precisam possuir preço (Para a embalagem padrão do produto) configurado na tabela de preço vinculada ao e-commerce.
- Os produtos são criados inicialmente com o status 'Rascunho'.
Os itens sincronizados com a plataforma Shopify, são atualizados com a informação SKU na [R179 - Itens/ Embalagens Venda], considerando que o SKU representa a ligação entre os sistemas. Com isso, o item não deve ser removido na plataforma, e sim inativado, pois é preciso esse processo para manter a consistência das integrações e evitar possíveis problemas de sincronização dos itens. |
Recepção dos Pedidos Aprovados na Shopify
Para que ocorra a sincronização de todos os pedidos com suas informações de pagamento corretamente é preciso realizar o vinculo da forma de pagamento do e-Commerce com o portador e condição de pagamento no Movere na [R518 - Tipos de Pagamento para E-Commerce] como exemplo abaixo:
Ressaltando que o campo [Forma de pagamento no e-Commerce] precisa ser idêntico a forma de pagamento configurada na Shopify.
A recepção de um pedido da Shopify inicia-se quando o cliente finaliza todo o processo de pagamento e o produto fique com o status não processado para que seja possível realizar a emissão de documento fiscal posteriormente no Movere. A partir da versão 4.673 os pedidos com status [Processado] também são sincronizados.
A sincronização dos pedidos possui o mesmo intervalo da sincronização de produtos de aproximadamente 15 minutos. Ao realizar a recepção de pedidos novos ou modificados, é possível visualizar os detalhes na [R10 - Meu E-Commerce], na aba de Pedidos, podendo acompanhar detalhes da sincronização ou mensagens de erro, caso houver. Exemplo imagem abaixo:
Após a sincronização dos pedidos, eles aparecerão com a tag "PedidoSincrozado" no e-Commerce.
Sincronização das Notas Fiscais
Quando ocorre a sincronização dos pedidos com o e-Commerce, eles viram orçamentos acessíveis na R419 [Vendas Varejo], com status [Aberto]. Quando esses pedidos de venda são fechados e tem nota gerada, eles ficam disponíveis para a sincronização de notas fiscais.
Quando ocorre a sincronização, a Shopify faz a recepção desses pedidos e eles aparecem com a tag "NotaSincronizada".
