月结账单

月结账单列表查询

接口URL

/napi/enterprise/account/bill/list

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
msgId	消息id	Y	string	128		企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode	企业编码	Y	string	50
entSettleAccountCodeList	企业结算账户编码列表	N	`List<String>`		["1000"]	用于企业集成时按结算账户过滤数据，使用前需要先在结算平台维护好“结算账户编码”信息，不传默认按租户级别返回所有数据
billCycle	账期	Y	String	10	202111	仅支持查询一年内账期数据
billStatus	账单状态	Y	String	20	WAIT_CONFIRM	WAIT_CONFIRM:待确认 CONFIRMED:已确认 PARTIAL_APPLY:部分申请 APPLIED：已申请
pageIndex	起始页码	Y	Integer		1	最小值1
pageSize	每页记录数	Y	Integer		20	建议20，上限200

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
resultCode	返回码	Y	string	0	0表示成功，其他值为失败
description	描述	Y	string	操作成功	描述信息，出错时为错误信息即错误原因。
data	响应数据	Y	BillPage

BillPage

参数名	参数说明	必填	参数类型	长度	备注
pageIndex	起始页码	Y	Integer	1
pageSize	每页记录数	Y	Integer	100
totalSize	总记录数	Y	Long	350
totalPages	总页数	Y	Integer	350
billList	客户账单列表	Y	List<BillInfoVo>		没有数据返回空列表

BillInfoVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
billNo	账单编号	Y	String	50	TRA20240625RH9X3
billName	账单名称	Y	String	200
billStatus	账单状态	Y	String	20
bizType	业务类型	Y	String	50		AIR：机票 TRAIN：火车票 CAR：用车 HOTEL：酒店
billCycle	账期	Y	String	10	202111
totalCount	账单合计明细数量	Y	Integer
totalAmount	账单合计金额	Y	BigDecimal	20,2		单位：元。保留两位小数
currency	币种	Y	String	10
providerId	服务商ID	Y	String	32
providerName	服务商名称	Y	String	100
settleAccountName	结算账户名称	Y	String	100

样例

请求示例：

{
  "entSettleAccountCodeList": [
    "3F69EE"
  ],
  "billCycle": "202410",
  "billStatus": "WAIT_CONFIRM",
  "pageIndex": 1,
  "pageSize": 20,
  "corpCode": "WELINK_B049D9F896BA4760A928AB2A549",
  "msgId": "3F69EE120241119124511AC5QS"
}

响应示例：

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "pageSize": 20,
    "pageIndex": 1,
    "totalSize": 1,
    "totalPages": 1,
    "billList": [
      {
        "billNo": "CAR20241130NDNEI",
        "billName": "南京意博结算账户202411",
        "billStatus": "WAIT_CONFIRM",
        "bizType": "CAR",
        "billCycle": "202410",
        "totalCount": 7,
        "totalAmount": 286.37,
        "currency": "CNY",
        "providerId": "ITRAVEL",
        "providerName": "慧通差旅",
        "settleAccountName": "南京意博结算账户"
      }
    ]
  }
}

月结账单机票明细查询

接口URL

napi/enterprise/account/bill/air/detail

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
msgId	消息id	Y	String	128		企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode	企业编码	Y	String	10	1000
billNo	账单编号	Y	String	50	TRA20240625RH9X3
pageIndex	起始页码	Y	Integer		1	最小值1
pageSize	每页记录数	Y	Integer		20	建议20，上限200

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
resultCode	返回码	Y	String	0	0表示成功，其他值为失败
description	描述	Y	String	操作成功	描述信息，出错时为错误信息即错误原因
data	响应数据	Y	AirBillPage

AirBillPage

参数名	参数说明	必填	参数类型	长度	备注
pageIndex	起始页码	Y	Integer	1
pageSize	每页记录数	Y	Integer	20
totalSize	总记录数	Y	Long	350
totalPages	总页数	Y	Integer	350
airDetailList	机票明细列表	Y	List<AirBillDetailVo>		没有数据返回空列表

AirBillDetailVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
enterpriseName	企业名称	Y	String	200	XXXX公司
bizScope	业务范围	Y	String	20	DOMESTIC	DOMESTIC 国内 INTERNATIONAL 国际
subBizType	交易类型	Y	String	20	ISSUE	ISSUE：出票 REFUND：退票 CHANGE：改期 INSUR：保险
travelNo	申请单号	N	String	200	TA412011062	慧通申请单号
travelType	出差类型	N	String	32	BUSINESS	因私：PRIVATE 因公：BUSINESS
orderId	订单号	Y	String	32	F118447970
orderLineId	订单行号	Y	String	50
itineraryNo	行程单号	N	String	64	5379631221
invoiceNo	数电发票号	N	String	64	5379631221
ticketNo	票号	Y	String	40	111-9218536547
orderTime	预定时间	Y	String		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
completeTime	出/退/改时间	Y	String		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
departureTime	乘机时间	N	String		20200901185020	航班在所在地的起飞时间格式化字符串 yyyyMMddHHmmss
ticketStatus	票状态	N	String	10	ISSUE	ISSUE：已出票 CHANGED：已改期 REFUNDED：已退票
validTripEndDate	有效行程结束日期	N	String	20	20220808	yyyyMMdd
ticketUseStatus	票使用状态	N	String	10	USED	UNUSED: 未使用 USED: 已使用
airwaysName	航司名称	N	String	200	南方航空, 南方航空	多个英文逗号分隔
flightNo	航班号	N	String	100	MU5151	多个英文逗号分隔
departureCountryName	出发国名称	N	String	100	中国
arrivalCountryName	目的国名称	N	String	100	中国
intercontinentalType	航段洲际类型	N	String	10	INTER	INTER：洲际 INSIDE：洲内
fullTrip	全航程	N	String	200	广州-南京,南京-北京	多个英文逗号分隔
cabinLevel	舱等	N	String	200	FIRST	FIRST: 头等舱 BUSINESS: 商务舱 ECONOMY: 经济舱 PREMIUM_ECONOMY：高端经济舱多个英文逗号分隔
cabin	舱位	N	String	50	Z	多个英文逗号分隔
discount	舱位折扣	N	String	20	37
orderSource	预订方式	N	String	50	Android	Android：安卓客户端 IOS：IOS Backend：PC后台 Front：PC前台 H5：H5/小程序 harmony：鸿蒙 OpenAPI：OpenAPI Welink：Welink PNRImport：PNR导入
customerAgreementPrice	是否客户协议价	N	String	10	Y	Y：是 N：否
changeReason	改期原因	N	String	2000
refundReason	退票原因	N	String	2000
feeEntityName	费用实体名称	N	String	100
feeEntityCode	费用实体编码	N	String	100
feeDetail	机票费用明细	N	AirFeeDetail
trInfo	TR信息	N	TrInfo
bookerInfo	预订人信息	N	BookerInfo
travelerInfo	出行人信息	N	TravelerInfo
benefitInfo	受益信息	N	BenefitInfo

AirFeeDetail

参数名	参数说明	必填	参数类型	长度	值举例	备注
productPrice	票价	Y	decimal	20,2		单位：元，保留两位小数
airportTax	民航基金	Y	decimal	20,2		单位：元，保留两位小数
fuelFee	燃油附加费	Y	decimal	20,2		单位：元，保留两位小数
insuranceFee	保险金额	Y	decimal	20,2		单位：元，保留两位小数
supplementTax	补税手续费	Y	decimal	20,2		单位：元，保留两位小数
commissionFee	退改手续费	Y	decimal	20,2		单位：元，保留两位小数
serviceFee	服务费	Y	decimal	20,2		单位：元，保留两位小数
interTax	国际税费	Y	decimal	20,2		单位：元，保留两位小数
settlementFee	结算金额	Y	decimal	20,2		单位：元，保留两位小数
currency	币种	Y	string	10	CNY	默认CNY

样例

请求示例：

{
  "billNo": "AIR20241128A1M1C",
  "pageIndex": 1,
  "pageSize": 20,
  "corpCode": "WELINK_B049D9F896BA4760A928AB2A549FBB59",
  "msgId": "3F69EE120241119124511AC5QS"
}

