在途商旅
  1. 账单
在途商旅
  • 关于本文档
  • API调用指南
    • API列表
    • 接入流程
    • 接口通用说明
    • 通用错误码
  • 服务端接口
    • 一、鉴权管理
      • 1、接口鉴权
        • a、获取token
      • 2、单点登录
        • a、目标页概述
        • b、单点登录
    • 二、企业信息
      • 1、概述
      • 2、组织单位
        • a、概述
        • b、常见问题
        • c、场景说明
        • d、组织同步
        • f、负责人同步
      • 3、员工信息
        • 概述
        • 场景说明
        • 常见问题
        • 手机号国家编码表
        • 员工同步
        • 员工直属主管同步
        • 员工常住地同步
        • 获取职级列表
        • 获取证件类型
        • 员工信息查询
      • 4、成本中心
        • 概述
        • 常见问题
        • 场景说明
        • 成本中心(部门所属)
        • 成本中心(员工所属)
      • 5、项目
        • 概述
        • 常见问题
        • 场景说明
        • 项目同步
      • 6、法人
        • 概述
        • 常见问题
        • 法人同步
    • 三、业务数据
      • 1.出行前
        • 概述
        • 差旅申请
          • 申请单同步
          • 申请单变更前校验
          • 取消申请单提前验证
          • 申请单状态变更
          • 获取申请单
          • 获取申请单使用状态
          • 获取申请单出行概况
          • 获取差旅类型
          • 获取费用类型
      • 2.出行中
        • 订单
          • 客票状态
          • 订单查询(全量)
          • 订单查询(分页)
          • 订单确认-V1
          • 订单确认-V2
      • 3.出行后
        • 账单
          • 获取账单主信息
            GET
          • 分页获取账单主信息
            GET
          • 获取账单订单明细
            GET
          • 账单中疑异订单通知
            POST
          • 确认账单通知
            POST
        • 票据
          • 订单开票信息
          • 个付电子发票查询
          • OCR票据查询
          • 订单数电票
      • 4.工作流
        • 查询审批记录
        • 审批结束通知
        • 审批记录同步
    • 四、事件订阅
      • 1、概述
      • 2、事件列表
      • 3、数据推送
      • 4、示例代码
      • 5、需求单服务类型
      • 8、openapi-sdk
      • 6、事件订阅接口
        • a、订阅事件
        • b、删除订阅
        • c、查询订阅
    • 五、通用数据
      • 国家编码对照表
      • 获取城市列表(废弃)
      • 获取城市列表V2
    • 六、其他
      • 补贴查询
      • 自定义补贴场景明细同步
  1. 账单

获取账单主信息

测试环境
https://openapi-uat.z-trip.cn
测试环境
https://openapi-uat.z-trip.cn
GET
/tmc/v1/bill/info
功能描述:根据 账单号 或 账单时间 生成时间获取账单主信息

请求参数

Query 参数
partnerCode
string 
企业编码
必需
示例值:
hyxd
billCode
string 
账单编号
可选
示例值:
eIB7XiKXTVCBGRCuiQ65AQ
liqDateBegin
string 
可选
账单开始时间 YYYY-MM-DD
示例值:
2021-05-01
liqDateEnd
string 
可选
账单结束时间 YYYY-MM-DD
示例值:
2021-05-21
billCategory
string 
可选
账单分类:订单类 GENERAL(默认), 积分类 POINTS 退款类 REFUND
示例值:
GENERAL
access_token
string 
可选
示例值:
{{openApiToken}}

返回响应

