Product Object

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
id
string

Unique product ID assigned by Voucherify.

Example:

prod_0b1da8105693710357

source_id
string, null

Unique product source ID.

Example:

productSourceID16

name
string, null

Unique user-defined product name.

Example:

T-shirt

price
integer, null

Unit price. It is represented by a value multiplied by 100 to accurately reflect 2 decimal places, such as $100.00 being expressed as 10000.

attributes
array

A 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.

metadata
object

The 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.

image_url
string, null

The 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_at
string

Timestamp representing the date and time when the product was created in ISO 8601 format.

Example:

2022-05-23T06:52:55.008Z

updated_at
string, null

Timestamp representing the date and time when the product was updated in ISO 8601 format.

Example:

2022-05-23T09:24:07.405Z

object
string

The type of object represented by JSON. This object stores information about the product.

Available values: product

Skus List For Product

AttributesDescription
object
string

The type of object represented by JSON. This object stores information about SKUs.

data_ref
string

Identifies the name of the JSON property that contains the array of SKUs.

data
array

A dictionary that contains an array of SKUs.

Array of SKU Object
total
integer

Total number of SKUs in the product.

SKU Object

AttributesDescription
id
string

A unique identifier that represents the SKU and is assigned by Voucherify.

Example:

sku_0b1621b319d248b79f

source_id
string, null

A unique SKU identifier from your inventory system.

Example:

sku_source_id_4

product_id
string

The parent product's unique ID.

Example:

prod_0b15f6b9f650c16990

sku
string, null

Unique user-defined SKU name.

Example:

Large Pink Shirt

price
integer, null

Unit price. It is represented by a value multiplied by 100 to accurately reflect 2 decimal places, such as $100.00 being expressed as 10000.

currency
string, null

SKU price currency.

Example:

USD

attributes
object

The 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_url
string, null

The HTTPS URL pointing to the .png or .jpg file that will be used to render the SKU image.

metadata
object

The 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.

created_at
string

Timestamp representing the date and time when the SKU was created in ISO 8601 format.

Example:

2022-05-17T10:36:30.187Z

updated_at
string, null

Timestamp representing the date and time when the SKU was updated in ISO 8601 format.

Example:

2022-05-17T10:55:09.137Z

object
string

The type of object represented by JSON. This object stores information about the SKU.

Available values: sku