目录
3.1 获取业务单据信息
3.1.1 接口说明
3.1.2 业务请求参数
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
交易类型 |
tranType |
String(20) |
是 |
MR_SER_ORDER_QUERY |
见 4.2 交易类型 |
|
请求流水号 |
reqSn |
String(64) |
是 |
163603444305383017 |
每一次发起请求的唯一标识 |
|
收银宝商户号 |
chanMerchantNo |
String(64) |
否 |
55258405311QVDU |
终端配置的收银宝商户号 |
|
交易时间 |
tranTime |
String(32) |
是 |
yyyyMMddHHmmss |
|
|
应用号 |
applicationId |
String(64) |
是 |
|
|
|
门店ID |
deptId |
String(20) |
否 |
|
|
|
签名类型 |
signType |
String(16) |
是 |
RSA |
|
|
签名 |
sign |
String(512) |
是 |
1054c65op927b558e7 2158b8957cf3ab |
参数签名值 |
|
版本号 |
version |
String(4) |
是 |
1.0 |
|
|
顾客姓名 |
customerName |
String(64) |
否 |
顾客姓名、证件、手机号、单据号、销售di至少有一项输入 | |
|
顾客证件号 |
customerNo |
String(64) | 否 | 顾客姓名、证件、手机号、单据号、销售di至少有一项输入 | |
|
顾客手机号 |
customerPhone |
String(64) | 否 | 顾客姓名、证件、手机号、单据号、销售di至少有一项输入 | |
|
服务单据号 |
serviceOrderNo |
String(64) | 否 | 顾客姓名、证件、手机号、单据号、销售di至少有一项输入 | 业务场景单据号，客户ERP系统中唯一 |
|
销售id |
salesId |
String(64) | 否 | 顾客姓名、证件、手机号、单据号、销售di至少有一项输入 |
3.1.3 业务响应参数
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
响应码 |
respCode |
String(4) |
是 |
|
4.1 系统响应码 |
|
响应信息 |
respMsg |
String(128) |
是 |
|
响应信息，错误时返回错误描述，成功时返回以下字段信息 |
|
请求流水号 |
reqSn |
String(64) |
是 |
163603444305383017 |
每一次发起请求的唯一标识 |
|
收银宝商户号 |
chanMerchantNo |
String(64) |
否 |
55258405311QVDU |
终端配置的收银宝商户号 |
|
签名类型 |
signType |
String(16) |
是 |
RSA |
|
|
签名 |
sign |
String(512) |
是 |
1054c65op927b558e7 2158b8957cf3ab |
参数签名值 |
|
应用号 |
applicationId |
String(64) |
是 |
|
|
|
门店ID |
deptId |
String(20) |
否 |
320490168570261504 |
|
|
订单列表 |
orderList |
JSONARRAY |
是 |
|
|
|
备注 |
remark |
String（256） |
否 |
|
备注信息 |
orderList：
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
单据号 |
serviceOrderNo |
String(64) |
否 |
|
|
|
单据名称 |
serviceOrderName |
String(64) |
否 |
|
|
|
单据类型 |
serviceOrderType |
String(64) |
否 |
|
|
|
单据状态 |
serviceOrderStatus |
String(64) |
否 |
|
|
|
单据状态描述 |
serviceOrderStatusMsg |
String(64) |
否 |
|
|
|
销售员ID |
salesId |
String(64) |
否 |
|
|
|
销售名称 |
salesName |
String(64) |
否 |
|
|
|
顾客姓名 |
customerName |
String(64) |
否 |
|
|
|
顾客证件号 |
customerNo |
String(64) |
否 |
|
|
|
顾客手机号 |
customerPhone |
String(64) |
否 |
|
|
|
车型 |
vehicleModel |
String(64) |
否 |
|
车型 |
|
车牌号 |
carid |
String(30) |
否 |
|
车牌号 |
|
车架号 |
vehicleid |
String(30) |
否 |
|
车架号 |
|
应付金额 |
totalAmount |
Long(20) |
是 |
|
|
|
已付金额 |
paidAmount |
Long(20) |
是 |
|
|
|
款项信息 |
itemInfoList |
JSONARRAY |
否 |
|
单据上送的所有款项 |
|
支付记录 |
payRecords |
JSONARRAY |
否 |
|
该业务单的已付记录明细表 |
|
单据链接 |
serviceOrderUrl |
String(256) |
否 |
|
可通过此链接直接打开融易车Pro的订单详情页，并进行相应支付（小程序环境支付详情可见附录指引） |
|
备注 |
remark |
String（256） |
否 |
|
备注信息 |
itemInfoList：
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
款项名称 |
itemName |
String(128) |
是 |
|
|
|
款项编号 |
itemNo |
String(32) |
是 |
|
|
|
金额 |
amount |
Long（20） |
是 |
|
单位为分 |
|
应付金额 |
totalAmount |
Long(20) |
是 |
|
|
|
已付金额 |
paidAmount |
Long(20) |
是 |
|
|
|
备注 |
remark |
String(256) |
否 |
|
备注信息 |
payRecords：
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
平台订单号 |
bizOrderNo |
String(64) |
是 |
|
|
|
订单类型 |
orderType
|
String（1） |
是
|
|
|
|
订单支付方式 |
orderPayType |
String（2） |
是 |
|
|
|
交易场景 |
tranScene |
String(2) |
是 |
|
见4.6交易场景 |
|
支付订单号 |
payOrderNo |
String(64) |
否 |
|
|
|
交易金额 |
orderAmount |
Long |
是 |
|
单位分 |
|
手续费 |
fee |
Long |
否 |
|
单位分 |
|
卡号 |
payAcctNo |
String(256) |
否 |
|
微信支付的openid 支付宝平台的user_id 银行卡号则是隐藏的卡号,例如621700****4586 |
|
卡类型 |
acctType |
String(32) |
否 |
|
见4.7账户类型 |
|
渠道流水号 |
paySerNo |
String(64) |
是 |
|
微信/支付宝/云闪付等渠道流水号 |
|
付款人户名 |
payAcctName |
String(256) |
否 |
|
|
|
付款人开户行 |
draweePartyId |
String(256) |
否 |
|
|
|
付款人开户行名称 |
draweePartyName |
String(256) |
否 |
|
|
|
收款人账号 |
payeeAcctNo |
String(256) |
否 |
|
|
|
收款人名称 |
payeeAcctName |
String(256) |
否 |
|
|
|
收款账户开户行 |
payeePartyId |
String(256) |
否 |
|
|
|
收款账户开户行名称 |
payeePartyName |
String(256) |
否 |
|
|
|
交易时间 |
tranTime |
String(32) |
是 |
|
yyyy-MM-dd HH:mm:ss |
|
完成时间 |
completeTime |
String(32) |
是 |
|
yyyy-MM-dd HH:mm:ss |
|
备注 |
remark |
String(256) |
否 |
|
备注 |
3.2 管理业务单据
3.2.1 接口说明
该接口用于前端创建以及修改融易车Pro单据
3.2.2 业务请求参数
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
交易类型 |
tranType |
String(20) |
是 |
MR_WOREKORDER_CREATE |
见 4.2 交易类型 |
|
请求流水号 |
reqSn |
String(64) |
是 |
163603444305383017 |
每一次发起请求的唯一标识 |
|
收银宝商户号 |
chanMerchantNo |
String(64) |
否 |
55258405311QVDU |
终端配置的收银宝商户号 |
|
交易时间 |
tranTime |
String(32) |
是 |
yyyyMMddHHmmss |
|
|
应用号 |
applicationId |
String(64) |
是 |
|
|
|
门店ID |
deptId |
String(20) |
是 |
|
|
|
签名类型 |
signType |
String(16) |
是 |
RSA |
|
|
签名 |
sign |
String(512) |
是 |
1054c65op927b558e7 2158b8957cf3ab |
参数签名值 |
|
版本号 |
version |
String(4) |
是 |
1.0 |
|
|
业务批次号 |
orderBatchNo |
String(64) |
否 |
|
|
|
操作类型 |
oprType |
String(1) |
是 |
|
A-新增 U-更新（目前仅作用于未产生过支付记录的单据） D-关闭 S-启用 |
|
单据订单列表 |
orderList |
JSONARRAY |
是 |
|
|
|
备注 |
remark |
String(256) |
否 |
|
备注 |
orderList：
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
单据号 |
serviceOrderNo |
String(64) |
否 |
|
|
|
单据名称 |
serviceOrderName |
String(64) |
否 |
|
|
|
单据类型 |
serviceOrderType |
String(64) |
否 |
|
|
|
单据状态 |
serviceOrderStatus |
String(64) |
否 |
|
|
|
单据状态描述 |
serviceOrderStatusMsg |
String(64) |
否 |
|
|
|
销售员ID |
salesId |
String(64) |
否 |
|
|
|
销售名称 |
salesName |
String(64) |
否 |
|
|
|
顾客姓名 |
customerName |
String(64) |
否 |
|
|
|
顾客证件号 |
customerNo |
String(64) |
否 |
|
|
|
顾客手机号 |
customerPhone |
String(64) |
否 |
|
|
|
车型 |
vehicleModel |
String(64) |
否 |
|
|
|
车牌号 |
carid |
String(30) |
否 |
|
车牌号 |
|
车架号 |
vehicleid |
String(30) |
否 |
|
车架号 |
|
应付金额 |
totalAmount |
Long(20) |
是 |
|
|
|
已付金额 |
paidAmount |
Long(20) |
否 |
|
|
|
款项信息 |
itemInfoList |
JSONARRAY |
否 |
|
单据上送的所有款项 |
|
备注 |
remark |
String（256） |
否 |
|
备注信息 |
itemInfoList：
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
款项名称 |
itemName |
String(128) |
是 |
|
|
|
款项编号 |
itemNo |
String(32) |
是 |
|
|
|
金额 |
amount |
Long（20） |
是 |
|
单位为分 |
|
备注 |
remark |
String(256) |
否 |
|
备注信息 |
3.2.3 业务响应参数
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
响应码 |
respCode |
String(4) |
是 |
|
4.1 系统响应码 |
|
响应信息 |
respMsg |
String(128) |
是 |
|
响应信息，错误时返回错误描述，成功时返回以下字段信息 |
|
请求流水号 |
reqSn |
String(64) |
是 |
163603444305383017 |
每一次发起请求的唯一标识 |
|
收银宝商户号 |
chanMerchantNo |
String(64) |
否 |
55258405311QVDU |
终端配置的收银宝商户号 |
|
签名类型 |
signType |
String(16) |
是 |
RSA |
|
|
签名 |
sign |
String(512) |
是 |
1054c65op927b558e7 2158b8957cf3ab |
参数签名值 |
|
应用号 |
applicationId |
String(64) |
是 |
|
|
|
门店ID |
deptId |
String(20) |
是 |
320490168570261504 |
|
|
单据订单列表 |
orderList |
JSONARRAY |
是 |
|
|
|
备注 |
remark |
String（256） |
否 |
|
备注信息 |
orderList：
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
单据号 |
serviceOrderNo |
String(64) |
是 |
|
|
|
销售员ID |
salesId |
String(64) |
否 |
销售员ID |
salesId |
|
销售名称 |
salesName |
String(64) |
否 |
销售名称 |
salesName |
|
顾客姓名 |
customerName |
String(64) |
否 |
顾客姓名 |
customerName |
|
顾客证件号 |
customerNo |
String(64) |
否 |
顾客证件号 |
customerNo |
|
顾客手机号 |
customerPhone |
String(64) |
否 |
顾客手机号 |
customerPhone |
|
车型 |
vehicleModel |
String(64) |
否 |
车型 |
vehicleModel |
|
车牌号 |
carid |
String(30) |
否 |
|
|
|
车架号 |
vehicleid |
String(30) |
否 |
|
|
|
单据链接 |
serviceOrderUrl |
String(256) |
否 |
|
可通过此链接直接打开融易车Pro的订单详情页，并进行相应支付（小程序环境支付详情可见附录指引） |
3.3 业务单据支付结果通知
3.3.1 接口说明
该接口为融易车Pro对外部系统请求通知
3.3.2 业务请求参数
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
交易类型 |
tranType |
String(20) |
是 |
MR_ORDER_NOTIFY |
见 4.2 交易类型 |
|
请求流水号 |
reqSn |
String(64) |
是 |
163603444305383017 |
每一次发起请求的唯一标识 |
|
收银宝商户号 |
chanMerchantNo |
String(64) |
否 |
55258405311QVDU |
终端配置的收银宝商户号 |
|
交易时间 |
tranTime |
String(32) |
是 |
yyyyMMddHHmmss |
|
|
应用号 |
applicationId |
String(64) |
是 |
|
|
|
门店ID |
deptId |
String(20) |
是 |
|
|
|
签名类型 |
signType |
String(16) |
是 |
RSA |
|
|
签名 |
sign |
String(512) |
是 |
1054c65op927b558e7 2158b8957cf3ab |
参数签名值 |
|
版本号 |
version |
String(4) |
是 |
1.0 |
|
|
单据号 |
serviceOrderNo |
String(64) |
否 |
|
|
|
平台订单号 |
bizOrderNo |
String(64) |
是 |
|
|
|
订单类型 |
orderType
|
String（1） |
是
|
|
|
|
订单支付方式 |
orderPayType |
String（2） |
是 |
|
|
|
交易场景 |
tranScene |
String(2) |
是 |
|
见4.6交易场景 |
|
支付订单号 |
payOrderNo |
String(64) |
否 |
|
|
|
业务退款号 |
cusOrderNo |
String(64) |
否 |
|
|
|
订单状态 |
orderStatus |
String(32) |
是 |
|
|
|
交易金额 |
orderAmount |
Long |
是 |
|
单位分 |
|
手续费 |
fee |
Long |
否 |
|
单位分 |
|
卡号 |
payAcctNo |
String(256) |
否 |
|
微信支付的openid 支付宝平台的user_id 银行卡号则是隐藏的卡号,例如621700****4586 |
|
卡类型 |
acctType |
String(32) |
否 |
|
见4.7账户类型 |
|
真实流水号 |
paySerNo |
String(64) |
是 |
|
微信/支付宝/云闪付/转账等渠道流水号 |
|
付款人户名 |
payAcctName |
String(256) |
否 |
|
|
|
付款人开户行 |
draweePartyId |
String(256) |
否 |
|
|
|
付款人开户行名称 |
draweePartyName |
String(256) |
否 |
|
|
|
收款人账号 |
payeeAcctNo |
String(256) |
否 |
|
|
|
收款人名称 |
payeeAcctName |
String(256) |
否 |
|
|
|
收款账户开户行 |
payeePartyId |
String(256) |
否 |
|
|
|
收款账户开户行名称 |
payeePartyName |
String(256) |
否 |
|
|
|
完成时间 |
completeTime |
String(32) |
是 |
|
yyyy-MM-dd HH:mm:ss |
|
备注 |
remark |
String(256) |
否 |
|
备注 |
3.3.3 业务响应参数
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
响应码 |
respCode |
String(4) |
是 |
|
4.1 系统响应码 |
|
响应信息 |
respMsg |
String(128) |
是 |
|
响应信息，错误时返回错误描述，成功时返回以下字段信息 |
|
请求流水号 |
reqSn |
String(64) |
是 |
163603444305383017 |
每一次发起请求的唯一标识 |
|
收银宝商户号 |
chanMerchantNo |
String(64) |
否 |
55258405311QVDU |
终端配置的收银宝商户号 |
|
签名类型 |
signType |
String(16) |
是 |
RSA |
|
|
签名 |
sign |
String(512) |
是 |
1054c65op927b558e7 2158b8957cf3ab |
参数签名值 |
|
应用号 |
applicationId |
String(64) |
是 |
|
|
|
门店ID |
deptId |
String(20) |
是 |
320490168570261504 |
3.4 对账文件下载
3.4.1 接口说明
3.4.2 业务请求参数
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
交易类型 |
tranType |
String(20) |
是 |
MR_ORDER_TRANSFILEDL |
见 4.2 交易类型 |
|
请求流水号 |
reqSn |
String(64) |
是 |
163603444305383017 |
每一次发起请求的唯一标识 |
|
收银宝商户号 |
chanMerchantNo |
String(64) |
否 |
55258405311QVDU |
终端配置的收银宝商户号 |
|
交易时间 |
tranTime |
String(32) |
是 |
yyyyMMddHHmmss |
|
|
应用号 |
applicationId |
String(64) |
是 |
|
|
|
门店ID |
deptId |
String(20) |
否 |
|
传值取单门店对账文件 |
|
签名类型 |
signType |
String(16) |
是 |
RSA |
|
|
签名 |
sign |
String(512) |
是 |
1054c65op927b558e7 2158b8957cf3ab |
参数签名值 |
|
版本号 |
version |
String(4) |
是 |
1.0 |
|
|
文件日期 |
fileDate |
String(32) |
是 |
|
yyyy-MM-dd |
|
备注 |
remark |
String(256) |
否 |
|
备注 |
3.4.3 业务响应参数
|
参数名称 |
参数 |
长度 |
必填 |
示例 |
备注 |
|
响应码 |
respCode |
String(4) |
是 |
|
4.1 系统响应码 |
|
响应信息 |
respMsg |
String(128) |
是 |
|
响应信息，错误时返回错误描述，成功时返回以下字段信息 |
|
请求流水号 |
reqSn |
String(64) |
是 |
163603444305383017 |
每一次发起请求的唯一标识 |
|
收银宝商户号 |
chanMerchantNo |
String(64) |
否 |
55258405311QVDU |
终端配置的收银宝商户号 |
|
签名类型 |
signType |
String(16) |
是 |
RSA |
|
|
签名 |
sign |
String(512) |
是 |
1054c65op927b558e7 2158b8957cf3ab |
参数签名值 |
|
应用号 |
applicationId |
String(64) |
是 |
|
|
|
门店ID |
deptId |
String(20) |
否 |
320490168570261504 |
|
|
文件下载地址 |
fileDownloadUrl |
String(256) |
是 |
|
|
|
备注 |
remark |
String(256) |
否 |
|
备注 |
3.5 退款提交申请
3.5.1 接口说明
该接口用于前端提交融易车Pro的支付流水退款申请，实际退款结果参考3.3接口。
具体参数请联系行业发展事业部。