响应示例：

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "pageSize": 20,
    "pageIndex": 1,
    "totalSize": 1,
    "totalPages": 1,
    "airDetailList": [
      {
        "feeEntityName": "南京意博软件有限公司",
        "feeEntityCode": "E0104173",
        "trInfo": {
          "travelNo": "TAFG12106523",
          "enterpriseTravelNo": "TAFG12106523",
          "travelPurpose": "斜杠/客户拜访",
          "trStatus": "APPROVED",
          "trStartDate": "20241119",
          "trEndDate": "20250204",
          "trCloseTime": "20250204",
          "trCreaterName": "吴**",
          "trCreaterStaffINo": "wwx1****1966",
          "trCreaterMobile": "188****4932",
          "trCreaterDeptName": "测试组",
          "extendInfo": null
        },
        "bookerInfo": {
          "bookerMemberId": "ID01230**51320944",
          "bookerName": "吴**",
          "bookerStaffNo": "wx1**1966",
          "bookerDeptCode": "TEST01",
          "bookerDeptName": "测试组",
          "bookerFullDept": "解决方案部|-|研发部，xxx专用部门"
        },
        "benefitInfo": {
          "benefitType": "COST_CENTER",
          "projectCode": null,
          "projectName": null,
          "deptCode": "TEST01",
          "deptName": "测试组",
          "costCenterCode": "20230926",
          "costCenterName": "测试组",
          "proportion": 100.00,
          "extendInfo": "{\"projectCode\": null, \"projectName\": null, \"costcenterCode\": \"20230926\", \"costcenterName\": \"测试组\", \"departmentCode\": \"TEST01\", \"departmentName\": \"测试组\"}"
        },
        "bizScope": "DOMESTIC",
        "orderLineId": "F1100332930",
        "travelerInfo": {
          "travelerMemberId": "ID01230***391262",
          "travelerName": "金*",
          "travelerStaffNo": "127***697",
          "travelerDeptCode": "",
          "travelerDeptName": "测试一部",
          "travelerStandard": null,
          "travelerCurrency": null,
          "travelerExchangeRate": null
        },
        "enterpriseName": "南京意博软件有限公司",
        "subBizType": "ISSUE",
        "travelNo": "TAFG12106523",
        "travelType": null,
        "orderId": "F1100332930",
        "itineraryNo": "241123268370",
        "invoiceNo": "241123268370",
        "ticketNo": "010-2411417251",
        "orderTime": "20241119164644",
        "completeTime": "20241119164654",
        "departureTime": "20241210091600",
        "ticketStatus": "REFUNDED",
        "validTripEndDate": "20241119",
        "ticketUseStatus": "UNUSED",
        "airwaysName": "长龙航空",
        "flightNo": "GJ3032",
        "departureCountryName": "中国",
        "arrivalCountryName": "中国",
        "intercontinentalType": "INSIDE",
        "fullTrip": "杭州-深圳",
        "cabinLevel": "BUSINESS",
        "cabin": "X",
        "discount": "34.00",
        "orderSource": "H5",
        "customerAgreementPrice": "N",
        "changeReason": "(自愿)误机或出行计划变更",
        "refundReason": "(自愿)放弃行程",
        "feeDetail": {
          "productPrice": 1480.00,
          "airportTax": 50.00,
          "fuelFee": 0.00,
          "insuranceFee": 0.00,
          "supplementTax": 0.00,
          "commissionFee": 0.00,
          "serviceFee": 45.90,
          "interTax": 0.00,
          "settlementFee": 1575.90,
          "currency": "CNY"
        }
      }
    ]
  }
}

月结账单酒店明细查询

接口URL

napi/enterprise/account/bill/hotel/detail

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
msgId	消息id	Y	String	128		企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode	企业编码	Y	String	10	1000
billNo	账单编号	Y	String	50	TRA20240625RH9X3
pageIndex	起始页码	Y	Integer		1	最小值1
pageSize	每页记录数	Y	Integer		20	建议20，上限200

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
resultCode	返回码	Y	String	0	0表示成功，其他值为失败
description	描述	Y	String	操作成功	描述信息，出错时为错误信息即错误原因
data	响应数据	Y	HotelBillPage

HotelBillPage

参数名	参数说明	必填	参数类型	长度	备注
pageIndex	起始页码	Y	Integer	1
pageSize	每页记录数	Y	Integer	100
totalSize	总记录数	Y	Long	350
totalPages	总页数	Y	Integer	350
hotelDetailList	酒店明细列表	Y	List<HotelBillDetailVo>		没有数据返回空列表

HotelBillDetailVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
enterpriseName	企业名称	Y	String	200	XXXX公司
bizScope	业务范围	Y	String	20	DOMESTIC	DOMESTIC 国内 INTERNATIONAL 国际
travelNo	申请单号	N	String	200	TA412011062	慧通申请单号
travelType	出差类型	N	String	32	BUSINESS	因私：PRIVATE 因公：BUSINESS
orderId	订单号	Y	String	32	H0124101609563240156
orderLineId	订单行号	Y	String	50
recheckOrderId	复核单号	N	String	32	ARH0124060514514933225-4
orderTime	预定时间	Y	String		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
cancelStatus	订单取消状态	N	String	20	CANCELLED	CANCELLED：已取消 NOT_CANCELLED：未取消
countryName	国家中文名	N	string	200	中国
cityName	城市	N	String	64	松原
hotelName	酒店名称	N	String	200	深圳长安大酒店
roomTypeName	房型	N	String	200	商务大床房
hotelSource	酒店资源来源	N	String	100	客户直签
checkinDate	入住日期	N	String		20220101	yyyyMMdd
checkoutDate	退房日期	N	String		20220102	yyyyMMdd
invoiceingMethod	发票提供方式	N	String	100	PLATFORM	PLATFORM：平台开票 HOTEL：酒店开票
bookerCheckinDate	预定入住日期	N	String		20200101	yyyyMMdd
bookerCheckoutDate	预定退房日期	N	String		20220102	yyyyMMdd
guaranteeFlag	是否担保	N	String	2	Y	Y:是 N:否
recheckRoomNight	复核间夜	N	BigDecimal	10,2	2.00
roomNight	结算间夜	N	BigDecimal	10,2	2.00
feeEntityName	费用实体名称	N	String	100
feeEntityCode	费用实体编码	N	String	100
feeDetail	酒店费用明细	N	HotelFeeDetail
trInfo	TR信息	N	TrInfo
bookerInfo	预订人信息	N	BookerInfo
travelerInfoList	入住人信息列表	Y	List<TravelerInfo>
benefitInfo	受益信息	N	BenefitInfo

