文档中心 > API类目 > 奇门仓储API

taobao.qimen.singleitem.synchronize (商品同步接口)

taobao.qimen.singleitem.synchronize

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request ItemSynRequest 可选
  • └ actionType
  • String
  • 必须
  • add
  • 操作类型(两种类型:add|update)
  • └ warehouseCode
  • String
  • 必须
  • CK1234
  • 仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER)
  • └ ownerCode
  • String
  • 必须
  • HZ123
  • 货主编码
  • └ supplierCode
  • String
  • 可选
  • GY123
  • 供应商编码
  • └ supplierName
  • String
  • 可选
  • 淘宝
  • 供应商名称
  • item
  • Item
  • 可选
  • 商品信息
  • └ itemCode
  • String
  • 必须
  • I1234
  • 商品编码
  • └ itemId
  • String
  • 可选
  • WI1234
  • 仓储系统商品编码(该字段是WMS分配的商品编号;WMS如果分配了商品编码;则后续的商品操作都需要传该字段;如果WMS不使用;WMS可 以返回itemId=itemCode的值)
  • └ goodsCode
  • String
  • 可选
  • H1234
  • 货号
  • └ itemName
  • String
  • 必须
  • SN123
  • 商品名称
  • └ shortName
  • String
  • 可选
  • JC123
  • 商品简称
  • └ englishName
  • String
  • 可选
  • EN123
  • 英文名
  • └ barCode
  • String
  • 必须
  • T1;T2
  • 条形码(可多个;用分号;隔开)
  • └ skuProperty
  • String
  • 可选
  • 红色
  • 商品属性(如红色;XXL)
  • └ stockUnit
  • String
  • 可选
  • 商品计量单位
  • └ length
  • String
  • 可选
  • 12.0
  • 长(单位:厘米)
  • └ width
  • String
  • 可选
  • 12.0
  • 宽(单位:厘米)
  • └ height
  • String
  • 可选
  • 12.0
  • 高(单位:厘米)
  • └ volume
  • String
  • 可选
  • 12.0
  • 体积(单位:升)
  • └ grossWeight
  • String
  • 可选
  • 12.0
  • 毛重(单位:千克)
  • └ netWeight
  • String
  • 可选
  • 12.0
  • 净重(单位:千克)
  • └ color
  • String
  • 可选
  • 红色
  • 颜色
  • └ size
  • String
  • 可选
  • 5英尺
  • 尺寸
  • └ title
  • String
  • 可选
  • 淘公仔
  • 渠道中的商品标题
  • └ categoryId
  • String
  • 可选
  • LB123
  • 商品类别ID
  • └ categoryName
  • String
  • 可选
  • 手机
  • 商品类别名称
  • └ pricingCategory
  • String
  • 可选
  • 手机类
  • 计价货类
  • └ safetyStock
  • Number
  • 可选
  • 12
  • 安全库存
  • └ itemType
  • String
  • 必须
  • ZC
  • 商品类型(ZC=正常商品;FX=分销商品;ZH=组合商品;ZP=赠品;BC=包材;HC=耗材;FL=辅料;XN=虚拟品;FS=附属品;CC=残次品; OTHER=其它;只传英文编码)
  • └ tagPrice
  • String
  • 可选
  • 12.0
  • 吊牌价
  • └ retailPrice
  • String
  • 可选
  • 12.0
  • 零售价
  • └ costPrice
  • String
  • 可选
  • 12.0
  • 成本价
  • └ purchasePrice
  • String
  • 可选
  • 12.0
  • 采购价
  • └ seasonCode
  • String
  • 可选
  • CHUN
  • 季节编码
  • └ seasonName
  • String
  • 可选
  • 春季
  • 季节名称
  • └ brandCode
  • String
  • 可选
  • LAL
  • 品牌代码
  • └ brandName
  • String
  • 可选
  • HM
  • 品牌名称
  • └ isSNMgmt
  • String
  • 可选
  • N
  • 是否需要串号管理(Y/N ;默认为N)
  • └ productDate
  • String
  • 可选
  • 2016-09-09
  • 生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 可选
  • 2016-09-09
  • 过期日期(YYYY-MM-DD)
  • └ isShelfLifeMgmt
  • String
  • 可选
  • N
  • 是否需要保质期管理(Y/N ;默认为N)
  • └ shelfLife
  • Number
  • 可选
  • 1
  • 保质期(单位:小时)
  • └ rejectLifecycle
  • Number
  • 可选
  • 1
  • 保质期禁收天数
  • └ lockupLifecycle
  • Number
  • 可选
  • 1
  • 保质期禁售天数
  • └ adventLifecycle
  • Number
  • 可选
  • 1
  • 保质期临期预警天数
  • └ isBatchMgmt
  • String
  • 可选
  • N
  • 是否需要批次管理(Y/N ;默认为N)
  • └ batchCode
  • String
  • 可选
  • P1234
  • 批次代码
  • └ batchRemark
  • String
  • 可选
  • 备注信息
  • 批次备注
  • └ packCode
  • String
  • 可选
  • B12
  • 包装代码
  • └ pcs
  • String
  • 可选
  • XG123
  • 箱规
  • └ originAddress
  • String
  • 可选
  • HK
  • 商品的原产地
  • └ approvalNumber
  • String
  • 可选
  • PB123
  • 批准文号
  • └ isFragile
  • String
  • 可选
  • N
  • 是否易碎品(Y/N ;默认为N)
  • └ isHazardous
  • String
  • 可选
  • N
  • 是否危险品(Y/N ;默认为N)
  • └ remark
  • String
  • 可选
  • 备注信息
  • 备注
  • └ createTime
  • String
  • 可选
  • 2017-09-09 12:00:00
  • 创建时间(YYYY-MM-DD HH:MM:SS)
  • └ updateTime
  • String
  • 可选
  • 2017-09-09 12:00:00
  • 更新时间(YYYY-MM-DD HH:MM:SS)
  • └ isValid
  • String
  • 可选
  • N
  • 是否有效(Y/N ;默认为N)
  • └ isSku
  • String
  • 可选
  • N
  • 是否sku(Y/N ;默认为N)
  • └ packageMaterial
  • String
  • 可选
  • BX123
  • 商品包装材料类型
  • └ supplierCode
  • String
  • 可选
  • temp
  • temp
  • └ logisticsType
  • String
  • 可选
  • 0
  • 销售配送方式(0=自配|1=菜鸟)
  • └ isLiquid
  • String
  • 可选
  • Y
  • 是否液体, Y/N, (默认为N)
  • └ extendProps
  • Map
  • 可选
  • 商品信息扩展属性
  • └ extendProps
  • Map
  • 可选
  • 扩展属性

