Descontos

Um Desconto permite que você recompense os clientes com códigos promocionais, ofertas automáticas, frete grátis ou ofertas do tipo “Compre X Leve Y”.
Com o DataEase você pode:

Criar centenas de novos códigos em um único upload.
Atualizar regras, datas ou configurações combinadas em massa.
Excluir rapidamente ofertas expiradas.

Guia de descontos do Shopify aqui.

2. Exportar

Escolha CSV (mais seguro para textos muito longos) ou Excel.
Escolha Desconto como a entidade.
Selecione campos como type, startsAt, codesCount, etc.
Execute a tarefa e baixe seu arquivo.

Precisa de capturas de tela? Veja o Guia de Exportação.

3. Importar

Comandos suportados na coluna command: CREATE, UPDATE, REPLACE, DELETE, IGNORE
itemCommand suportado na linha de código: CREATE, UPDATE, MERGE, DELETE, IGNORE

Obtenha a planilha de exemplo: Discount-import-sample.xlsx
Preencha as linhas:
- type (DiscountCodeBasic, DiscountAutomaticBasic, etc.) é obrigatório para CREATE.
- Cada código vai em sua própria linha com itemCommand.
- Use handle ou title para corresponder quando id estiver vazio.
Mapeie as colunas no DataEase, faça o upload e inicie a importação.

Passos completos: Guia de Importação

Notas

startsAt / endsAt mudam apenas se a coluna estiver incluída.

recurringCycleLimit = 0 significa ilimitado para assinaturas.

combinesWithShipping é proibido para descontos de frete e gerará um erro.

Limites do Shopify: 5.000 descontos inteligentes e 60 regras por desconto.

4. Referência de campos

Básico

id — ID do Desconto (necessário para UPDATE, REPLACE, DELETE).
title — Nome visto por comerciantes e clientes.
summary — Descrição longa da oferta (apenas para administração).
shortSummary — Versão curta de summary. Apenas exportação.
startsAt — Quando o desconto se torna ativo (ISO 8601).
endsAt — Quando o desconto expira. Use null para sem data de término.
status — Estado atual: ACTIVE, SCHEDULED, EXPIRED. Apenas exportação.
type — Necessário no CREATE. Um dos: DiscountCodeBasic, DiscountAutomaticBasic, DiscountCodeBxgy, DiscountAutomaticBxgy, DiscountCodeFreeShipping, DiscountAutomaticFreeShipping.
code — Texto do código promocional (aplica-se apenas a descontos baseados em código).
itemCommand — Para cada linha de código: CREATE, UPDATE, MERGE, DELETE, IGNORE.
discountClass — Controla como os descontos se combinam (pedido, produto, frete). Desde a Admin API 2026-07 um desconto pode ter várias classes; esta coluna mantém a primeira. Apenas exportação.
discountClasses — Todas as classes do desconto, separadas por vírgula (por exemplo, PRODUCT, ORDER). Apenas exportação.
codesCount — Número de códigos vinculados ao desconto. Apenas exportação.
command — Comando principal para o desconto: CREATE, UPDATE, REPLACE, DELETE, IGNORE.

Cliente Recebe (recompensa)

customerGetsAllItems — true se todos os itens recebem a recompensa.
customerGetsCollectionHandle — Handles das coleções a serem recompensadas.
customerGetsVariantsSku — SKUs de variantes a serem recompensadas.
customerGetsProductsHandle — Handles de produtos a serem recompensados.
customerGetsPercentage — Percentual de desconto (0 – 1). Exemplo: 0.2 = 20% de desconto.
customerGetsOnQuantity — Quantidade de itens que recebem a recompensa (BxGy).
customerGetsAmountValue — Desconto fixo em dinheiro (moeda da loja).
customerGetsAmountAppliesOnEachItem — true para aplicar valor fixo a cada item; caso contrário, dividir entre os itens.

Cliente Compra (pré-requisito)

customerBuysAllItems — true se qualquer item pode acionar a oferta.
customerBuysCollectionHandle — Coleções que acionam a oferta.
customerBuysVariantsSku — SKUs de variantes que acionam a oferta.
customerBuysProductsHandle — Handles de produtos que acionam a oferta.
customerBuysAmount — Gasto mínimo necessário.
customerBuysQuantity — Quantidade mínima necessária.

Opções

combinesWithOrder — true se este desconto se combina com descontos de pedido.
combinesWithProduct — true se este desconto se combina com descontos de produto.
combinesWithShipping — true se este desconto se combina com descontos de frete.
appliesOncePerCustomer — true se cada cliente pode usar o desconto apenas uma vez.
usageLimit — Máximo de usos totais (null = ilimitado).
customerSelectionAllCustomers — true se todos os clientes podem usar o desconto.
customerSelectionSegments — IDs de segmentos de clientes permitidos ou bloqueados.
customerSelectionCustomers — IDs de clientes específicos permitidos ou bloqueados.
recurringCycleLimit — Para assinaturas: quantos ciclos de faturamento a oferta se aplica (0 = ilimitado).
minimumQuantity — Mínimo de itens no carrinho para aplicar o desconto.
minimumSubtotal — Subtotal mínimo do carrinho para aplicar o desconto.
appliesOnOneTimePurchase — true se funciona em itens de compra única.
appliesOnSubscription — true se funciona em itens de assinatura.
usesPerOrderLimit — Máximo de vezes que o desconto pode ser aplicado em um único pedido.
maximumShippingPrice — Custo máximo de frete que ainda qualifica para desconto de frete grátis.
destinationSelectionAllCountries — true se o desconto de frete grátis cobre todos os países.
destinationSelectionCountries — Códigos de país de duas letras que qualificam.
destinationSelectionIncludeRestOfWorld — true se países não listados também qualificam.

Metafields

metafields — Campos extras adicionados por aplicativos. Veja o Guia de Metafields.

5. Filtros

Code — Encontre descontos contendo um código específico.
CombinesWith — Filtre por sinalizador de combinação (order_discounts, product_discounts, shipping_discounts).
DiscountClass — Filtre por classe (pedido, produto, frete).
DiscountType — Filtre por tipo (percentual, valor_fixo, bogo, frete_grátis).
Id — Exporte um único desconto por id.
Method — code ou automatic.
StartsAt — Intervalo para data de início de atividade.
EndsAt — Intervalo para data de término de atividade.
CreatedAt — Intervalo de data de criação.
UpdatedAt — Intervalo de data da última atualização.
Status — ACTIVE, EXPIRED, SCHEDULED.
TimesUsed — Mínimo ou máximo de usos totais.
Title — Correspondência parcial no title.

Precisa de ajuda? Nossa equipe de suporte responde em até 24 horas.

Campos adicionais

Mais colunas que o DataEase suporta para esta entidade:

hasTimelineComment — Indica se o desconto tem um comentário na linha do tempo (booleano).
totalSales — Vendas totais geradas pelo desconto (numérico).
customerGetsAmountCurrencyCode — Código da moeda para o valor do desconto que o cliente recebe (ISO 4217).