商品-同步

简要描述：

• 商品同步

接口说明：

• 1.1接口描述：同步商品信息至WMS
• 1.2接口说明：ERP通过奇门调用该接口,FMS调用奇门接口往WMS同步商品信息
• 1.3接口方法： taobao.qimen.singleitem.synchronize

  接口版本：

请求头：

请求参数:

公共请求参数

request

item

返回参数:

response

请求示例(xml)

<request> 
    <actionType>add|update, 必填</actionType> 
    <warehouseCode>仓库编码, string (50)，必填 ，统仓统配等无需 ERP 指定仓储编码
    的情况填 OTHER</warehouseCode> 
    <ownerCode>货主编码, string (50) , 必填</ownerCode> 
    <supplierCode>供应商编码, string (50) </supplierCode> 
    <supplierName>供应商名称, string (200) </supplierName> 
    <item> 
    <itemCode>商品编码, string (50) , 必填</itemCode> 
    <itemId>仓储系统商品编码, string (50) , 条件必填, 该字段是 WMS 分配的商品编
    号，WMS 如果分配了商品编码，则后续的商品操作都需要传该字段，如果 WMS 不使
    用，WMS 可以返回 itemId=itemCode 的值 </itemId> 
    <goodsCode>货号，string（50）</goodsCode>
    <itemName>商品名称, string (200) , 必填</itemName> 
    <shortName>商品简称, string (200) </shortName> 
    <englishName>英文名, string (200) </englishName> 
    <barCode>条形码, string (500) , 可多个，用分号（;）隔开，必填</barCode> 
    <skuProperty>商品属性 (如红色, XXL) , string (200) </skuProperty> 
    <stockUnit>商品计量单位, string (50) </stockUnit> 
    <length>长 (厘米) , double (18, 2) </length> 
    <width>宽 (厘米) , double (18, 2) </width> 
    <height>高 (厘米) , double (18, 2) </height> 
    <volume>体积 (升) , double (18, 3) </volume> 
    <grossWeight>毛重 (千克) , double (18, 3) </grossWeight> 
    <netWeight>净重 (千克) , double (18, 3) </netWeight> 
    <color>颜色, string (50) </color> 
    <size>尺寸, string (50) </size> 
    <title>渠道中的商品标题, string (200) </title> 
    <categoryId>商品类别 ID, string (50) </categoryId> 
    <categoryName>商品类别名称, string (200) </categoryName> 
    <pricingCategory>计价货类, string (200) </pricingCategory> 
    <safetyStock>安全库存, int</safetyStock> 
    <itemType>商品类型 (ZC=正常商品, FX=分销商品, ZH=组合商品, ZP=赠品, BC=包 材, HC=耗材, FL=辅料, XN=虚拟品, FS=附属品, CC=残次品, OTHER=其它) , string 
    (10) , 必填, (只传英文编码) </itemType> 
    <tagPrice>吊牌价, double (18, 2) </tagPrice> 
    <retailPrice>零售价, double (18, 2) </retailPrice> 
    <costPrice>成本价, double (18, 2) </costPrice> 
    <purchasePrice>采购价, double (18, 2) </purchasePrice> 
    <seasonCode>季节编码, string (50) </seasonCode> 
    <seasonName>季节名称, string (50) </seasonName> 
    <brandCode>品牌代码, string (50) </brandCode> 
    <brandName>品牌名称, string (50) </brandName> 
    <isSNMgmt>是否需要串号管理, Y/N (默认为 N) </isSNMgmt> 
    <productDate>生产日期, string (10) , YYYY-MM-DD</productDate> 
    <expireDate>过期日期, string (10) , YYYY-MM-DD</expireDate> 
    <isShelfLifeMgmt>是否需要保质期管理, Y/N (默认为 N) </isShelfLifeMgmt> 
    <shelfLife>保质期 (小时) , int</shelfLife> 
    <rejectLifecycle>保质期禁收天数, int</rejectLifecycle> 
    <lockupLifecycle>保质期禁售天数, int</lockupLifecycle>
    <adventLifecycle>保质期临期预警天数, int</adventLifecycle>
    <isBatchMgmt>是否需要批次管理, Y/N (默认为 N) </isBatchMgmt> 
    <batchCode>批次代码, string (50) </batchCode> 
    <batchRemark>批次备注, string (200) </batchRemark> 
    <packCode>包装代码, string (50) </packCode> 
    <pcs>箱规, string(50)</pcs> 
    <originAddress>商品的原产地, string (50) </originAddress> 
    <approvalNumber>批准文号, string (50) </approvalNumber> 
    <isFragile>是否易碎品, Y/N, (默认为 N) </isFragile> 
    <isHazardous>是否危险品, Y/N, (默认为 N) </isHazardous>
    <isLiquid>是否液体, Y/N, (默认为 N) </isLiquid>
    <remark>备注, string (500) </remark> 
    <createTime>创建时间, string (19) , YYYY-MM-DD HH:MM:SS</createTime> 
    <updateTime>更新时间, string (19) , YYYY-MM-DD HH:MM:SS</updateTime> 
    <isValid>是否有效, Y/N (默认为 Y) </isValid> 
    <isSku>是否 sku, Y/N, (默认为 Y) </isSku> 
    <packageMaterial>商品包装材料类型, string (200) </packageMaterial>
    <logisticsType>销售配送方式（0=自配|1=菜鸟）, string (10) </logisticsType>
    <extendProps> 
        <key1>value1</key1> 
        <key2>value2</key2> 
    </extendProps> 
    </item> 
</request>

返回示例(xml):

正确时返回:

<response>
    <flag>success</flag>
    <code>0</code>
    <message>invalid appkey</message>
    <itemId>CH123</itemId>
    <requestId>8bde9c225ba9436abbfae303ecde91d1</requestId>
</response>

错误时返回:

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
   <requestId>8bde9c225ba9436abbfae303ecde91d1</requestId>
</error_response>

备注:

• 更多返回错误代码请看首页的错误代码描述