Products

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=reseller

Hidden 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"