Coleções

Uma Coleção agrupa produtos para que os compradores possam encontrá-los mais rapidamente — pense em “Tênis de Corrida” ou “Promoção de Verão”.
O DataEase permite que você:

Crie ou renomeie centenas de coleções em um único upload.
Adicione ou remova produtos, regras, fontes e condições em massa.
Altere rapidamente a ordem de classificação, imagens e texto de SEO.

Novo modelo de coleções do Shopify (Admin API 2026-07). O Shopify não separa mais as coleções em “inteligentes” e “personalizadas”. Uma coleção é construída a partir de uma ou mais fontes; cada fonte tem condições de inclusão/exclusão e/ou produtos, variantes ou subcoleções selecionados manualmente. O DataEase suporta esse modelo através das colunas Fontes e condições (detalhes abaixo). Arquivos com as colunas clássicas de regras e produtos continuam funcionando para coleções que as colunas clássicas ainda conseguem descrever.

Guia de coleções do Shopify aqui.

2. Exportar

Escolha CSV ou Excel.
Selecione Coleção como a entidade.
Selecione os campos que você precisa — title, sortOrder, ruleColumn, etc. Para exportar coleções construídas com o novo modelo, ative o grupo de colunas Fontes e condições.
Opcional: marque Matrixify-style headers and values para gravar as colunas de fonte e condição com cabeçalhos e valores no estilo Matrixify (por exemplo, Source: Type, Include, any condition) em vez de valores da API (sourceType, INCLUDE, ANY).
Execute a tarefa e baixe seu arquivo.

Coleções que as colunas clássicas não conseguem descrever. Se uma coleção usa o novo modelo de uma forma que as colunas clássicas de regras não conseguem expressar (por exemplo, várias fontes, exclusões, fontes de variantes ou condições combinadas com seleções manuais), suas células ruleColumn/ruleRelation/ruleCondition/appliedDisjunctively ficam vazias e o log de exportação mostra um aviso pedindo para ativar as colunas Fontes e condições. Com apenas as colunas clássicas ativadas, essa coleção é exportada apenas com sua linha principal.

Passo a passo: Guia de exportação

3. Importar

Comandos suportados em command: CREATE, UPDATE, REPLACE, DELETE, IGNORE
Comandos de item de linha (regras ou produtos): CREATE, MERGE, UPDATE, DELETE, IGNORE

Para coleções manuais, use linhas de produtos (productId).
Para coleções inteligentes, use linhas de regras (ruleColumn / ruleCondition…).
Para coleções que usam o novo modelo (várias fontes, exclusões, fontes de variantes, subcoleções), use as colunas Fontes e condições.

O modo é decidido por coleção: se qualquer linha de uma coleção preencher uma coluna de Fontes e condições (por exemplo, sourceType ou conditionField), toda a coleção é importada no novo modo e suas linhas productId / productHandle / productPosition apenas definem a posição de ordenação — elas não adicionam nem removem produtos. Caso contrário, aplica-se o comportamento clássico: as linhas de produto adicionam (CREATE, MERGE), movem (UPDATE) ou removem (DELETE) produtos selecionados manualmente.

Linhas de produto clássicas em uma coleção inteligente. Um arquivo clássico com linhas de produto (productId + itemCommand CREATE) para uma coleção inteligente existente agora adiciona esses produtos como seleções manuais, transformando a coleção em uma mistura de condições e produtos selecionados. Depois disso, importações de regras clássicas para essa coleção (incluindo importações agendadas salvas) falham com “The collection uses the new collections model (MIXED_SELECTIONS_AND_CONDITIONS)”. Use as colunas Fontes e condições para essas coleções.

Dica: Apenas coleções com sortOrder = MANUAL permitem definir productPosition.

Baixe o arquivo de exemplo: Collection-import-sample.xlsx
Preencha os campos obrigatórios: title e handle para CREATE; inclua id ou handle para UPDATE/DELETE.
Mapeie as colunas no DataEase, faça o upload e inicie a importação.

Passos completos: Guia de importação

4. Referência de campos

Básico

