18/5/23, 9:09 Open Platform

App Console Announcement Documentation  Data Moat  I

Product API 
Latest update 2022-06-16 04:41:03  4012

POST AdjustSellableQuantity
CreateProduct POST /produ

POST CreateProduct
POST /product/create  Authorization Required JAVA PHP

POST DeactivateProduct Description: Use this API to create a single new product which may contain one or more SKUs. Note:
IopClient clie
Before calling this interface, you need to carefully review the API's Best Practices:
IopRequest req
GET GetBrandByPages https://open.miravia.com/apps/doc/doc?nodeId=42633&docId=121142
request.setApi
request.addApi
GET/POST IopResponse re
Service Endpoints System.out.pri
GET GetCategoryTree Thread.sleep(1
Region Endpoint
GET GetProductItems
Spain https://api.miravia.es
GET GetProducts
Response
GET GetQcStatus Common Parameters
{
GET GetResponse Name Type Required or not Description "code": "0",
"data": {
POST MigrateImage Unique app ID issued by Miravia
app_key String Yes Open Platform console when you "item_id":
apply for an app category "sku_list"
POST MigrateImages
{
The time stamp of the request e.g. "shop_
POST ProductPreCheck 1517820392000 (which translates "sku_i
timestamp String Yes to 5 February 2018 08:46:32) with
"selle
POST RemoveProduct less than 7200s difference from
UTC time }
GET/POST RemoveSku ]
access_token String Yes API interface call credentials },
POST SetImage "request_id"
The HMAC hash algorithm you are }
sign_method String Yes
using to calculate your signature
POST UpdatePriceQuantity

Part of the authentication process

POST UpdateProduct that is used for identifying and
sign String Yes
verifying who is sending a request
POST UpdateProductStatus (click here for details)

GET/POST

Parameters
POST UploadImage

Name Type Required or not Description

GET/POST
payload Payload Yes Parameter description
GET/POST

Order API 
Response Parameters
Seller API 
Name Type Description
System API 
 data Object Response body

Fulfillment API 

Feed API  Error Code

Media Center API  Error Code Error Message Solution

Return and Refund API 

1 E001: Parameter %s is mandatory The parameter is mandatory but not specified.

The request format is not valid, need to be json

Finance API 
5 E005: Invalid Request Format format, please note whether the parameter
contains quotation marks and is escaped.
Affiliate API 

6 E006: Unexpected internal error Unexpected internal error.

30 E030: Empty Request Paylod is empty.

The specified category ID is not valid. Field

201 E201: %s Invalid CategoryId 'PrimaryCategory' need to be a numeric category id
instead of category name

202 E202: %s Invalid SPUId The specified SPU ID is not valid.

205 E205: SPU does not exist The specified SPU ID does not exist.

https://open.miravia.com/apps/doc/api?path=%2Fproduct%2Fcreate 1/3
18/5/23, 9:09 Open Platform

Error Code Error Message Solution

App Console Announcement Documentation  Data Moat  I
E206: Different category id in SPU
206 The specified category ID is not consistent.
Product API 
and PrimaryCategory

POST AdjustSellableQuantity 500 E500: Create product failed Failed to create the product.

502 E502: Search SPU failed Failed to search for the specified SPU.
POST CreateProduct

Some behaviors prohibited by platforms are

POST DeactivateProduct E512:
verified，eg: title contains keywords that are
512 BIZ_CHECK_MANGROVE_RULE_Q
prohibited. Please modify the parameters
C
GET GetBrandByPages according to the error message

GET/POST E901: The request is too frequent,

901 or the requested functionality is System busy, please try again later.
temporarily disabled.
GET GetCategoryTree

1000 Internal Application Error Internal system error.

GET GetProductItems
Filed "price" and "special_price" are numeric and the
GET GetProducts BIZ_CHECK_PRICE_PRECISION_IN precision cannot exceed 2 decimal places.And
4104
VALID special_price must be lower than the price if
GET GetQcStatus special_price is filled.

BIZ_CHECK_SELLER_SKU_DUPLIC Different Skus of the same item must have

GET GetResponse 4105
ATE different sellerSku

POST MigrateImage CHK_CATPROP_CPV_INPUT_SIZE

4106 Variation should not exceed 2
_LIMIT
POST MigrateImages
CHECK_CAT_PROP_INVALID_NUM
4107 Numeric category attribute value is not a number
POST ProductPreCheck
BER

Mandatory field is missing. eg: pakage_length、

POST RemoveProduct
4108 CHK_BASIC_REQUIRED pakage_width、package_height、 package_weight
are mandatory, but missing
GET/POST RemoveSku
CHK_SKU_PROPS_NOT_MATCH_S The current category does not allow custom sales
4109
POST SetImage ALE_PROP properties

