轻易云
注册体验

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

所属平台
领星ERP
类型
WebAPI
作用
EXECUTE
接口版本
1.0
适配器
\Adapter\LingXing\LXExecuteAdapter
授权方式
OTHER
描述
产品 · POST · 请求参数 78 个(必填 14) · 响应参数 11 个 · 限流令牌桶容量 5
更新日期
2026-11-21

添加/编辑多属性产品

POST/erp/sc/routing/storage/spu/set
加工厂
{
  "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"
        }
      ]
    }
  }
}

接口请求参数

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

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message提示消息stringsuccess必填提示消息
3error_details错误信息array<any>—必填错误信息
4request_id请求链路idstring6D1422D5-B767-675D-42F6-F604319C2333必填请求链路id
5response_time响应时间string2023-03-09 14:45:40必填响应时间
6total总数integer0必填总数
7data响应数据array<object>—必填响应数据
7.1ps_idspu唯一idinteger113必填spu唯一id
7.2sku_listspu下对应的sku数据array<object>—必填spu下对应的sku数据
7.2.1product_id本地产品idinteger48528必填本地产品id
7.2.2sku本地产品skustringCWZS20A-S必填本地产品sku

领星ERP的接口:添加/编辑多属性产品(/erp/sc/routing/storage/spu/set),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。