Skip to main content

Product

This is an object representing a product. This entity should be used to map product items from your inventory management system. The aim of products is to build which reflect product-specific campaigns. All of:
  1. Product without Skus Object
  2. AttributesDescription
    skusSee: Skus List For Product

Product without Skus Object

AttributesDescription
idstringUnique product ID assigned by Voucherify.Example:prod_0b1da8105693710357
source_idstring, nullUnique product source ID.Example:productSourceID16
namestring, nullUnique user-defined product name.Example:T-shirt
priceinteger, nullUnit price. It is represented by a value multiplied by 100 to accurately reflect 2 decimal places, such as $100.00 being expressed as 10000.
attributesarrayA list of product attributes whose values you can customize for given SKUs: ["color","size","ranking"]. Each child SKU can have a unique value for a given attribute.
metadataobjectThe metadata object stores all custom attributes assigned to the product. A set of key/value pairs that you can attach to a product object. It can be useful for storing additional information about the product in a structured format. It can be used to create product collections.
image_urlstring, nullThe HTTPS URL pointing to the .png or .jpg file that will be used to render the product image.Example:https://images.com/original.jpg
created_atstringTimestamp representing the date and time when the product was created. The value is shown in the ISO 8601 format.Example:2022-05-23T06:52:55.008Z
updated_atstring, nullTimestamp representing the date and time when the product was updated. The value is shown in the ISO 8601 format.Example:2022-05-23T09:24:07.405Z
objectstringThe type of the object represented by JSON. This object stores information about the product.Available values: product

Skus List For Product

AttributesDescription
objectstringThe type of the object represented by JSON. This object stores information about SKUs.
data_refstringIdentifies the name of the JSON property that contains the array of SKUs.
dataarrayA dictionary that contains an array of SKUs.Array of SKU Object
totalintegerTotal number of SKUs in the product.

SKU Object

AttributesDescription
idstringA unique identifier that represents the SKU and is assigned by Voucherify.Example:sku_0b1621b319d248b79f
source_idstring, nullA unique SKU identifier from your inventory system.Example:sku_source_id_4
product_idstringThe parent product’s unique ID.Example:prod_0b15f6b9f650c16990
skustring, nullUnique user-defined SKU name.Example:Large Pink Shirt
priceinteger, nullUnit price. It is represented by a value multiplied by 100 to accurately reflect 2 decimal places, such as $100.00 being expressed as 10000.
currencystring, nullSKU price currency.Example:USD
attributesobjectThe attributes object stores values for all custom attributes inherited by the SKU from the parent product. A set of key/value pairs that are attached to a SKU object and are unique to each SKU within a product family.
image_urlstring, nullThe HTTPS URL pointing to the .png or .jpg file that will be used to render the SKU image.
metadataobjectThe metadata object stores all custom attributes assigned to the SKU. A set of key/value pairs that you can attach to a SKU object. It can be useful for storing additional information about the SKU in a structured format. It can be used to create product collections.
created_atstringTimestamp representing the date and time when the SKU was created. The value is shown in the ISO 8601 format.Example:2022-05-17T10:36:30.187Z
updated_atstring, nullTimestamp representing the date and time when the SKU was updated. The value is shown in the ISO 8601 format.Example:2022-05-17T10:55:09.137Z
objectstringThe type of the object represented by JSON. This object stores information about the SKU.Available values: sku
I