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

taobao.qimen.items.synchronize (商品同步接口 (批量))

ERP调用奇门的接口,批量同步商品信息给WMS

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request ItemsSynchronizeRequest 可选
  • └ actionType
  • String
  • 必须
  • add
  • 操作类型(两种类型:add|update)
  • └ warehouseCode
  • String
  • 必须
  • CK1234
  • 仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER)
  • └ ownerCode
  • String
  • 必须
  • HZ123
  • 货主编码
  • items
  • 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
  • 商品包装材料类型
  • └ logisticsType
  • String
  • 可选
  • 1
  • 销售配送方式(0=自配|1=菜鸟)
  • └ isLiquid
  • String
  • 可选
  • N
  • 是否液体, Y/N, (默认为N)
  • └ extendProps
  • Map
  • 可选
  • 扩展属性

响应参数

名称 类型 示例值 描述
response ItemsSynchronizeResponse
  • └ flag
  • String
  • success
  • 响应结果:success|failure
  • └ code
  • String
  • 0
  • 响应码
  • └ message
  • String
  • invalid appkey
  • 响应信息
  • items
  • BatchItemSynItem []
  • 商品同步批量接口中单商品信息
  • └ itemCode
  • String
  • I123
  • 没有同步成功的商品的编码
  • └ message
  • String
  • 服务异常
  • 出错信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenClient client = new DefaultQimenClient(url, appkey, secret);
ItemsSynchronizeRequest req = new ItemsSynchronizeRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
req.setActionType("add");
req.setWarehouseCode("CK1234");
req.setOwnerCode("HZ123");
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),,");
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),,");
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.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.setProduceCode("temp");
obj1.setOrderLineNo("temp");
obj1.setActualQty("temp");
obj1.setAmount("temp");
obj1.setUnit("temp");
obj1.setWarehouseCode("temp");
obj1.setLockQuantity("temp");
obj1.setOrderCode("temp");
obj1.setOrderType("temp");
obj1.setOutBizCode("temp");
obj1.setLackQty("temp");
obj1.setReason("temp");
obj1.setSnCode("temp");
obj1.setStandardPrice("temp");
obj1.setReferencePrice("temp");
obj1.setDiscount("temp");
obj1.setActualAmount("temp");
obj1.setLatestUpdateTime("temp");
obj1.setChangeTime("temp");
obj1.setTempRequirement("temp");
obj1.setChannelCode("temp");
obj1.setLogisticsType("1");
obj1.setIsLiquid("N");
req.setItems(obj1);
ItemsSynchronizeResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<response>
    <flag>success</flag>
    <code>0</code>
    <message>invalid appkey</message>
    <items>
        <batch_item_syn_item>
            <itemCode>I123</itemCode>
            <message>服务异常</message>
        </batch_item_syn_item>
    </items>
</response>

异常示例

  • XML示例
  • JSON示例
<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

返回
顶部