个人账单

个人账单列表查询

接口URL

/napi/enterprise/account/personalbill/list

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
msgId	消息id	Y	string	128		企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode	企业编码	Y	string	50
travelNo	申请单号	Y	string	200	TA412011062	慧通申请单号

响应参数定义

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

PersonalBillData

参数名	参数说明	必填	参数类型	长度	值举例	备注
personalBillList	个人账单列表	Y	List<PersonalBillInfo>

PersonalBillInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
personalBillNo	账单编号	Y	string	50
personalBillStatus	账单状态	Y	string	20		WAIT：待确认 SUSPENDED：已挂起 CONFIRMED：已确认

样例

请求示例：

{
  "msgId": "B049D9F896BA4760A928AB2A549FBB59ERP20241130010000",
  "corpCode": "B049D9F896BA4760A928AB2A549FBB59",
  "travelNo": "TAFG12099176"
}

响应示例：

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "personalBillList": [
      {
        "personalBillNo": "BILL-20241107-UAMMZKCEFQ",
        "personalBillStatus": "CONFIRMED"
      }
    ]
  }
}

个人账单明细查询

接口URL

/napi/enterprise/account/personalbill/detail

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
msgId	消息id	Y	string	128		企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode	企业编码	Y	string	50
travelNo	申请单号	N	string	200	TA412011062	慧通申请单号
personalBillNoList	个人账单编号列表	N	List<String>			个人账单编号列表和出差申请单号二选一

响应参数定义

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

PersonalBillDetailData

参数名	参数说明	必填	参数类型	长度	值举例	备注
personalBillDetailList	个人账单明细列表	Y	List<PersonalBillDetailInfo>

PersonalBillDetailInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
personalBillNo	账单编号	Y	string	50
travelNo	出差申请单号	Y	string	200
reimburseNo	报销单号	N	string	200
reimburseStatus	报销状态	Y	string	20
airBillDetailList	机票明细列表	Y	List<AirBillDetailVo>			没有数据返回空列表
hotelBillDetailList	酒店明细列表	Y	List<HotelBillDetailVo>			没有数据返回空列表
trainBillDetailList	火车明细列表	Y	List<TrainBillDetailVo>			没有数据返回空列表
carBillDetailList	用车明细列表	Y	List<CarBillDetailVo>			没有数据返回空列表

AirBillDetailVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
enterpriseName	企业名称	Y	string	200	XXX公司
providerId	服务商ID	Y	string	32
providerName	服务商名称	Y	string	100
bizScope	业务范围	Y	string	20	DOMESTIC	DOMESTIC 国内 INTERNATIONAL 国际
subBizType	交易类型	Y	string	20	ISSUE	ISSUE：出票 REFUND：退票 CHANGE：改期
orderId	订单号	Y	string	32	F118447970
orderItemId	订单项Id	Y	string	64		机票唯一标识
ticketNo	票号	Y	string	40	111-9218536547
orderTime	预定时间	Y	string		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
departureTime	乘机时间	N	string		20200901185020	航班所在地起飞时间 格式化字符串 yyyyMMddHHmmss
arrivalTime	到达时间	N	string		20200901185020	航班所在地到达时间 格式化字符串 yyyyMMddHHmmss
ticketStatus	票状态	N	string	10	ISSUE	ISSUE：已出票 CHANGED：已改期 REFUNDED：已退票
ticketUseStatus	票使用状态	N	string	10	USED	UNUSED: 未使用, USED: 已使用
airwaysName	航司名称	N	string	200	南方航空	多个英文逗号分隔
flightNo	航班号	N	string	100	MU5151	多个英文逗号分隔
fullTrip	全航程	N	string	200	广州-南京,南京-北京	多个英文逗号分隔
departureCityId	出发城市Id	N	string	32
arrivalCityId	到达城市Id	N	string	32
cabinLevel	舱等	N	string	200	FIRST	FIRST: 头等舱 BUSINESS: 商务舱 ECONOMY: 经济舱 PREMIUM_ECONOMY：高端经济舱 多个英文逗号分隔
cabin	舱位	N	string	50	Z	多个英文逗号分隔
discount	舱位折扣	N	string	20	37
feeDetail	机票费用明细	N	List<AirFeeDetail>			如果币种不一致，则返回多条
travelerInfo	出行人信息	N	TravelerInfo

AirFeeDetail

参数名	参数说明	必填	参数类型	长度	值举例	备注
productPrice	票价	Y	decimal	20,2		单位：元，保留两位小数
airportTax	民航基金	Y	decimal	20,2		单位：元，保留两位小数
fuelFee	燃油附加费	Y	decimal	20,2		单位：元，保留两位小数
insuranceFee	保险金额	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

HotelBillDetailVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
enterpriseName	企业名称	Y	string	200	XXX公司
providerId	服务商ID	Y	string	32
providerName	服务商名称	Y	string	100
bizScope	业务范围	Y	string	20	DOMESTIC	DOMESTIC 国内 INTERNATIONAL 国际
orderId	订单号	Y	string	32	F118447970
orderItemId	订单项Id	Y	string	64
recheckOrderId	复核单号	N	string	32	ARH0124060514514933225-4
orderTime	预定时间	Y	string		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
countryName	国家中文名	N	string	200	中国
cityName	城市名称	N	string	64	松原
cityId	城市Id	N	string	32	34400001
hotelName	酒店名称	N	string	200	深圳长安大床房
roomTypeName	房型	N	string	200	商务大床房
checkinDate	入住日期	N	string		20220101	yyyyMMdd
checkoutDate	退房日期	N	string		20220102	yyyyMMdd
roomNight	结算间夜	N	decimal	10,2	2.00
feeDetail	酒店费用明细	N	List<HotelFeeDetail>			如果币种不一致，则返回多条
travelerInfoList	入住人信息列表	Y	List<TravelerInfo>

HotelFeeDetail

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

TrainBillDetailVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
enterpriseName	企业名称	Y	string	200	XXX公司
providerId	服务商ID	Y	string	32
providerName	服务商名称	Y	string	100
bizScope	业务范围	Y	string	20	DOMESTIC	DOMESTIC 国内 INTERNATIONAL 国际
subBizType	交易类型	Y	string	20	ISSUE	ISSUE：出票 REFUND：退票 CHANGE：改期
orderId	订单号	Y	string	32	F118447970
orderItemId	订单项Id	Y	string	64		火车票唯一标识
electronicOrderId	电子票号	N	string	32	SL20407244
orderTime	预定时间	Y	string		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
trainNo	车次	N	string	40	Z471
seatNo	座位号	N	string	64	3车14号
departDate	乘车时间	N	string		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
arrivalTime	到达时间	N	string		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
ticketStatus	票状态	N	string	10	CHANGED	ISSUE：已出票 CHANGED：已改期 REFUNDED：已退票
seatType	席别	N	string	50	硬座
departStation	出发车站	N	string	50	南京
arrivalStation	到达车站	N	string	50	上海
departCityId	出发城市Id	N	string	32
arrivalCityId	到达城市Id	N	string	32
tripType	中转标识	N	string	20	SINGLE	SINGLE：单程 ROUND：往返 MULTI：联程 TRANSFER：中转 DIRECT：直达
feeDetail	火车费用明细	N	List<TrainFeeDetail>			如果币种不一致，则返回多条
travelerInfo	出行人信息	Y	TravelerInfo

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

CarBillDetailVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
enterpriseName	企业名称	Y	string	200	XXX公司
providerId	服务商ID	Y	string	32
providerName	服务商名称	Y	string	100
bizScope	业务范围	Y	string	20	DOMESTIC	DOMESTIC 国内 INTERNATIONAL 国际
orderId	订单号	Y	string	32	F118447970
orderItemId	订单项Id	Y	string	64
rideType	运力类型	N	string	32	BUSINESS	ECONOMY:经济型 COMFORTABLE:舒适型 BUSINESS:商务型 LUXURY:豪华型 TAXI:出租车
orderTime	预定时间	Y	string		20200901185020	GMT+8 格式化字符串 yyyyMMddHHmmss
departureTime	出发时间	N	string		20200901185020	用车出发时间 格式化字符串 yyyyMMddHHmmss
arrivalTime	到达时间	N	string		20200901185020	用车到达时间 格式化字符串 yyyyMMddHHmmss
departAddress	出发地	N	string	500	出发地
arrivalAddress	目的地	N	string	500	目的地
departCityName	出发城市	N	string	100	深圳
departCityId	出发城市ID	N	string	32
arrivalCityName	到达城市	N	string	100	北京
arrivalCityId	到达城市ID	N	string	32
feeDetail	用车费用明细	N	List<CarFeeDetail>			如果币种不一致，则返回多条
travelerInfo	出行人信息	Y	TravelerInfo

CarFeeDetail

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

TravelerInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
travelerName	出行人姓名	N	string	255	张三
travelerStaffNo	出行人工号	N	string	50	008485
travelerDeptCode	出行人部门编码	N	string	200	C012
travelerDeptName	出行人部门名称	N	string	500	信息部

样例

请求示例：

{
  "msgId": "B049D9F896BA4760A928AB2A549FBB59ERP20241130010000",
  "corpCode": "B049D9F896BA4760A928AB2A549FBB59",
  "personalBillNoList": [
    "BILL-20241107-UAMMZKCEFQ"
  ]
}

