个人账单

个人账单列表查询

接口URL

/napi/enterprise/account/personalbill/list

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
msgId	消息id	Y	String	128	B049D9F896BA4760A928AB2A549FBB59ERP20241130010000	企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode	企业编码	Y	String	50	B049D9F896BA4760A928AB2A549FBB59
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	BILL-20241107-UAMMZKCEFQ
personalBillStatus	账单状态	Y	String	20	CONFIRMED	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	B049D9F896BA4760A928AB2A549FBB59ERP20241130010000	企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode	企业编码	Y	String	50	B049D9F896BA4760A928AB2A549FBB59
travelNo	申请单号	N	String	200	TA412011062	慧通申请单号
personalBillNoList	个人账单编号列表	N	List<String>		["BILL-20241107-UAMMZKCEFQ"]	个人账单编号列表和出差申请单号二选一
filterAdjustFlag	过滤调账数据标识	N	String	2	N	Y:过滤调账数据，N:不过滤。默认为:Y

响应参数定义

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

PersonalBillDetailData

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

PersonalBillDetailInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
personalBillNo	账单编号	Y	String	50	BILL-20241202-QBGLPOKZV6
travelNo	出差申请单号	Y	String	200	TAFG12105823
reimburseNo	报销单号	N	String	200	BX20250725002866
reimburseStatus	报销状态	Y	String	20	REIMBURSE_COMP
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	ITRAVEL
providerName	服务商名称	Y	String	100	慧通差旅
bizScope	业务范围	Y	String	20	DOMESTIC	DOMESTIC 国内 INTERNATIONAL 国际
subBizType	交易类型	Y	String	20	ISSUE	ISSUE：出票 REFUND：退票 CHANGE：改期 INSUR:保险
orderId	订单号	Y	String	32	F118447970
orderItemId	订单项Id	Y	String	64	F118447970T11	机票唯一标识
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	156110100
arrivalCityId	到达城市Id	N	String	32	34400001
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
tripValid	行程有效状态	N	String	20	VALID	VALID:有效 INVALID:无效
relatedOrderItemId	关联订单项ID	N	String	64	F118447972T11

AirFeeDetail

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

HotelBillDetailVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
enterpriseName	企业名称	Y	String	200	XXX公司
providerId	服务商ID	Y	String	32	ITRAVEL
providerName	服务商名称	Y	String	100	慧通差旅
bizScope	业务范围	Y	String	20	INTERNATIONAL	DOMESTIC 国内 INTERNATIONAL 国际
orderId	订单号	Y	String	32	G0124120214291113183
orderItemId	订单项Id	Y	String	64	ARH0124120214291113183-2
recheckOrderId	复核单号	N	String	32	ARG0124120214291113183-2
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	BigDecimal	10,2	10.00
feeDetail	酒店费用明细	N	List<HotelFeeDetail>			如果币种不一致，则返回多条
travelerInfoList	入住人信息列表	Y	List<HotelTravelerInfo>
tripValid	行程有效状态	N	String	20	VALID	VALID:有效 INVALID:无效

HotelFeeDetail

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

HotelTravelerInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
travelerName	出行人姓名	N	String	255	张三
travelerStaffNo	出行人工号	N	String	50	008485
travelerDeptCode	出行人部门编码	N	String	200	C012
travelerDeptName	出行人部门名称	N	String	500	信息部
tenantUserId	租户用户ID	N	String	200	w40060821
travelStandard	差标	N	String	50	300
travelCurrency	差标币种	N	String	50	CNY

TrainBillDetailVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
enterpriseName	企业名称	Y	String	200	XXX公司
providerId	服务商ID	Y	String	32	ITRAVEL
providerName	服务商名称	Y	String	100	慧通服务商
bizScope	业务范围	Y	String	20	DOMESTIC	DOMESTIC 国内 INTERNATIONAL 国际
subBizType	交易类型	Y	String	20	ISSUE	ISSUE：出票 REFUND：退票 CHANGE：改期 INSUR:保险
orderId	订单号	Y	String	32	T0126021010170100029
orderItemId	订单项Id	Y	String	64	TB2026021010170206690TKT2026021010170205310	火车票唯一标识
electronicOrderId	电子票号	N	String	32	SL202602101017022032TL
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	156310100
arrivalCityId	到达城市Id	N	String	32	156320120
tripType	中转标识	N	String	20	SINGLE	SINGLE：单程 ROUND：往返 MULTI：联程 TRANSFER：中转 DIRECT：直达
feeDetail	火车费用明细	N	List<TrainFeeDetail>			如果币种不一致，则返回多条
travelerInfo	出行人信息	Y	TravelerInfo
tripValid	行程有效状态	N	String	20	VALID	VALID:有效 INVALID:无效
relatedOrderItemId	关联订单项ID	N	String	64	TB2025070815031316640TKT2025070815031306033

TrainFeeDetail

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

CarBillDetailVo