HotelFeeDetail

参数名	参数说明	必填	参数类型	长度	值举例	备注
roomPrice	房费	Y	decimal	20,2		单位：元，保留两位小数
unitPrice	单价	N	BigDecimal	20,2	10.00	单位：元，保留两位小数
supplementTax	补税手续费	Y	decimal	20,2		单位：元，保留两位小数
serviceFee	服务费	Y	decimal	20,2		单位：元，保留两位小数
serviceSupplementTax	服务费补税手续费	Y	decimal	20,2		单位：元，保留两位小数
settlementFee	结算金额	Y	decimal	20,2		单位：元，保留两位小数
currency	币种	Y	String	10	CNY	默认CNY

样例

请求示例：

{
  "billNo": "HOT20241017WQXT2",
  "pageIndex": 1,
  "pageSize": 20,
  "corpCode": "WELINK_B049D9F896BA4760A928AB2A549FBB59",
  "msgId": "3F69EE120241119124511AC5QS"
}

响应示例：

{
  "feeEntityName": "test002费用实体",
  "feeEntityCode": "test002",
  "trInfo": {
    "travelNo": "TAFG12103705",
    "enterpriseTravelNo": "TAFG12103705",
    "travelPurpose": "册数",
    "trStatus": "CLOSE",
    "trStartDate": "20241001",
    "trEndDate": "20241231",
    "trCloseTime": "20241108001506",
    "trCreaterName": "周**",
    "trCreaterStaffINo": "12***96",
    "trCreaterMobile": "137****7777",
    "trCreaterDeptName": "中H测试部",
    "extendInfo": null
  },
  "bookerInfo": {
    "bookerMemberId": "ID012******01298",
    "bookerName": "周蓉蓉",
    "bookerStaffNo": "12***96",
    "bookerDeptCode": "CNNC02",
    "bookerDeptName": "中H测试部",
    "bookerFullDept": ""
  },
  "benefitInfo": {
    "benefitType": "COST_CENTER",
    "projectCode": null,
    "projectName": null,
    "deptCode": "CNNC02",
    "deptName": "中H测试部",
    "costCenterCode": "031321-32132130",
    "costCenterName": "中H测试",
    "proportion": 100.00,
    "extendInfo": "{\"projectCode\": null, \"projectName\": null, \"costcenterCode\": \"031321-32132130\", \"costcenterName\": \"中H测试\", \"departmentCode\": \"CNNC02\", \"departmentName\": \"中H测试部\"}"
  },
  "bizScope": "DOMESTIC",
  "orderLineId": "H0124110716373049558",
  "enterpriseName": "中H测试部",
  "travelNo": "TAFG12103705",
  "travelType": null,
  "orderId": "H0124110716373049558",
  "recheckOrderId": "ARH0124110716373049558-1",
  "orderTime": "20241107163731",
  "cancelStatus": null,
  "countryName": "中国",
  "cityName": "南京",
  "hotelName": "南京索菲特银河大酒店",
  "roomTypeName": "高级大床房",
  "hotelSource": "代签",
  "checkinDate": "20241122",
  "checkoutDate": "20241123",
  "invoiceingMethod": "PLATFORM",
  "bookerCheckinDate": "20241122",
  "bookerCheckoutDate": "20241123",
  "guaranteeFlag": "N",
  "recheckRoomNight": 1.00,
  "roomNight": 1.00,
  "feeDetail": {
    "roomPrice": 0.01,
    "unitPrice": 0.01,
    "supplementTax": 0.00,
    "serviceFee": 20.00,
    "serviceSupplementTax": 0.00,
    "settlementFee": 20.01,
    "currency": "CNY"
  },
  "travelerInfoList": [
    {
      "travelerMemberId": "ID0123********1298",
      "travelerName": "周**",
      "travelerStaffNo": "12***96",
      "travelerDeptCode": "CNNC02",
      "travelerDeptName": "中H测试部",
      "travelerStandard": "-1",
      "travelerCurrency": "CNY",
      "travelerExchangeRate": "1.000000000000000000"
    }
  ]
}

