Reautorizar a ligação Shopify no Celigo

Se as encomendas chegam ao NetSuite através do Celigo, aproximam-se duas datas que a maioria das lojas ainda não viu. A Shopify deixa de aceitar, a 1 de janeiro de 2027, os tokens de acesso offline sem validade nas apps públicas, e o Celigo está a passar um tipo de ligação Shopify para uma app Shopify própria do cliente. Ter ou não de fazer alguma coisa depende de um único dado: que tipo de ligação Shopify existe no integrator.io.

Este é um guia curto com uma lista de verificação. Somos Celigo implementation partner e não falamos em nome da Shopify, do Celigo nem da Oracle NetSuite. Tudo o que se segue vem da documentação pública destas empresas, que voltámos a ler a 28 de outubro de 2026 e que ligamos no fim. Quando um ponto não pôde ser confirmado, diz «não confirmado».

Resposta curta. Provavelmente sim, se criou fluxos Shopify próprios no Celigo (uma ligação «self-service»). O Celigo indica que essas ligações passam a usar a app Shopify do próprio cliente, que as existentes têm de ser reautorizadas contra ela e que a app pública partilhada fica disponível apenas como alternativa até meados de dezembro de 2026. As ligações da integration app Shopify–NetSuite não são afetadas pela mudança de app e continuam na app pública do Celigo. Uma integração à medida construída como app pública da Shopify tem de passar a tokens com validade e renovação antes de 1 de janeiro de 2027, ou a Shopify responde com 403 às chamadas à API.

• Tem de agir: as ligações OAuth self-service da Shopify na app pública do Celigo.
• Verifique um ponto: as ligações da integration app, onde a mesma loja não pode estar ligada a partir de mais do que uma conta integrator.io.
• Ação do programador: as apps públicas Shopify à medida que ainda usem tokens sem validade.

O que muda e quando

Porque é que o Celigo o fez, nas palavras do Celigo: o modelo de tokens com validade da Shopify admite apenas uma cadeia de tokens renováveis por combinação de app e loja, pelo que uma app partilhada poria todos os clientes na mesma cadeia. Uma app própria isola a sua.

Uma nota da própria Shopify: o requisito não se aplica às apps personalizadas (custom apps) nem às criadas por comerciantes, e o controlo incide sobre os pedidos à GraphQL Admin API.

Passo 1. Que tipo de ligação existe?

No integrator.io, abra Resources > Connections e filtre por Shopify. De cada ligação, anote três dados: quem é o proprietário, o tipo de autenticação e o tipo de app.

1. Pertence à integration app Shopify–NetSuite. O Celigo indica que não são afetadas pela mudança para app própria e que continuam na app pública do Celigo. Anote e avance, exceto quanto à regra de uma só conta explicada abaixo.
2. Self-service, OAuth 2.0, tipo de app «Public app». Afetada. Planeie a reautorização contra a app própria (passo 2).
3. Self-service, OAuth 2.0, tipo de app «Custom app». Já está numa app própria. Confirme que aparece Online e que os scopes cobrem todos os fluxos que a usam.
4. Ligações Token ou Basic de uma app personalizada antiga. Não são apps públicas, e a Shopify diz que a mudança não se aplica a apps personalizadas. Podemos dizer «não afetadas por esta mudança» e nada mais. Note que a Shopify já não permite aos novos utilizadores criar apps personalizadas antigas, pelo que a orientação atual do Celigo para configurar Token parte de uma app criada no Shopify Dev Dashboard.
5. Tudo o resto que toque na loja. Apps de agências, middleware, scripts, ferramentas de relatórios. Pergunte a cada responsável uma só coisa: é uma app pública?

A regra de uma só conta. A Shopify só admite um token ativo por loja, pelo que uma loja só pode estar ligada à integration app Shopify–NetSuite a partir de uma conta integrator.io, em qualquer região. O prazo do Celigo para consolidar as lojas ligadas a partir de várias contas foi 20 de outubro de 2026. Quem estiver nessa situação, ou não tiver a certeza, deve contactar já o account manager do Celigo: o Celigo indica que uma loja que a 1 de novembro continue ligada a partir de mais do que uma conta não é migrada e deixa de funcionar a 1 de janeiro de 2027.

Passo 2. Como reautorizar contra a app Shopify própria

Isto aplica-se apenas às ligações self-service. O Celigo tem o guia ecrã a ecrã (Set up an OAuth 2.0 connection to Shopify); eis o esquema.

1. Crie a app. No Shopify Dev Dashboard, crie uma app para a loja. Defina os scopes que os fluxos usam, publique uma versão e instale-a na loja. O guia do Celigo indica que se selecione pelo menos read_orders.
2. Copie as credenciais. Retire o Client ID e o Client secret das definições (Settings) da app. Guarde o secret no gestor de palavras-passe. Nunca o cole num ticket, numa conversa ou num documento.
3. Configure a ligação. No Celigo, defina Auth type como OAuth 2.0 e App type como Custom app. Adicione um cliente OAuth 2.0 com essas credenciais, escolha os scopes, indique o nome da loja e clique em Save & authorize. O Celigo recomenda a versão de API 2026-10.
4. Contas da UE. Inicie sessão com a opção EU Account; fazê-lo pelo portal global pode devolver à página de início de sessão.
5. Confirme que a ligação aparece como Online.
6. Ajuste os scopes aos fluxos. Se um fluxo toca em encomendas, produtos, inventário, expedições ou clientes, a app precisa do scope correspondente; caso contrário, esse fluxo falha com um erro de permissões.

