3.5.1外部订单同步

字段名

参数类型

必填

最大长度

说明

取值

reqOrderNo

String

是

64

外部订单号

transTime

String

是

19

交易时间

时间格式:yyyy-dd-MM HH:mm:ss

shopId

String

否

11

店铺ID

shopCode

String

否

20

店铺号

与shopId功能相同，shopId和shopCode同时输入则只取shopId,二者必输一个

customerId

Integer

否

11

会员ID

数字营销系统会员编号

openId

String

否

180

用户openid

与customerId功能相同，customerId和openId同时传则只取customerId。只传openid未查询到顾客信息则创建新用户

mobile

String

否

11

会员手机号

与customerId功能相同，customerId和mobile同时传则取customerId顾客信息。传了mobile，未查询到顾客信息则注册会员，已查询到非会员顾客信息的绑定手机号

amount

String

是

14

订单金额

单位:元

excludeDiscountAmount

String

否

14

不参与优惠金额

单位:元

cash

String

否

14

现金金额

单位:元

score

Integer

否

11

支持多少积分

scoreAmount

String

否

14

积分支付金额

单位:元

balanceAmount

String

否

14

余额支付金额

单位:元

cashierUserSysno

Integer

否

11

收银员编号

orderRemark

String

否

200

订单备注

tradeType

Integer

是

4

交易类型

1消费 2充值 3停车缴费

discountList

ArrayList

否

用券信息

promotionId

Integer

否

11

活动ID

使用活动优惠时必填

couponId

Integer

否

11

卡券ID

使用券时二选一必填

couponNo

Integer

否

32

卡券编号

amount

String

否

14

优惠金额

单位:元，使用非计次券时必填

count

Integer

否

11

优惠次数

使用计次券时必填

paymentInfoList

ArrayList

否

支付信息

paymentMethod

Integer

是

4

支付方式

0-POS扫码支付 1-POS刷卡支付 2-线上支付 4-现金支付

paymentAmount

String

是

14

支付金额

单位:元

paymentFrom

Integer

是

4

支付来源

0-微信支付

1-支付宝支付

2-QQ支付

3-银联支付

4-银行卡支付

5-现金支付

bankName

String

否

100

发卡行名称

bankAcctNo

String

否

30

银行卡号/账户

bankAcctName

String

否

20

银行卡姓名

bankAcctType

String

否

2

银行卡类型

00-借记卡，02-准贷记卡/贷记卡

voucherNo

String

否

30

凭证号

transReferenceNo

String

否

30

交易参考号

字段名

参数类型

必填

最大长度

说明

取值

code

Integer

是

4

返回码

0：表示成功；

3：表示失败，具体失败原因参见msg字段；

其他：参见4.1 公共返回码

msg

String

是

200

错误信息

data

reqOrderNo

String

是

64

外部订单号

orderCode

String

是

40

数字营销订单号

scores

Integer

否

11

赠送积分

benefitsQrcodeUrl

String

否

不限

领券二维码

couponList

否

赠送卡券信息

couponName

String

是

50

券名称

quantity

Integer

是

11

券数量