月结账单用车明细查询

接口URL

napi/enterprise/account/bill/car/detail

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
msgId	消息id	Y	String	128		企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode	企业编码	Y	String	10	1000
billNo	账单编号	Y	String	50	TRA20240625RH9X3
pageIndex	起始页码	Y	Integer		1	最小值1
pageSize	每页记录数	Y	Integer		20	建议20，上限200

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
resultCode	返回码	Y	String	0	0表示成功，其他值为失败
description	描述	Y	String	操作成功	描述信息，出错时为错误信息即错误原因
data	响应数据	Y	CarBillPage

CarBillPage

参数名	参数说明	必填	参数类型	长度	备注
pageIndex	起始页码	Y	Integer	1
pageSize	每页记录数	Y	Integer	100
totalSize	总记录数	Y	Long	350
totalPages	总页数	Y	Integer	350
carDetailList	用车明细列表	Y	List<CarBillDetailVo>		没有数据返回空列表

CarBillDetailVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
enterpriseName	企业名称	Y	String	200	XXXX公司
bizScope	业务范围	Y	String	20	DOMESTIC	DOMESTIC 国内 INTERNATIONAL 国际
travelNo	申请单号	N	String	200	TA412011062	慧通申请单号
travelType	出差类型	N	String	32	BUSINESS	因私：PRIVATE 因公：BUSINESS
orderId	订单号	Y	String	32	U1100110690
orderLineId	订单行号	Y	String	50
carUseScene	用车场景	N	String	32	COMMON	PERSONAL:个人用车 COMMON:普通打车 OVERTIME:加班打车 BUSINESS_TRIP:业务用车
carUseType	用车类型	N	String	32	NORMAL	NORMAL: 普通打车 AIRPORT_PICKUP: 接机 AIRPORT_DROP_OFF: 送机
rideType	运力类型	N	String	32	BUSINESS	ECONOMY:经济型 COMFORTABLE:舒适型 BUSINESS:商务型 LUXURY:豪华型 TAXI:出租车
orderTime	预定时间	Y	String		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
transactionTime	交易时间	N	String		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
departTime	出发时间	N	String		20200901185020	用车出发时间格式化字符串 yyyyMMddHHmmss
arrivalTime	到达时间	N	String		20200901185020	用车到达时间格式化字符串 yyyyMMddHHmmss
departAddress	出发地	N	String	500	出发地
arrivalAddress	目的地	N	String	500	目的地
supplierChannel	供应商渠道	N	String	64
departCityName	出发城市	N	String	100	南京
arrivalCityName	到达城市	N	String	100	深圳
feeEntityName	费用实体名称	N	String	100
feeEntityCode	费用实体编码	N	String	100
feeDetail	用车费用明细	N	CarFeeDetail
trInfo	TR信息	N	TrInfo
bookerInfo	预订人信息	N	BookerInfo
travelerInfo	出行人信息	N	TravelerInfo
benefitInfo	受益信息	N	BenefitInfo

CarFeeDetail

参数名	参数说明	必填	参数类型	长度	值举例	备注
productPrice	订单金额	Y	Decimal	20,2		单位：元，保留两位小数
supplementTax	补税手续费	Y	Decimal	20,2		单位：元，保留两位小数
serviceFee	服务费	Y	Decimal	20,2		单位：元，保留两位小数
settlementFee	结算金额	Y	Decimal	20,2		单位：元，保留两位小数
currency	币种	Y	String	10	CNY	默认CNY

样例

请求示例：

{
  "billNo": "CAR202411217VFMX",
  "pageIndex": 1,
  "pageSize": 20,
  "corpCode": "WELINK_B049D9F896BA4760A928AB2A549FBB59",
  "msgId": "3F69EE120241119124511AC5QS"
}

