A API 2026-10 do Shopify, liberada em 15 de outubro, traz breaking changes que afetam diretamente apps de frete, gestão de estoque e processamento de pedidos. Equipes de desenvolvimento que não se adaptarem até o deadline de migração vão enfrentar falhas silenciosas e dados inconsistentes. Este guia traduz as mudanças técnicas em ações concretas.
Mudanças em frete: registro de carrier service reformulado
O fluxo de registro de serviços de transporte mudou. Apps que utilizam a Carrier Service API precisam atualizar a forma como declaram opções de frete. A principal alteração: quando um carrinho se qualifica para múltiplas taxas flat ou por valor de pedido dentro da mesma opção, o checkout agora aplica apenas a taxa mais alta, não a soma.
Para lojas brasileiras que dependem de cálculos combinados de frete (por região + peso + valor), essa mudança pode gerar divergências no valor cobrado. A Shakers recomenda mapear todas as regras de frete ativas, ativar o novo modelo em ambiente de staging e comparar os valores antes de migrar em produção.
A migração para frete por mercado (Market-driven shipping) é obrigatória até 1º de julho de 2027. Lojas novas já entram nesse modelo automaticamente.
Estoque: tratamento de erros agora é explícito
Até a versão anterior, mutações de inventário que falhavam no POS eram processadas silenciosamente. A API 2026-10 rejeita mutações de carrinho não confirmadas e retorna erros explícitos.
Parece uma mudança pequena, mas o impacto é considerável. Apps de gestão de estoque que dependiam do comportamento anterior (falha silenciosa seguida de reconciliação manual) vão precisar implementar tratamento de erro adequado. Sem isso, operações de estoque podem travar no POS sem que o operador entenda o motivo.
A recomendação é revisar todos os fluxos de mutação de inventário e garantir que cada chamada trate os novos códigos de erro antes de avançar no fluxo.
Pedidos: recálculo de impostos e campos depreciados
Duas mudanças afetam o processamento de pedidos. A primeira: quando o endereço de entrega é alterado após a criação do pedido, a API agora recalcula impostos automaticamente. Para lojas nos EUA, o Shopify Tax entra em ação. Para operações brasileiras, o comportamento depende do gateway e da configuração fiscal da loja.
A segunda: campos depreciados em versões anteriores foram removidos. APIs de desconto, coleção e mercado que usavam endpoints antigos precisam migrar para os equivalentes na 2026-10. A release candidate da 2027-01, já disponível, vai remover ainda mais campos. Quem ainda usa a 2025-10 ou anterior precisa planejar duas migrações seguidas.
Global Catalog REST API: sunset em 2 de novembro
Esta é a mudança com o prazo mais curto. A Global Catalog REST API será desligada em 2 de novembro de 2026. A alternativa é o Global Catalog MCP, que usa o Model Context Protocol para comunicação.
Se sua operação utiliza a REST API para sincronizar catálogo com marketplaces, ERPs ou ferramentas de pricing, o prazo de migração é de duas semanas a partir da publicação desta versão. A Shakers tem visto equipes subestimarem essa migração porque o MCP exige uma abordagem diferente de integração: em vez de chamadas REST tradicionais, o protocolo opera com contexto conversacional.
Outras mudanças que exigem atenção
Customer Account API: limite de 3.000 requisições por minuto. O rate limit é compartilhado entre todos os apps da loja. Operações com muitos apps ativos devem monitorar o consumo para evitar throttling inesperado.
Script tags bloqueadas desde 1º de outubro. Lojas que não migraram para a Web Pixels API não conseguem atualizar IDs de pixel, corrigir eventos quebrados ou alterar parâmetros de tracking até março de 2027. Se sua loja usa scripts de tracking legados, a migração é urgente.
Next Gen Events na versão 2026-10. O substituto declarativo dos webhooks clássicos está disponível. A transição não é obrigatória agora, mas a Shopify sinaliza que webhooks tradicionais terão suporte reduzido nas próximas versões.
selling_plan_id nos line items de webhooks de pedidos. Apps de assinatura e planos de venda recorrente ganham visibilidade direta no webhook, sem necessidade de chamada adicional para identificar o plano.
Checklist de migração para equipes brasileiras
-
Audite as chamadas de Carrier Service. Verifique se seu app calcula frete corretamente com a nova regra de taxa única (a mais alta prevalece).
-
Teste mutações de inventário no POS. Simule falhas e confirme que seu app trata os novos erros explícitos.
-
Migre da Global Catalog REST API antes de 2 de novembro. Valide a integração com o Global Catalog MCP em staging.
-
Revise campos depreciados. Use o changelog oficial para mapear quais endpoints sua integração consome e quais foram removidos.
-
Migre scripts de tracking para Web Pixels API. Sem isso, seu tracking fica congelado até março de 2027.
-
Monitore o rate limit da Customer Account API. Ajuste a frequência de chamadas se sua loja opera com múltiplos apps.
Perguntas frequentes
Até quando posso usar a Global Catalog REST API?
Até 2 de novembro de 2026. Após essa data, a API será desligada e todas as integrações que dependem dela vão parar de funcionar. A migração deve ser feita para o Global Catalog MCP.
A mudança no cálculo de frete afeta lojas no Brasil?
Sim. Lojas que usam múltiplas regras de frete combinadas (região + peso + valor) podem ver diferenças nos valores cobrados. O checkout agora aplica apenas a taxa mais alta quando há múltiplas opções elegíveis, em vez de somar.
O que acontece se eu não migrar meus scripts de tracking?
Desde 1º de outubro, a criação de novas script tags está bloqueada. Lojas que não migraram para a Web Pixels API não conseguem atualizar IDs de pixel nem corrigir eventos quebrados. Esse bloqueio permanece até março de 2027.
Next Gen Events substitui webhooks imediatamente?
Não. A versão 2026-10 introduz o modelo declarativo como alternativa, mas webhooks clássicos ainda funcionam. A Shopify indica que o suporte a webhooks tradicionais será reduzido em versões futuras, então a migração gradual é recomendada.
O que fazer agora
A API 2026-10 não é uma atualização incremental. São breaking changes que afetam três pilares da operação: logística, estoque e pedidos. Equipes que deixarem a migração para depois vão acumular débito técnico com a 2027-01 já no horizonte. Na Shakers, o time técnico já mapeou todos os impactos para operações brasileiras no Shopify Plus. Se sua equipe precisa de apoio na migração, é o momento de agir.