响应参数

名称 类型 示例值 描述
response Response
  • └ flag
  • String
  • success
  • 响应结果:success|failure
  • └ code
  • String
  • 0
  • 响应码
  • └ message
  • String
  • invalid appkey
  • 响应信息
  • └ itemId
  • String
  • CH123
  • 仓储系统商品Id(当这个字段不为空的时候;所有erp传输的时候都碰到itemid必传)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
QimenClient client = new DefaultQimenClient(url, appkey, secret);
SingleitemSynchronizeRequest req = new SingleitemSynchronizeRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
req.setActionType("add");
req.setWarehouseCode("CK1234");
req.setOwnerCode("HZ123");
req.setSupplierCode("GY123");
req.setSupplierName("淘宝");
Item obj1 = new Item();
obj1.setProductCode("奇门仓储字段,说明,string(50),,");
obj1.setPaperQty("奇门仓储字段,说明,string(50),,");
obj1.setDiffQuantity("奇门仓储字段,说明,string(50),,");
obj1.setExtCode("奇门仓储字段,说明,string(50),,");
Batch obj2 = new Batch();
obj2.setBatchCode("奇门仓储字段,说明,string(50),,");
obj2.setProductDate("奇门仓储字段,说明,string(50),,");
obj2.setExpireDate("奇门仓储字段,说明,string(50),,");
obj2.setProduceCode("奇门仓储字段,说明,string(50),,");
obj2.setInventoryType("奇门仓储字段,说明,string(50),,");
obj2.setActualQty("奇门仓储字段,说明,string(50),,");
obj2.setQuantity("奇门仓储字段,说明,string(50),,");
obj2.setRemark("备注");
obj1.setBatchs(obj2);
PriceAdjustment obj3 = new PriceAdjustment();
obj3.setType("奇门仓储字段,说明,string(50),,");
obj3.setStandardPrice("奇门仓储字段,说明,string(50),,");
obj3.setDiscount("奇门仓储字段,说明,string(50),,");
obj3.setStartDate("奇门仓储字段,说明,string(50),,");
obj3.setEndDate("奇门仓储字段,说明,string(50),,");
obj3.setRemark("备注");
obj1.setPriceAdjustment(obj3);
obj1.setOriginCode("奇门仓储字段,说明,string(50),,");
obj1.setItemCode("I1234");
obj1.setItemId("WI1234");
obj1.setGoodsCode("H1234");
obj1.setItemName("SN123");
obj1.setShortName("JC123");
obj1.setEnglishName("EN123");
obj1.setBarCode("T1;T2");
obj1.setSkuProperty("红色");
obj1.setStockUnit("个");
obj1.setLength("12.0");
obj1.setWidth("12.0");
obj1.setHeight("12.0");
obj1.setVolume("12.0");
obj1.setGrossWeight("12.0");
obj1.setNetWeight("12.0");
obj1.setColor("红色");
obj1.setSize("5英尺");
obj1.setTitle("淘公仔");
obj1.setCategoryId("LB123");
obj1.setCategoryName("手机");
obj1.setPricingCategory("手机类");
obj1.setSafetyStock(12L);
obj1.setItemType("ZC");
obj1.setTagPrice("12.0");
obj1.setRetailPrice("12.0");
obj1.setCostPrice("12.0");
obj1.setPurchasePrice("12.0");
obj1.setSeasonCode("CHUN");
obj1.setSeasonName("春季");
obj1.setBrandCode("LAL");
obj1.setBrandName("HM");
obj1.setIsSNMgmt("N");
obj1.setProductDate("2016-09-09");
obj1.setExpireDate("2016-09-09");
obj1.setIsShelfLifeMgmt("N");
obj1.setShelfLife(1L);
obj1.setRejectLifecycle(1L);
obj1.setLockupLifecycle(1L);
obj1.setAdventLifecycle(1L);
obj1.setIsBatchMgmt("N");
obj1.setBatchCode("P1234");
obj1.setBatchRemark("备注信息");
obj1.setPackCode("B12");
obj1.setPcs("XG123");
obj1.setOriginAddress("HK");
obj1.setApprovalNumber("PB123");
obj1.setIsFragile("N");
obj1.setIsHazardous("N");
obj1.setRemark("备注信息");
obj1.setCreateTime("2017-09-09 12:00:00");
obj1.setUpdateTime("2017-09-09 12:00:00");
obj1.setIsValid("N");
obj1.setIsSku("N");
obj1.setPackageMaterial("BX123");
obj1.setChannelCode("123");
obj1.setTempRequirement("temp");
obj1.setChangeTime("temp");
obj1.setLatestUpdateTime("temp");
obj1.setActualAmount("temp");
obj1.setDiscount("temp");
obj1.setReferencePrice("temp");
obj1.setStandardPrice("temp");
obj1.setSnCode("temp");
obj1.setReason("temp");
obj1.setLackQty("temp");
obj1.setOutBizCode("temp");
obj1.setOrderType("temp");
obj1.setOrderCode("temp");
obj1.setLockQuantity("temp");
obj1.setWarehouseCode("temp");
obj1.setUnit("temp");
obj1.setAmount("temp");
obj1.setActualQty("temp");
obj1.setOrderLineNo("temp");
obj1.setProduceCode("temp");
obj1.setOwnerCode("temp");
obj1.setSupplierCode("temp");
obj1.setSupplierName("temp");
obj1.setSn("temp");
obj1.setTareWeight("temp");
obj1.setStockStatus("temp");
obj1.setPrice("temp");
obj1.setIsAreaSale("temp");
obj1.setQuantity("temp");
obj1.setNormalQty("temp");
obj1.setDefectiveQty("temp");
obj1.setReceiveQty("temp");
obj1.setExCode("temp");
obj1.setDiscountPrice("temp");
obj1.setInventoryType("temp");
obj1.setPlanQty("temp");
obj1.setSourceOrderCode("temp");
obj1.setSubSourceOrderCode("temp");
obj1.setLogisticsType("0");
obj1.setIsLiquid("Y");
req.setItem(obj1);
SingleitemSynchronizeResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<response>
    <flag>success</flag>
    <code>0</code>
    <message>invalid appkey</message>
    <itemId>CH123</itemId>
</response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部