客服热线:40010-40088
进入官网

订单新建

接口介绍

用户在线下订单,调用开放平台新增订单接口,将订单信息流转至订单系统。

业务约束

(1)、新增订单成功后,系统默认订单状态为待受理。
(2)、对于返回的异常代码,如果属于系统异常,建议再次发送请求,属于业务异常, 不进行重发。

传入参数信息

    入参 

参数名

参数说明

数据类型

必填

备注

params

Json字符串

String

Json字符串,具体见下面params参数说明

timestamp

时间戳

String

当前时间对应的时间戳

digest

签名摘要

String

base64(MD5(params +code + AppSecret))

code

客户ID

String

客户唯一ID简码大写字母(订单头)

    Params参数说明 

参数名

参数说明

最大长度

类型

必填

备注

orderNo

订单号

64 String

Code+时间戳

sendSiteId

寄件网点ID

8

String

默认-1

dispatchSiteId

派件网点ID

8

String

 

goodsType

商品类别

1

int

默认0

0:文件类

1:电子产品类(包括家用电器)

2:办公用品类, 服装鞋帽,箱包类

3:化妆品  美容产品类

4:珠宝,手表,眼镜,贵重饰品类

5:食品,保健药品类

6:工艺品类(包括瓷器,茶具,烹饪用品)

7:玩具乐器类

8:其他类

goodsName

商品名称

100

String

 

piece

商品数量

5

int

 

remark

商品描述

500

String

 

totalPiece

总件数

6

Int

默认为0

totalWeight

重量

10

double

 

totalVol

体积

8

double

 

paySideId

付款方ID

8

Int

默认为0

payModeId

支付模式ID

8

int

103到付现金104月结102现金109返款到付110回单付

freightCharge1

网上运费单价

6

double

默认为0

freightCharge

网上运费价格

6

double

默认为0

insuredAmount

保价金额

6

double

 

codCharge

代收货款

6

double

 

ecWarehouseId

电商仓库ID

8

long

 

receiveFlag

上门接货类型(1,需要上门接货0,客户自送)

1

int

 

smsFlag

短信通知

1

int

(0-否 1-是)

serviceType

服务类型(1-正常, 2-次日达 4-次晨达 8-当日达)

2

int

 

packageFlag

是否打包

1

int

(0-否  1-是)

packageDesc

包装说明

100

String

 

ewbFlag

开单标识

1

int

(0-未开  1-已开)

receiveEmployeeId

收件业务员

8

int

 

sendCompanyName

寄件公司名称

100

String

没有公司名则填人名

sendLinkMan

寄件联系人

100

String

 

sendPhoneSms

寄件手机

20

String

 

sendPhone

寄件联系电话

32

String

 

sendAddress

寄件地址

256

String

 

sendPostcode

寄件邮编

6

String

 

sendProvince

寄件省份

32

String

 

sendCity

寄件城市

32

String

 

sendCounty

寄件区县

32

String

 

sendStartTime

客户约定取货开始时间

20

String

yyyy-MM-dd HH:mm:ss

sendEndTime

客户约定取货结束时间

20

String

yyyy-MM-dd HH:mm:ss

dispatchCompanyName

收件公司名称

100

String

没有公司名则填人名

dispatchLinkMan

收件联系人

100

String

 

dispatchPhoneSms

收件手机

20

String

 

dispatchPhone

收件联系电话

32

String

 

dispatchAddress

收件地址

256

String

 

dispatchPostcode

收件邮编

6

String

 

dispatchProvince

收件省份

32

String

 

dispatchCity

收件城市

32

String

 

dispatchCounty

收件区县

32

String

 

dispatchStartTime

客户约定送达开始时间(13:20)

20

String

yyyy-MM-dd HH:mm:ss

dispatchEndTime

客户约定送达结束时间(14:20)

20

String

yyyy-MM-dd HH:mm:ss

coupon

优惠券

20

String

 

returnTime

返款时效

20

String

代收货款为必传字段

returnTarget

返款对象

1

int

1-返款客户;2-返款网点代(收货款为必传字段)

subOrdeId

采购单号

 

String

 

memberType

CXT: 诚信通;PT:普通会员;POW:实力商家

 

String

 

serviceDipFlag

天猫服务类型

 

int

 

reservationFixDate

预约时间

 

date

 

reservationFixDate

预约完成时间

 

date

 

fixFinDate

安装完成时间

 

date

 

goodCharge

商品費用

 

double

 

请求报文示例

参数params值示例:

{

    "logisticNo": null,

    "sendSiteId": null,

    "dispatchSiteId": null,

    "orderStatus": null,

    "totalPiece": null,

    "totalWeight": null,

    "totalVol": null,

    "paySideId": null,

    "payModeId": null,

    "freightCharge1": null,

    "freightCharge": null,

    "insuredAmount": null,

    "codCharge": null,

    "ecWarehouseId": null,

    "receiveFlag": null,

    "smsFlag": null,

    "serviceType": null,

    "packageFlag": null,

    "packageDesc": null,

    "ewbFlag": null,

    "receiveEmployeeId": null,

    "sendCompanyName": "xxx",

    "sendLinkMan": "测试1",

    "sendPhoneSms": "00000000",

    "sendPhone": null,

    "sendAddress": "上海市安能物流",

    "sendPostcode": null,

    "sendProvince": "上海",

    "sendCity": "上海",

    "sendCounty": "青浦",

    "sendStartTime": null,

    "sendEndTime": null,

    "dispatchCompanyName": "安能物流",

    "dispatchLinkMan": "测试2",

    "dispatchPhoneSms": "11111111",

    "dispatchPhone": null,

    "dispatchAddress": "杭州萧山安能物流",

    "dispatchPostcode": null,

    "dispatchProvince": "浙江",

    "dispatchCity": "杭州",

    "dispatchCounty": "萧山",

    "dispatchStartTime": null,

    "dispatchEndTime": null,

    "createdTime": null,

    "modifiedBy": null,

    "modifiedTime": null,

    "rdStatus": null,

    "coupon": null,

    "ordStatusVO": null,

    "goodsType": null,

    "goodsName": null,

    "piece": null,

    "remark": null,

    "goodsOrder": null,

    "bankName": "丞风银行",

    "subBankName": "丞风银行亚洲分行",

    "accountCode": "6532658987",

    "accountName": "xp",

    "orderCanceId": null,

    "ordStatusList": null

}

返回参数信息
    出参(公共):

序号

参数名

参数说明

数据类型

是否必填

备注

1

result

返回结果

boolean

成功:true;失败:false

2

resultCode

返回码

String

见码表说明

3

resultInfo

返回信息

String

 

4

reason

原因

String

 

返回报文示例

成功返回数据的结构示例:

{"result":true,"resultCode":"1000","resultInfo":"成功获取","reason":"成功获取"}

失败返回数据的结构示例:

{"result":false,"resultCode":"2002","resultInfo":"摘要验证失败","reason":"摘要验证错误"}