响应示例：

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "pageSize": 20,
    "pageIndex": 1,
    "totalSize": 1,
    "totalPages": 1,
    "carDetailList": [
      {
        "feeEntityName": "南京意博软件有限公司",
        "feeEntityCode": "E0104173",
        "trInfo": {
          "travelNo": "TAFG12090580",
          "enterpriseTravelNo": "TAFG12090580",
          "travelPurpose": "客户拜访",
          "trStatus": "APPROVED",
          "trStartDate": "20240926",
          "trEndDate": "20241130",
          "trCloseTime": null,
          "trCreaterName": "张**",
          "trCreaterStaffINo": null,
          "trCreaterMobile": "139****3016",
          "trCreaterDeptName": "测试一部",
          "extendInfo": null
        },
        "bookerInfo": {
          "bookerMemberId": "ID012405111017506949",
          "bookerName": "杨**",
          "bookerStaffNo": "wx13**1862",
          "bookerDeptCode": null,
          "bookerDeptName": "测试部6",
          "bookerFullDept": "，南京意博软件有限公司，中核测试部"
        },
        "benefitInfo": {
          "benefitType": "COST_CENTER",
          "projectCode": null,
          "projectName": null,
          "deptCode": "",
          "deptName": "测试一部",
          "costCenterCode": "灵雀替换测试",
          "costCenterName": "灵雀替换测试",
          "proportion": 100.00,
          "extendInfo": "{\"projectCode\": null, \"projectName\": null, \"costcenterCode\": \"灵雀替换测试\", \"costcenterName\": \"灵雀替换测试\", \"departmentCode\": \"\", \"departmentName\": \"测试一部\"}"
        },
        "bizScope": "DOMESTIC",
        "orderLineId": "U1100023200",
        "travelerInfo": {
          "travelerMemberId": "ID012405***17506949",
          "travelerName": "杨**",
          "travelerStaffNo": "wx1***862",
          "travelerDeptCode": null,
          "travelerDeptName": "测试部6",
          "travelerStandard": null,
          "travelerCurrency": null,
          "travelerExchangeRate": null
        },
        "enterpriseName": "南京意博软件有限公司",
        "travelNo": "TAFG12090580",
        "travelType": null,
        "orderId": "U1100110690",
        "carUseScene": "BUSINESS_TRIP",
        "carUseType": "NORMAL",
        "rideType": "ECONOMY",
        "orderTime": "20241126140337",
        "transactionTime": "20241126140356",
        "departTime": "20241126140355",
        "arrivalTime": "20241126150355",
        "departAddress": "北京",
        "arrivalAddress": "北京",
        "supplierChannel": "曹操出行",
        "departCityName": "北京",
        "arrivalCityName": "北京",
        "feeDetail": {
          "productPrice": 100.00,
          "supplementTax": 10.00,
          "serviceFee": 20.00,
          "settlementFee": 130.00,
          "currency": "CNY"
        }
      }
    ]
  }
}

月结账单火车明细查询

接口URL

napi/enterprise/account/bill/train/detail

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
msgId	消息id	Y	String	128		企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode	企业编码	Y	String	10	1000
billNo	账单编号	Y	String	50	TRA20240625RH9X3
pageIndex	起始页码	Y	Integer		1	最小值1
pageSize	每页记录数	Y	Integer		20	建议20，上限200

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
resultCode	返回码	Y	String	0	0表示成功，其他值为失败
description	描述	Y	String	操作成功	描述信息，出错时为错误信息即错误原因
data	响应数据	Y	TrainBillPage

TrainBillPage

参数名	参数说明	必填	参数类型	长度	备注
pageIndex	起始页码	Y	Integer	1
pageSize	每页记录数	Y	Integer	100
totalSize	总记录数	Y	Long	350
totalPages	总页数	Y	Integer	350
trainDetailList	火车账单明细列表	Y	List<TrainBillDetailVo>		没有数据返回空列表

TrainBillDetailVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
enterpriseName	企业名称	Y	String	200	XXXX公司
bizScope	业务范围	Y	String	20	DOMESTIC	DOMESTIC 国内 INTERNATIONAL 国际
subBizType	交易类型	Y	String	20	ISSUE	ISSUE：出票 REFUND：退票 CHANGE：改期 INSUR：保险
travelNo	申请单号	N	String	200	TA412011062	慧通申请单号
travelType	出差类型	N	String	32	BUSINESS	因私：PRIVATE 因公：BUSINESS
orderId	订单号	Y	String	32	T0124101514393850276
orderLineId	订单行号	Y	String	50
ticketId	客票ID	Y	String	40
electronicOrderId	电子票号	N	String	32	SL20407244
orderTime	预定时间	Y	String		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
completeDate	出/退/改票时间	Y	String		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
supplierChannel	供应商渠道	N	String	64	12306
trainNo	车次	N	String	40	Z271
seatNo	座位号	N	string	64	3车14号
departDate	乘车时间	N	String		20200901185020	实际乘车时间格式化字符串yyyyMMddHHmmss
ticketStatus	票状态	N	String	10	CHANGED	ISSUE : 已出票 CHANGED: 已改期 REFUNDED 已退票
validTripEndDate	有效行程结束日期	N	String		20200901	yyyyMMdd
showPrice	票面价	N	BigDecimal	20,2	88.88	单位：元保留两位小数
seatType	席别	N	String	50	硬座
departStation	出发车站	N	String	50	南京
arrivalStation	到达车站	N	String	50	上海
tripType	中转标识	N	String	20	SINGLE	SINGLE：单程 ROUND：往返 MULTI：联程 TRANSFER：中转 DIRECT：直达
supplierInvoiceType	供应商发票类型	N	String	32	DIGITAL_INVOICE	DIGITAL_INVOICE:电子发票 PAPER_INVOICE:纸质发票
feeEntityName	费用实体名称	N	String	100
feeEntityCode	费用实体编码	N	String	100
feeDetail	火车费用明细	N	TrainFeeDetail
trInfo	TR信息	N	TrInfo
bookerInfo	预订人信息	N	BookerInfo
travelerInfo	出行人信息	N	TravelerInfo
benefitInfo	受益信息	N	BenefitInfo