id — ID da Coleção. Necessário para UPDATE, REPLACE ou DELETE.
command — Ação para a linha da coleção: CREATE, UPDATE, REPLACE, DELETE, IGNORE.
title — Nome mostrado aos compradores.
handle — String amigável para URL. Deve ser único.
descriptionHtml — Descrição em rich-text com HTML.
templateSuffix — Modelo Liquid alternativo (sem .liquid).
sortOrder — Ordem padrão dos produtos: ALPHA_ASC, ALPHA_DESC, CREATED, CREATED_DESC, MANUAL, MOST_RELEVANT, PRICE_ASC, PRICE_DESC. Desde a Admin API 2026-07, o Shopify retorna coleções ordenadas por mais vendidos como MOST_RELEVANT, então as exportações gravam MOST_RELEVANT em vez de BEST_SELLING. BEST_SELLING não é mais suportado pelo DataEase — use MOST_RELEVANT nos seus arquivos.
updatedAt — Data da última modificação (ISO 8601). Apenas exportação.

SEO

seoTitle — Tag de título de página personalizada.
seoDescription — Meta-descrição personalizada.

Imagem

imageUrl — URL da imagem em destaque.
imageAltText — Texto alternativo para a imagem.
imageHeight — Altura da imagem (px). Apenas exportação.
imageWidth — Largura da imagem (px). Apenas exportação.

Item de linha (regra ou produto)

itemCommand — CREATE, MERGE, UPDATE, DELETE ou IGNORE para esta linha.

Campos de regra de coleção inteligente

Essas colunas clássicas são preenchidas na exportação apenas quando a coleção ainda pode ser descrita como um único conjunto de regras; caso contrário, ficam vazias (veja Exportar).

ruleColumn — Atributo do produto para a regra (ex., TITLE, TAG, VENDOR).
ruleCondition — Valor que a regra compara, como Shoes.
ruleConditionObjectId — Informação extra para alguns tipos de regra (ex., ID de categoria).
ruleRelation — Operador: EQUALS, CONTAINS, NOT_EQUALS, etc.
appliedDisjunctively — true = corresponde a QUALQUER regra; false = corresponde a TODAS as regras.

Campos de produto de coleção manual

productId — ID de um produto a incluir.
productPosition — Número de posição (funciona apenas se sortOrder = MANUAL).
productTitle — Título do produto. Apenas exportação.
productHandle — Handle do produto. Apenas exportação.

Publicação

publicationScope — Canais de vendas onde a coleção é publicada.

Metafields

metafields — Campos extras do aplicativo. Veja o Guia de Metafields.

5. Filtros

CollectionType — Smart (with conditions) ou Custom (manual only). O novo modelo do Shopify não tem tipo de coleção, então o DataEase o deduz a partir das fontes da coleção: smart = pelo menos uma fonte com uma condição de inclusão; custom = todo o resto (apenas produtos selecionados manualmente, subcoleções, ou sem fontes). Como esse filtro é aplicado depois que o Shopify retorna as coleções, a contagem de coleções no formulário de exportação pode aparecer como ≤ N (no máximo N).
Handle — Exportar coleções onde handle contém o texto que você digitar.
Id — Exportar uma única coleção por id.
ProductId — Exportar coleções que incluem um productId específico.
ProductPublicationStatus — Filtrar pelo status de publicação do produto dentro da coleção.
PublishableStatus — Escolha coleções prontas, agendadas ou não publicadas.
PublishedAt — Intervalo de datas quando a coleção se tornou visível.
PublishedStatus — true para publicado, false para oculto.
Title — Exportar coleções cujo title contém seu texto.
UpdatedAt — Filtrar por intervalo de datas da última atualização.

Fontes e condições

Ative o grupo de colunas Fontes e condições para exportar e importar coleções no novo modelo de coleções do Shopify. Uma linha = uma condição ou um item selecionado manualmente de uma fonte; as colunas da fonte se repetem em todas as linhas dessa fonte. As colunas básicas da coleção (handle, title, …) se repetem como de costume.