参数名	参数说明	必填	参数类型	长度	值举例	备注
enterpriseName	企业名称	Y	String	200	XXX公司
providerId	服务商ID	Y	String	32	ITRAVEL
providerName	服务商名称	Y	String	100	慧通服务商
bizScope	业务范围	Y	String	20	DOMESTIC	DOMESTIC 国内 INTERNATIONAL 国际
orderId	订单号	Y	String	32	U1100327920
orderItemId	订单项Id	Y	String	64	U1100327920
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	南京禄口国际机场-T1航站楼
departCityName	出发城市	N	String	100	南京
departCityId	出发城市ID	N	String	32	156320100
arrivalCityName	到达城市	N	String	100	南京
arrivalCityId	到达城市ID	N	String	32	156320100
feeDetail	用车费用明细	N	List<CarFeeDetail>			如果币种不一致，则返回多条
travelerInfo	出行人信息	Y	TravelerInfo
tripValid	行程有效状态	N	String	20	VALID	VALID:有效 INVALID:无效

CarFeeDetail

参数名	参数说明	必填	参数类型	长度	值举例	备注
productPrice	订单金额	Y	BigDecimal	20,2	8.92	单位：元，保留两位小数
serviceFee	服务费	Y	BigDecimal	20,2	0.00	单位：元，保留两位小数
settlementFee	结算金额	Y	BigDecimal	20,2	8.92	单位：元，保留两位小数
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	信息部
tenantUserId	租户用户ID	N	String	200	w40060821

样例

请求示例：

{
  "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测试部",
              "tenantUserId": "w40060821"
            },
            "tripValid": "VALID",
            "relatedOrderItemId": null
          }
        ],
        "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测试部",
                "tenantUserId": "w40060821",
                "travelStandard": "500",
                "travelCurrency": "CNY"
              },
              {
                "travelerName": "***",
                "travelerStaffNo": null,
                "travelerDeptCode": "CNNC02",
                "travelerDeptName": "中H测试部",
                "tenantUserId": "w40060821",
                "travelStandard": "500",
                "travelCurrency": "CNY"
              }
            ],
            "tripValid": "VALID"
          }
        ],
        "trainBillDetailList": [
          {
            "enterpriseName": "南京意博软件有限公司",
            "providerId": "ITRAVEL",
            "providerName": "慧通服务商",
            "bizScope": "DOMESTIC",
            "subBizType": "ISSUE",
            "orderId": "T0126021010170100029",
            "orderItemId": "TB2026021010170206690TKT2026021010170205310",
            "electronicOrderId": "SL202602101017022032TL",
            "orderTime": "20260210101702",
            "trainNo": "G34",
            "seatNo": "18车38C号",
            "departDate": "20260212130000",
            "arrivalTime": "20260212140800",
            "ticketStatus": "ISSUE",
            "seatType": "G二等座",
            "departStation": "上海",
            "arrivalStation": "上海",
            "departCityId": "156310100",
            "arrivalCityId": "156310100",
            "tripType": "DIRECT",
            "feeDetail": [
              {
                "productPrice": 134.50,
                "commissionFee": 0.00,
                "resignFee": 0.00,
                "insuranceFee": 0.00,
                "serviceFee": 0.00,
                "settlementFee": 134.50,
                "currency": "CNY"
              }
            ],
            "travelerInfo": {
              "travelerName": "李四",
              "travelerStaffNo": "40098839",
              "travelerDeptCode": "CNNC02",
              "travelerDeptName": "中H测试部",
              "tenantUserId": "w40060821"
            },
            "tripValid": "VALID",
            "relatedOrderItemId": null
          }
        ],
        "carBillDetailList": [
          {
            "enterpriseName": "南京意博软件有限公司",
            "providerId": "ITRAVEL",
            "providerName": "慧通服务商",
            "bizScope": "DOMESTIC",
            "orderId": "U1100327920",
            "orderItemId": "U1100327920",
            "rideType": "ECONOMY",
            "orderTime": "20260319101048",
            "departTime": "20260319105422",
            "departureTime": "20260319105422",
            "arrivalTime": "20260319111905",
            "departAddress": "华为云楼-西门",
            "arrivalAddress": "南京禄口国际机场-T1航站楼",
            "departCityName": "南京",
            "departCityId": "156320100",
            "arrivalCityName": "南京",
            "arrivalCityId": "156320100",
            "feeDetail": [
              {
                "productPrice": 8.92,
                "serviceFee": 0.00,
                "settlementFee": 8.92,
                "currency": "CNY"
              }
            ],
            "travelerInfo": {
              "travelerName": "李四",
              "travelerStaffNo": "40098839",
              "travelerDeptCode": "40098839",
              "travelerDeptName": "中H测试部",
              "tenantUserId": "w40060821"
            },
            "tripValid": "VALID"
          }
        ]
      }
    ]
  }
}

个人账单报销结果回写

接口URL

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

请求参数定义

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

ReimburseInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
personalBillNoList	个人账单编号列表	Y	List<String>		["BILL-20241218-XOZE4FIMR8"]	个人账单编号列表不能为空
reimburseNo	报销单号	N	String	200	RH412107862	报销单号长度不能超过200
reimburseAmount	报销金额	N	BigDecimal	20,2	1254.50
reimburseDesc	报销备注	N	String	2000	XX项目出差报销
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
}