Set Up Worktops through API

➡️ See the API Reference documentation 🔗 for detailed information.

Set Up the Dimensions

For precut worktops, width is a mandatory parameter used for price calculation.

Parameter	Type	Possible values
`width`	real	[0 ;∞]
`depth`	real	[0 ;∞]
`height`	real	[0 ;∞]

"width": {
    "typeID": 1,
    "values": [
        4000
    ],
    "editable": null,
    "translation": {
        "name": {
            "1": "Longueur",
            "2": "Width",
            "3": "Anchura",
            "4": "Breite"
        },
        "values": {
            "2": {
                "4000": "4000"
            }
        }
    },
    "defaultValue": 4000
}

Set Up the Type of Worktop

Parameter	Type	Possible values
`worktopType`	string	custom or precut

"worktopType": {
    "typeID": 4,
    "values": [
        "custom"
    ],
    "editable": null,
    "translation": {
        "name": {
            "2": "worktopType"
        },
        "values": {
            "2": {
                "custom": "custom"
            }
        }
    },
    "defaultValue": "custom"
}

Set Up the Waterfall

Parameter	Type	Possible values
`waterfallPossible`	boolean	true or false
`waterfallType`	string	angled or straight
`waterfallJointProduct`	product	external dbID

"waterfallPossible": {
    "typeID": 3,
    "editable": null,
    "translation": {
        "name": {
            "2": "waterfallPossible"
        }
    },
    "defaultValue": 0
}

Set Up the Joint between two Worktops

Parameter	Type	Possible values
`cornerJointPossible`	boolean	true or false
`cornerHandedJointPossible`	boolean	true or false
`notchOffset`	real	[0 ;∞]

"cornerJointPossible": {
    "typeID": 3,
    "editable": null,
    "translation": {
        "name": {
            "2": "cornerJointPossible"
        }
    },
    "defaultValue": 1
}
	
"cornerHandedJointPossible": {
		"typeID": 3,
		"editable": null,
		"translation": {
			"name": {
				"2": "cornerHandedJointPossible"
			}
		},
		"defaultValue": 1
	}
	
"notchOffset": {
		"typeID": 1,
		"editable": null,
		"translation": {
			"name": {
				"2": "notchOffset"
			}
		},
		"defaultValue": 20
	}

Enable an Arc Operation

Parameter	Type	Possible values
`arcOperationPossible`	boolean	true or false

"arcOperationPossible": {
    "typeID": 3,
    "editable": null,
    "translation": {
        "name": {
            "2": "arcOperationPossible"
        }
    },
    "defaultValue": 0
}

Set Up the Number of Rounded Cuts Allowed

Parameter	Type	Possible values
`roundedCutAllowedNumber`	integer	0 / ... / Infinite

"roundedCutAllowedNumber": {
    "typeID": 4,
    "values": [
        1
        2
        4
    ],
    "editable": null,
    "translation": {
        "name": {
            "2": "roundedCutAllowedNumber"
        },
        "values": {
            "2": {
                "1": "1"
                "2": "2"
                "3": "4"
            }
        }
    },
    "defaultValue": 1
}

Filtering Parameters

You can create the parameter of your choice to be used by the customer to filter the list of worktops in the edit panel. Below are two possible filtering parameters.

Filter Worktops with Material

Parameter	Type	Possible values
`worktopMaterial`	string	acrylic / laminate / quartz / wood

"worktopMaterial": {
    "typeID": 4,
    "values": [
        "acrylic"
    ],
    "editable": null,
    "translation": {
        "name": {
            "2": "worktopMaterial"
        },
        "values": {
            "2": {
                "laminate": "acrylic"
            }
        }
    },
    "defaultValue": "acrylic"
}

⚠️The MinDistanceTapHoleAndSink 🔗 and MinDistanceTapHoleAndWTBackEdge 🔗 Applicative Rules are based on the worktopMaterial parameter (value: quartz) and make this parameter mandatory on the worktop product. In this case, worktopMaterial is not limited to a filtering usage.

Filter Worktops with Thickness

Parameter	Type	Possible values
`worktopThickness`	string	[0 ;∞]

"worktopThickness": {
    "typeID": 1,
    "values": [
        38
    ],
    "editable": null,
    "translation": {
        "name": {
            "2": "worktopThickness"
        },
        "values": {
            "2": {
                "38": "38"
            }
        }
    },
    "defaultValue": 38
}

Reversible Worktops

The `side` parameter

Parameter	Type	Possible values	Default value
`side`	Discrete variation	-1 / 1	1

First, add the side parameter.

"side": {
    "typeID": 2,
    "editable": null,
    "translation": {
        "name": {
            "2": "doubleSided"
        }
    },
    "defaultValue": 0
}

Defines the materials for each side

Then, define the materials for each side of the worktop:

Parameter	Type	Possible values
`topMaterial`	Material	External dbID
`bottomMaterial`	Material	External dbID

"topMaterial": {
    "ids": [
        "11"
    ],
    "tags": [],
    "typeID": 6,
    "editable": null,
    "nullable": false,
    "translation": {
        "name": {
            "2": "material"
        }
    },
    "defaultValue": "11"
},

Double-sided option

The `doubleSided` and `doubleSidedWaterfall` parameters

