Returns a list of discounts.

Table-Specific Information

Select

The 本製品 uses the Shopify API to process WHERE clause conditions built with the following columns and operators. The 本製品 processes other filters client-side within the 本製品.

• Title supports the '=, !=' comparison operators.
• DiscountClass supports the '=' comparison operator.
• StartsAt supports the '=, !=, <, >, >=, <=' comparison operators.

For example, the following queries are processed server-side:

  SELECT * FROM DiscountsCodeBasic WHERE Title = 'Val1'
  SELECT * FROM DiscountsCodeBasic WHERE DiscountClass = 'Val1'
  SELECT * FROM DiscountsCodeBasic WHERE StartsAt = '2023-01-01 11:10:00'

Insert

The following columns can be used to create a new record:

Title, EndsAt, StartsAt, UsageLimit, RecurringCycleLimit, AppliesOncePerCustomer, CombinesWithOrderDiscounts, CombinesWithProductDiscounts, CombinesWithShippingDiscounts, CustomerGetsAppliesOnSubscription, CustomerGetsAppliesOnOneTimePurchase, DiscountCustomerAllAllCustomers, DiscountMinimumQuantityGreaterThanOrEqualToQuantity

The following pseudo-columns can be used to create a new record:

Code, AppliesOnEachItem, DiscountAmount, ProductsToAdd, ProductsToRemove, AddAllCustomers, CustomersToAdd, CustomersToRemove, CustomerSegmentsToAdd, CustomerSegmentsToRemove

Update

The following columns can be updated:

Title, EndsAt, StartsAt, UsageLimit, RecurringCycleLimit, AppliesOncePerCustomer, CombinesWithOrderDiscounts, CombinesWithProductDiscounts, CombinesWithShippingDiscounts, CustomerGetsAppliesOnSubscription, CustomerGetsAppliesOnOneTimePurchase, DiscountCustomerAllAllCustomers, DiscountMinimumQuantityGreaterThanOrEqualToQuantity

The following pseudo-columns can be used to update a record:

Code, AppliesOnEachItem, DiscountAmount, ProductsToAdd, ProductsToRemove, AddAllCustomers, CustomersToAdd, CustomersToRemove, CustomerSegmentsToAdd, CustomerSegmentsToRemove

Delete

You can delete entries by specifying the following column:

Id

Columns

Name	Type	ReadOnly	References	Description
Id [KEY]	String	True		A globally-unique ID.
Title	String	False		The title of the discount.
Status	String	True		The status of the discount.
Summary	String	True		A detailed summary of the discount.
CodesCount	Int	True		The number of redeem codes for the discount.
CodesCountPrecision	String	True		The count's precision, or the exactness of the value.
DiscountClass	String	True		The class of the discount for combining purposes.
EndsAt	Datetime	False		The date and time when the discount ends. For open-ended discounts, use 'null'.
ShortSummary	String	True		A short summary of the discount.
StartsAt	Datetime	False		The date and time when the discount starts.
UsageLimit	Int	False		The maximum number of times that the discount can be used.
AsyncUsageCount	Int	True		The number of times that the discount has been used.
HasTimelineComment	Bool	True		Indicates whether there are any timeline comments on the discount.
RecurringCycleLimit	Int	False		The number of times a discount applies on recurring purchases (subscriptions).
AppliesOncePerCustomer	Bool	False		Whether the discount can be applied only once per customer.
CreatedAt	Datetime	True		The date and time when the discount was created.
CombinesWithOrderDiscounts	Bool	False		Combines with order discounts.
CombinesWithProductDiscounts	Bool	False		Combines with product discounts.
CombinesWithShippingDiscounts	Bool	False		Combines with shipping discounts.
CustomerGetsAppliesOnSubscription	Bool	False		Whether the discount applies on subscription items.
CustomerGetsAppliesOnOneTimePurchase	Bool	False		Whether the discount applies on regular one-time-purchase items.
DiscountCustomerAllAllCustomers	Bool	False		Whether the discount can be applied by all customers. This value is always 'true'.
DiscountMinimumQuantityGreaterThanOrEqualToQuantity	String	False		The minimum quantity of items that's required for the discount to be applied.
TotalSalesAmount	Decimal	True		Decimal money amount.
TotalSalesCurrencyCode	String	True		Currency of the money.

Pseudo-Columns

疑似カラムは、明示的にリストされているタイプのステートメントでのみ使用できるフィールドです。これらは標準的なカラムではなく、特定の操作のための追加機能を提供するものです。

Name	Type	Description
Code	String	The code to use the discount.
AppliesOnEachItem	Bool	If true, then the discount is applied to each of the entitled items. If false, then the amount is split across all of the entitled items.
DiscountAmount	Decimal	The value of the discount.
ProductsToAdd	String	A simple, comma-separated list of products IDs to add.
ProductsToRemove	String	A simple, comma-separated list of products IDs to remove.
AddAllCustomers	Bool	Whether all customers can use this discount.
CustomersToAdd	String	A simple, comma-separated list of customers IDs to add.
CustomersToRemove	String	A simple, comma-separated list of customers IDs to remove.
CustomerSegmentsToAdd	String	A simple, comma-separated list of customers IDs to add.
CustomerSegmentsToRemove	String	A simple, comma-separated list of customers IDs to remove.