At the moment, you can already select your desired options when importing merchOne Products. You can still continue reading this Article for more information.

What are required options?

For some products of merchOne, 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 Required options in Product base.



The required options box will only show up with merchOne and Printful products.
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 merchOne products' required options in app

Updated Mar 9, 2022: now you can select the extra options before importing a product. Then we'll pre-fill the "Default options" bases on the options you select.



Or you can follow the steps below to set up manually:

Step 1: Check if product has required options

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

First, log in to your merchOne account on https://api.picanova.com/dashboard
Within merchOne 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: https://api.picanova.com/docs
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 "2 cm".



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 "2 cm". Input text should be:

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

Click Save and done

Compilation of merchOne 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:
- 2 cm:
"Stretcher frame": "2 cm"

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"

Updated on: 20/04/2023