O botão «Trocar código de autorização» do Shopify: mitos e realidade

Onde está o botão e o que faz do princípio ao fim

O botão Trocar código de autorização (Exchange Auth Code) está no ecrã Instâncias Shopify (Shopify Instances), nas versões 17, 18, 19 e 20 do Odoo. As fichas de loja abrem-se a partir do menu Shopify › Configuração › Lojas (Shopify › Configuration › Stores). Para ver o troço Configuração (Configuration) é preciso a permissão Operador (Operator); para o troço Shopify, a de Visualizador (Viewer).

No Odoo 20.0, ao carregar nele, o módulo percorre as lojas selecionadas e faz a troca em cada uma. Verifica se a loja tem um código de autorização guardado; envia ao Shopify esse código juntamente com a chave e o segredo de API da aplicação; confirma que a resposta traz um token de acesso; e só então guarda as alterações.

Com o Odoo em português de Portugal, o botão chama-se Trocar código de autorização. O esquema seguinte reúne o seu nome noutros idiomas.

Ideias erradas sobre o botão de troca

«O botão aparece na ficha de qualquer loja»

A vista oculta o botão quando o campo Shopify connection tem o valor que traz de origem, pelo que com os valores por defeito não se vê. Esse campo não aparece em nenhuma vista. O botão vê-se quando esse campo tem um valor diferente do de origem. A condição é a mesma no Odoo 17, 18, 19 e 20.

«Carregar nele abre a autorização no Shopify»

Ao carregar nele, o módulo trabalha com o código de autorização que já está guardado na loja. Se esse código estiver vazio, no Odoo 20.0 o botão pára com Código de autorização em falta. (Missing authorization code.) e não altera nada.

«Se o Shopify rejeitar a troca, a loja fica a meio»

Quando o botão pára com uma mensagem, a ação é interrompida e não se guarda nada do que ia mudar. Além da mensagem anterior, o botão pode parar com estas:

• Troca OAuth Shopify falhou: … (Shopify OAuth exchange failed: …). Aparece quando o Shopify responde com um código de estado de erro. No lugar das reticências vai o início do texto com que o Shopify respondeu: lê-o para saber o que disse.
• A resposta da troca OAuth Shopify não incluiu um token de acesso. (Shopify OAuth exchange response did not include an access token.). Aparece quando a resposta do Shopify não traz token de acesso.

«O token que guarda é permanente»

No Odoo 20.0, o módulo pede ao Shopify o par de token de acesso de curta duração e token de renovação; o comentário do código fala de um token de renovação de 90 dias. O token de renovação só é guardado se o Shopify o devolver, e a data de caducidade do token de acesso só se o Shopify indicar quantos segundos dura. Guardam-se também a hora da troca como última renovação e as permissões concedidas: as do próprio token ou, se não vierem, as do utilizador associado; se não houver nenhuma, fica vazio.

«Depois de trocar, o código pode voltar a usar-se»

Ao guardar, o módulo esvazia o código de autorização e o valor de estado pendente de OAuth. Segundo o comentário do código, esse valor é de uso único: é consumido aí para que um retorno de chamada repetido não possa concluir-se uma segunda vez. Ao mesmo tempo, a loja passa ao estado ligada e apaga-se o último erro de ligação. Se voltares a carregar no botão com o código já esvaziado, pára com Código de autorização em falta..

«Com comprar o módulo já está»

O botão faz parte de um módulo de pagamento único por versão que precisa da subscrição do FlexigoTech Cloud (plano Conector): 49 €/mês ou 490 €/ano, sem IVA. A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição dá; os dados ficam no teu Odoo.

O módulo está publicado no Odoo Apps para 17.0, 18.0, 19.0 e 20.0. Com a subscrição, o módulo para as versões novas do Odoo vem incluído se o compraste em flexigotech.com; na Odoo App Store, cada versão do Odoo compra-se lá. Tens a ficha no Odoo Apps e a página do módulo.

O que ver quando o botão pára com uma mensagem

• Com Código de autorização em falta., a loja não tinha código de autorização guardado nesse momento (ou já tinha sido esvaziado numa troca anterior).
• Com Troca OAuth Shopify falhou: …, lê o texto que vem a seguir aos dois pontos: é a resposta do Shopify.
• Com A resposta da troca OAuth Shopify não incluiu um token de acesso., o Shopify respondeu sem devolver o token.

Em cada um destes casos a ação é interrompida e não se guarda nada do que o botão ia alterar.

Se procuras outro botão do módulo

O conector tem mais botões com a sua própria história. Se te interessa o stock, tens outro artigo sobre o botão de stock do conector.

Como ajuda a FlexigoTech

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se, ao ligar a tua loja, te deparares com alguma destas mensagens e não souberes por onde seguir, diz-nos que texto aparece depois dos dois pontos e vemos contigo.

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 (d7e627b4): views/shopify_instance_views.xml
• Código do módulo: flexigobe_shopify_seller_connector 20.0 (d7e627b4): models/shopify_instance.py
• Código do módulo: flexigobe_shopify_seller_connector 20.0 (d7e627b4): models/fgt_cloud.py
• apps.odoo.com/apps/modules/20.0/flexigobe_shopify_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html