Merchant API Code Reference

Error Code

Success

Code Description
000000 Success

System Error

Code Description
100001 Unknown server error
100002 Problem parsing JSON

General Error

Code Description
200001 Validation failed
200002 HTTP not found
200003 System down for maintenance
200004 Access not granted, probability access token not valid
200005 Access denied
200006 System down for maintenance
200007 Exceeding rate limit of Merchant API

Product

Code Description
201001 Product not found
201002 Failed creating product
201003 Failed updating product
201004 Failed deleting product
201005 Can not update product status because product inventory hasn’t been created yet
201006 Product creation will exceed your product limit on PRIMO. You might contact with us at yo@primo.im to increase the limit

Product Image

Code Description
201101 Product image not found
201102 Failed uploading product image
201103 Failed creating product image
201104 Failed updating product image
201105 Failed deleting product image
201106 Maximum 10 images allowed
201107 Select other image as default to unset this one

Product Inventory

Code Description
201201 Product inventory not found
201202 Failed creating product inventory
201203 Failed updating product inventory
201204 Failed deleting product inventory
201205 Maximum 20 inventory combinations for each product allowed
201206 Variant type mismatch with product detail variant type value
201207 Size and color combination already exist on Inventory
201208 Basic inventory for this product has already been created. Please update that inventory
201209 Custom inventory for this product has already been created. Please update existing inventory.
201210 Delete only works for inventory with variant_type = 1

Product Discount

Code Description
2010301 Product discount not found
2010302 Failed creating product discount
2010303 Failed updating product discount
2010304 Failed deleting product discount
2010305 Maximum 5 discounts per product allowed

Merchant

Code Description
202001 Merchant not found

Code Reference

Product Category Code

Code Description
1 Fashion
2 Food
3 Outdoor
4 Health and Diet
5 Beauty
6 Electronics
7 Interior/Furniture
8 Garden
9 Everyday Goods
10 DIY
11 Pets
12 Instruments/Hobbies
13 Toys/Games
14 Kids
15 Sports
16 Vehicles
17 Video/Music/Software/Tickets
18 Print Media
19 Utilities
20 Credit Cards
21 Jobs
22 Financial
23 Real Estate
24 Cable/Broadband/Satellite etc
25 Used
26 Service/Event/Seminar etc
99 Others

Inventory Color Search Index

Code Color Description
1 #FF0000 Red
2 #00FF00 Cyan
3 #0000FF Blue
4 #0000A0 Dark Blue
5 #ADD8E6 Light Blue
6 #800080 Purple
7 #FFFF00 Yellow
8 #FF00FF Magenta
9 #FFFFFF White
10 #C0C0C0 Silver
11 #808080 Gray
12 #000000 Black
13 #FFA500 Orange
14 #A52A2A Brown
15 #800000 Maroon
16 #008000 Green
17 #808000 Olive
18 #FFC0CB Pink
19 #EE82EE Violet
20 #F5F5DC Beige
21 #00BFFF Sky Blue

API Formula

Price Rule

PRIMO supports several currencies for product prices based on the country of the merchant. The default currency will be USD if your country is not listed.

There is a minimum price for products depending on your currency. However you have the option to set the product as $0 (free) as well.

Please refer this list for minimum product price.

Code Currency Minimum Price
1 USD: United States Dollar $0.50
2 JPY: Japanese Yen ¥50
3 CNY: Chinese Yen Coming soon
4 GBP: British Pound £0.30
5 EUR: EURO €0.50
6 AUD: Australian Dollar $0.50
7 CAD: Canadian Dollar $0.50
8 HKD: Hong Kong Dollar $4.00