BIZ_CHECK_CAT_PROP_MANDAT
POST UpdatePriceQuantity 4110 Brand is mandatory.
ORY

POST UpdateProduct CHK_CATPROP_CPV_TEXT_REPE

4111 Category attribute content repeats
AT
POST UpdateProductStatus
Different SKUs of the same item must have
4112 CHK_SKU_PROPS_DUPLICATE
GET/POST different Sales property.

CHK_SKU_PROPS_NOT_IDENTICA Each SKUs of the item needs to have sales

POST UploadImage 4113
L property

GET/POST BIZ_CHECK_PRICE_SAMPLE_NON Special Category "Free Sample" can only be used to

4114
_ZERO publish samples with a price of 0
GET/POST
Categories that do not allow custom sales porperty
Order API  4115 CHK_CATPROP_CPV_NOT_ENUM can only enter the standard values provided by the
system
Seller API 
BIZ_CHECK_MAIN_IMAGE_DUPLI
4116 Cannot use images with the same url
CATE
System API 

BIZ_CHECK_SPECIAL_PRICE_FRO
4117 Special offer date check
Fulfillment API  M_DATE_AFTER_TO_DATE

Feed API The price must be greater than 0 unless category


4118 BIZ_CHECK_PRICE_IS_ZERO
"Free Sample" isused
Media Center API 
BIZ_CHECK_SPECIAL_PRICE_RAT
4119 Special price range check
E_OUT_OF_RANGE
Return and Refund API 

CHK_CATPROP_CPV_MAX_LEGNT
4120 Attribute value of the category over the limit
Finance API  H

Affiliate API BIZ_CHECK_SPECIAL_PRICE_PRE Precision of price and special price cannot exceed

4121
CISION_INVALID 2 decimal places.

BIZ_CHECK_VIRTUAL_BUNDLE_SK
4122 Deprecated
U_SUB_OVER_LIMIT

Some behaviors prohibited by platforms are

verified，eg: title contains keywords that are
4123 BIZ_CHECK_MANGROVE_RULE
prohibited. Please modify the parameters
according to the error message

4124 BIZ_CHECK_MANGROVE_RULE_Q Some behaviors prohibited by platforms are

verified，eg: title contains keywords that are

https://open.miravia.com/apps/doc/api?path=%2Fproduct%2Fcreate 2/3
18/5/23, 9:09 Open Platform

Error Code Error Message Solution

App Console Announcement Documentation  Data Moat  I
C prohibited. Please modify the parameters
Product API  according to the error message

THD_IC_F_IC_DOMAIN_PROPERT
POST AdjustSellableQuantity 4125 System internal error
Y_002

POST CreateProduct THD_IC_F_IC_INFRA_PRODUCT_0 Different Skus of the same item must have
4126
36 different sellerSku
POST DeactivateProduct
THD_IC_F_IC_SCENE_PUBLISH_01
4127 System internal error
2
GET GetBrandByPages

THD_IC_F_IC_DOMAIN_ACTOR_00
GET/POST GetCategoryAttribu 4128 Seller is under punishment of blocking edit
6

GET GetCategoryTree BIZ_CHECK_PROP_SPECIAL_CHA Sales property value contains symbol/character

4129
R that is not allowed: "" ". Delete then reload
GET GetProductItems
The brand is not authorized, please go to the
BIZ_CHECK_OFFICIAL_STORE_BR following link to apply for authorization.
GET GetProducts 4130
AND_UNAUTHORIZED https://sellercenter.miravia.es/apps/setting/brand/
application
GET GetQcStatus
BIZ_CHECK_CAT_PROP_SENSITIV
4131 Description has sensitive words
GET GetResponse E_WORDS

POST MigrateImage The request format is not valid, need to be json

4132 Invalid Request Format format, please note whether the parameter
contains quotation marks and is escaped.
POST MigrateImages

4133 Invalid variation Invalid variation

POST ProductPreCheck
Please select the last level
4134 Only leaf category can be used to publish product
POST RemoveProduct category.

GET/POST RemoveSku
THD_IC_ERR_F_DOMAIN_IMAGE_ Please use the sales attributes defined in the
4192
00_01_003 variant field

POST SetImage
You are not allow to use “Delivered
4162 You are not allow to use “Delivered by seller”.
by seller”.
POST UpdatePriceQuantity

POST UpdateProduct
API Testing Tool SDK Download

POST UpdateProductStatus
Please rate this article     
GET/POST UpdateSellableQua

POST UploadImage

GET/POST searchBrandByNam

GET/POST searchCategoryByK

Order API 

Seller API 

System API 

Fulfillment API 

Feed API 

Media Center API 

Return and Refund API 

Finance API 

Affiliate API 

https://open.miravia.com/apps/doc/api?path=%2Fproduct%2Fcreate 3/3