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