How to configure products
Required properties
Each product property is marked as required (true or false). If a required property is missing, the configuration can't be ordered.
Excluded options
Some product options cannot be combined, usually because of physical limits. For example, some materials are not available for offset printing because the size of the printing sheets do not match. To retrieve a list of excluded options, use the reseller view (see the next topic).
"excludes": [
[
{
"property": "material",
"options": [
"115gr_gesatineerd_mc",
"150gr_gesatineerd_mc",
"200gr_gesatineerd_mc"
]
},
{
"property": "printingmethod",
"options": [
"offset"
]
}
],
]Reseller view
The reseller view offers more data about product configurations than the default view. For example, it includes the name of property groups that can be used to logically position product properties and options.
https://api.print.com/products/{sku}?view=resellerHidden properties
Some properties are set automatically and can be hidden from customers to create a more simple user experience. These properties can be found in the hidden property group.
Locked options
Some options are determined by the product configuration and can't be changed by the user. When placing an order through the API, locked options can be left out of the request and will be added automatically. In the following example, 'Clean cut' is locked and determined by the rest of the product configuration:
{
"slug":"clean_cut",
"title":"Clean cut",
"locked":true,
"options":[
{
"slug":"no",
"name":"No",
"nullable":true,
"eco":false
},
{
"slug":"yes",
"name":"Yes",
"description":"Clean cut",
"nullable":false,
"eco":false
}
],
"required":false
}Variants
Product variants are used in mainly textile products to combine different product sizes and colours in a single order. The benefit of this is that the startup costs of creating a printable area is divided over the variants.
"variants": [
{
"textile_sizes": "m",
"color_textile": "black_tshirt_bc150",
"copies": 10
},
{
"textile_sizes": "l",
"color_textile": "red_tshirt_bc150",
"copies": 10
}
],Bundling
Products like flyers and folders can be bundled. However, bundling is only possible if the total number of copies can be divided by the bundle amount. Please note that this is not part of the product excludes and have to be configured manually. Some examples:
- 100 copies
- Can be bundled in bundles of 25, 50 and 100
- Cannot be bundled in bundles of 250 or 500
- 75 copies
- Can be bundled in bundles of 25
- Cannot be bundled in bundles of 50, 100, 250 or 1.000
"bundle": "bundle_per_25"