🟢200成功
application/json
Body
error
string 
必需
data
array [object {27}] 
必需
accountId
integer 
账户ID
可选
accountName
string 
所属账户名称
可选
adjustAmount
number 
调整项金额
可选
billAmount
number 
账单金额 = 订单金额+调整项金额
可选
billCategory
string 
账单分类
可选
订单类 GENERAL, 积分类 POINTS 退款类 REFUND
billStatisticItems
array [object {9}] 
账单分类统计明细
可选
code
string 
账单编码,唯一编码
可选
createTime
string 
创建时间
可选
id
integer 
账单id
可选
invoiceAmount
integer 
未开票金额
可选
liqDateBegin
string 
结算期间开始时间: "2020-07-01 12:33:33"
可选
liqDateEnd
string 
结算期间结束时间: "2020-07-01 12:33:33"
可选
liquidationStatus
string 
清账状态
可选
OPEN-未清账完成,CLOSE-已清账完成
orderAmount
integer 
订单金额
可选
orderIdList
array [object {1}] 
账单包含订单号集合
可选
billAdjitems
array [object {5}] 
调整项
可选
调整项明细信息列表
billInvoiceInfos
array [object {13}] 
开票信息列表
可选
overdueTime
string 
账单逾期日期
可选
liqConfirmTime
string 
账单确认时间
可选
partnerCode
string 
企业code
可选
partnerName
string 
企业名称
可选
remainAmount
number 
未清账金额
可选
status
string 
账单状态
可选
1.
CANCEL作废、 DRAFT 草稿、 NOT_CONFIRM 待确认、CONFIRM 已确认
invoiceStatus
string 
确认开票信息状态
可选
1.
待确认开票信息:WAIT_CONFIRM
2.
已确认开票信息:CONFIRM_INVOICE
tmcCode
string 
tmc编码
可选
tmcName
string 
tmc名称
可选
updateTime
string 
账单更新时间: "2020-07-01 12:33:33"
可选
error_description
string 
必需
示例
{
  "error": "0",
  "data": [
    {
      "accountId": 28,
      "accountName": "yangyy结算账户1",
      "adjustAmount": 0,
      "billAmount": 14421,
      "billCategory": "GENERAL",
      "billInvoiceInfos": [],
      "billStatisticItems": [
        {
          "amount": 40,
          "corpCode": "yangyy111111111111",
          "corpName": "yangyy-uat测试专用法人",
          "costName": "yangyy-uat测试专用",
          "serviceChargeAmount": 0,
          "statisticBizType": "INSURANCE",
          "tmcCode": "yangyy001",
          "tmcName": "yangyy-uatTMC测试专用"
        },
        {
          "amount": 2,
          "corpCode": "yangyy111111111111",
          "corpName": "yangyy-uat测试专用法人",
          "costName": "研发部",
          "costUnitCode": "",
          "serviceChargeAmount": 0,
          "statisticBizType": "INTL_FLIGHT",
          "tmcCode": "yangyy001",
          "tmcName": "yangyy-uatTMC测试专用"
        },
        {
          "amount": 3,
          "corpCode": "2121289000099999999",
          "corpName": "yangyy-uat测试专用法人5",
          "costName": "",
          "costUnitCode": "",
          "serviceChargeAmount": 0,
          "statisticBizType": "HOTEL",
          "tmcCode": "yangyy001",
          "tmcName": "yangyy-uatTMC测试专用"
        },
        {
          "amount": 1570,
          "corpCode": "2121289000099999999",
          "corpName": "yangyy-uat测试专用法人5",
          "costName": "",
          "costUnitCode": "",
          "serviceChargeAmount": 10,
          "statisticBizType": "FLIGHT",
          "tmcCode": "yangyy001",
          "tmcName": "yangyy-uatTMC测试专用"
        },
        {
          "amount": 1480,
          "corpCode": "yangyy111111111111",
          "corpName": "yangyy-uat测试专用法人",
          "costName": "yangyy-uat测试专用",
          "serviceChargeAmount": 10,
          "statisticBizType": "INTL_FLIGHT",
          "tmcCode": "yangyy001",
          "tmcName": "yangyy-uatTMC测试专用"
        },
        {
          "amount": 1013,
          "corpCode": "yangyy111111111111",
          "corpName": "yangyy-uat测试专用法人",
          "costName": "yangyy-uat测试专用",
          "serviceChargeAmount": 20,
          "statisticBizType": "TRAIN",
          "tmcCode": "yangyy001",
          "tmcName": "yangyy-uatTMC测试专用"
        }
      ],
      "code": "gAhqd0wBTtKt6Su2SmgEEw",
      "createTime": "2023-03-27 15:48:28",
      "id": 211126,
      "invoiceAmount": 0,
      "liqDateBegin": "2023-03-11 00:00:00",
      "liqDateEnd": "2023-03-20 23:59:59",
      "liquidationStatus": "OPEN",
      "orderAmount": 14421,
      "orderIdList": [
        {
          "orderId": "128532256136832"
        },
        {
          "orderId": "118532463853056"
        }
      ],
      "overdueTime": "2023-03-21 00:00:00",
      "partnerCode": "yangyy002",
      "partnerName": "yangyy-uat测试企业",
      "remainAmount": 14421,
      "status": "DRAFT",
      "tmcCode": "yangyy001",
      "tmcName": "yangyy-uatTMC测试专用",
      "updateTime": "2023-03-30 14:35:16"
    }
  ],
  "error_description": "成功"
}
上一页
订单确认-V2
下一页
分页获取账单主信息
Built with