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

fineex.wms.trades.add (订单创建接口)

订单创建接口【客户创建单据】

1、 提交订单 支持1单或者多单请求一次,每次发送订单数最多50单(即:50个<order></order>节点)。支持多线程发送。根据自己系统而定。遇到大促、双11单量大;建议后台自动提交,每次最大50单,多线程发送。

2、 注意:请控制好自己系统中订单的提交,不要并发同时多个人能操作,相同的订单。而导致大量报错,提示订单已存在重复提交。

3、 提交订单中的商品明细条码不能重复出现,如订单明细:

A条码 数量2个

A条码 数量1个。

提交订单应该合并一起, A 条码 数量3个。

系统参数

应用参数

名称
类型
必须
长度
描述
request
request
request
orders
order[]
50
订单集合(最大50)
wareHouseCode
String
32
仓库编号(发网提供)
saleOrderCode
String
50
销售订单号,主键 唯一;
orderType
Int
单据类型;(默认为正常订单) 11=正常订单、15=次品订单
logisticsCode
String
30
要求配送快递公司代码,如为空则由发网选择;可能最终使用快递不是客户指定快递;以发网回传数据为准。EMS=EMS、ZJS=宅急送、YTO=圆通、STO=申通、SF=顺丰、YUNDA=韵达、ZTO=中通、FINEEX=发网、FIREWIND=风火、ZJB=宅急便、SURE=速尔、APEX=全一、CCES=CCES、QFKD=全峰、FKD=飞快达、TOPNAME=特能、XCJB=星辰急便、HTKY=汇通、ANE=安能、EBON=一邦快递、TTKDEX=天天快递、DBL=德邦、NEDA=能达、UC=优速、GTO=国通快递、LBEX=龙邦、FKD=飞康达、JD=京东快递、POSTB=邮政小包、XBWL=新邦物流、FAST=快捷快递、XNEXPRESS=虚拟快递公司、OTHER=其他
saleDate
String
19
销售时间 (格式:yyyy-MM-dd HH:mm:ss)
deliveryPlanTime
String
19
预计发货时间 (格式:yyyy-MM-dd HH:mm:ss)
itemAmount
double
(18, 2)
商品总金额 (元)
freight
double
(18, 2)
快递费用 (元)
totalAmount
double
(18, 2)
订单总金额 (元),订单总金额=商品总金额+快递费用
payment
double
(18, 2)
代收金额 (元),(货到付款填写,不是填写0)
insuranceValue
double
(18, 2)
保价金额 (元)
shopName
String
50
店铺名称
communitySyncCode
string
社区同步编码(社区团购业务,该字段必填)
buyerNick
String
50
买家昵称
tradeId
String
50
平台订单号
sourcePlatformCode
String
50
订单来源平台编码; TB=淘宝、TM=天猫、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、FK=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、POS=POS门店、PDD=拼多多、OTHER=其他, (只传英文编码)
remark
String
200
备注
isPrintInvoice
bit
1
是否打印发票; 0=不打印、1=打印
country
String
100
国家(境外业务必填)
dropoffType
String
50
境外业务(指定将包裹交给FedEx所用的方法。此元素不会派遣速递员进行包裹取件)
serviceType
String
50
境外业务(为费率请求指定托运包裹时要使用的FedEx服务)
packagingType
String
50
境外业务(指定对包裹使用的包装)
isUrgency
bit
1
是否紧急发货0:不是1是(默认0)
receiver
receiver
收货人信息
name
String
32
收货人姓名
zipCode
String
10
邮编
phone
String
32
收货人固定电话(固定电话和移动电话必填一项) 非唯品会JITX订单固定电话必须明文传输
mobilePhone
String
32
收货人移动电话(固定电话和移动电话必填一项) 非唯品会JITX订单移动电话必须明文传输
province
String
32
收货人 省份
city
String
32
收货人 城市
county
String
32
收货人 区县(PDD拼多多平台此值必填)
address
String
150
收货人详细地址; address和address2 二选一
address2
String
500
收货人详细地址(含省、市、区); address和address2 二选一
sender
sender
发货人信息
senderName
String
32
发货人姓名
senderPhone
String
32
发货人移动电话
senderMobile
String
32
发货人固定电话
items
item[]
barCode
String
64
商品条码
itemName
String
250
商品名称
price
double
(18, 2)
商品单价
quantity
int
数量
batchCode
String
64
批次编码(若需要指定批次发货请联系发网技术)

响应参数

名称
类型
必须
长度
描述
response
response
response
flag
String
32
全部成功:true 全部失败:false 注意:部分成功也为true 需处理
code
String
32
错误码
message
String
200
错误说明
orders
order[]
失败订单集合(批量推送且部分成功时才有此节点)
saleOrderCode
String
32
失败订单号
message
String
32
失败原因

请求示例

  • XML示例
<request>
     <orders>
      <order>
       <wareHouseCode>1009</wareHouseCode>
       <saleOrderCode>S201512091001</saleOrderCode>
       <orderType>11</orderType>
       <logisticsCode>YTO</logisticsCode>
       <itemAmount>50</itemAmount>
       <freight>33</freight>
       <totalAmount>6</totalAmount>
       <saleDate>2015-06-06 12:20:33</saleDate>
       <deliveryPlanTime>2015-06-07 12:20:33</deliveryPlanTime>
       <payment>0</payment>
       <insuranceValue>0</insuranceValue>
       <shopName>测试店铺</shopName>
       <communitySyncCode>10001</communitySyncCode>
       <buyerNick>测试买家</buyerNick>
       <tradeId>102665646</tradeId>
       <sourcePlatformCode>TB</sourcePlatformCode>
       <remark>备注</remark>
       <country>国家</country>
       <dropoffType>2</dropoffType>
       <serviceType>2</serviceType>
       <packagingType>2</packagingType>
       <isPrintInvoice>0</isPrintInvoice>
       <receiver>
        <name>张三</name>
        <zipCode>600000</zipCode>
        <phone>0731-7920XXX</phone>
        <mobilePhone>13749XXXXXX</mobilePhone>
        <province>上海</province>
        <city>上海市</city>
        <county>宝山区</county>
        <address>纪薀路588号智力产业园3号楼北楼</address>
        <address2>上海市宝山区纪薀路588号智力产业园3号楼北楼</address2>
       </receiver>
       <sender>
        <senderName>张三</senderName>
        <senderMobile>0731-7920XXX</senderMobile>
        <senderPhone>13749XXXXXX</senderPhone>
       </sender>
       <items>
        <item>
         <barCode>TEST1</barCode>
         <itemName>测试商品</itemName>
         <price>25</price>
         <quantity>2</quantity>
        </item>
        <item>
         <barCode>TEST2</barCode>
         <itemName>测试商品2</itemName>
         <price>18</price>
         <quantity>3</quantity>
        </item>
       </items>
      </order>
       <order>
       ......
       </order>
     </orders>
</request>

响应示例

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

错误码解释

错误码 错误描述 解决方案
B01004 发网不存在商品 检测提示商品,是否同步到发网
B01005 仓库编号不存在或未启用 检测仓库编号是否正确
B01006 会员不存在或未启用 检测会员号是否正确
B01007 订单号重复 请检查订单号,是否已经存在
B01008 商品重复出现 1个订单中不能出现2条一样的商品记录;请合并处理。
B01099 执行异常,请稍后重试! 稍后重试!重试3次还是报错,联系发网技术。

API工具

FAQ