É possível mudar no local uma ligação Public app? O artigo de OAuth do Celigo diz que não: uma ligação configurada como Public app não pode ser reautenticada como Custom app, ao passo que o contrário é possível. O changelog do Celigo diz que as ligações self-service existentes «need to be re-authorized against a local app». Não conseguimos conciliar as duas frases só com a documentação e não o confirmámos com o Celigo. Até o fazer, siga o caminho prudente: crie uma ligação Custom app nova, redirecione para ela os fluxos que usavam a antiga e consulte o suporte do Celigo antes de apagar o que quer que seja.

Passo 3. Um plano de testes antes de confiar nela

Comece numa loja de desenvolvimento ou sandbox, ou pela ligação de menor risco. O Celigo migra as ligações das integration apps entre 1 e 15 de novembro, «before the Black Friday/Cyber Monday period», e nós colocaríamos o trabalho self-service na mesma janela: termine antes de meados de novembro, não na semana do corte da alternativa.

Depois de cada reautorização:

• Execute cada fluxo uma vez manualmente: encomendas para o NetSuite, expedições e tracking de volta para a Shopify, inventário, produtos e preços, reembolsos, payouts.
• Abra a gestão de erros e confirme que está vazia para os fluxos executados.
• Compare o número de encomendas da mesma janela na Shopify e no NetSuite.
• Verifique que os webhook listeners continuam a receber eventos.
• Ative alertas, como e-mails de erro e alertas de fluxos de longa duração, e acompanhe-os durante a primeira semana.
• Registe quem é o proprietário da app Shopify, onde está guardado o client secret e qual é o processo de rotação. Rodar o secret implica reautorizar.

Um comportamento a conhecer: o Celigo indica que um refresh token que fique cerca de 90 dias sem uso expira, e o comerciante tem então de reautorizar a ligação. Uma loja sazonal ou um fluxo em pausa podem deparar-se com isto.

Passo 4. Se uma integração à medida é uma app pública da Shopify

Esta parte é para a agência ou o programador interno. O guia da Shopify, Migrate to expiring offline access tokens, tem o código. Em resumo:

1. Peça tokens com validade acrescentando expiring=1 ao pedido de token exchange ou de authorization code, ou ative a flag expiringOfflineAccessTokens no template de app da Shopify.
2. Guarde o access token, o refresh token e os dois valores de validade, expires_in e refresh_token_expires_in.
3. Renove antes de decorrer expires_in e guarde sempre o refresh token mais recente que for devolvido.
4. Migre as instalações que existem hoje com o fluxo de migração por token exchange, que não precisa de sessão de utilizador. Invalida de forma permanente o token anterior para os pedidos à GraphQL Admin API, pelo que se deve guardar a resposta.
5. Perante um 403 cuja mensagem diga que os tokens sem validade já não são aceites, reautentique; perante um 401 invalid_request na renovação, peça ao comerciante que volte a abrir a app.

Um scope em falta também devolve 403, pelo que convém ler a mensagem antes de decidir em que caso se está.

O que se avaria se não fizer nada

Se uma ligação parar, os sintomas são os de qualquer conector em baixo: as encomendas deixam de chegar ao NetSuite, as expedições e o inventário deixam de voltar à Shopify e a contabilidade encontra desvios na reconciliação seguinte. É a mesma falha que descrevemos em SuiteCommerce ou Shopify com NetSuite como o custo de ser dono de um conector: falha em silêncio e alguém tem de dar por isso.

O que não conseguimos confirmar

• O dia exato de meados de dezembro. O Celigo não dá data.
• O que faz o Celigo a uma ligação self-service que ainda esteja na app pública quando a alternativa terminar.
• Se uma ligação Public app existente pode ser mudada no local ou precisa de uma ligação nova (ver passo 2).
• Como se aplica a nota do Celigo de 27 de outubro, segundo a qual as suas apps Shopify já emitem tokens com validade, às ligações self-service que continuam na alternativa da app pública.
• Se as ligações HTTP e REST do Celigo à Shopify se comportam de forma diferente das GraphQL.

Vamos atualizar esta página depois de meados de dezembro e depois de 1 de janeiro de 2027, e alterar a data no topo quando o fizermos.

Onde entra a Atypical Tech

Somos uma empresa de engenharia de integração sediada em Espanha e parceira do Celigo e da Stacksync. Inventariamos as ligações Shopify, reautorizamo-las e testamo-las, e levamos as integrações à medida para tokens com validade. Veja a nossa página de integração NetSuite + Shopify e como trabalhamos como Celigo implementation partner.

Não tem a certeza de quais das ligações Shopify são afetadas? Verificamo-las consigo em 30 minutos.

Perguntas frequentes

