获取账单列表

  • 接口(建议后缀): /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]
consumeAmount BigDecimal Y 账单非服务费总金额 [7] (待废弃)
serviceAmount BigDecimal N 账单总服务费金额 [7] (待废弃)
extraServiceAmount BigDecimal N 账单总额外服务费金额 [7] (待废弃)
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)

results matching ""

    No results matching ""