响应示例：

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "personalBillDetailList": [
      {
        "personalBillNo": "BILL-20241202-QBGLPOKZV6",
        "travelNo": "TAFG12105823",
        "reimburseNo": "BX20250725002866",
        "reimburseStatus": "REIMBURSE_COMP",
        "airBillDetailList": [
          {
            "enterpriseName": "中H测试部",
            "providerId": "ITRAVEL",
            "providerName": "慧通差旅",
            "bizScope": "INTERNATIONAL",
            "subBizType": "ISSUE",
            "orderId": "I1100448640",
            "orderItemId": "I1100448640T11",
            "ticketNo": "9996056105697",
            "orderTime": "20241202144819",
            "departureTime": "20241229001000",
            "arrivalTime": "20241229025000",
            "ticketStatus": "ISSUE",
            "ticketUseStatus": "UNUSED",
            "airwaysName": "马印航空",
            "flightNo": "OD4800",
            "fullTrip": "北京-香港",
            "departureCityId": "156110100",
            "arrivalCityId": "34400001",
            "cabinLevel": "ECONOMY",
            "cabin": "A",
            "discount": "100",
            "feeDetail": [
              {
                "productPrice": 2430.00,
                "airportTax": 0.00,
                "fuelFee": 0.00,
                "insuranceFee": 0.00,
                "commissionFee": 0.00,
                "serviceFee": 55.00,
                "interTax": 1340.00,
                "settlementFee": 3825.00,
                "currency": "CNY"
              }
            ],
            "travelerInfo": {
              "travelerName": "***",
              "travelerStaffNo": "123456",
              "travelerDeptCode": "CNNC02",
              "travelerDeptName": "中H测试部"
            }
          }
        ],
        "hotelBillDetailList": [
          {
            "enterpriseName": "中H测试部",
            "providerId": "ITRAVEL",
            "providerName": "慧通差旅",
            "bizScope": "INTERNATIONAL",
            "orderId": "G0124120214291113183",
            "orderItemId": "ARG0124120214291113183-2",
            "recheckOrderId": "ARG0124120214291113183-2",
            "orderTime": "20241202142910",
            "countryName": "中国",
            "cityName": "香港",
            "cityId": "34400001",
            "hotelName": "国际资源合并酒店",
            "roomTypeName": "商务山景",
            "checkinDate": "20241202",
            "checkoutDate": "20241212",
            "roomNight": 10.00,
            "feeDetail": [
              {
                "productPrice": 8230.00,
                "unitPrice": 823.00,
                "serviceFee": 0.00,
                "settlementFee": 8230.00,
                "currency": "CNY"
              }
            ],
            "travelerInfoList": [
              {
                "travelerName": "***",
                "travelerStaffNo": "123456",
                "travelerDeptCode": "CNNC02",
                "travelerDeptName": "中H测试部"
              },
              {
                "travelerName": "***",
                "travelerStaffNo": null,
                "travelerDeptCode": "CNNC02",
                "travelerDeptName": "中H测试部"
              }
            ]
          }
        ],
        "trainBillDetailList": [],
        "carBillDetailList": []
      }
    ]
  }
}

个人账单报销结果回写

接口URL

/napi/enterprise/account/personalbill/reimburse/postback

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
msgId	消息id	Y	string	128		企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode	企业编码	Y	string	50
reimburseList	报销信息列表	Y	List<ReimburseInfo>			最多两百条

ReimburseInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
personalBillNoList	个人账单编号列表	Y	List<String>			个人账单编号列表不能为空
reimburseNo	报销单号	N	string	200	RH412107862	报销单号长度不能超过200
reimburseAmount	报销金额	N	decimal	20,2	1254.50
reimburseDesc	报销备注	N	string	2000
reimburseStatus	报销状态	Y	string	20	NO_REIMBURSE:未报销, REIMBURSE_PROC:报销中, REIMBURSE_COMP:报销完成

响应参数定义

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

样例

请求示例：

{
  "msgId": "B049D9F896BA4760A928AB2A549FBB59ERP20241130010000",
  "corpCode": "B049D9F896BA4760A928AB2A549FBB59",
  "reimburseList": [
    {
      "personalBillNoList": [
        "BILL-20241218-XOZE4FIMR8"
      ],
      "reimburseNo": "RF-978411213",
      "reimburseAmount": 100.50,
      "reimburseDesc": "测试报销数据",
      "reimburseStatus": "REIMBURSE_COMP"
    },
    {
      "personalBillNoList": [
        "BILL-20241218-7NLL6ON74Q"
      ],
      "reimburseNo": "BX-978456213RF",
      "reimburseAmount": 152.50,
      "reimburseDesc": "月底自动报销",
      "reimburseStatus": "REIMBURSE_COMP"
    }
  ]
}

响应示例：

{
  "resultCode": "0",
  "description": "操作成功",
  "data": null
}