文档中心 > 开发文档 > API文档

fineex.wms.products.sync (商品信息同步接口)

对商品信息的新增、修改功能。

系统参数

应用参数

名称
类型
必须
长度
描述
request
request
request
items
item[]
items 建议最大值50条
actionType
String
32
操作类型:ADD-新增 MODIFY-修改(actionType=ADD,发网已存在的商品进行修改操作)
barCode
String
64
商家条码 [唯一确定该商品,可作为分拣依据](去空格)
itemCode
String
64
SKU 编码(去空格)
itemName
String
255
商品名称
categoryName
String
40
一级商品类型(类目名称)
secondCategName
String
40
二级商品类型(类目名称) 包含二级类目,一次只能推送一条商品信息
property
String
100
商品属性,如颜色:红色尺寸:M
length
decimal
长 (厘米) 长宽高重量体积默认接口不修改,若要接口修改告知项目配置策略
width
decimal
宽 (厘米)
height
decimal
高 (厘米)
volume
decimal
商品体积(L)
weight
decimal
商品重量(kg)
unit
String
20
商品单位
packageSpec
String
100
商品包装规格
alterStorageAmount
Int
预警库存
isBanAviation
String
1
是否禁航空件(Y是,N否)
isLogCodeFlag
String
1
是否管控SN码(Y是,N否)
isDateValid
String
1
是否管控效期(Y是,N否)
criticalperiod
Int
临保期(天)
shelflife
Int
保质期(天)
caution
Int
预警天数(天)
forceLower
Int
强制下架天数(天)
allowIn
Int
允许入库天数(天)
PrePackType
Int
1=前置,2=后置,其他=没有预包
PackageRemark
String
前(后)置预包装描述
FacturerName
String
生产企业名称
FacturerLicence
String
生产企业生产许可证
VoucherCode
String
备案凭证编码
RegisterCode
String
注册证号
IsFirstMedical
bit
是否一类医疗器械
IsSecondMedical
bit
是否二类医疗器械
IsWareHouseIn
bit
是否需要采购入库单
IsProductionDate
bit
是否需要生产日期
IsExpireDate
bit
是否需要失效日期
DepositType
int
存储要求(1常温,2恒温,3冷藏,4冷冻)
sublists
sublist[]
sublists 包含子条码,一次只能推送一条商品信息
subCode
String
64
子条码

响应参数

名称
类型
必须
长度
描述
response
response
response
flag
String
32
成功:true 失败:false
code
String
32
错误码
message
String
200
错误说明

请求示例

  • XML示例
<request>
      <items>
       <item>
        <barCode>TEST1</barCode>
        <itemCode>1456465</itemCode>
        <categoryName>装潢/灯具/五金/安防/卫浴</categoryName>
        <actionType>ADD</actionType>
        <itemName>活性炭1kg</itemName>
        <property>颜色:红色;尺寸: M </property>
        <length>2</length>
        <width>2</width>
        <height>2</height>
        <volume>2</volume>
        <weight>2</weight>
        <unit>包</unit>
        <alterStorageAmount>20</alterStorageAmount>
        <packageSpec>12包/箱</packageSpec>
        <isBanAviation>N</isBanAviation>
        <isLogCodeFlag>N</isLogCodeFlag>
        <isDateValid>N</isDateValid>
        <batchRule>0</batchRule>
        <criticalperiod>30</criticalperiod>
        <shelflife>365</shelflife>
        <PrePackType>1</PrePackType>
        <PackageRemark>前置预包装123</PackageRemark>
        <FacturerName>生产企业名称</FacturerName>
        <FacturerLicence>生产企业生产许可证</FacturerLicence>
        <VoucherCode>备案凭证编码</VoucherCode>
        <RegisterCode>注册证号</RegisterCode>
        <IsFirstMedical>0</IsFirstMedical>
        <IsSecondMedical>0</IsSecondMedical>
        <IsWareHouseIn>0</IsWareHouseIn>
        <IsProductionDate>0</IsProductionDate>
        <IsExpireDate>0</IsExpireDate>
        <DepositType>1</DepositType>
        <sublists>
         <sublist>
          <subCode>123522225</subCode>
         </sublist>
        </sublists>
       </item>
       <item>
       ......
       </item>
     </items>
</request>

响应示例

  • XML示例
<response>
     <flag>true</flag>
     <code></code>
     <message></message>
</response>

错误码解释

错误码 错误描述 解决方案
B01002 字段参数输入不合法 检查提示参数;
B01004 商品条码不存在
B01099 执行异常,请稍后重试! 稍后重试!重试3次还是报错,联系发网技术。

API工具

FAQ