What are required options?

For some products of Picanova, it's required to have certain extra options. These options are called required option of product.
(For example: Canvas requires certain extra options, including canvas border and stretcher frame)

Within teeinblue, these required options need to be added as "Default options" in Product base.



One product can have multiple required options to be added. If required options are missing, you won't be able to send order that contains these products to fulfill.

Set up Picanova products' required options in app

Step 1: Check if product has required options

In order to learn if your product requires an extra option:

First, log in to your Picanova account on api.picanova.com
Within Picanova platform, find product ID (1)
Use product ID to check if that product contains a required option (2)

(1) Find product ID

From Dashboard, go to "API Documentation" page
Scroll down to "Products" section ➡ Open the /products category
Click on "Try it out" button ➡ Click on "Execute" button



After then, you will see a panel under "Server response" listed all products in code. In that panel, each product name and ID can be found subsequently.

Example: Product "Canvas" has ID "2", while product "Magic Mug" has ID "4"



(2) Check product option requirement
In "Products" section, open /products/{product_id} category ➡ Click on "Try it out" button



Type product ID in the input field "ID of product to return" ➡ Finish action by clicking on "Execute".
Example: Canvas ID = "2"



After then, you will see another panel under "Server response" listed all info of product in code:



Scroll down the panel, find a code line named "options"
Check the line "name" of option
Check if there is line "is_required": true . A required option shall contain this code line within

Example: Variant "Canvas border" of Canvas contains "is_required": true ➡ Canvas border is a required option



Continue to repeat the above action to see how many required options are included in product

Example: Canvas has 2 required options: Canvas border and Stretcher frame



Step 2: Set up required options in teeinblue

Variant of required option

Before setting up the required options in teeinblue, we need to find the variant of option.

From the coding panel scroll down and look for line "values"
Under "values" code line, you will start seeing the ID and name of variants

Example: Canvas border contains 5 variants, following: Mirrored, Folded, Stretched, White, Black. While Stretcher frame contains only 1 variant as "2cm".



Note down the option name for later use

A required options can have multiple variants, but only ONE variant can be selected to add in product base.

Add required options in Product base
After choosing the variant of option, go back to teeinblue ➡ Go to Product base section
Edit product base (Example: [EU] Canvas)
Add required options in the input field of "Default options" following the formula: "Option_name": "OptionVariant_name"

Example: Canvas border with variant "Mirrored" and Stretcher frame with variant "2cm". Input text should be:

{
"Canvas border": "Mirrored",
"Stretcher frame": "2cm"
}




Click Save and done


Compilation of Picanova products that require custom options

To help you on adding required options easier, we've synthesized a list of products and its required options + available variants in the list below.

You can copy and paste the code line from code section format of "Template to add required options" directly to teeinblue.

Writing format: Name of Required options + Available variant(s): Template to add required options

Canvas (International and EU) - ID: 2
Canvas border:

- Mirrored:
"Canvas border": "Mirrored"

- Folded:
"Canvas border": "Folded"

- Stretched:
"Canvas border": "Stretched"

- White:
"Canvas border": "White"

- Black:
"Canvas border": "Black"

Stretcher frame:
- 2cm:
"Stretcher frame": "2cm"

Passepartout (EU) - ID: 11
Decor Frame:

- Deco Black Matte:
"Decor Frame": "Deco Black Matte

- Deco White:
"Decor Frame": "Deco White"

- Deco Silver:
"Decor Frame": "Deco Silver"

- Deco Walnut flair:
"Decor Frame": "Deco Walnut flair"

- Deco Oak flair:
"Decor Frame": "Deco Oak flair"

Tote Bag (EU) - ID: 28
Backside:

- Red:
"Backside": "Red"

- Pink:
"Backside": "Pink"

- Rose:
"Backside": "Rose"

- Heaven:
"Backside": "Heaven"

- Blue:
"Backside": "Blue"

- Aqua:
"Backside": "Aqua"

- Forest
"Backside": "Forest"

- Lime:
"Backside": "Lime"

- Yellow:
"Backside": "Yellow"

- Orange:
"Backside": "Orange"

- Grey:
"Backside": "Grey"

- Black:
"Backside": "Black"

- Mirrored:
"Backside": "Mirrored"

- White:
"Backside": "White"

Cushion Premium (EU) - ID: 31
Backside:

- Red:
"Backside": "Red"

- Pink:
"Backside": "Pink"

- Rose:
"Backside": "Rose"

- Heaven:
"Backside": "Heaven"

- Blue:
"Backside": "Blue"

- Aqua:
"Backside": "Aqua"

- Forest
"Backside": "Forest"

- Lime:
"Backside": "Lime"

- Yellow:
"Backside": "Yellow"

- Orange:
"Backside": "Orange"

- Grey:
"Backside": "Grey"

- Black:
"Backside": "Black"

- Mirrored:
"Backside": "Mirrored"

- White:
"Backside": "White"

(Last updated on Mar 2021)
Was this article helpful?
Cancel
Thank you!