Discounts

Discountは、プロモコード、自動ディール、送料無料、または「Xを買うとYがもらえる」オファーで買い物客に報酬を与えることができます。
DataEaseを使用すると、以下のことが可能です：

1回のアップロードで数百の新しいコードを作成します。
ルール、日付、または結合設定を一括で更新します。
期限切れのディールを迅速に削除します。

Shopifyの割引ガイド。

2. エクスポート

CSV（非常に長いテキストに安全）またはExcelを選択します。
エンティティとしてDiscountを選択します。
type、startsAt、codesCountなどのフィールドを選択します。
タスクを実行し、ファイルをダウンロードします。

スクリーンショットが必要ですか？エクスポートガイドをご覧ください。

3. インポート

command列でサポートされているコマンド: CREATE, UPDATE, REPLACE, DELETE, IGNORE
コードラインのitemCommandでサポートされている: CREATE, UPDATE, MERGE, DELETE, IGNORE

サンプルシートを取得します: Discount-import-sample.xlsx
行を埋めます:
- type（DiscountCodeBasic, DiscountAutomaticBasicなど）はCREATEに必要です。
- 各コードはitemCommandで独自の行に配置されます。
- idが空の場合、handleまたはtitleを使用して一致させます。
DataEaseで列をマッピングし、アップロードしてインポートを開始します。

完全な手順: インポートガイド

注意

startsAt / endsAtは、列が含まれている場合にのみ変更されます。

recurringCycleLimit = 0はサブスクリプションに対して無制限を意味します。

combinesWithShippingは送料割引には禁止されており、エラーが発生します。

Shopifyの制限: 5,000のスマートディスカウントと1つのディスカウントあたり60のルール。

4. フィールドリファレンス

基本

id — 割引ID（UPDATE, REPLACE, DELETEに必要）。
title — マーチャントと買い物客が見る名前。
summary — ディールの長い説明（管理者のみ）。
shortSummary — summaryの短いバージョン。エクスポートのみ。
startsAt — 割引が有効になる時刻（ISO 8601）。
endsAt — 割引が終了する時刻。終了日がない場合はnullを使用。
status — 現在の状態: ACTIVE, SCHEDULED, EXPIRED。エクスポートのみ。
type — CREATEに必要。次のいずれか: DiscountCodeBasic, DiscountAutomaticBasic, DiscountCodeBxgy, DiscountAutomaticBxgy, DiscountCodeFreeShipping, DiscountAutomaticFreeShipping。
code — プロモコードのテキスト（コードベースの割引にのみ適用）。
itemCommand — 各コード行に対して: CREATE, UPDATE, MERGE, DELETE, IGNORE。
discountClass — 割引の結合方法を制御（注文、製品、送料）。Admin API 2026-07以降、割引は複数のクラスを持てるようになりましたが、この列は最初のクラスのみを保持します。エクスポートのみ。
discountClasses — 割引のすべてのクラス（カンマ区切り、例: PRODUCT, ORDER）。エクスポートのみ。
codesCount — 割引にリンクされたコードの数。エクスポートのみ。
command — 割引のメインコマンド: CREATE, UPDATE, REPLACE, DELETE, IGNORE。

Customer Gets (報酬)

customerGetsAllItems — すべてのアイテムが報酬を受け取る場合はtrue。
customerGetsCollectionHandle — 報酬を受け取るコレクションのハンドル。
customerGetsVariantsSku — 報酬を受け取るバリアントのSKU。
customerGetsProductsHandle — 報酬を受け取る製品のハンドル。
customerGetsPercentage — 割引率（0 – 1）。例: 0.2 = 20%オフ。
customerGetsOnQuantity — 報酬を受け取るアイテムの数量（BxGy）。
customerGetsAmountValue — 固定金額オフ（ストア通貨）。
customerGetsAmountAppliesOnEachItem — 各アイテムに固定金額を適用する場合はtrue; それ以外はアイテム間で分割。

Customer Buys (前提条件)

customerBuysAllItems — どのアイテムでもディールを引き起こすことができる場合はtrue。
customerBuysCollectionHandle — ディールを引き起こすコレクション。
customerBuysVariantsSku — ディールを引き起こすバリアントのSKU。
customerBuysProductsHandle — ディールを引き起こす製品のハンドル。
customerBuysAmount — 必要な最低支出額。
customerBuysQuantity — 必要な最低数量。

オプション

combinesWithOrder — この割引が注文割引と組み合わせる場合はtrue。
combinesWithProduct — この割引が製品割引と組み合わせる場合はtrue。
combinesWithShipping — この割引が送料割引と組み合わせる場合はtrue。
appliesOncePerCustomer — 各顧客が割引を一度だけ使用できる場合はtrue。
usageLimit — 最大総使用回数（null = 無制限）。
customerSelectionAllCustomers — すべての買い物客が割引を使用できる場合はtrue。
customerSelectionSegments — 許可またはブロックされた顧客セグメントID。
customerSelectionCustomers — 許可またはブロックされた特定の顧客ID。
recurringCycleLimit — サブスクリプションの場合: ディールが適用される請求サイクルの数（0 = 無制限）。
minimumQuantity — 割引を適用するためにカートに必要な最小アイテム数。
minimumSubtotal — 割引を適用するためにカートに必要な最小小計。
appliesOnOneTimePurchase — 一度限りのアイテムに適用される場合はtrue。
appliesOnSubscription — サブスクリプションアイテムに適用される場合はtrue。
usesPerOrderLimit — 1つの注文で割引を適用できる最大回数。
maximumShippingPrice — 送料無料割引の対象となる最大送料。
destinationSelectionAllCountries — 送料無料割引がすべての国を対象とする場合はtrue。
destinationSelectionCountries — 対象となる2文字の国コード。
destinationSelectionIncludeRestOfWorld — リストされていない国も対象となる場合はtrue。

Metafields

metafields — アプリによって追加された追加フィールド。Metafieldsガイドを参照してください。

5. フィルター

Code — 特定のコードを含む割引を見つけます。
CombinesWith — 組み合わせフラグでフィルター（order_discounts, product_discounts, shipping_discounts）。
DiscountClass — クラスでフィルター（order, product, shipping）。
DiscountType — タイプでフィルター（percentage, fixed_amount, bogo, free_shipping）。
Id — idで単一の割引をエクスポートします。
Method — codeまたはautomatic。
StartsAt — 有効開始日範囲。
EndsAt — 有効終了日範囲。
CreatedAt — 作成日範囲。
UpdatedAt — 最終更新日範囲。
Status — ACTIVE, EXPIRED, SCHEDULED。
TimesUsed — 最小または最大総使用回数。
Title — titleの部分一致。

サポートが必要ですか？サポートチームは24時間以内に返信します。

追加フィールド

このエンティティに対してDataEaseがサポートする他の列:

hasTimelineComment — 割引にタイムラインコメントがあるかどうかを示します（ブール値）。
totalSales — 割引によって生成された総売上（数値）。
customerGetsAmountCurrencyCode — 顧客が受け取る割引金額の通貨コード（ISO 4217）。