Products (PIM)

Product Information Manager

Add a product in its transiteo catalog

POST https://api.transiteo.io/v1/customer/products

This endpoint allows you to add a product in your catalog. And thanks to product SKU you could calculate duties and taxes from & to every countries in the world.

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	"your id_token"

Json Request Format

{
    "type": string,
    "sku": string,
    "value": string,
    "weight": number,
    "weight_unit": string,
    "unit_price": number,
    "currency_unit_price": string,
    "ecoTax_code_pro": string,
    "ecoTax_subCode_pro": string,
    "ecoTax_code_personal": string,
    "ecoTax_price_pro": number,
    "ecoTax_price_personal": number,
    "ecoTax_price_default_pro": number,
    "ecoTax_price_default_personal": number,
    "ecoTax_default": string,
    "co2_product_kg": number,
    "un_code": [string],
    "origin_country": string,
    "to_district": string,
    "to_country": string,
    "hscodefinder_hs_code": string,
    "quantity": number,
    "sale_unit_price": number,
    "sale_currency_unit_price": string,
    "purchase_unit_price": number,
    "purchase_currency_unit_price": string
}

Request fields & values

"type"

You need to fill with "SKU" Type : string Required : yes

"sku"

You need to fill this field with the sku (Stock Keeping Unit) of your product. Examples : "9754628", "dress" or "ARZ2-987H" Type : string Required : yes

"value"

You need to fill this field with the title of your product. Examples : "Playstation 5", "Thon blanc germon au naturel 200g" or "Louis Vitton bagpack" Type : string Required : yes

"weight"

You need to fill the "weight" field of the product with a number. Examples : 12 or 3.5 Type : number Required : yes.

"products" / "weight_unit"

You can fill the "weight_unit" field with one of this two labels : - "kg" : if you use the international metric system - "lbs" : if you use the imperial system Type : string Required : yes.

"unit_price"

You need to fill the "unit_price" field with a number representing the price of one item. Examples : 39 or 99.90 Type : number Required : yes.

"currency_unit_price"

You need to fill the "currency_unit_price" field of the product with a currency iso Alpha 3. Download the list of currencies with them name and code. Examples : "EUR" or "CAD" Type : string Required : yes

"origin_country"

You need to fill this field with the iso Alpha 2 or 3 of the product origin country. Download the list of countries. Examples : CHN Type : string Required : No

"to_district"

You need to fill thsi field with the iso code of the district of the product's arrival district. Download the list of districts. Examples : FR-IDF Type : string Required : No

"to_country"

You need to fill the "to_country" field with the Iso Alpha 2 or 3 from where the product arrives. Download the list of countries. Examples : "Brazil" or "GLP" Type : string Required : yes if hscodefinder_hs_code is filled.

"hscodefinder_hs_code"

You need to fill this field with a HS Code. Between 8 to 13 digits numbers. Examples : 9503006100 Type : string Required : No

"quantity"

You need to fill this field with the quantity of this product in your stock. Examples : 10 or 28 Type : string Required : No

"sale_unit_price"

You need to fill this field with your sale price Examples : 23.76 or 11 Type : string Required : No

"sale_currency_unit_price"

You need to fill this field with the currency of your sale price. Examples : USD Type : string Required : No

"purchase_unit_price"

You need to fill this field with your purchase price. Examples : 23.76 or 11 Type : string Required : No

"purchase_currency_unit_price"

You need to fill this field with the currency of your purchase price. Examples : USD Type : string Required : No

JSON Examples - Request & Response

It exist many possibilities. Please book a call with our support team.

Video explainer

in progress...

Update a product in its catalog

PUT https://api.transiteo.io/v1/customer/products/{sku}

This endpoint allows you tu update a product in its catalog

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	"your id_token"

200

Get product informations

GET https://api.transiteo.io/v1/customer/products/{sku}

This endpoint allows you to get informations of specific product

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	"your id_token"

200

Get all products in its catalog

GET https://api.transiteo.io/v1/customer/products

This endpoint allows you to get a list of all product in its catalog

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	"your id_token"

200

Delete a product in its catalog

DELETE https://api.transiteo.io/v1/customer/products/{sku}

This endpoint allows to delete a specific product inn its catalog

Headers

Name	Type	Description
Content-type	string	application/json
Authorization	string	"your id_token"

200