Qeasy Cloud
Get Started

领星ERP 添加/编辑多属性产品 API

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
产品 · POST · 请求参数 78 个(必填 14) · 响应参数 11 个 · 限流令牌桶容量 5
Updated At
2026-11-21

添加/编辑多属性产品

POST/erp/sc/routing/storage/spu/set
Factory
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/routing/storage/spu/set"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 5,
    "text": ""
  },
  "requestExample": {
    "spu": "AAAAAABBB",
    "spu_name": "AAAAAAAAA",
    "model": "",
    "unit": "",
    "status": 0,
    "cid": "",
    "bid": "",
    "create_uid": 0,
    "developer_uid": "",
    "product_duty_uids": [],
    "description": "",
    "use_spu_template": 0,
    "sku_list": [
      {
        "sku": "CWZS20A-S",
        "product_name": "儿童沙滩罩衫",
        "picture_list": [
          {
            "pic_url": "http://hhjskbnd.png",
            "is_primary": 1
          }
        ],
        "attribute": [
          {
            "pa_id": "",
            "pai_id": ""
          }
        ]
      }
    ],
    "purchase_info": {
      "cg_uid": 1,
      "purchase_remark": "",
      "cg_delivery": 0,
      "cg_product_length": 0,
      "cg_product_width": 0,
      "cg_product_height": 0,
      "cg_product_net_weight": 0,
      "cg_product_gross_weight": 0,
      "cg_package_length": 0,
      "cg_package_width": 0,
      "cg_package_height": 0,
      "cg_box_length": 0,
      "cg_box_width": 0,
      "cg_box_height": 0,
      "cg_box_weight": 0,
      "cg_box_pcs": "",
      "cg_product_material": ""
    },
    "logistics": {
      "declaration": {
        "customs_export_name": "",
        "customs_import_name": "",
        "customs_import_price_currency": "",
        "customs_import_price": 0,
        "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": "",
        "customs_clearance_brand_type": "",
        "customs_clearance_product_pattern": "",
        "allocation_remark": "",
        "customs_clearance_pic_url": ""
      },
      "base": {
        "bg_export_hs_code": "",
        "special_attr": []
      },
      "fee": {
        "US_cg_transport_costs": 0,
        "US_currency": "",
        "US_clearance_price": 0,
        "US_clearance_price_currency": "",
        "US_bg_import_hs_code": 0,
        "US_bg_tax_rate": 0
      }
    },
    "attribute_skc_list": [
      {
        "pa_id": "",
        "skc": ""
      }
    ]
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "6D1422D5-B767-675D-42F6-F604319C2333",
    "response_time": "2023-03-09 14:45:40",
    "total": 0,
    "data": {
      "ps_id": 113,
      "sku_list": [
        {
          "product_id": 48528,
          "sku": "CWZS20A-S"
        },
        {
          "product_id": 48529,
          "sku": "CWZS20A-M"
        },
        {
          "product_id": 48530,
          "sku": "CWZS20A-L"
        }
      ]
    }
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1spuSPU(添加时必填)string—RequiredSPU(添加时必填)
2spu_name款名(添加时必填)string—Required款名(添加时必填)
3model型号string—Optional型号
4unit单位string—Optional单位
5status状态【默认1】integer—Optional状态【默认1】:0 停售,1 在售,2 开发中,3 清仓
6cid分类idinteger—Optional分类id
7bid品牌idinteger—Optional品牌id
8create_uid创建人idinteger—Optional创建人id
9developer_uid开发人idinteger—Optional开发人id
10product_duty_uids产品负责人idarray<any>—Optional产品负责人id
11description产品描述string—Optional产品描述
12use_spu_template是否应用SPU信息至新生成的SKUinteger—Optional是否应用SPU信息至新生成的SKU:0 否,1 是
13sku_list产品列表【提交的sku不存在时系统会自动创建】array<object>—Required产品列表【提交的sku不存在时系统会自动创建】
13.1sku本地产品SKUstring—Required本地产品SKU
13.2product_name产品名称【提交的sku不存在时为必填项】string—Optional产品名称【提交的sku不存在时为必填项】
13.3attribute属性列表array<object>—Required属性列表
13.3.1pa_id属性idinteger—Required属性id
13.3.2pai_id属性值idinteger—Required属性值id
13.4picture_list产品图片信息array<object>—Optional产品图片信息
13.4.1is_primary是否产品主图integer—Required是否产品主图:0否,1是
14purchase_info采购相关信息object—Optional采购相关信息
14.1cg_uid采购integer—Optional采购:采购员id
14.2purchase_remark采购string—Optional采购:采购备注
14.3cg_delivery采购integer—Optional采购:采购交期(天)
14.4cg_product_length采购number—Optional采购:单品规格-长(CM)
14.5cg_product_width采购number—Optional采购:单品规格-宽(CM)
14.6cg_product_height采购number—Optional采购:单品规格-高(CM)
14.7cg_product_net_weight采购number—Optional采购:单品净重(G)
14.8cg_product_gross_weight采购number—Optional采购:单品毛重(G)
14.9cg_package_length采购number—Optional采购:包装规格-长(CM)
14.10cg_package_width采购number—Optional采购:包装规格-宽(CM)
14.11cg_package_height采购number—Optional采购:包装规格-高(CM)
14.12cg_box_length采购number—Optional采购:外箱规格-长(CM)
14.13cg_box_width采购number—Optional采购:外箱规格-宽(CM)
14.14cg_box_height采购number—Optional采购:外箱规格-高(CM)
14.15cg_box_weight采购number—Optional采购:单箱重量(KG)
14.16cg_box_pcs采购string—Optional采购:单箱数量(包装数量)
14.17cg_product_material采购string—Optional采购:产品材质
15logistics物流报关相关信息object—Optional物流报关相关信息
15.1declaration报关数据object—Optional报关数据
15.1.1customs_export_name报关string—Optional报关:申报品名(中文)
15.1.2customs_import_name报关string—Optional报关:申报品名(英文)
15.1.3customs_import_price_currency报关string—Optional报关:申报单价的币种
15.1.4customs_import_price报关number—Optional报关:申报单价
15.1.5customs_declaration_unit报关单位string—Optional报关单位
15.1.6customs_declaration_spec规格型号string—Optional规格型号
15.1.7customs_declaration_origin_produce报关string—Optional报关:原厂国(地区)
15.1.8customs_declaration_inlands_source报关string—Optional报关:境内货源地
15.1.9customs_declaration_exempt报关string—Optional报关:征免
15.2clearance清关数据object—Optional清关数据
15.2.1customs_clearance_material清关string—Optional清关:材质
15.2.2customs_clearance_usage清关string—Optional清关:用途
15.2.3customs_clearance_internal_code清关string—Optional清关:内部编码
15.2.4customs_clearance_preferential清关string—Optional清关:出口享惠情况: 1 不享惠 2 享惠 3 不确定享惠情况
15.2.5customs_clearance_brand_type清关string—Optional清关:品牌类型: 1 无品牌 2 境内自主品牌 3 境内收购品牌 4 境外品牌(贴牌生产) 5 境外品牌(其他)
15.2.6customs_clearance_product_pattern清关string—Optional清关:产品型号
15.2.7allocation_remark清关string—Optional清关:配货备注
15.2.8customs_clearance_pic_url清关string—Optional清关:清关图片
15.3base物流基础信息object—Optional物流基础信息
15.3.1bg_export_hs_code报关string—Optional报关:HS Code(中国)
15.3.2special_attr产品特殊属性array<any>—Optional产品特殊属性:1 含电 2 纯电 3 液体 4 粉末 5 膏体 6 带磁
15.4fee头程费用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
15.4.1国家简码_cg_transport_costs默认头程费用(含税)number—Optional默认头程费用(含税)
15.4.2国家简码_currency默认头程费用币种string—Optional默认头程费用币种
15.4.3国家简码_clearance_price清关价格number—Optional清关价格
15.4.4国家简码_clearance_price_currency清关价格币种string—Optional清关价格币种
15.4.5国家简码_bg_import_hs_codeHS Codestring—OptionalHS Code
15.4.6国家简码_bg_tax_rate税率number—Optional税率
16aux_relation_list辅料列表array<object>—Optional辅料列表
16.1aux_sku辅料skustring—Required辅料sku
16.2sku_qty辅料比例(主料)string—Required辅料比例(主料)
16.3aux_qty辅料比例(辅料)string—Required辅料比例(辅料)
17attribute_skc_listskc列表array<object>—Optionalskc列表
17.1pa_id属性idinteger—Required属性id
17.2skcskcstring—Requiredskc,新增时根据skc业务配置规则自动生成
18sku_lissku_lisobject—Optional
18.1picture_listpicture_listobject—Optional
18.1.1pic_url产品图片链接string—Required产品图片链接

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message提示消息stringsuccessRequired提示消息
3error_details错误信息array<any>—Required错误信息
4request_id请求链路idstring6D1422D5-B767-675D-42F6-F604319C2333Required请求链路id
5response_time响应时间string2023-03-09 14:45:40Required响应时间
6total总数integer0Required总数
7data响应数据array<object>—Required响应数据
7.1ps_idspu唯一idinteger113Requiredspu唯一id
7.2sku_listspu下对应的sku数据array<object>—Requiredspu下对应的sku数据
7.2.1product_id本地产品idinteger48528Required本地产品id
7.2.2sku本地产品skustringCWZS20A-SRequired本地产品sku

The 添加/编辑多属性产品 API (/erp/sc/routing/storage/spu/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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.