/erp/sc/routing/storage/product/set{
"operation": {
"method": "POST",
"path": "/erp/sc/routing/storage/product/set"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 10,
"text": ""
},
"requestExample": {
"sku": "SKU2986DFA",
"product_name": "钢化玻璃膜2",
"picture_list": [
{
"pic_url": "https://xxxx.com/123.jpg",
"is_primary": 1
}
],
"unit": "个",
"category_id": 2,
"category": "分类5",
"model": "",
"brand_id": 0,
"brand": "",
"status": 0,
"description": "",
"group_list": [
{
"sku": "CWZS20A-L",
"quantity": 1
}
],
"cg_opt_uid": 0,
"cg_opt_username": "",
"product_developer_uid": 0,
"product_developer": "",
"purchase_remark": "",
"cg_price": "",
"is_related": 0,
"cg_delivery": 0,
"cg_product_material": "",
"cg_product_length": "",
"cg_product_width": "",
"cg_product_height": "",
"cg_product_net_weight": "",
"cg_product_gross_weight": "",
"cg_package_length": "",
"cg_package_width": "",
"cg_package_height": "",
"cg_box_length": "",
"cg_box_width": "",
"cg_box_height": "",
"cg_box_weight": "",
"cg_box_pcs": 0,
"bg_customs_export_name": "",
"bg_export_hs_code": "",
"bg_customs_import_name": "",
"currency": "CNY",
"bg_customs_import_price": "",
"product_creator_uid": 0,
"product_duty_uids": [],
"is_append_product_duty": 0,
"qc_standard": {
"custom_qc_template": {
"qc_image": [
{
"file_id": "",
"customer_url": ""
}
]
}
},
"product_logistics_list": {
"US_cg_transport_costs": 0,
"US_currency": "",
"US_clearance_price": 0,
"US_clearance_price_currency": "",
"US_bg_import_hs_code": "",
"US_bg_tax_rate": 0,
"US_clearance_remark": ""
},
"supplier_quote": [
{
"erp_supplier_id": 1,
"supplier_id": 0,
"supplier_product_url": [],
"quote_remark": "",
"is_primary": 1,
"quotes": [
{
"currency": "CNY",
"is_tax": 0,
"tax_rate": 0,
"step_prices": [
{
"moq": 0,
"price_with_tax": 10
}
]
}
]
}
],
"special_attr": [
1,
2,
3
],
"declaration": {
"customs_declaration_unit": "",
"customs_declaration_spec": "",
"customs_declaration_origin_produce": "",
"customs_declaration_inlands_source": "",
"customs_declaration_exempt": ""
},
"clearance": {
"customs_clearance_material": "",
"customs_clearance_usage": "",
"customs_clearance_internal_code": "",
"customs_clearance_preferential": 0,
"customs_clearance_brand_type": 0,
"customs_clearance_product_pattern": "",
"allocation_remark": "",
"weaving_mode": 0,
"customs_clearance_pic_url": ""
},
"aux_relation_list": [
{
"aux_sku": "AUX-GLUE-01",
"sku_qty": 1,
"aux_qty": 2
}
],
"spec_pack_list": [
{
"spec_title": "小箱包装",
"cg_box_pcs": 50,
"cg_box_length": "25.0",
"cg_box_width": "15.0",
"cg_box_height": "10.0",
"cg_package_length": "12.0",
"cg_package_width": "6.0",
"cg_package_height": "1.0",
"cg_box_weight": "6.0",
"cg_product_gross_weight": "25.0"
}
],
"api_spu": "SPU001",
"api_spu_attribute": [
{
"pa_id": 1,
"pai_id": 101
}
],
"custom_fields": [
{
"id": "207663076879646721",
"val": "测试ceshi",
"character": ""
}
]
},
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "CCF38623-DE1A-004F-0961-90A6AF265013",
"response_time": "2021-11-11 11:14:33",
"data": {
"product_id": 1010,
"sku": "SKU2986DFA1",
"sku_identifier": "SKU2986DFA1"
},
"total": 0
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | sku | sku | string | — | Required | SKU |
| 2 | product_name | 品名【添加时必填】 | string | — | Required | 品名【添加时必填】 |
| 3 | sku_identifier | SKU识别码 | string | — | Optional | SKU识别码 |
| 4 | picture_list | 产品图片信息 | array<object> | — | Optional | 产品图片信息 |
| 4.1 | pic_url | 产品图片链接 | string | — | Optional | 产品图片链接 |
| 4.2 | is_primary | 是否产品主图 | integer | — | Optional | 是否产品主图:0 否,1 是 |
| 5 | unit_process_fee | 单位加工费 | integer | — | Optional | 单位加工费 |
| 6 | unit | 单位(商品单位 | string | — | Optional | 单位(商品单位:套、个、台) |
| 7 | category_id | 分类id | integer | — | Optional | 分类id,与分类同时存在时,优先取分类id |
| 8 | category | 分类 | string | — | Optional | 分类 |
| 9 | model | 型号 | string | — | Optional | 型号 |
| 10 | brand_id | 品牌id | integer | — | Optional | 品牌id,与品牌同时存在时,优先取品牌id |
| 11 | brand | 品牌 | string | — | Optional | 品牌 |
| 12 | open_status | 开启状态 | integer | — | Optional | 开启状态:0 停用,1 启用 |
| 13 | status | 状态【默认1】 | integer | — | Optional | 状态【默认1】:0 停售,1 在售,2 开发中,3 清仓 |
| 14 | description | 商品描述 | string | — | Optional | 商品描述 |
| 15 | group_list | 组合商品列表 | array<object> | — | Optional | 组合商品列表 |
| 15.1 | sku | 子商品 | string | — | Optional | 子商品 |
| 15.2 | quantity | 商品比例数 | integer | — | Optional | 商品比例数 |
| 16 | cg_opt_uid | 采购 | integer | — | Optional | 采购:采购员id,与采购员名同时填写时,以采购员id为准 |
| 17 | cg_opt_username | 采购 | string | — | Optional | 采购:采购员名 |
| 18 | product_developer_uid | 开发者id | integer | — | Optional | 开发者id,与开发者名称同时填写时,以开发者id为准 |
| 19 | product_developer | 开发者名称 | string | — | Optional | 开发者名称 |
| 20 | product_creator_uid | 创建人id | integer | — | Optional | 创建人id,默认API账号id |
| 21 | product_duty_uids | 负责人id | array<any> | — | Optional | 负责人id |
| 22 | is_append_product_duty | 负责人是否追加创建人 | integer | — | Optional | 负责人是否追加创建人:0 否,1 是;默认1,只有编辑SKU时才生效 |
| 23 | purchase_remark | 采购备注 | string | — | Optional | 采购备注 |
| 24 | cg_price | 采购 | string | — | Optional | 采购:采购成本(RMB) |
| 25 | is_related | 是否关联单品成本 | integer | — | Optional | 是否关联单品成本:0 否,1 是 |
| 26 | cg_delivery | 采购 | integer | — | Optional | 采购:采购交期 |
| 27 | cg_product_material | 采购 | string | — | Optional | 采购:商品材质 |
| 28 | cg_product_length | 采购 | string | — | Optional | 采购:单品规格-长(CM) |
| 29 | cg_product_width | 采购 | string | — | Optional | 采购:单品规格-宽(CM) |
| 30 | cg_product_height | 采购 | string | — | Optional | 采购:单品规格-高(CM) |
| 31 | cg_product_net_weight | 采购 | string | — | Optional | 采购:单品净重(G) |
| 32 | cg_product_gross_weight | 采购 | string | — | Optional | 采购:单品毛重(G) |
| 33 | cg_package_length | 采购 | string | — | Optional | 采购:包装规格-长(CM) |
| 34 | cg_package_width | 采购 | string | — | Optional | 采购:包装规格-宽(CM) |
| 35 | cg_package_height | 采购 | string | — | Optional | 采购:包装规格-高(CM) |
| 36 | cg_box_length | 采购 | string | — | Optional | 采购:外箱规格-长(CM) |
| 37 | cg_box_width | 采购 | string | — | Optional | 采购:外箱规格-宽(CM) |
| 38 | cg_box_height | 采购 | string | — | Optional | 采购:外箱规格-高(CM) |
| 39 | cg_box_weight | 采购 | string | — | Optional | 采购:单箱重量(KG) |
| 40 | cg_box_pcs | 采购 | integer | — | Optional | 采购:单箱数量(包装数量) |
| 41 | bg_customs_export_name | 报关 | string | — | Optional | 报关:申报品名(中文) |
| 42 | bg_export_hs_code | 报关 | string | — | Optional | 报关:HS Code(中国) |
| 43 | bg_customs_import_name | 报关 | string | — | Optional | 报关:申报品名(英文) |
| 44 | currency | 报关 | string | — | Optional | 报关:申报金额的币种 |
| 45 | bg_customs_import_price | 报关 | string | — | Optional | 报关:申报金额 |
| 46 | qc_standard | 质检标准 | object | — | Optional | 质检标准 |
| 46.1 | custom_qc_template | 自定义质检标准 | object | — | Optional | 自定义质检标准 |
| 46.1.1 | qc_image | 质检图片【最多十张图】 | array<object> | — | Optional | 质检图片【最多十张图】 |
| 46.1.1.1 | file_id | 质检图片文件id | string | — | Optional | 质检图片文件id |
| 46.1.1.2 | customer_url | 客户的质检图片URL | string | — | Optional | 客户的质检图片URL |
| 47 | new_qc_standard | 新质检标准 | object | — | Optional | 新质检标准;可选,可与旧qc_standard同时传入 |
| 47.1 | qc_method | 质检方式 | integer | — | Required | 质检方式:1抽检,2全检,3免检;编辑不传则保留,新增不传默认1 |
| 47.2 | pqt_id | 系统质检模板ID | string | — | Optional | 系统质检模板ID;只关联已有模板 |
| 47.3 | custom_qc_template | 自定义质检标准 | object | — | Required | 自定义质检标准 |
| 47.3.1 | template_item | 自定义质检项完整列表 | array<object> | — | Required | 自定义质检项完整列表,最多30项;编辑时未回传的原质检项会删除 |
| 47.3.1.1 | pqti_id | 自定义质检项ID | string | — | Optional | 自定义质检项ID;编辑已有项时传入,新增项传空字符串或不传 |
| 47.3.1.2 | qc_item | 质检项名称 | string | — | Required | 质检项名称,最多100个字符 |
| 47.3.1.3 | sort | 排序 | integer | — | Optional | 排序,取值0至255 |
| 47.3.1.4 | qc_content | 质检内容 | object | — | Required | 质检内容,非空字符串数组,可包含HTML |
| 48 | product_logistics_list | 报关清关费用信息 | object | — | Optional | 报关清关费用信息 支持国家:US、CA、MX、JP、UK、DE、FR、ES、IT、NL、AU、SG、IN、AE、SA、BR、SE、PL、BE、TR、UA、HU、PK、LB、AT、CH、CZ、DK、IE、LU、NO、PT、SK、RU、KZ、BY、CL、KR |
| 48.1 | US_cg_transport_costs | 默认头程费用(含税) | string | — | Optional | 默认头程费用(含税) |
| 48.2 | US_currency | 默认头程费用币种 | string | — | Optional | 默认头程费用币种 |
| 48.3 | US_clearance_price | 清关价格 | string | — | Optional | 清关价格 |
| 48.4 | US_clearance_price_currency | 清关价格币种 | string | — | Optional | 清关价格币种,默认CNY |
| 48.5 | US_bg_import_hs_code | HS Code | string | — | Optional | HS Code |
| 48.6 | US_bg_tax_rate | 税率 | string | — | Optional | 税率 |
| 48.7 | US_clearance_remark | 备注 | string | — | Optional | 备注 |
| 49 | supplier_quote | supplier_quote | array<object> | — | Optional | 供应商报价信息(该参数传空值则清空产品供应商报价) |
| 49.1 | erp_supplier_id | 领星ERP供应商id | integer | — | Required | 领星ERP供应商id,查询本地产品详情接口对应字段【supplier_id】,与supplier_id必填其一 |
| 49.2 | supplier_id | 客户系统供应商id | integer | — | Optional | 客户系统供应商id,没有填这个值或者对应供应商不存在,则取erp_supplier_id,与erp_supplier_id必填其一 |
| 49.3 | supplier_product_url | 采购链接 | array<any> | — | Optional | 采购链接,字符串数组,最多20个,没有则传空数组 |
| 49.4 | quote_remark | 报价备注 | string | — | Optional | 报价备注 |
| 49.5 | quote_cg_delivery | 供应商交期 | integer | — | Optional | 供应商交期 |
| 49.6 | is_primary | 首选供应商 | integer | — | Required | 首选供应商:0 否,1 是 |
| 49.7 | quotes | 报价信息 | array<object> | — | Required | 报价信息,传供应商报价时必传 |
| 49.7.1 | currency | 报价币种 | string | — | Required | 报价币种,目前只有CNY和USD |
| 49.7.2 | is_tax | 是否含税 | integer | — | Required | 是否含税:0 否,1 是 |
| 49.7.3 | tax_rate | 税率 | string | — | Required | 税率,为空则表示为0 |
| 49.7.4 | step_prices | 阶梯价信息 | array<object> | — | Required | 阶梯价信息 |
| 49.7.4.1 | moq | 最小起订量 | integer | — | Required | 最小起订量,最小值为1 |
| 49.7.4.2 | price_with_tax | 含税单价 | string | — | Required | 含税单价,4位小数 |
| 50 | special_attr | 产品特殊属性 | array<any> | — | Optional | 产品特殊属性:1 含电,2 纯电,3 液体,4 粉末,5 膏体,6 带磁,7 纺织品,8普货(普货于其他选项互斥) |
| 51 | declaration | 报关数据 | object | — | Optional | 报关数据 |
| 51.1 | customs_import_price | 报关 | integer | — | Optional | 报关:报关单价 |
| 51.2 | customs_import_price_currency | 报关 | string | — | Optional | 报关:报关单价币种 |
| 51.3 | customs_export_name | 报关 | string | — | Optional | 报关:中文报关名 |
| 51.4 | customs_import_name | 报关 | string | — | Optional | 报关:英文报关名 |
| 51.5 | customs_declaration_unit | 报关 | string | — | Optional | 报关:报关单位 |
| 51.6 | customs_declaration_spec | 报关 | string | — | Optional | 报关:规格型号 |
| 51.7 | customs_declaration_origin_produce | 报关 | string | — | Optional | 报关:原厂国(地区) |
| 51.8 | customs_declaration_inlands_source | 报关 | string | — | Optional | 报关:境内货源地 |
| 51.9 | customs_declaration_hs_code | 报关 | string | — | Optional | 报关:报关HSCODE |
| 51.10 | other_declare_element | 报关 | string | — | Optional | 报关:其他申报要素 |
| 51.11 | customs_declaration_exempt | 报关 | string | — | Optional | 报关:征免 |
| 51.12 | production_and_sales_enterprise_name | 报关 | string | — | Optional | 报关:生产销售企业名称 |
| 51.13 | production_and_sales_enterprise_code | 报关 | string | — | Optional | 报关:生产销售企业代码 |
| 51.14 | customs_declaration_first_unit | 报关 | string | — | Optional | 报关:第一法定单位 |
| 51.15 | customs_declaration_first_unit_rate | 报关 | number | — | Optional | 报关:第一法定单位转换率 |
| 51.16 | customs_declaration_second_unit | 报关 | string | — | Optional | 报关:第二法定单位 |
| 51.17 | customs_declaration_second_unit_rate | 报关 | number | — | Optional | 报关:第二法定单位转换率 |
| 51.18 | customs_declaration_extra_quarantine_code | 报关 | string | — | Optional | 报关:附加检疫码 |
| 52 | clearance | 清关数据 | object | — | Optional | 清关数据 |
| 52.1 | customs_clearance_material | 清关 | string | — | Optional | 清关:中文材质 |
| 52.2 | customs_clearance_en_material | 清关 | string | — | Optional | 清关:英文材质 |
| 52.3 | customs_clearance_usage | 清关 | string | — | Optional | 清关:中文用途 |
| 52.4 | customs_clearance_en_usage | 清关 | string | — | Optional | 清关:英文用途 |
| 52.5 | customs_clearance_internal_code | 清关 | string | — | Optional | 清关:内部编码 |
| 52.6 | customs_clearance_preferential | 清关 | integer | — | Optional | 清关:出口享惠情况:1 不享惠,2 享惠,3 不确定享惠情况 |
| 52.7 | customs_clearance_brand_type | 清关 | integer | — | Optional | 清关:品牌类型:1 无品牌,2 境内自主品牌,3 境内收购品牌,4 境外品牌(贴牌生产),5 境外品牌(其他) |
| 52.8 | customs_clearance_product_pattern | 清关 | string | — | Optional | 清关:产品型号 |
| 52.9 | allocation_remark | 清关 | string | — | Optional | 清关:配货备注 |
| 52.10 | weaving_mode | 织造方式 | integer | — | Optional | 织造方式:1 针织,2 梭织 |
| 52.11 | customs_clearance_pic_url | 清关 | string | — | Optional | 清关:清关图片 |
| 52.12 | customs_clearance_price | 默认清关单价 | number | — | Optional | 默认清关单价 |
| 52.13 | customs_clearance_price_currency | 默认清关单价币种 | string | — | Optional | 默认清关单价币种 |
| 52.14 | customs_clearance_hs_code | 默认清关HSCODE | string | — | Optional | 默认清关HSCODE |
| 52.15 | customs_clearance_tax_rate | 默认清关税率 | string | — | Optional | 默认清关税率 |
| 52.16 | customs_clearance_remark | 默认清关备注 | string | — | Optional | 默认清关备注 |
| 53 | aux_relation_list | 辅料列表 | array<object> | — | Optional | 辅料列表 |
| 53.1 | aux_sku | 辅料sku | string | — | Required | 辅料sku |
| 53.2 | sku_qty | 辅料比例(主料) | integer | — | Optional | 辅料比例(主料) |
| 53.3 | aux_qty | 辅料比例(辅料) | integer | — | Optional | 辅料比例(辅料) |
| 54 | spec_pack_list | 采购 | array<object> | — | Optional | 采购:更多箱规(非默认箱规) |
| 54.1 | spec_title | 采购 | string | — | Required | 采购:更多箱规-箱规名称 |
| 54.2 | cg_box_pcs | 采购 | integer | — | Optional | 采购:更多箱规-单箱数量 |
| 54.3 | cg_box_length | 采购 | string | — | Optional | 采购:更多箱规-外箱规格-长(CM) |
| 54.4 | cg_box_width | 采购 | string | — | Optional | 采购:更多箱规-外箱规格-宽(CM) |
| 54.5 | cg_box_height | 采购 | string | — | Optional | 采购:更多箱规-外箱规格-高(CM) |
| 54.6 | cg_package_length | 采购 | string | — | Optional | 采购:更多箱规-包装规格-长(CM) |
| 54.7 | cg_package_width | 采购 | string | — | Optional | 采购:更多箱规-包装规格-宽(CM) |
| 54.8 | cg_package_height | 采购 | string | — | Optional | 采购:更多箱规-包装规格-高(CM) |
| 54.9 | cg_box_weight | 采购 | string | — | Optional | 采购:更多箱规-单箱重量(KG) |
| 54.10 | cg_product_gross_weight | 采购 | string | — | Optional | 采购:更多箱规-单品毛重(G) |
| 55 | api_spu | SPU(填写时属性列表必填 | string | — | Optional | SPU(填写时属性列表必填,同时填写且为空时取消关联) |
| 56 | api_spu_attribute | 属性列表(填写时spu必填 | array<object> | — | Optional | 属性列表(填写时spu必填,同时填写且为空时取消关联) |
| 56.1 | pa_id | 属性ID | integer | — | Required | 属性ID |
| 56.2 | pai_id | 属性值ID | integer | — | Required | 属性值ID |
| 57 | custom_fields | custom_fields | string | — | Optional | [array] |
| 57.1 | id | id | string | — | Optional | [string] |
| 57.2 | val | val | string | — | Required | [string] |
| 57.3 | character | character | string | — | Optional | [string] |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 错误信息 | array<any> | — | Required | 错误信息 |
| 4 | request_id | 请求链路id | string | | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2020-04-30 17:33:32 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | product_id | 本地产品id | integer | 1010 | Required | 本地产品id |
| 6.2 | sku | 本地产品sku | string | SKU2986DFA1 | Required | 本地产品sku |
| 6.3 | sku_identifier | SKU识别码 | string | SKU2986DFA1 | Required | SKU识别码 |
The 添加/编辑本地产品 API (/erp/sc/routing/storage/product/set) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.