A versão 2026-04 da API do Shopify já está em produção. Traz mudanças relevantes para quem desenvolve apps, integrações ou mantém operações customizadas no Shopify. Algumas são adições de funcionalidade. Outras são breaking changes que exigem ação. Veja o que mudou e o que você precisa fazer.

Discount Tags

A API agora suporta tags em descontos. Na prática, isso permite categorizar e filtrar descontos programaticamente. Operações que gerenciam centenas de cupons e promoções ganham uma camada de organização que antes só existia manualmente no admin.

Para integradores: se você mantém sincronização de promoções entre Shopify e ERP, as discount tags simplificam o mapeamento. Cada desconto pode carregar tags que identificam campanha, canal de origem ou tipo de promoção.

Código de barras em inventário

A versão 2026-04 adiciona suporte a código de barras nos shipments de inventário. Novos campos e mutations na API permitem atribuir, definir ou limpar códigos de barras únicos de até 255 caracteres. Isso acelera o processo de recebimento de mercadoria para operações com volume.

Para lojas no Brasil que usam leitor de código de barras no recebimento de mercadoria, essa atualização elimina a necessidade de apps de terceiros para o controle básico de entrada no estoque.

Metaobjects sem escopo de acesso

App-owned metaobjects não exigem mais access scopes dedicados. Isso simplifica o desenvolvimento de apps que usam metaobjects para armazenar dados customizados. Menos permissões necessárias na instalação do app significa menos fricção para o lojista e review mais rápido na Shopify App Store.

Diretiva @idempotent obrigatória

A mudança mais importante para desenvolvedores: a diretiva @idempotent agora é obrigatória em ajustes de inventário e reembolsos. Isso garante que uma mesma requisição não seja processada duas vezes em caso de timeout ou retry automático.

Se sua integração faz ajustes de estoque via API, verifique se já inclui a diretiva. Sem ela, as mutations vão retornar erro na versão 2026-04. É uma breaking change que exige ação imediata.

Collection Sort Order: MOST_RELEVANT

O valor MOST_RELEVANT agora está disponível na GraphQL Admin API para ordenação de coleções. Disponível a partir da versão 2026-07, mas já é possível testar em ambientes de desenvolvimento. Para lojas que usam coleções automáticas, essa ordenação por relevância pode melhorar a descoberta de produtos sem intervenção manual.

O que fazer agora

Se você mantém integrações com a API do Shopify, três ações são prioritárias:

• Auditar todas as mutations de inventário e reembolso para incluir @idempotent. Sem isso, as chamadas vão quebrar.
• Verificar se seus apps já estão na versão 2026-04 ou se ainda dependem de versões anteriores que serão descontinuadas.
• Testar as discount tags em ambiente de staging se você gerencia promoções programaticamente.

Calendário de deprecação

O Shopify depreca versões de API com antecedência, mas o histórico mostra que muitas operações só migram quando algo quebra. Não espere o deadline. A versão 2025-01 já está no caminho de sunset. Se suas integrações ainda rodam nessa versão, o momento de migrar é agora.

A Shakers mantém todas as integrações de seus clientes Shopify Plus atualizadas com as versões mais recentes da API. Se sua operação depende de integrações customizadas e precisa de suporte técnico para a migração, podemos ajudar a auditar e atualizar.