Tenho de reautorizar a minha ligação Shopify no Celigo?

Sim, se for uma ligação OAuth self-service da Shopify na app pública do Celigo. A 28 de outubro de 2026, o Celigo indica que essas ligações passam a usar a app Shopify do próprio cliente e mantém o caminho da app pública apenas como alternativa até meados de dezembro de 2026. As ligações da integration app Shopify–NetSuite não fazem parte dessa mudança.

A integration app Shopify–NetSuite do Celigo é afetada?

Não pela mudança para app própria, segundo o changelog do Celigo de 15 de outubro de 2026. O Celigo migra ele próprio as suas ligações para tokens com validade, entre 1 e 15 de novembro de 2026, sem reinstalação. A exceção é uma loja ligada a partir de mais do que uma conta integrator.io, que não é migrada e deixa de funcionar a 1 de janeiro de 2027.

O que acontece a 1 de janeiro de 2027?

A Shopify passa a rejeitar os pedidos à GraphQL Admin API das apps públicas existentes que apresentem um token offline sem validade. A resposta é um 403 e os comerciantes perdem o acesso a essa app até se reautenticarem. As apps personalizadas e as criadas por comerciantes ficam fora do requisito, segundo a Shopify.

Porque é que o Celigo precisa que eu tenha uma app Shopify própria?

O Celigo explica que os tokens com validade da Shopify admitem uma única cadeia de tokens renováveis por combinação de app e loja. Uma app pública partilhada poria todos os clientes numa só cadeia, pelo que uma app própria mantém a sua ligação separada. É a explicação do Celigo, no changelog de 15 de outubro de 2026.

Posso mudar uma ligação Public app para Custom app?

O artigo de OAuth do Celigo diz que uma ligação configurada como Public app não pode ser reautenticada como Custom app, pelo que o plano prudente é uma ligação Custom app nova e redirecionar os fluxos. O changelog fala em reautorizar as ligações existentes. Não confirmámos o caminho exato com o Celigo, por isso consulte antes o suporte.

Como testo depois de reautorizar?

Execute cada fluxo uma vez manualmente, verifique a gestão de erros, compare o número de encomendas entre a Shopify e o NetSuite para a mesma janela, confirme que os webhooks continuam a disparar e ative alertas durante a primeira semana. Faça-o primeiro numa loja de desenvolvimento, se existir, e termine antes de meados de novembro.

E se uma agência construiu a nossa integração Shopify?

Pergunte se é uma app pública da Shopify e se já pede tokens com validade e renovação. Se for pública e não o fizer, tem de migrar antes de 1 de janeiro de 2027. Se for uma app personalizada criada para a loja, a Shopify diz que o requisito não se aplica.

Qual é exatamente o prazo do Celigo?

O Celigo diz «mid-December 2026» e não indica o dia, pelo que a data não está confirmada. Planeie terminar em meados de novembro, antes da Black Friday e da Cyber Monday, e trate a data de dezembro como uma alternativa, não como o plano.

Reserve uma verificação das ligações Shopify–NetSuite

Listamos as ligações Shopify, dizemos quais são afetadas e o que faríamos primeiro, para que o trabalho fique concluído bem antes do corte de meados de dezembro do Celigo.

Reserve uma chamada de 30 min · 30 minutos · Sem compromisso · Inglês, espanhol, português e catalão

Relacionado: todos os sistemas que ligamos e a nossa página de parceiro Celigo.

Sobre o autor

Bruno Galo é o fundador da Atypical Tech, uma empresa de engenharia de integração sediada em Espanha que liga o NetSuite a CRM, plataformas de ecommerce e ao resto dos sistemas de uma empresa mid-market. A Atypical Tech é parceira do Celigo e da Stacksync.

LinkedIn: https://www.linkedin.com/in/brunogd

Fontes

Todas consultadas a 28 de outubro de 2026.

• Celigo, Changelog (entradas de 15, 22 e 27 de outubro de 2026) — https://docs.celigo.com/hc/en-us/articles/55197491098395-Changelog
• Celigo, FAQ: Shopify expiring offline access token migration — https://docs.celigo.com/hc/en-us/articles/56227117237915
• Celigo, Shopify–NetSuite integration app release notes, 2026.11.1 — https://docs.celigo.com/hc/en-us/articles/56774766500763
• Celigo, Set up an OAuth 2.0 connection to Shopify — https://docs.celigo.com/hc/en-us/articles/360038755451-Set-up-an-OAuth-2-0-connection-to-Shopify
• Celigo, Set up an OAuth 2.0 connection to Shopify in Shopify–NetSuite integration app — https://docs.celigo.com/hc/en-us/articles/12090736546331-Set-up-an-OAuth-2-0-connection-to-Shopify-in-Shopify-NetSuite-integration-app
• Celigo, Set up an HTTP connection to Shopify using a custom app — https://docs.celigo.com/hc/en-us/articles/47171304254875-Set-up-an-HTTP-connection-to-Shopify-using-a-custom-app
• Shopify, Migrate to expiring offline access tokens — https://shopify.dev/docs/apps/build/authentication-authorization/migrate-to-expiring-offline-access-tokens