TrainFeeDetail

参数名	参数说明	必填	参数类型	长度	值举例	备注
productPrice	票价	Y	decimal	20,2		单位：元，保留两位小数
commissionFee	退票手续费	Y	decimal	20,2		单位：元，保留两位小数
resignFee	改签费	Y	decimal	20,2		单位：元，保留两位小数
insuranceFee	保险	Y	decimal	20,2		单位：元，保留两位小数
serviceFee	服务费	Y	decimal	20,2		单位：元，保留两位小数
settlementFee	结算金额	Y	decimal	20,2		单位：元，保留两位小数
currency	币种	Y	String	10	CNY	默认CNY

样例

请求示例：

{
  "billNo": "TRA20241017ST6LO",
  "pageIndex": 1,
  "pageSize": 20,
  "corpCode": "WELINK_B049D9F896BA4760A928AB2A549FBB59",
  "msgId": "3F69EE120241119124511AC5QS"
}

响应示例：

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "pageSize": 20,
    "pageIndex": 1,
    "totalSize": 1,
    "totalPages": 1,
    "trainDetailList": [
      {
        "feeEntityName": "结算标识名称01",
        "feeEntityCode": "test_lam",
        "trInfo": {
          "travelNo": "TAFG12106672",
          "enterpriseTravelNo": "TAFG12106672",
          "travelPurpose": "客户拜访",
          "trStatus": "APPROVED",
          "trStartDate": "20241120",
          "trEndDate": "20241122",
          "trCloseTime": null,
          "trCreaterName": "李**",
          "trCreaterStaffINo": "300***117",
          "trCreaterMobile": "176****2613",
          "trCreaterDeptName": "南京意博软件有限公司",
          "extendInfo": null
        },
        "bookerInfo": {
          "bookerMemberId": "ID01240717***7467626",
          "bookerName": "李**",
          "bookerStaffNo": "300***117",
          "bookerDeptCode": "0",
          "bookerDeptName": "南京意博软件有限公司",
          "bookerFullDept": "南京意博软件有限公司"
        },
        "benefitInfo": {
          "benefitType": "COST_CENTER",
          "projectCode": null,
          "projectName": null,
          "deptCode": "0",
          "deptName": "南京意博软件有限公司",
          "costCenterCode": "546356345",
          "costCenterName": "成本中心测试-南京意博",
          "proportion": 100.00,
          "extendInfo": "{\"projectCode\": null, \"projectName\": null, \"costcenterCode\": \"546356345\", \"costcenterName\": \"成本中心测试-南京意博\", \"departmentCode\": \"0\", \"departmentName\": \"南京意博软件有限公司\"}"
        },
        "bizScope": "DOMESTIC",
        "orderLineId": "TB2024112216392333584",
        "travelerInfo": {
          "travelerMemberId": "ID012407***37467626",
          "travelerName": "李**",
          "travelerStaffNo": "300***17",
          "travelerDeptCode": null,
          "travelerDeptName": "南京意博软件有限公司",
          "travelerStandard": null,
          "travelerCurrency": null,
          "travelerExchangeRate": null
        },
        "enterpriseName": "南京意博软件有限公司",
        "subBizType": "ISSUE",
        "travelNo": "TAFG12106672",
        "travelType": null,
        "orderId": "T0124112216392313233",
        "ticketId": "TKT2024112216392331289",
        "electronicOrderId": "SL70117039",
        "orderTime": "20241024163923",
        "completeDate": "20241122163927",
        "supplierChannel": "12306",
        "trainNo": "T282",
        "seatNo": "3车15号硬座",
        "departDate": "20241124191500",
        "ticketStatus": "ISSUE",
        "validTripEndDate": "20241122",
        "showPrice": 177.50,
        "seatType": "硬座",
        "departStation": "上海南",
        "arrivalStation": "北京西",
        "tripType": "DIRECT",
        "supplierInvoiceType": "PAPER_INVOICE",
        "feeDetail": {
          "productPrice": 177.50,
          "commissionFee": 0.00,
          "resignFee": 0.00,
          "insuranceFee": 0.00,
          "serviceFee": 0.00,
          "settlementFee": 177.50,
          "currency": "CNY"
        }
      }
    ]
  }
}

