Comment on page
The fixed price promotion object
A comprehensive list of the fixed price promotion resource's attributes and relationships
A fixed price promotion object is returned as part of the response body of each successful list, retrieve, create or update API call to the
/api/fixed_price_promotions
endpoint.Field | Type | Description |
---|---|---|
type | string | fixed_price_promotions |
id | string | The fixed price promotion unique identifier |
links.self | string | The fixed price promotion endpoint URL |
attributes.name | string | The promotion's internal name. |
attributes.currency_code | string | The international 3-letter currency code as defined by the ISO 4217 standard. |
attributes.exclusive | boolean | Indicates if the promotion will be applied exclusively, based on its priority score. |
attributes.priority | integer | The priority assigned to the promotion (lower means higher priority). |
attributes.starts_at | datetime | The activation date/time of this promotion. |
attributes.expires_at | datetime | The expiration date/time of this promotion (must be after starts_at). |
attributes.total_usage_limit | integer | The total number of times this promotion can be applied. |
attributes.total_usage_count | integer | The number of times this promotion has been applied. |
attributes.active | boolean | Indicates if the promotion is active (enabled and not expired). |
attributes._disable | boolean | Send this attribute if you want to mark the promotion as disabled. |
attributes._enable | boolean | Send this attribute if you want to mark the promotion as enabled. |
attributes.disabled_at | datetime | Time at which the promotion was disabled. |
attributes.created_at | datetime | Time at which the resource was created. |
attributes.updated_at | datetime | Time at which the resource was last updated. |
attributes.reference | string | A string that you can use to add any external identifier to the resource. This can be useful for integrating the resource to an external system, like an ERP, a marketing tool, a CRM, or whatever. |
attributes.reference_origin | string | Any identifier of the third party system that defines the reference code |
attributes.metadata | object | Set of key-value pairs that you can attach to the resource. This can be useful for storing additional information about the resource in a structured format. |
attributes.fixed_amount_cents | integer | The price fixed amount to be applied on matching SKUs, in cents |
attributes.fixed_amount_float | float | The discount fixed amount to be applied, float. |
attributes.formatted_fixed_amount | string | The discount fixed amount to be applied, formatted. |
relationships.market | object | The associated market. |
relationships.promotion_rules | array | The associated promotion rules. |
relationships.order_amount_promotion_rule | object | The associated order amount promotion rule. |
relationships.sku_list_promotion_rule | object | The associated SKU list promotion rule. |
relationships.coupon_codes_promotion_rule | object | The associated coupon codes promotion rule. |
relationships.coupons | array | The associated coupons through coupon codes promotion rule. |
relationships.sku_list | object | The associated SKU list. |
relationships.attachments | array | The associated attachments. |
relationships.events | array | The associated events. |
relationships.tags | array | The associated tags. |
relationships.versions | array | The associated changes. |
relationships.skus | array | The associated SKUs. |
meta.mode | string | The resource environment (can be one of test or live ) |
Last modified 2mo ago