Os valores são aceitos no estilo API (INCLUDE, ALL, TAGGED_WITH, COMPARE_AT_PRICE) ou no estilo Matrixify (Include, all conditions, Includes, Compare at price), sem diferenciar maiúsculas de minúsculas. Arquivos exportados da planilha Collections do Matrixify são reconhecidos pelos seus cabeçalhos (Source: ID, Condition: Field, …).

sourceId — ID da fonte. Use o ID exportado para alterar uma fonte existente, ou seu próprio rótulo (por exemplo, s1) para agrupar as linhas de uma nova fonte.
sourceCommand — MERGE (padrão) adiciona as linhas à fonte; REPLACE limpa a fonte e a preenche a partir do arquivo; DELETE remove a fonte.
sourceType — PRODUCTS, VARIANTS, COLLECTIONS (subcoleções), ou APP <app id> | PRODUCTS / APP <app id> | VARIANTS para uma fonte compartilhada por outro aplicativo (somente leitura na importação). UNKNOWN é apenas para exportação.
sourceTitle — Título da fonte. Se estiver vazio quando uma fonte é criada, o DataEase gera um a partir do título da coleção.
sourceDescription — Descrição da fonte.
inclusionType — INCLUDE (padrão) ou EXCLUDE.
inclusionMatch — ALL ou ANY: se os produtos devem corresponder a todas ou a qualquer uma das condições de inclusão (ou exclusão) da fonte. Uma nova fonte usa ALL por padrão.
conditionCommand — MERGE (padrão) adiciona a condição se ela ainda não existir; DELETE a remove. Para alterar o valor de uma condição, exclua a condição antiga e adicione a nova, ou use sourceCommand = REPLACE.
conditionField — TAG, TITLE, TYPE, VENDOR, STATUS, CATEGORY, CATEGORY_WITH_SUBCATEGORIES, PRICE, COMPARE_AT_PRICE, INVENTORY_STOCK, WEIGHT, VARIANT_TITLE, COLLECTION (somente exclusão), MANUAL_SELECTION, METAFIELD: namespace.key, VARIANT_METAFIELD: namespace.key. UNKNOWN é apenas para exportação (uma condição que o DataEase não consegue gravar; essas linhas são ignoradas na importação com um aviso).
conditionRelation — Operador, por exemplo TAGGED_WITH, EQUALS, CONTAINS, DOES_NOT_CONTAIN, GREATER_THAN, IS_SET, INCLUDES. Deixe vazio para MANUAL_SELECTION e COLLECTION.
conditionValue — Valor(es), separados por vírgula (\, para uma vírgula literal). Preços aceitam uma moeda opcional (12.50 EUR, padrão = moeda da loja); pesos, uma unidade opcional (1.5 kg, padrão = unidade da loja). Para MANUAL_SELECTION use um handle ou ID de produto por linha, product-handle | Variant Title para uma variante, ou um handle de coleção em uma fonte COLLECTIONS. A exportação grava handles para que os arquivos possam ser movidos entre lojas.
conditionMatch — ANY (padrão) ou ALL para uma condição com vários valores; OR / AND são aceitos na importação.

No novo modo, as linhas productId / productHandle / productPosition apenas definem a posição de ordenação (para sortOrder = MANUAL). Os limites do Shopify para o novo modelo são verificados antes da importação chamar o Shopify: até 10 fontes por coleção, 60 condições por fonte (cada valor conta), 5 coleções excluídas, 10 subcoleções e 1.000 exclusões manuais.

Exemplo — condição de tag mais uma seleção manual e uma exclusão manual em uma fonte:

handle,title,sourceId,sourceType,sourceTitle,inclusionType,inclusionMatch,conditionField,conditionRelation,conditionValue,conditionMatch
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,INCLUDE,ANY,TAG,TAGGED_WITH,"vegan,plant-based",ANY
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,INCLUDE,,MANUAL_SELECTION,,oat-milk,
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,EXCLUDE,,MANUAL_SELECTION,,leather-belt,

Reimportar o mesmo arquivo não cria fontes ou condições duplicadas.

Precisa de ajuda? Nossa equipe de suporte responde dentro de 24 horas.

Campos adicionais

Mais colunas que o DataEase suporta para esta entidade:

productsCount — Número de produtos na coleção.