通用结构定义

预订人信息

BookerInfo

参数名	参数说明	必填	参数类型	长度	值举例
bookerMemberId	预订人memberId	N	String	200
bookerName	预订人姓名	N	String	255	程XX
bookerStaffNo	预订人工号	N	String	50	01234567
bookerDeptCode	预订人部门编码	N	String	200	3000006
bookerDeptName	预订人部门名称	N	String	500	信息管理本部
bookerFullDept	预订人全部门	N	String	2000	本部-信息管理本部

出行人信息

TravelerInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
travelerMemberId	出行人memberId	N	String	200
travelerName	出行人姓名	N	String	255	程XX
travelerStaffNo	出行人工号	N	String	50	01234567
travelerDeptCode	出行人部门编码	N	String	200	信息管理本部
travelerDeptName	出行人部门名称	N	String	500	信息管理本部
travelerStandard	入住人差标	N	String	32		仅酒店业务涉及
travelerCurrency	差标币种	N	String	20		仅酒店业务涉及
travelerExchangeRate	差标汇率	N	String	32		仅酒店业务涉及

TR信息

TrInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
travelNo	申请单号	N	String	200	TA412011062	慧通申请单号
enterpriseTravelNo	企业申请单号	N	String	200	TA412011062	企业客户系统申请单号
travelPurpose	出差目的	N	String	2000	客户拜访
trStatus	审批状态	N	String	10
trStartDate	出差开始日期	N	String		20200901	yyyyMMdd
trEndDate	出差结束日期	N	String		20200901	yyyyMMdd
trCloseTime	申请单关闭日期	N	String		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
trCreaterName	申请人姓名	N	String	100	程XX
trCreaterStaffINo	申请人工号	N	String	50	01234567
trCreaterMobile	申请人手机号	N	String	50
trCreaterDeptName	申请人部门名称	N	String	500
extendInfo	Tr扩展信息	N	String	5000

受益信息

BenefitInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
benefitType	受益类型	N	String	10	DEPARTMENT	COST_CENTER：成本中心 PROJECT：受益项目 DEPARTMENT：部门
projectCode	受益项目编码	N	String	100	9000000
projectName	受益项目名称	N	String	2000	信息管理本部
deptCode	受益部门编码	N	String	100	9000000
deptName	受益部门	N	String	2000	信息管理本部
costCenterCode	成本中心编码	N	String	100	9000000
costCenterName	成本中心名称	N	String	2000	信息管理本部
proportion	分摊比率	N	BigDecimal	16,2	100.00
extendInfo	受益扩展属性	N	String	5000

月结账单

# 月结账单

# 月结账单列表查询

# 接口URL

# 请求参数定义

# 响应参数定义

# BillPage

# BillInfoVo

# 样例

# 月结账单机票明细查询

# 接口URL

# 请求参数定义

# 响应参数定义

# AirBillPage

# AirBillDetailVo

# AirFeeDetail

# 样例

# 月结账单酒店明细查询

# 接口URL

# 请求参数定义

# 响应参数定义

# HotelBillPage

# HotelBillDetailVo

# HotelFeeDetail

# 样例

# 月结账单用车明细查询

# 接口URL

# 请求参数定义

# 响应参数定义

# CarBillPage

# CarBillDetailVo

# CarFeeDetail

# 样例

# 月结账单火车明细查询

# 接口URL

# 请求参数定义

# 响应参数定义

# TrainBillPage

# TrainBillDetailVo

# TrainFeeDetail

# 样例

# 通用结构定义

# 预订人信息

# BookerInfo

# 出行人信息

# TravelerInfo

# TR信息

# TrInfo

# 受益信息

# BenefitInfo

月结账单

月结账单列表查询

接口URL

请求参数定义

响应参数定义

BillPage

BillInfoVo

样例

月结账单机票明细查询

接口URL

请求参数定义

响应参数定义

AirBillPage

AirBillDetailVo

AirFeeDetail

样例

月结账单酒店明细查询

接口URL

请求参数定义

响应参数定义

HotelBillPage

HotelBillDetailVo

HotelFeeDetail

样例

月结账单用车明细查询

接口URL

请求参数定义

响应参数定义

CarBillPage

CarBillDetailVo

CarFeeDetail

样例

月结账单火车明细查询

接口URL

请求参数定义

响应参数定义

TrainBillPage

TrainBillDetailVo

TrainFeeDetail

样例

通用结构定义

预订人信息

BookerInfo

出行人信息

TravelerInfo

TR信息

TrInfo

受益信息

BenefitInfo