(CN) Product API Integrations

(CN) Product API Integrations

Screenshot 2024-08-23 at 12.51.42.png

How do I provide safety information?

Quick Links

For Product API integrations, safety information can be provided at SKU level by including the appropriate attribute name and value in the SKU description when creating or updating a product and SKU.

From 13th December 2024, if we are not able to display your product’s safety information it may be removed from sale


How to provide safety information via API

Providing your safety information via API can be done for existing and new products by creating or updating a product and SKU.

If you integrate via a Partner, and you are not able to use the below attribute names, you must provide safety information via CSV file upload until your Partner provides support.

Attribute Names

The following attribute names are available to provide safety information values:

Safety Warnings CE Mark Ingredients Serial Number Manufacturer Part Number Model Number Batch Number Safety Attestation

Expected Values

Please see below to understand what values are expected for each attribute name.

JSON incompatible values must be escaped. Click here to see an example API request.

Attribute Name

Value

Attribute Name

Value

Safety Warnings

The applicable safety warnings for your SKU. You can provide multiple safety warnings by enclosing the list in square brackets ([]), enclosing the list items in quotation marks (““) and separating list items with a comma (,). For example:

Single safety warning:

Not suitable for children under 36 months

Multiple safety warnings:

["Not suitable for children under 36 months","Choking Hazard","Adult supervision recommended"]

CE Mark

A declaration that your SKU has a CE mark present.

If applicable, please provide the value “1” as this corresponds to the following statement: This SKU has a CE mark present.

1

Any value other than “1” will be ignored. If you provide a value other than “1” and your SKU is an a mandatory category, it may be removed from sale.

Ingredients

A list of ingredients for your SKU, including quantity and unit if applicable. You can provide multiple ingredients by enclosing the list in square brackets ([]), enclosing the list items in quotation marks (““) and separating list items with a comma (,). For example:

Single ingredient:

Octinoxate 6.7%

Multiple ingredients:

["Octinoxate 6.7%","Titanium Dioxide 1.6%","Butylene Glycol","Polymethylsilsesquioxane"]

Serial Number

A unique identifier for your SKU if serial number is applicable.

Optional

Manufacturer Part Number

A unique identifier for your SKU if manufacturer part number is applicable.

Optional

Model Number

A unique identifier for your SKU if model number is applicable.

Optional

Batch Number

A unique identifier for your SKU if batch number is applicable.

Optional

Safety Attestation

An attestation that must be provided when safety information is not required for a SKU in an obligatory category path.

If applicable, please provide the value “1” as this corresponds to the following statement: This SKU does not require safety information.

1

Any value other than “1” will be ignored. If you provide a value other than “1” and your SKU is an a mandatory category, it may be removed from sale.

Example

Please see below for an example:

... "attributes": [ { "name": "Safety Warnings", "value": "[\"Not suitable for children under 36 months\",\"Choking Hazard\",\"Adult supervision recommended\"]" }, { "name": "CE Mark", "value": "1" } ] ...

API Documentation

You can learn more about how to provide your product data via API by clicking the link below.