Os campos da Instância do conector Shopify para Odoo, um a um

Onde está a ficha

A ficha de Instâncias Shopify abre-se a partir do menu Shopify › Configuração › Lojas (Shopify › Configuration › Stores). Se não vês um troço do menu, falta uma permissão: Configuração (Configuration) pede Operador (Operator) e Shopify pede Visualizador (Viewer). No Odoo 20 a ficha tem os campos que se explicam a seguir; o módulo está publicado no Odoo Apps para as versões 17.0, 18.0, 19.0 e 20.0.

Ligação ao Shopify

Os campos desta parte estão no separador Ligação (Connection). A ligação passa pela FlexigoTech Cloud: guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar.

Shopify app

Seletor do separador Ligação, grupo FlexigoTech Cloud. Com os valores por defeito vê-se; fica oculto se a ligação não passar pela FlexigoTech Cloud, e só o veem os utilizadores com permissão de administração das Definições. Os seus valores são My own app (made in the Dev Dashboard of this store's organization) e An app distributed to this store (authorization code); no código vem marcado o primeiro. Segundo a ajuda, com a tua própria app a FlexigoTech Cloud obtém o token com o client credentials grant e não há nada a autorizar; com uma app distribuída à loja (Custom distribution) autorizas no Shopify uma única vez, depois de guardar. O que indicar: a opção que corresponda à forma como criaste a app.

Client secret (FlexigoTech Cloud)

Campo de texto no mesmo grupo e com as mesmas condições de visibilidade que o anterior. A ajuda diz que é enviado uma única vez, cifrado, à FlexigoTech Cloud juntamente com o client ID e a loja, e que nunca é guardado no Odoo. O que indicar: o segredo da tua app Shopify.

I accept that my Shopify app and my calls to Shopify go through FlexigoTech Cloud

Caixa de seleção do mesmo grupo, com as mesmas condições de visibilidade. Segundo a ajuda, a FlexigoTech Cloud guarda o segredo cifrado, obtém e renova o token de acesso e passa ao Shopify cada chamada desta loja (encomendas, produtos, stock, localizações, envios e rastreamento, reembolsos, cancelamentos e edições de encomenda, transportadoras, pagamentos e disputas), com os dados que cada chamada leva. A ajuda acrescenta que o Odoo não guarda cópia nem do segredo nem do token. Marcá-la é aceitar isso.

Domínio da loja (Shop Domain)

Texto que se vê na ficha e também na lista de Instâncias Shopify. A ajuda pede o domínio exato do Shopify, por exemplo flexigobe.myshopify.com. O que indicar: esse domínio, tal como é o da tua loja.

Connect Pairing Code

Campo da ficha. Fica oculto se a instância já estiver ligada ou se não se cumprir outra condição da vista. A sua ajuda diz: «Paste the one-time pairing code shown in the embedded Shopify app (when you install from the Shopify App Store), then click Pair with Shopify.».

Âmbitos solicitados (Requested Scopes)

Texto longo no separador Ligação, grupo Shopify App Credentials. Segundo a ajuda, são os âmbitos OAuth solicitados ao Shopify, separados por vírgulas. O módulo preenche-o com um valor por defeito que calcula ele próprio; se o editares, mantém as vírgulas entre âmbitos.

Código de autenticação (Auth Code)

Campo do separador Ligação. Com os valores por defeito não se vê: fica oculto quando a ligação passa pela FlexigoTech Cloud, pelo que aparece quando não passa por aí. A ajuda descreve-o como o código de utilização única devolvido pelo callback de OAuth do Shopify.

Uma nota sobre o domínio: com o Odoo em castelhano, a ajuda que acompanha Domínio da loja diz «Use o seu domínio Shopify exato, por exemplo: flexigobe.myshopify.com». O esquema seguinte recolhe também as versões em alemão, francês, italiano e português.

Stock e consultas ao Shopify

Estes dois campos estão no separador Operações (Operations), grupo Configurações de sincronização (Sync Settings).

Webhook de sincronização de stock (Webhook Sync Stock)

Caixa de seleção desativada por defeito. A ajuda diz que serve para receber os webhooks inventory_levels/update do Shopify e atualizar o stock do Odoo quase em tempo real, e que exige ter ativada a sincronização de stock. O que indicar: ativa-a apenas se quiseres essa atualização quase imediata, e com a caixa Sync Stock Enabled do mesmo grupo já ativada.

Tamanho da página (Page Size)

Número de registos que se pedem ao Shopify por página, entre 1 e 100; vem em 50. A ajuda avisa de duas coisas: acima de 100 o Shopify rejeita a consulta sem mais, e uma página grande numa consulta com muita informação pode exceder o limite de custo. O que indicar: um valor dentro do intervalo; o de partida é 50.

Encomendas

Os campos desta parte estão no separador Operações, grupo Definições de pedidos (Order Settings).

Horas da janela de sincronização de pedidos (Order Sync Window Hours)

Inteiro que vem em 24. A ajuda define-o como a janela de tempo de reserva para a primeira sincronização de encomendas quando não existe uma marca temporal anterior. O que indicar: o que quiseres que essa primeira leitura cubra.

Âmbito de importação de pedidos (Order Import Scope)

Que encomendas do Shopify se importam como ordens de vendas. Opções: Todas as encomendas (All orders), Apenas pagos (Paid only) e Pago e não satisfeito (Paid & Unfulfilled), que é a que vem por defeito. Esta última importa apenas as encomendas pagas que ainda não foram preparadas, e a ajuda recomenda-a quando preparas a partir do Odoo.

Usar o número da encomenda Shopify como número da encomenda de venda (Use Shopify order number as SO number)

Caixa de seleção ativada por defeito. Segundo a ajuda, atribui à ordem de vendas do Odoo o número da encomenda do Shopify, anulando a sequência própria do Odoo, para que os números coincidam com os do Shopify.

Prefixo da loja (Store Prefix)

Identificador da loja Shopify (a ajuda dá como exemplos ZA e EU). Guarda-se em cada ordem de vendas importada para saber de que loja vem. O que indicar: um identificador curto que distinga esta loja das restantes.

Prazo de entrega do fornecedor (dias) (Supplier lead time (days))

Inteiro que vem em 7. A ajuda diz que é usado pela análise de artigos para calcular o momento de reposição e as quantidades recomendadas.

Se preferires que to deixem configurado

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Podes ver o módulo na respetiva página e na ficha do Odoo Apps.

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