招行商务卡流水导入
- 接口：/bankcard/import/data
- Method：POST
- 数据格式：JSON
请求参数
| 参数 | 类型 | 必须 | 默认值 | 描述 |
|---|---|---|---|---|
| bankCode | string | Y | - | 银行编号 |
| transactionFileName | string | Y | - | 交易文件名称，xxx.txt |
| billList | List<BankCardConsumptionBillDto> | Y | - | 消费流水列表 |
备注
- 公司开通第三方服务——招行商务卡，并提供招行对应的CompanyId
- 定时使用招商银行的客户端获取某一天消费流水
BankCardConsumptionBillDto 结构
该结构对应招行数据文件中的字段。
| 参数 | 类型 | 必须 | 默认值 | 主键 | 描述 |
|---|---|---|---|---|---|
| accountName | string | N | 账户号 | ||
| cardNo | string | Y | 卡号 | ||
| cardholderName | string | N | 持卡人姓名 | ||
| cardholderNameEn | string | N | 持卡人英文姓名 | ||
| employeeId | string | N | 员工编号 | ||
| transactionDescription | string | Y | 交易摘要 | ||
| transactionDate | string | Y | 交易日期 | ||
| postedDate | string | N | 记帐日期 | ||
| countryCode | string | N | 交易地点（国别） | ||
| cityCode | string | N | 交易城市 | ||
| originalCcyCode | string | N | 交易币种 | ||
| originalAmount | BigDecimal | N | 交易金额 | ||
| postedCcyCode | string | N | 入帐币种(人民币) | ||
| postedAmount | BigDecimal | Y | 入帐金额（人民币），作为消费金额导入费用列表 | ||
| ccyExchangeDate | string | N | 外币折算日 | ||
| merchantCategoryCode | string | N | 商户类别代码 | ||
| authorizationCode | string | N | 授权号 | ||
| acquiringSeqNo | string | Y | 收单顺序号 |
如果从银行拿到的流水无 acquiringSeqNo 值（如建设银行），则由客户方自行生成唯一值，需保证重复导入文件时，该笔流水的acquiringSeqNo的值保持不变。建议使用 {transactionDate}_{index}以保证唯一。
示例
请求数据
{
"timestamp": 123456,
"data": [
{
"bankCode": "cmb", --国内
"transactionFileName": "9900000001_20120530.txt",
"billList": [
{
"accountName": "01021XXXXXX001",
"cardNo": "479XXXXXXXXXX706",
"cardholderName": "张XX",
"cardholderNameEn": "ZHANG XX",
"employeeId": "17760",
"transactionDescription": "苏州工业园区XXX酒家",
"transactionDate": "20111201",
"postedDate": "20111202",
"countryCode": "CHN",
"cityCode": "3102",
"originalCcyCode": "156",
"originalAmount": "000000000311.00",
"postedCcyCode": "156",
"postedAmount": "000000000311.00",
"ccyExchangeDate": "20111202",
"merchantCategoryCode": "5812",
"authorizationCode": "706315",
"acquiringSeqNo": "99990XXXXXXXXXX5678910"
},
{
"accountName": "01018XXXXXXXX001", --国外
"cardNo": "4792XXXXXXXXX926",
"cardholderName": "孙X",
"cardholderNameEn": "SUN X",
"employeeId": "17760",
"transactionDescription": "CHINA XXX KITCHEN 汇率 6.3771",
"transactionDate": "20111204",
"postedDate": "20111207",
"countryCode": "NLD",
"originalCcyCode": "978",
"originalAmount": "000000000013.00",
"postedCcyCode": "156",
"postedAmount": "000000000113.45",
"ccyExchangeDate": "20111207",
"merchantCategoryCode": "5812",
"authorizationCode": "554742",
"acquiringSeqNo": "0008436808XXXXXXXX8910"
}
]
}
]
}
返回数据(成功）
{
"code": "ACK",
"message": ""
}