Lingxing
切换旧版

添加/编辑多属性产品

POST/erp/sc/routing/storage/spu/set

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/storage/spu/setHTTPSPOST5

请求参数

spustring必填
SPU(添加时必填)
spu_namestring必填
款名(添加时必填)
modelstring
型号
unitstring
单位
statusinteger
状态【默认1】:0 停售,1 在售,2 开发中,3 清仓
cidinteger
分类id
bidinteger
品牌id
create_uidinteger
创建人id
developer_uidinteger
开发人id
product_duty_uidsarray<any>
产品负责人id
descriptionstring
产品描述
use_spu_templateinteger
是否应用SPU信息至新生成的SKU:0 否,1 是
sku_listarray<object>必填
产品列表【提交的sku不存在时系统会自动创建】
隐藏子属性
skustring必填
本地产品SKU
product_namestring
产品名称【提交的sku不存在时为必填项】
attributearray<object>必填
属性列表
隐藏子属性
pa_idinteger必填
属性id
pai_idinteger必填
属性值id
picture_listarray<object>
产品图片信息
隐藏子属性
is_primaryinteger必填
是否产品主图:0否,1是
purchase_infoobject
采购相关信息
隐藏子属性
cg_uidinteger
采购:采购员id
purchase_remarkstring
采购:采购备注
cg_deliveryinteger
采购:采购交期(天)
cg_product_lengthnumber
采购:单品规格-长(CM)
cg_product_widthnumber
采购:单品规格-宽(CM)
cg_product_heightnumber
采购:单品规格-高(CM)
cg_product_net_weightnumber
采购:单品净重(G)
cg_product_gross_weightnumber
采购:单品毛重(G)
cg_package_lengthnumber
采购:包装规格-长(CM)
cg_package_widthnumber
采购:包装规格-宽(CM)
cg_package_heightnumber
采购:包装规格-高(CM)
cg_box_lengthnumber
采购:外箱规格-长(CM)
cg_box_widthnumber
采购:外箱规格-宽(CM)
cg_box_heightnumber
采购:外箱规格-高(CM)
cg_box_weightnumber
采购:单箱重量(KG)
cg_box_pcsstring
采购:单箱数量(包装数量)
cg_product_materialstring
采购:产品材质
logisticsobject
物流报关相关信息
隐藏子属性
declarationobject
报关数据
隐藏子属性
customs_export_namestring
报关:申报品名(中文)
customs_import_namestring
报关:申报品名(英文)
customs_import_price_currencystring
报关:申报单价的币种
customs_import_pricenumber
报关:申报单价
customs_declaration_unitstring
报关单位
customs_declaration_specstring
规格型号
customs_declaration_origin_producestring
报关:原厂国(地区)
customs_declaration_inlands_sourcestring
报关:境内货源地
customs_declaration_exemptstring
报关:征免
clearanceobject
清关数据
隐藏子属性
customs_clearance_materialstring
清关:材质
customs_clearance_usagestring
清关:用途
customs_clearance_internal_codestring
清关:内部编码
customs_clearance_preferentialstring
清关:出口享惠情况:
1 不享惠
2 享惠
3 不确定享惠情况
customs_clearance_brand_typestring
清关:品牌类型:
1 无品牌
2 境内自主品牌
3 境内收购品牌
4 境外品牌(贴牌生产)
5 境外品牌(其他)
customs_clearance_product_patternstring
清关:产品型号
allocation_remarkstring
清关:配货备注
customs_clearance_pic_urlstring
清关:清关图片
baseobject
物流基础信息
隐藏子属性
bg_export_hs_codestring
报关:HS Code(中国)
special_attrarray<any>
产品特殊属性:1 含电
2 纯电
3 液体
4 粉末
5 膏体
6 带磁
feeobject
头程费用,支持国家: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
隐藏子属性
国家简码_cg_transport_costsnumber
默认头程费用(含税)
国家简码_currencystring
默认头程费用币种
国家简码_clearance_pricenumber
清关价格
国家简码_clearance_price_currencystring
清关价格币种
国家简码_bg_import_hs_codestring
HS Code
国家简码_bg_tax_ratenumber
税率
aux_relation_listarray<object>
辅料列表
隐藏子属性
aux_skustring必填
辅料sku
sku_qtystring必填
辅料比例(主料)
aux_qtystring必填
辅料比例(辅料)
attribute_skc_listarray<object>
skc列表
隐藏子属性
pa_idinteger必填
属性id
skcstring必填
skc,新增时根据skc业务配置规则自动生成
sku_lisobject
隐藏子属性
picture_listobject
隐藏子属性
pic_urlstring必填
产品图片链接

请求示例

{
    "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": ""
        }
    ]
}

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
提示消息
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 6D1422D5-B767-675D-42F6-F604319C2333
response_timestring必填
响应时间
示例 2023-03-09 14:45:40
totalinteger必填
总数
示例 0
dataarray<object>必填
响应数据
隐藏子属性
ps_idinteger必填
spu唯一id
示例 113
sku_listarray<object>必填
spu下对应的sku数据
隐藏子属性
product_idinteger必填
本地产品id
示例 48528
skustring必填
本地产品sku
示例 CWZS20A-S

返回成功示例

{
    "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"
            }
        ]
    }
}