O que faz o botão Sincronizar localizações do conector Shopify para Odoo

Antes de clicar: onde está e o que precisa

O botão Sincronizar localizações (Sync Locations) existe no Odoo 17.0, 18.0, 19.0 e 20.0. No Odoo 20.0, o botão traz para o Odoo as localizações Shopify de uma loja.

• Abre o menu Shopify › Configuração › Lojas (Shopify › Configuration › Stores). Se não vires um dos níveis, falta uma permissão: Shopify exige Visualizador (Viewer) e Configuração (Configuration) exige Operador (Operator).

• Procura o botão Sincronizar localizações no ecrã Instâncias Shopify (Shopify Instances). Vê-se sempre, sem qualquer condição, no Odoo 17, 18, 19 e 20.

• Tem presente como a loja está ligada. Se passa pelo FlexigoTech Cloud, a chamada ao Shopify passa pelo serviço e o Odoo não se liga diretamente à loja. Se a loja se liga de forma direta, o módulo tenta primeiro obter um token de acesso; se depois continuar sem ele, o botão para com o aviso Não há ligação Shopify para …. Abra o separador Connection e siga os passos de configuração.

Ao clicar: o que faz, por ordem

• Pede ao Shopify, numa única consulta, as primeiras 50 localizações, sem incluir as herdadas. De cada uma lê o identificador, o nome, se está ativa e a morada.

• Salta as localizações que chegam sem identificador. Com as restantes, procura nessa mesma loja uma localização com o mesmo identificador Shopify: se existir, atualiza o nome, se está ativa no Shopify e a morada; se não existir, cria-a. Como a pesquisa é feita dentro da loja, as localizações de outra loja não são tocadas.

• Se o Shopify não enviar nome, o módulo usa o identificador como nome. A morada é guardada unida por vírgulas quando o Shopify a envia como lista; caso contrário, fica vazia.

• Se nenhuma localização dessa loja estiver marcada como principal, pega na primeira que esteja ativa no Shopify e marca-a como principal: retira a marca às restantes e guarda na loja essa localização como predefinida, com o seu identificador e o seu nome. Se já havia uma principal, não a altera.

• Termina com um aviso de sucesso. Só cria ou atualiza as localizações que o Shopify devolve nessa consulta.

Depois de clicar: o que verificar

• Lê o aviso: título Localizações sincronizadas (Locations Synced) e mensagem … localizações Shopify encontradas (… novas). (Found … Shopify locations (… new).). O primeiro número é o total que o Shopify devolveu; o segundo, as que não existiam no Odoo e foram criadas.

• Se clicares outra vez sem alterações no Shopify, as que já existiam são atualizadas e só contam como novas as que não estavam.

• Se alterares no Shopify o nome, a morada ou se uma localização está ativa, clica de novo: o botão atualiza esses três dados nas localizações que já existem.

• Verifica se a loja tem localização principal: se já havia uma, é respeitada, e se não havia nenhuma é marcada a primeira ativa. Se nenhuma localização estiver ativa no Shopify, não há nenhuma para marcar.

Se o botão parar com um erro

Os avisos seguintes vêm da chamada ao Shopify que o botão faz. Quando um deles surge, a ação para e não se guarda nada do que ia mudar.

• Não há ligação Shopify para …. Abra o separador Connection e siga os passos de configuração. (Shopify is not connected for …. Open the Connection tab and follow the setup steps.) Surge quando a loja não usa o FlexigoTech Cloud e continua sem token de acesso depois de o módulo tentar obtê-lo. As reticências são o nome com que o Odoo mostra a loja. O que fazer: o que diz o aviso, abrir o separador Connection da loja e seguir os passos de configuração.

• Chamada GraphQL Shopify falhou (…): … (Shopify GraphQL call failed (…): …). Surge quando o Shopify responde com um código de erro. O aviso traz esse código e o início da resposta. Antes de chegar aqui, se o Shopify indicar que há demasiados pedidos, o módulo espera e tenta de novo. O que fazer: lê o código e o texto que acompanham o aviso.

• GraphQL Shopify devolveu erros: … (Shopify GraphQL returned errors: …). Pode surgir ao clicar no botão. O que fazer: lê o detalhe que vem a seguir aos dois pontos.

• A chamada GraphQL Shopify esgotou as tentativas. (Shopify GraphQL call exhausted retries.) Pode surgir ao clicar no botão. O que fazer: clica de novo.

Essa mesma função de chamada ao Shopify é usada também, sem clicar neste botão, pela tarefa agendada Shopify Sync Payouts (a cada seis horas, desativada ao instalar) e pelo que o módulo faz ao guardar uma guia de remessa ou ao validá-la com o botão standard do Odoo, que o módulo alarga.

Como a FlexigoTech te ajuda

O módulo tem pagamento único por versão do Odoo e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano, sem IVA, até 3 contas da plataforma. A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar. Está publicado no Odoo Apps para 17.0, 18.0, 19.0 e 20.0 (consulta a ficha e a página do módulo). Se estás a implementar o Odoo e queres ligar a tua loja, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes

• Código do módulo: flexigobe_shopify_seller_connector 20.0 (2950bdc0): views/shopify_instance_views.xml
• Código do módulo: flexigobe_shopify_seller_connector 20.0 (2950bdc0): models/shopify_instance.py
• Código do módulo: flexigobe_shopify_seller_connector 20.0 (2950bdc0): models/fgt_cloud.py
• apps.odoo.com/apps/modules/20.0/flexigobe_shopify_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html