Changelog

Shopify Admin API 2026-07 e o Novo Modelo de Coleções

September 27, 2026

O DataEase agora usa a Admin API do Shopify versão 2026-07. A maioria dos arquivos e tarefas salvas continua funcionando como antes. Esta página lista o que mudou para você.

Ação necessária: aprove a nova permissão

O aplicativo agora solicita acesso a transferências de estoque (read_inventory_transfers, write_inventory_transfers). O Shopify mostra a cada loja um aviso de aprovação na próxima vez que o DataEase for aberto.

  • Até que você aprove, a importação de definições de metafield com tipo de proprietário TRANSFER falha com um erro de linha. Todo o resto funciona como antes.
  • As tarefas agendadas continuam sendo executadas enquanto a aprovação estiver pendente.

Detalhes: Definições de Metafield.

Coleções

O Shopify substituiu as coleções inteligentes/personalizadas por um modelo construído a partir de fontes (condições de inclusão/exclusão, seleções manuais de produtos, variantes ou subcoleções).

  • Novas colunas de Fontes e condições: sourceId, sourceCommand, sourceType, sourceTitle, sourceDescription, inclusionType, inclusionMatch, conditionCommand, conditionField, conditionRelation, conditionValue, conditionMatch. A importação aceita tanto valores da API quanto valores do Matrixify, e reconhece cabeçalhos do Matrixify.
  • Nova opção de exportação “Matrixify-style headers and values”: grava as novas colunas com cabeçalhos e valores no estilo Matrixify.
  • Colunas de regra clássicas ficam vazias para coleções que elas não conseguem descrever. O log de exportação então pede para você ativar as colunas de Fontes e condições.
  • Linhas de produto clássicas em uma coleção inteligente existente agora adicionam os produtos como seleções manuais, transformando-a em uma coleção mista. Depois disso, importações de regras clássicas para essa coleção falham com MIXED_SELECTIONS_AND_CONDITIONS, então use as novas colunas para ela.
  • sortOrder: coleções ordenadas por mais vendidos agora são exportadas como MOST_RELEVANT. BEST_SELLING não é mais suportado.
  • Filtro de tipo de coleção agora é rotulado Smart (with conditions) / Custom (manual only). Sua contagem pode aparecer como ≤ N.

Detalhes: Coleções.

Produtos e variantes

  • taxCode (Avalara) não é mais suportado pelo Shopify. O valor é ignorado na importação e a linha recebe um aviso.
  • Exportações de produtos com as colunas collections / smartCollections leem 12 produtos por requisição, e exportações com variantImage leem 20. Essas exportações são mais lentas, mas os arquivos são os mesmos. Veja Limites do Shopify.
  • Atualizações de estoque e reembolsos que o Shopify se recusa a repetir após uma tentativa anterior falhada (IDEMPOTENCY_PREVIOUS_ATTEMPT_FAILED) agora mostram um aviso claro na linha (estoque) ou um erro (reembolsos).

Detalhes: Produtos, Pedidos.

Clientes, empresas, descontos, loja

  • Clientes: UnsubscribeUrl fica vazio para clientes sem endereço de email. As exportações incluem todos os endereços de um cliente, sem limite de 250 endereços. Veja Clientes.
  • Empresas: isenções de impostos e registro fiscal da localização são importados através das novas configurações de impostos por localização do Shopify. Veja Empresas.
  • Descontos: nova coluna de exportação discountClasses lista todas as classes de um desconto. Com Include rest of world = TRUE e nenhum país informado, um desconto é importado como válido para todos os países. Com países informados, apenas esses países são usados e a linha recebe um aviso. Veja Descontos.
  • Loja: nova coluna de exportação planPublicDisplayName. Veja Loja.

Metafields e definições de metafield

  • Definições de metafield com tipo de proprietário TRANSFER (transferências de estoque) são suportadas.
  • O DataEase não envia mais acesso de administrador para seus próprios namespaces (por exemplo custom). Para namespaces de aplicativo, PUBLIC_READ(_WRITE) é enviado como MERCHANT_READ(_WRITE).
  • Valores de metafield JSON com mais de 2.000.000 caracteres recebem um erro de linha claro. Veja Metafields.

Contagens e eventos

  • Contagens grandes de registros agora aparecem como 10.000+ em vez de >10000.
  • A exportação de Eventos mostra um aviso de que o Shopify mantém apenas os últimos 12 meses de eventos. Veja Eventos.