131 lines
3.9 KiB
YAML
131 lines
3.9 KiB
YAML
type: object
|
|
required:
|
|
- code
|
|
- rule
|
|
- regions
|
|
properties:
|
|
code:
|
|
type: string
|
|
description: A unique code that will be used to redeem the Discount
|
|
is_dynamic:
|
|
type: boolean
|
|
description: >-
|
|
Whether the Discount should have multiple instances of itself, each with a
|
|
different code. This can be useful for automatically generated codes that
|
|
all have to follow a common set of rules.
|
|
default: false
|
|
rule:
|
|
description: The Discount Rule that defines how Discounts are calculated
|
|
type: object
|
|
required:
|
|
- type
|
|
- value
|
|
- allocation
|
|
properties:
|
|
description:
|
|
type: string
|
|
description: A short description of the discount
|
|
type:
|
|
type: string
|
|
description: >-
|
|
The type of the Discount, can be `fixed` for discounts that reduce the
|
|
price by a fixed amount, `percentage` for percentage reductions or
|
|
`free_shipping` for shipping vouchers.
|
|
enum:
|
|
- fixed
|
|
- percentage
|
|
- free_shipping
|
|
value:
|
|
type: number
|
|
description: >-
|
|
The value that the discount represents; this will depend on the type
|
|
of the discount
|
|
allocation:
|
|
type: string
|
|
description: The scope that the discount should apply to.
|
|
enum:
|
|
- total
|
|
- item
|
|
conditions:
|
|
type: array
|
|
description: >-
|
|
A set of conditions that can be used to limit when the discount can
|
|
be used. Only one of `products`, `product_types`,
|
|
`product_collections`, `product_tags`, and `customer_groups` should be
|
|
provided.
|
|
items:
|
|
type: object
|
|
required:
|
|
- operator
|
|
properties:
|
|
operator:
|
|
type: string
|
|
description: Operator of the condition
|
|
enum:
|
|
- in
|
|
- not_in
|
|
products:
|
|
type: array
|
|
description: list of product IDs if the condition is applied on products.
|
|
items:
|
|
type: string
|
|
product_types:
|
|
type: array
|
|
description: >-
|
|
list of product type IDs if the condition is applied on product
|
|
types.
|
|
items:
|
|
type: string
|
|
product_collections:
|
|
type: array
|
|
description: >-
|
|
list of product collection IDs if the condition is applied on
|
|
product collections.
|
|
items:
|
|
type: string
|
|
product_tags:
|
|
type: array
|
|
description: >-
|
|
list of product tag IDs if the condition is applied on product
|
|
tags.
|
|
items:
|
|
type: string
|
|
customer_groups:
|
|
type: array
|
|
description: >-
|
|
list of customer group IDs if the condition is applied on
|
|
customer groups.
|
|
items:
|
|
type: string
|
|
is_disabled:
|
|
type: boolean
|
|
description: >-
|
|
Whether the Discount code is disabled on creation. You will have to enable
|
|
it later to make it available to Customers.
|
|
default: false
|
|
starts_at:
|
|
type: string
|
|
format: date-time
|
|
description: The time at which the Discount should be available.
|
|
ends_at:
|
|
type: string
|
|
format: date-time
|
|
description: The time at which the Discount should no longer be available.
|
|
valid_duration:
|
|
type: string
|
|
description: Duration the discount runs between
|
|
example: P3Y6M4DT12H30M5S
|
|
regions:
|
|
description: >-
|
|
A list of Region ids representing the Regions in which the Discount can be
|
|
used.
|
|
type: array
|
|
items:
|
|
type: string
|
|
usage_limit:
|
|
type: number
|
|
description: Maximum times the discount can be used
|
|
metadata:
|
|
description: An optional set of key-value pairs to hold additional information.
|
|
type: object
|