接口地址：https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/trxfile/get
测试地址：https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/trxfile/get
获取下载对账流水文件临时url。
请求参数
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
|
orgid |
机构ID |
实际交易的机构ID |
是 |
11 |
服务商appid调用时必填 |
|
cusid |
商户号 |
实际交易的店铺ID |
否 |
11 |
|
|
version |
版本号 |
接口版本号 |
是 |
2 |
默认填11 |
|
date |
交易日期 |
|
否 |
10 |
格式：yyyy-MM-dd |
|
filetype |
文件类型 |
1-订单流水文件 2-分账流水文件 3-会员及卡券消费结算流水文件 |
否 |
2 |
见文件详细说明 |
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
|
signtype |
签名类型 |
|
是 |
8 |
支持MD5、RSA、SM2，不填默认MD5 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |
响应参数
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
|
|
retmsg |
返回码说明 |
|
是 |
100 |
|
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
|
cusid |
商户号 |
实际交易的店铺ID |
否 |
15 |
|
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
|
orgid |
机构ID |
实际交易的机构ID |
否 |
11 |
|
|
url |
文件下载地址 |
|
否 |
|
|
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |
文件详细说明：
对账文件内容，每一行的记录字段以“,”符号分割，第一行为字段名。
1-订单流水文件：
字段：外部订单号,交易订单号,订单原始金额（分）,不参与优惠抵扣金额（分）,商户活动优惠金额（分）,商户卡券抵扣金额（分）,钱包消费金额（分）,积分抵扣金额（分）,银行活动优惠金额（分）,充值赠送金额（分）,支付方式,用户实际支付金额（分）,交易类型,交易时间,店铺ID,店铺编号,店铺名称,顾客ID,收银宝支付流水号,积分（数量）,终端编号,原交易订单号,备注,手续费（分）
数据：O2021030811213901,63105215619969768296,100.00,0,0,0,0.00,0.00,0,0,现金,100,1,2021-03-08 10:14:43,147,125,星巴克光华店,123,112002680000003001,0,11754687,,示例数据,0
字段说明：
|
字段名称 |
说明 |
|
外部订单号 |
商户订单号 |
|
交易订单号 |
数字营销系统订单号 |
|
订单原始金额 |
订单金额，单位分 |
|
不参与优惠抵扣金额 |
单位分 |
|
商户活动优惠金额 |
单位分 |
|
商户卡券抵扣金额 |
单位分 |
|
钱包消费金额 |
单位分 |
|
积分抵扣金额 |
单位分 |
|
银行活动优惠金额 |
单位分 |
|
充值赠送金额 |
单位分 |
|
支付方式 |
银行卡、微信、支付宝、云闪付、现金、全抵扣 |
|
用户实际支付金额 |
单位分 |
|
交易类型 |
1-消费，2-撤销，3-退款，4-充值 |
|
交易时间 |
格式：yyyy-MM-dd HH:mm:ss |
|
店铺ID |
|
|
店铺编号 |
|
|
店铺名称 |
|
|
顾客ID |
|
|
收银宝支付流水号 |
收银宝支付的流水号 |
|
积分消费数量 |
|
|
终端编号 |
POS编号，码牌号 |
|
原交易订单号 |
退款交易原消费订单号 |
|
备注 |
|
|
手续费 |
单位分 |
2-分账流水文件：
字段：店铺编号,店铺名称,交易订单号,渠道订单号,商户订单号,支付类型,收款金额,手续费,支付时间,终端号,财务科目ID,财务科目名称,备注,店铺ID,顾客实付金额
数据：nc01,No.1店,76251827001620728973,240717122792949626,M2024071715302786271,微信,10.00,0.02,2024-07-17 15:28:43,,125,水费,,1,10.00
字段说明：
|
字段名称 |
说明 |
|
商户号 |
店铺编号、机构ID或抽佣方外部编号 |
|
商户名称 |
店铺名称、机构名称或抽佣方账户名称 |
|
交易订单号 |
数字营销系统订单号 |
|
渠道订单号 |
支付系统订单号 |
|
商户订单号 |
商户订单号 |
|
支付类型 |
银行卡、微信、支付宝、云闪付、现金、全抵扣 |
|
收款金额 |
商户收款金额（在一笔订单中拆分出该商户的收款金额），如反交易为负值，单位元 |
|
手续费 |
反交易为负值，单位元 |
|
支付时间 |
格式：yyyy-MM-dd HH:mm:ss |
|
终端号 |
|
|
财务科目ID |
业务方自定义ID(如果为分账方时，显示收款账务科目） |
|
财务科目名称 |
业务方自定义科目名称 |
|
备注 |
|
|
店铺ID |
店铺ID、机构ID或抽佣方账户ID |
|
顾客实付金额 |
单位元 |
3-会员及卡券消费结算流水文件：
字段：交易流水号,交易店铺ID,交易店铺编号,交易店铺名称,交易时间,交易金额（非计次卡）,交易次数（计次卡）,核销场景,券号,券模板名称,交易类型,结算店铺ID,结算店铺编号,结算店铺名称,结算方式,结算值,本金,手续费费率,应结算金额,手续费,实际结算金额,结算时间,结算单号,结算渠道交易单号,结算状态,结算结果描述
数据：
74446761869593672866,61056535,,批量开通账户测试2,2025-05-08 15:39:23,,1,卡券核销,93710010020000000710,结算计次券2,消费,61056535,,批量开通账户测试2,,,3.00,,0.10,,0.04,2025-05-12 10:41:00,SVC79427106137067080541,,结算成功,
73496761930706372555,61056535,,批量开通账户测试2,2025-05-08 15:40:32,10.00,,卡券核销,93710010000000001034,结算测试0321,消费,61056535,,批量开通账户测试2,,,2.00,,0.10,,0.10,2025-05-12 10:41:00,SVC79427106137067080541,,结算失败,余额不足
字段说明：
|
字段名称 |
说明 |
|
交易流水号 |
|
|
交易店铺ID |
|
|
交易店铺编号 |
|
|
交易店铺名称 |
|
|
交易时间 |
格式yyyy-MM-dd HH:mm:ss |
|
交易金额（非计次卡） |
单位元 |
|
交易次数（计次卡） |
单位次 |
|
核销场景 |
会员余额消费、卡券核销 |
|
券号 |
|
|
券模板名称 |
|
|
交易类型 |
消费、退货 |
|
结算店铺ID |
|
|
结算店铺编号 |
|
|
结算店铺名称 |
|
|
结算方式 |
按比例、按固定金额 |
|
结算值 |
|
|
本金 |
卡券核销时商户上送的本金值，单位元 |
|
手续费费率 |
|
|
应结算金额 |
单位元 |
|
手续费 |
单位元 |
|
实际结算金额 |
单位元 |
|
结算时间 |
格式yyyy-MM-dd HH:mm:ss |
|
结算单号 |
|
|
结算渠道交易单号 |
|
|
结算状态 |
结算成功、结算失败、不结算 |
|
结算结果描述 |
|