详细描述

新增产品

支持平台: 淘宝

API用户类型授权

需授权

系统级别输入参数

名称 类型 是否必须 描述
method String

API接口名称

certi_id Number

分配给应用的证书ID

from_node_id String

API调用的来源节点ID,对于第三方开发者来说,此id即为申请应用颁发的APP KEY

from_api_v String

请求方版本号

to_node_id String

API调用的目的节点ID(除了基础服务类api,其他接口必传此参数)

to_api_v String

接收方版本号

callback_url String

响应回调地址,带http路径的标准URL。(调用异步接口此参数必填)

v String

矩阵API协议版本,可选值:1.0

timestamp String

时间戳,格式为yyyy-MM-dd hh:mm:ss,例如:2008-01-25 20:23:30。ShopEx API服务端允许客户端请求时间误差为10分钟

format String

可选,指定响应格式。默认JSON ,目前支持格式为JSON

sign String

对调用API时所有输入参数(包括应用级参数)进行签名结果

应用级输入参数

名称 类型
默认全部
示例值 默认值 描述
name String

淘宝(必填)

产品名称

productcat_id Number

淘宝(必填)

产品线ID

standard_price String

淘宝(必填)

标准价格,单位:元。例:“10.56”。

cost_price String

淘宝(必填)

采购价格,单位:元。例:“10.56”。

retail_price_low String

淘宝(必填)

最低零售价,单位:元。例:“10.56”。

retail_price_high String

淘宝(必填)

最高零售价,单位:元。例:“10.56”。

outer_id String

淘宝(可选)

商家编码

quantity Number

淘宝(必填)

产品库存

alarm_number Number

淘宝(必填)

警戒库存

desc String

淘宝(必填)

产品描述,长度为5到25000字符。

province String

淘宝(必填)

所在地:省,例:“浙江”

city String

淘宝(必填)

所在地:市,例:“杭州”

postage_type String

淘宝(必填)

运费类型,可选值:seller(供应商承担运费)、buyer(分销商承担运费),默认seller。

postage_id String

淘宝(可选)

运费模板ID(淘宝的运费模版ID)

postage_ordinary String

淘宝(可选)

平邮费用,单位:元。例:“10.56”。

postage_fast String

淘宝(可选)

快递费用,单位:元。例:“10.56”。

postage_ems String

淘宝(可选)

ems费用,单位:元。例:“10.56”。

status String

淘宝(可选)

发布状态,可选值:up(上架)、down(下架)、delete(删除)

sku_ids String

淘宝(可选)

sku id列表,例:1001,1002,1003

sku_cost_prices String

淘宝(可选)

sku采购价格,单位元,例:"10.50,11.00,20.50",字段必须和上面的sku_ids保持一致。

sku_quantitys String

淘宝(可选)

sku库存,例:"10,20,30"。

sku_outer_ids String

淘宝(可选)

sku商家编码,例:"S1000,S1002,S1003"。

have_invoice String

淘宝(必填)

是否有发票,可选值:false(否)、true(是),默认false。

have_guarantee String

淘宝(必填)

是否有保修,可选值:false(否)、true(是),默认false。

discount_id Number

淘宝(可选)

折扣ID

返回结果

名称 类型 是否必须 示例值 描述
fenxiao_product Fenxiao_Product

返回 pid,created

XML数据格式:

			
JSON数据格式:
{    
      "rsp":"fail",
      "msg_id":"3463421b2581604c74dcb9b74ffab2e4"
      "data":{
           "fenxiao_product":{
                "pid": "52",
                "created": 2000-01-01 00:00:00
           }
      }
}

错误码

错误码 错误描述 解决方案

FAQ

修改时间:2013-05-20 09:28:06