Create a sale offer

post /rest/api/sale_offers

Creates a Sale Offer resource.

Creates a sale offer - the selling price of a variant for a country, with a tax and a taxExcludedPrice, valid from startsAt. Attach channels to scope it to specific sales surfaces, and a discountTaxExcludedPrice for a promotion.

Relations are IRIs

variant, country, tax and channels reference existing resources by IRI. taxExcludedPrice is a money object (amount + currency).

Headers

Name	Type	Required	Description
X-Flowkiwi-Organization-Id	string	required	The organization the request acts as. Determines the identity, permissions and ownership applied when reading or modifying data on the instance.

Request body

Property	Type	Required	Description
status	string	required	The status of the offer.
taxExcludedPrice	EmbeddedMoneyResource | null	required	The price set for the offer, excluding tax.
Show taxExcludedPrice fields Property Type Required Description amount string required The monetary amount, as a decimal string. currency string required The ISO 4217 currency code (e.g. EUR).
discountTaxExcludedPrice	EmbeddedMoneyResource | null	-	The discounted tax-excluded price, when a discount applies.
Show discountTaxExcludedPrice fields Property Type Required Description amount string required The monetary amount, as a decimal string. currency string required The ISO 4217 currency code (e.g. EUR).
startsAt	string | null	-	Start date of the offer. Defaults to the current date/time if not provided.
endsAt	string | null	-	End date of the offer.
country	string | null	required	The country resource it belongs to.
tax	string | null	required	The tax resource it belongs to.
variant	string | null	required	The variant resource it belongs to.
channels	string[]	-	A list of Channel IRIs the sale offer is distributed through.

Response

201 - Sale Offer resource created

Property	Type	Required	Description
@context	object	-
@id	string	required
@type	string	required
id	string	-	The unique identifier of the sale offer.
status	string	-	The status of the offer.
taxExcludedPrice	EmbeddedMoneyResource	required	The price set for the offer, excluding tax.
Show taxExcludedPrice fields Property Type Required Description amount string required The monetary amount, as a decimal string. currency string required The ISO 4217 currency code (e.g. EUR).
taxExcludedPricePerUnit	EmbeddedPricePerUnitResource | null	-	The tax-excluded price expressed per measurement reference unit.
Show taxExcludedPricePerUnit fields Property Type Required Description amount string required The monetary amount, as a decimal string. currency string required The ISO 4217 currency code (e.g. EUR). unit "ml" | "cl" | "l" | "mg" | "g" | "kg" | "mm" | "cm" | "m" | "m2" | "unit" required The reference unit the amount is expressed per. value integer required The number of reference units the amount applies to.
price	EmbeddedMoneyResource	-	The tax-included price, computed from taxExcludedPrice and the referenced Tax rate.
Show price fields Property Type Required Description amount string required The monetary amount, as a decimal string. currency string required The ISO 4217 currency code (e.g. EUR).
pricePerUnit	EmbeddedPricePerUnitResource | null	-	The tax-included price expressed per measurement reference unit.
Show pricePerUnit fields Property Type Required Description amount string required The monetary amount, as a decimal string. currency string required The ISO 4217 currency code (e.g. EUR). unit "ml" | "cl" | "l" | "mg" | "g" | "kg" | "mm" | "cm" | "m" | "m2" | "unit" required The reference unit the amount is expressed per. value integer required The number of reference units the amount applies to.
discountPrice	EmbeddedMoneyResource | null	-	The discounted tax-included price, when a discount applies.
Show discountPrice fields Property Type Required Description amount string required The monetary amount, as a decimal string. currency string required The ISO 4217 currency code (e.g. EUR).
discountPricePerUnit	EmbeddedPricePerUnitResource | null	-	The discounted tax-included price per measurement reference unit, when a discount applies.
Show discountPricePerUnit fields Property Type Required Description amount string required The monetary amount, as a decimal string. currency string required The ISO 4217 currency code (e.g. EUR). unit "ml" | "cl" | "l" | "mg" | "g" | "kg" | "mm" | "cm" | "m" | "m2" | "unit" required The reference unit the amount is expressed per. value integer required The number of reference units the amount applies to.
discountTaxExcludedPrice	EmbeddedMoneyResource | null	-	The discounted tax-excluded price, when a discount applies.
Show discountTaxExcludedPrice fields Property Type Required Description amount string required The monetary amount, as a decimal string. currency string required The ISO 4217 currency code (e.g. EUR).
discountTaxExcludedPricePerUnit	EmbeddedPricePerUnitResource | null	-	The discounted tax-excluded price per measurement reference unit, when a discount applies.
Show discountTaxExcludedPricePerUnit fields Property Type Required Description amount string required The monetary amount, as a decimal string. currency string required The ISO 4217 currency code (e.g. EUR). unit "ml" | "cl" | "l" | "mg" | "g" | "kg" | "mm" | "cm" | "m" | "m2" | "unit" required The reference unit the amount is expressed per. value integer required The number of reference units the amount applies to.
startsAt	string	-	Start date of the offer. Defaults to the current date/time if not provided.
endsAt	string | null	-	End date of the offer.
country	string	required	The country resource it belongs to.
tax	string	required	The tax resource it belongs to.
variant	string	required	The variant resource it belongs to.
channels	string[]	-	A list of Channel IRIs the sale offer is distributed through.
createdAt	string	-	The date and time when the resource was created (ISO 8601 format).
updatedAt	string	-	The date and time when the resource was last modified (ISO 8601 format).

Errors

400 - Invalid input

Property	Type	Required	Description
@context	object	-
@id	string	required
@type	string	required
title	string | null	-	A short, human-readable summary of the problem.
detail	string | null	-	A human-readable explanation specific to this occurrence of the problem.
status	number | null	-
instance	string | null	-	A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
type	string	-	A URI reference that identifies the problem type

403 - Access denied. The caller is missing one or more identity permissions required for this operation.

Content-Type: application/problem+json

Property	Type	Required	Description
@context	object	-
@id	string	required
@type	string	required
type	string	-
title	string	-
status	integer	-
detail	string	-
missingPermissions	string[]	-	Identity permissions that the caller is missing for this operation. Present only when the 403 is caused by a denied identity:* permission.

422 - An error occurred

Property	Type	Required	Description
@context	object	-
@id	string	required
@type	string	required
status	integer	-
violations	object[]	-
Show violations fields Property Type Required Description propertyPath string required The property path of the violation message string required The message associated with the violation code string - The code of the violation hint string - An extra hint to understand the violation payload object - The serialized payload of the violation
detail	string	-
type	string	-
title	string | null	-
instance	string | null	-