Parameter	Type	Possible values	Default value
`doubleSided`	boolean	TRUE / FALSE	FALSE
`doubleSidedWaterfall`	boolean	TRUE / FALSE	FALSE

"doubleSided": {
    "typeID": 3,
    "editable": null,
    "translation": {
        "name": {
            "2": "doubleSided"
        }
    },
    "defaultValue": 0
},
"doubleSidedWaterfall": {
    "typeID": 3,
    "editable": null,
    "translation": {
        "name": {
            "2": "doubleSidedWaterfall"
        }
    },
    "defaultValue": 1
}

The `doubleSidedProduct` parameter

Parameter	Type	Possible values
`doubleSideProduct`	Product	External dbID

📌 doubleSidedProduct must be defined on all the available worktop board products, not the worktop generic product.

"doubleSideProduct": {
    "ids": [
        "50",
        null
    ],
    "tags": [],
    "typeID": 7,
    "editable": null,
    "nullable": true,
    "translation": {
        "name": {
            "2": "doubleSideProduct"
        }
    },
    "defaultValue": ""
},

Set Up Edge Compatibility

Parameter	Type	Possible values
`edgeCompatibility`	product	External dbID

⚠️ This parameter cannot be nullable because of its dependency with applicative rules.

"edgeCompatibility": {
    "ids": [
        "14180",
        "14179"
    ],
    "tags": [],
    "typeID": 7,
    "editable": null,
    "nullable": false,
    "translation": {
        "name": {
            "2": "edgeCompatibility"
        }
    },
    "defaultValue": "14179"
},

Set Up Default Edge Finish Products

Parameter	Type	Possible values
`adjacentEdgeFinish`	product	External dbID
`backEdgeFinish`	product	External dbID
`frontEdgeFinish`	product	External dbID
`nonVisibleEdgeFinish`	product	External dbID

"adjacentEdgeFinish": {
    "ids": [
        "14180",
        "14179"
    ],
    "tags": [],
    "typeID": 7,
    "editable": null,
    "nullable": true,
    "translation": {
        "name": {
            "2": "adjacentEdgeFinish"
        }
    },
    "defaultValue": "14179"
},
"backEdgeFinish": {
    "ids": [
        "14180",
        "14179"
    ],
    "tags": [],
    "typeID": 7,
    "editable": null,
    "nullable": true,
    "translation": {
        "name": {
            "2": "backEdgeFinish"
        }
    },
    "defaultValue": "14179"
},
"frontEdgeFinish": {
    "ids": [
        "14180",
        "14179"
    ],
    "tags": [],
    "typeID": 7,
    "editable": null,
    "nullable": true,
    "translation": {
        "name": {
            "2": "frontEdgeFinish"
        }
    },
    "defaultValue": "14179"
},
"nonVisibleEdgeFinish": {
    "ids": [
        "14180",
        "14179"
    ],
    "tags": [],
    "typeID": 7,
    "editable": null,
    "nullable": true,
    "translation": {
        "name": {
            "2": "nonVisibleEdgeFinish"
        }
    },
    "defaultValue": "14179"
},

Set Up Operation Compatibility

Parameter	Type	Possible values
`operationCompatibility`	product	External dbID

"operationCompatibility": {
    "ids": [
        "21",
        "19",
        "13",
        "20",
        "18",
        null
    ],
    "tags": [],
    "typeID": 7,
    "editable": null,
    "nullable": true,
    "translation": {
        "name": {
            "2": " operationCompatibility "
        }
    },
    "defaultValue": ""
},

Set Up Polished Underside

Parameter	Type	Possible values
`polishedUnderside`	product	External dbID

"polishedUnderside": {
    "ids": [
        "1234"
    ],
    "tags": [],
    "typeID": 7,
    "editable": null,
    "nullable": true,
    "translation": {
        "name": {
            "2": " polishedUnderside "
        }
    },
    "defaultValue": "1234"
},

Pricing

For "custom" worktops, the pricing method is "per linear meter" and thus, the following value is required:


{"pricingMethod":"linearMeter"}

Price Sample

(additional information is not mandatory)

"prices": [
			{
				"typePrice": "regular",
				"price": 100,
				"startDate": null,
				"endDate": null,
				"currency": "EUR",
				"additionalInformations": {
					"pricingMethod": "linearMeter"
				}
			}
		]

Deploy

To definitely activate the worktop option on a cabinet, the worktopOption parameter must set to 'true' at top-assembly level.

Parameter	Type	Default value
`worktopOption`	boolean	true

"worktopOption": {
			"typeID": 3,
			"editable": null,
			"translation": {
				"name": {
					"2": "worktopOption"
				}
			},
			"defaultValue": 0
		}

Set Up the Dimensions​

Set Up the Type of Worktop​

Set Up the Waterfall​

Set Up the Joint between two Worktops​

Enable an Arc Operation​

Set Up the Number of Rounded Cuts Allowed​

Filtering Parameters​

Filter Worktops with Material​

Filter Worktops with Thickness​

Reversible Worktops​

The side parameter​

Defines the materials for each side​

Double-sided option​

The doubleSided and doubleSidedWaterfall parameters​

The doubleSidedProduct parameter​

Set Up Edge Compatibility​

Set Up Default Edge Finish Products​

Set Up Operation Compatibility​

Set Up Polished Underside​

Pricing​

Price Sample​

Deploy​