获取账单列表
- 接口(建议后缀): /reconciliation/list
- Method:POST
- 数据格式: Json
- 调用方: 每刻
- 接口说明: 每刻将通过该接口拿取第三方对账单,对账接口的调用是由企业对账人在界面上发起的,并且随时可以删除账单并发起重新调用获取相同的账单,以便第三方进行账单调整。
请求参数
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
externalCorpCode | String | Y | 企业唯一标识 |
startDate | String | Y | 账单开始时间(yyyy-MM-dd) [1] |
endDate | String | Y | 账单结束时间(yyyy-MM-dd) [1] |
billAccount | String | N | 第三方约定的拆账单规则唯一标识 [2] |
subsidiaryCode | String | N | 账单所属子公司 |
departmentCode | String | N | 账单所属部门 |
costCenterCode | String | N | 成本中心编码 |
originalAppCode | String | N | 实际供应商(TMC) |
businessScope | BusinessScope | N | 业务类型 [3] |
pageNo | int | Y | 第几页(从第1页开始) |
pageSize | int | Y | 每页容量(最大为 100) |
[info] 说明:
[1] 开始时间和结束时间表示的是出账日的时间,举个例子,第三方与企业约定的出账日是每月的 3号出上个月整月的账单,则对账人可以选上月的 15号作为开始时间,本月的 15号作为结束时间,因为本月 3号包含在对账人选的时间范围内,可以返回,采用这种方式的好处在于,可以避免第三方与企业约定的账期不是自然月,可能是自然周,或者是约定好的日期,这样只需要知道每月几号或者每周几号出账单就行
[2] 如果企业有复杂拆账单需求,例如需要将某几个子公司或者某几个部门合并到一张账单中统一对帐,billAccount 就是由第三方定义的描述这种账单拆分规则的唯一标识
[3] 业务类型用于企业有需求按照业务类型分账单,第三方支持这个请求参数可以获取到企业这次对帐需要的业务类型
BusinessScope
code | 定义 |
---|---|
FLIGHT | 机票 |
HOTEL | 酒店 |
TRAIN | 火车 |
CAR | 用车 |
返回结构
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
success | bool | Y | 请求是否成功 |
errorMessage | String | N | 失败信息(当 success 为 false 时,失败信息为必填) |
data | List<Recon> | Y | 账单列表 |
hasNextPage | bool | N | 是否有下一页 |
Recon
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
externalCorpCode | String | Y | 企业唯一标识 |
billCode | String | Y | 账单唯一标识 |
originalAppCode | String | N | 实际供应商(TMC) |
amount | BigDecimal | Y | 账单总金额 [4] |
BigDecimal | |||
currency | String | Y | 账单币种 |
startDate | String | Y | 账单开始时间(yyyy-MM-dd) |
endDate | String | Y | 账单结束时间(yyyy-MM-dd) |
comment | String | N | 备注 |
[info] 说明:
[4] amount = sum(所有明细的CORP_PAY_FEE)
[5] consumeAmount=amount-serviceAmount-extraServiceAmount
[6] serviceAmount = sum (所有明细SERVICE_AMOUNT)
[7] extraServiceAmount=sum (所有明细EXTRA_SERVICE_AMOUNT)