付款单


付款单

付款单列表查询

接口URL

/napi/enterprise/account/payment/list

请求参数定义

参数名参数说明必填参数类型长度值举例备注
msgId消息IDYString128企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode企业编码YString50
createDateStart创建开始日期YString2020220808yyyyMMdd
createDateEnd创建结束日期YString2020220808yyyyMMdd
pageIndex起始页码YInteger1最小值1
pageSize每页记录数YInteger20建议20,上限200
entSettleAccountCodeList企业结算账户编码列表NList<String>["1000"]用于企业集成时按结算账户过滤数据,使用前需要先在结算平台维护好“结算账户编码”信息,不传默认按租户级别返回所有数据

响应参数定义

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

PaymentPage

参数名参数说明必填参数类型长度值举例备注
pageIndex起始页码YInteger1
pageSize每页记录数YInteger20
totalSize总记录数YLong200
totalPages总计页数YInteger200
paymentInfoList付款单信息列表YList<PaymentInfo>

PaymentInfo

参数名参数说明必填参数类型长度值举例备注
paymentNo付款单号YString50AP-20241029VASEGI5HWE
includeBizTypeList包含业务类型列表YList<String>["AIR", "HOTEL"]CAR:用车
AIR:机票
TRAIN:火车
HOTEL:酒店
createTime付款单创建时间YString20200901185020GMT+8格式化字符串 yyyyMMddHHmmss
settlementAmount结算金额合计YBigDecimal20,2120.11单位:元,保留两位小数
invoiceCompanyName开票公司名称YString1000测试开票公司名称
invoiceTitleName发票抬头名称YString255测试发票抬头名称
providerId服务商IDNString32ITRAVEL
providerName服务商名称NString200慧通
creatorName付款单创建人姓名NString200
creatorStaffNo付款单创建人工号NString100

样例

请求示例
{
  "entSettleAccountCodeList": [
    "3F69EE"
  ],
  "createDateStart": "20241017",
  "createDateEnd": "20241024",
  "corpCode": "3F69EE",
  "msgId": "3F69EE120241119124511AC5QS",
  "pageSize": 1,
  "pageIndex": 1
}
响应参数
{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "pageSize": 1,
    "pageIndex": 1,
    "totalSize": 6,
    "totalPages": 6,
    "paymentInfoList": [
      {
        "paymentNo": "AP-20241022B8BFJMD955",
        "includeBizTypeList": [
          "AIR"
        ],
        "createTime": "20241022094217",
        "settlementAmount": 150.00,
        "invoiceCompanyName": "深圳慧通商务有限公司",
        "invoiceTitleName": "南京意博测试",
        "providerId": "ITRAVEL",
        "providerName": "慧通差旅",
        "creatorName": "林**",
        "creatorStaffNo": "1*******"
      }
    ]
  }
}

机票付款单明细查询

接口URL

/napi/enterprise/account/payment/air/detail

请求参数定义

参数名参数说明必填参数类型长度值举例备注
msgId消息idYString128企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode企业编码YString101000
paymentNo付款单号YString50AP-20241029VASEGI5HWE
pageIndex起始页码YInteger1最小值1
pageSize每页记录数YInteger20建议20,上限200

响应参数定义

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

AirDetailPage

参数名参数说明必填参数类型长度值举例备注
pageIndex起始页码YInteger1
pageSize每页记录数YInteger20
totalSize总记录数YLong350
totalPages总计页数YInteger200
airDetailList机票明细列表YList<AirDetailVo>没有数据返回空列表

AirDetailVo

参数名参数说明必填参数类型长度值举例备注
billNo账单编号YString50AIR20241024VJPBV
invoiceBillNo发票单号YString50
enterpriseName企业名称YString200XXXX公司
bizScope业务范围YString20DOMESTICDOMESTIC 国内
INTERNATIONAL 国际
subBizType交易类型YString32ISSUEISSUE:出票
REFUND:退票
CHANGE:改期
INSUR:保险
travelNo申请单号NString200TA412011062慧通申请单号
travelType出差类型NString32BUSINESS因私:PRIVATE
因公:BUSINESS
orderId订单号YString50F118447970
orderItemId订单项号NString64
invoiceNo数电发票号NString645379631221只有发票类型是行程单时有值
itineraryNo行程单号NString645379631221只有发票类型是行程单时有值
ticketNo票号YString100111-9218536547
orderTime预定时间YString20200901185020GMT+8格式化字符串 yyyyMMddHHmmss
completeTime出/退/改时间YString20200901185020GMT+8格式化字符串 yyyyMMddHHmmss
departureTime乘机时间NString20200901185020航班所在地的起飞时间格式化字符串 yyyyMMddHHmmss
ticketStatus票状态NString32ISSUEISSUE:已出票
CHANGED:已改期
REFUNDED:已退票
validTripEndDate有效行程结束日期NString2020220808yyyyMMdd
ticketUseStatus票使用状态NString10USEDUNUSED: 未使用
USED: 已使用
airwaysName航司名称NString200南方航空, 南方航空多个英文逗号分隔
flightNo航班号NString200MU5151多个英文逗号分隔
departureCountryName出发国名称NString100中国
arrivalCountryName目的国名称NString100中国
intercontinentalType航段洲际类型NString10INTERINTER:洲际
INSIDE:洲内
fullTrip全航程NString200广州-南京,南京-北京多个英文逗号分隔
cabinLevel舱等NString200FIRSTFIRST: 头等舱
BUSINESS: 商务舱
ECONOMY: 经济舱
PREMIUM_ECONOMY:高端经济舱
多个英文逗号分隔
cabin舱位NString100Z多个英文逗号分隔
discount舱位折扣NString2137.00
orderSource预订方式NString50AndroidAndroid:安卓客户端
IOS:IOS
Backend:PC后台
Front:PC前台
H5:H5/小程序
harmony:鸿蒙
OpenAPI:OpenAPI
Welink:Welink
PNRImport:PNR导入
customerAgreementPrice是否客户协议价NString10YY:是
N:否
changeReason改期原因NString2000
refundReason退票原因NString2000
feeEntityName费用实体名称NString100
feeEntityCode费用实体编码NString100
currency币种YString10CNY默认CNY
feeDetail机票费用明细NList<PaymentDetailFeeItem>
trInfoTR信息NTrInfo
bookerInfo预订人信息NBookerInfo
travelerInfo出行人信息NTravelerInfo
benefitInfo受益信息NBenefitInfo

样例

请求示例
{
  "msgId": "3F69EE120241119124511AC5QS",
  "corpCode": "3F69EE",
  "paymentNo": "AP-20241121GETZ3B0DQW",
  "pageIndex": 1,
  "pageSize": 1
}
响应参数
{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "pageSize": 1,
    "pageIndex": 1,
    "totalSize": 17,
    "totalPages": 17,
    "airDetailList": [
      {
        "billNo": "AIR20241024VJPBV",
        "invoiceBillNo": "IND-20241121MJ25PQYJLJ",
        "enterpriseName": "南京意博软件有限公司",
        "bizScope": "DOMESTIC",
        "travelNo": "TA11123",
        "travelType": "PRIVATE",
        "orderId": "F1100217570",
        "feeEntityName": "test001费用实体",
        "feeEntityCode": "test001",
        "currency": "CNY",
        "feeDetail": [
          {
            "feeType": "PRODUCT_PRICE",
            "taxRate": 0,
            "amount": 582.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 582.00
          },
          {
            "feeType": "SERVICE_FEE",
            "taxRate": 0,
            "amount": 0.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 0.00
          },
          {
            "feeType": "AIRPORT_TAX",
            "taxRate": 0,
            "amount": 0.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 0.00
          },
          {
            "feeType": "FUEL_FEE",
            "taxRate": 0,
            "amount": 0.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 0.00
          },
          {
            "feeType": "INSURANCE_FEE",
            "taxRate": 0,
            "amount": 0.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 0.00
          },
          {
            "feeType": "SUPPLEMENT_TAX",
            "taxRate": 0,
            "amount": 0.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 0.00
          },
          {
            "feeType": "COMMISSION_FEE",
            "taxRate": 0,
            "amount": 60.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 60.00
          },
          {
            "feeType": "INTER_TAX",
            "taxRate": 0,
            "amount": 0.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 0.00
          },
          {
            "feeType": "SETTLEMENT_FEE",
            "taxRate": 0,
            "amount": 642.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 642.00
          }
        ],
        "trInfo": {
          "travelNo": "TAFG12108931",
          "enterpriseTravelNo": "TAFG12108931",
          "travelPurpose": "册数",
          "trStatus": "APPROVED",
          "trStartDate": "20241125",
          "trEndDate": "20241207",
          "trCloseTime": "20241207121112",
          "trCreaterName": "林**",
          "trCreaterStaffINo": "1********",
          "trCreaterMobile": "181********",
          "trCreaterDeptName": "研发部",
          "extendInfo": null
        },
        "bookerInfo": {
          "bookerName": "林**",
          "bookerStaffNo": "1*******",
          "bookerDeptCode": "****02",
          "bookerDeptName": "信息管理本部",
          "bookerFullDept": "",
          "bookerMemberId": "ID01**********"
        },
        "benefitInfo": {
          "benefitType": "COST_CENTER",
          "projectCode": "project1",
          "projectName": "项目1",
          "deptCode": "dept1",
          "deptName": "部门1",
          "costCenterCode": "031321-32132130",
          "costCenterName": "成本中心1",
          "proportion": 30.00,
          "extendInfo": "{\"projectCode\": \"project1\", \"projectName\": \"项目1\", \"costcenterCode\": \"031321-32132130\", \"costcenterName\": \"成本中心1\", \"departmentCode\": \"dept1\", \"departmentName\": \"部门1\"}"
        },
        "subBizType": "CHANGE",
        "orderItemId": "C1100217571T11",
        "invoiceNo": null,
        "itineraryNo": null,
        "ticketNo": "010-2410859771",
        "orderTime": "20240123155958",
        "completeTime": "20241123160021",
        "departureTime": "20231031101000",
        "ticketStatus": "REFUNDED",
        "validTripEndDate": "20231131",
        "ticketUseStatus": "UNUSED",
        "airwaysName": "中国联航",
        "flightNo": "KN4216",
        "departureCountryName": "中国",
        "arrivalCountryName": "中国",
        "intercontinentalType": "INTER",
        "fullTrip": "上海-北京",
        "cabinLevel": "ECONOMY",
        "cabin": "D",
        "discount": "59.00",
        "orderSource": "Backend",
        "customerAgreementPrice": "N",
        "changeReason": "(自愿)误机或出行计划变更",
        "refundReason": "",
        "travelerInfo": {
          "travelerName": "林**",
          "travelerStaffNo": "1*********",
          "travelerDeptCode": "****02333",
          "travelerDeptName": "信息管理本部",
          "travelerMemberId": "ID1***************",
          "travelerStandard": null,
          "travelerCurrency": null,
          "travelerExchangeRate": null
        }
      }
    ]
  }
}

用车付款单明细查询

接口URL

/napi/enterprise/account/payment/car/detail

请求参数定义

参数名参数说明必填参数类型长度值举例备注
msgId消息idYString128企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode企业编码YString101000
paymentNo付款单号YString50AP-20241029VASEGI5HWE
pageIndex起始页码YInteger1最小值1
pageSize每页记录数YInteger20建议20,上限200

响应参数定义

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

CarDetailPage

参数名参数说明必填参数类型长度值举例备注
pageIndex起始页码YInteger1
pageSize每页记录数YInteger20
totalSize总记录数YLong350
totalPages总计页数YInteger200
carDetailList用车明细列表YList<CarDetailVo>没有数据返回空列表

CarDetailVo

参数名参数说明必填参数类型长度值举例备注
billNo账单编号YString50CAR20241126UIBGV
invoiceBillNo发票单号YString50
enterpriseName企业名称YString200XXXX公司
bizScope业务范围YString20DOMESTICDOMESTIC 国内
INTERNATIONAL 国际
travelNo申请单号NString200TA412011062慧通申请单号
travelType出差类型NString32BUSINESS因私:PRIVATE
因公:BUSINESS
orderId订单号YString50U1100143550
carUseScene用车场景NString32COMMONPERSONAL:个人用车
COMMON:普通打车
OVERTIME:加班打车
BUSINESS_TRIP:业务用车
carUseType用车类型NString32NORMALNORMAL: 普通打车
AIRPORT_PICKUP: 接机
AIRPORT_DROP_OFF: 送机
rideType运力类型NString32BUSINESSECONOMY:经济型
COMFORTABLE:舒适型
BUSINESS:商务型
LUXURY:豪华型
TAXI:出租车
orderTime预定时间YString20200901185020GMT+8格式化字符串 yyyyMMddHHmmss
transactionTime交易时间NString20200901185020GMT+8格式化字符串 yyyyMMddHHmmss
departTime出发时间NString20200901185020用车出发时间格式化字符串 yyyyMMddHHmmss
arrivalTime到达时间NString20200901185020用车到达时间格式化字符串 yyyyMMddHHmmss
departAddress出发地NString500出发地
arrivalAddress目的地NString500目的地
supplierChannel供应商渠道NString64
departCityName出发城市NString200南京
arrivalCityName到达城市NString200深圳
feeEntityName费用实体名称NString100
feeEntityCode费用实体编码NString100
currency币种YString10CNY默认CNY
feeDetail用车费用明细NList<PaymentDetailFeeItem>
trInfoTR信息NTrInfo
bookerInfo预订人信息NBookerInfo
travelerInfo出行人信息NTravelerInfo
benefitInfo受益信息NBenefitInfo

样例

请求示例

{
  "msgId": "3F69EE120241119124511AC5QS",
  "corpCode": "WELINK_B049D9F896BA4760A928AB2A549FBB59",
  "paymentNo": "AP-20241126SUMJWSCXPC",
  "pageIndex": 1,
  "pageSize": 1
}

响应参数

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "pageSize": 1,
    "pageIndex": 1,
    "totalSize": 2,
    "totalPages": 2,
    "carDetailList": [
      {
        "billNo": "CAR20241126UIBGV",
        "invoiceBillNo": "IND-20241126BNAXN460OZ",
        "enterpriseName": "南京意博软件有限公司",
        "bizScope": "DOMESTIC",
        "travelNo": "",
        "travelType": "BUSINESS",
        "orderId": "U1100547050",
        "feeEntityName": "南京意博软件有限公司",
        "feeEntityCode": "E0104173",
        "currency": "CNY",
        "feeDetail": [
          {
            "feeType": "PRODUCT_PRICE",
            "taxRate": 0,
            "amount": 196.82,
            "canDeductAmount": 0.00,
            "notDeductAmount": 196.82
          },
          {
            "feeType": "SERVICE_FEE",
            "taxRate": 0,
            "amount": 0.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 0.00
          },
          {
            "feeType": "SUPPLEMENT_TAX",
            "taxRate": 0,
            "amount": 5.90,
            "canDeductAmount": 0.00,
            "notDeductAmount": 5.90
          },
          {
            "feeType": "SETTLEMENT_FEE",
            "taxRate": 0,
            "amount": 202.72,
            "canDeductAmount": 0.00,
            "notDeductAmount": 202.72
          }
        ],
        "trInfo": {
          "travelNo": "TAFG12108931",
          "enterpriseTravelNo": "TAFG12108931",
          "travelPurpose": "册数",
          "trStatus": "APPROVED",
          "trStartDate": "20241125",
          "trEndDate": "20241207",
          "trCloseTime": "20241207121112",
          "trCreaterName": "林***",
          "trCreaterStaffINo": "1*********",
          "trCreaterMobile": "181*********",
          "trCreaterDeptName": "研发部",
          "extendInfo": null
        },
        "bookerInfo": {
          "bookerName": "林**",
          "bookerStaffNo": "1******",
          "bookerDeptCode": "dept",
          "bookerDeptName": "测试部6",
          "bookerFullDept": ",南京意博软件有限公司,中核测试部",
          "bookerMemberId": "ID01************"
        },
        "benefitInfo": {
          "benefitType": "COST_CENTER",
          "projectCode": "project1",
          "projectName": "项目1",
          "deptCode": "dept1",
          "deptName": "部门1",
          "costCenterCode": "031321-32132130",
          "costCenterName": "成本中心1",
          "proportion": 30.00,
          "extendInfo": "{\"projectCode\": \"project1\", \"projectName\": \"项目1\", \"costcenterCode\": \"031321-32132130\", \"costcenterName\": \"成本中心1\", \"departmentCode\": \"dept1\", \"departmentName\": \"部门1\"}"
        },
        "carUseScene": "BUSINESS_TRIP",
        "carUseType": "NORMAL",
        "rideType": "ECONOMY",
        "orderTime": "20241126160329",
        "transactionTime": "20241126160347",
        "departTime": "20241126160347",
        "arrivalTime": "20241126170347",
        "departAddress": "北京",
        "arrivalAddress": "北京",
        "supplierChannel": "曹操出行",
        "departCityName": "北京",
        "arrivalCityName": "北京",
        "travelerInfo": {
          "travelerName": "林**",
          "travelerStaffNo": "1**********",
          "travelerDeptCode": "测试部门1",
          "travelerDeptName": "测试部6",
          "travelerMemberId": "ID1*********",
          "travelerStandard": null,
          "travelerCurrency": null,
          "travelerExchangeRate": null
        }
      }
    ]
  }
}

酒店付款单明细查询

接口URL

napi/enterprise/account/payment/hotel/detail

请求参数定义

参数名参数说明必填参数类型长度值举例备注
msgId消息idYString128企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode企业编码YString101000
paymentNo付款单号YString50AP-20241029VASEGI5HWE
pageIndex起始页码YInteger1最小值1
pageSize每页记录数YInteger20建议20,上限200

响应参数定义

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

HotelDetailPage

参数名参数说明必填参数类型长度值举例备注
pageIndex起始页码YInteger1
pageSize每页记录数YInteger20
totalSize总记录数YLong350
totalPages总计页数YInteger200
hotelDetailList酒店明细列表YList<HotelDetailVo>没有数据返回空列表

HotelDetailVo

参数名参数说明必填参数类型长度值举例备注
billNo账单编号YString50HOT20241126GKIZY
invoiceBillNo发票单号YString50
enterpriseName企业名称YString200XXXX公司
bizScope业务范围YString20DOMESTICDOMESTIC 国内
INTERNATIONAL 国际
travelNo申请单号NString200TA412011062慧通申请单号
travelType出差类型NString32BUSINESS因私:PRIVATE
因公:BUSINESS
orderId订单号YString50G0124112614002312725
recheckOrderId复核单号NString100ARH0124060514514933225-4
orderTime预定时间YString20200901185020GMT+8格式化字符串 yyyyMMddHHmmss
cancelStatus订单取消状态NString20CANCELLEDCANCELLED:已取消
NOT_CANCELLED:未取消
countryName国家中文名Nstring200中国
cityName城市NString64松原
hotelName酒店名称NString500深圳长安大酒店
roomTypeName房型NString255商务大床房
hotelSource酒店资源来源NString100客户直签
checkinDate入住日期NString20220101yyyyMMdd
checkoutDate退房日期NString20220102yyyyMMdd
invoiceingMethod发票提供方式NString100PLATFORMPLATFORM:平台开票
HOTEL:酒店开票
bookerCheckinDate预定入住日期NString20220101yyyyMMdd
bookerCheckoutDate预定退房日期NString20220102yyyyMMdd
guaranteeFlag是否担保NString2YY:是
N:否
recheckRoomNight复核间夜NBigDecimal10,22.00
roomNight结算间夜NBigDecimal10,22.00
unitPrice单价NBigDecimal20,210.00单位:元保留两位小数
feeEntityName费用实体名称NString100
feeEntityCode费用实体编码NString100
currency币种YString10CNY默认CNY
feeDetail酒店费用明细NList<PaymentDetailFeeItem>
trInfoTR信息NTrInfo
bookerInfo预订人信息NBookerInfo
travelerInfoList入住人信息列表YList<TravelerInfo>
benefitInfo受益信息NBenefitInfo

样例

请求示例

{
  "msgId": "3F69EE120241119124511AC5QS",
  "corpCode": "WELINK_B049D9F896BA4760A928AB2A549FBB59",
  "paymentNo": "AP-20241126U8ERI4FA52",
  "pageIndex": 1,
  "pageSize": 1
}

响应参数

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "pageSize": 1,
    "pageIndex": 1,
    "totalSize": 3,
    "totalPages": 3,
    "hotelDetailList": [
      {
        "billNo": "HOT20241126GKIZY",
        "invoiceBillNo": "IND-202411268Z2OWOVCIN",
        "enterpriseName": "南京意博软件有限公司",
        "bizScope": "INTERNATIONAL",
        "travelNo": "TAFG12108931",
        "travelType": "BUSINESS",
        "orderId": "G0124112614002312725",
        "feeEntityName": "南京意博软件有限公司",
        "feeEntityCode": "20019756",
        "currency": "CNY",
        "feeDetail": [
          {
            "feeType": "PRODUCT_PRICE",
            "taxRate": 6,
            "amount": 200.70,
            "canDeductAmount": 11.36,
            "notDeductAmount": 189.34
          },
          {
            "feeType": "SERVICE_FEE",
            "taxRate": 6,
            "amount": 18.00,
            "canDeductAmount": 1.02,
            "notDeductAmount": 16.98
          },
          {
            "feeType": "SUPPLEMENT_TAX",
            "taxRate": 6,
            "amount": 12.04,
            "canDeductAmount": 0.68,
            "notDeductAmount": 11.36
          },
          {
            "feeType": "SERVICE_SUPPLEMENT_TAX",
            "taxRate": 6,
            "amount": 1.08,
            "canDeductAmount": 0.06,
            "notDeductAmount": 1.02
          },
          {
            "feeType": "SETTLEMENT_FEE",
            "taxRate": 0,
            "amount": 231.82,
            "canDeductAmount": 13.12,
            "notDeductAmount": 218.70
          }
        ],
        "trInfo": {
          "travelNo": "TAFG12108931",
          "enterpriseTravelNo": "TAFG12108931",
          "travelPurpose": "册数",
          "trStatus": "APPROVED",
          "trStartDate": "20241125",
          "trEndDate": "20241207",
          "trCloseTime": "20241207121112",
          "trCreaterName": "林**",
          "trCreaterStaffINo": "1**********",
          "trCreaterMobile": "181*********",
          "trCreaterDeptName": "研发部",
          "extendInfo": null
        },
        "bookerInfo": {
          "bookerName": "林**",
          "bookerStaffNo": "1**********",
          "bookerDeptCode": "****02",
          "bookerDeptName": "研发部",
          "bookerFullDept": "",
          "bookerMemberId": "ID012***************"
        },
        "benefitInfo": {
          "benefitType": "COST_CENTER",
          "projectCode": "project1",
          "projectName": "项目1",
          "deptCode": "dept1",
          "deptName": "部门1",
          "costCenterCode": "031321-32132130",
          "costCenterName": "成本中心1",
          "proportion": 30.00,
          "extendInfo": "{\"projectCode\": \"project1\", \"projectName\": \"项目1\", \"costcenterCode\": \"031321-32132130\", \"costcenterName\": \"成本中心1\", \"departmentCode\": \"dept1\", \"departmentName\": \"部门1\"}"
        },
        "recheckOrderId": "ARG0124112614002312725-1",
        "orderTime": "20241126140024",
        "cancelStatus": null,
        "countryName": "中国",
        "cityName": "香港",
        "hotelName": "国际单体自签酒店",
        "roomTypeName": "MACQING",
        "hotelSource": "客户直签",
        "checkinDate": "20241125",
        "checkoutDate": "20241128",
        "invoiceingMethod": "PLATFORM",
        "bookerCheckinDate": "20241125",
        "bookerCheckoutDate": "20241128",
        "guaranteeFlag": "N",
        "recheckRoomNight": 3.00,
        "roomNight": 3.00,
        "unitPrice": 66.90,
        "travelerInfoList": [
          {
            "travelerName": "林**",
            "travelerStaffNo": "",
            "travelerDeptCode": "****",
            "travelerDeptName": "研发部",
            "travelerMemberId": "",
            "travelerStandard": "200",
            "travelerCurrency": "CNY",
            "travelerExchangeRate": 1.000000000000000000
          },
          {
            "travelerName": "林**",
            "travelerStaffNo": "",
            "travelerDeptCode": "****02",
            "travelerDeptName": "研发部",
            "travelerMemberId": "",
            "travelerStandard": "200",
            "travelerCurrency": "CNY",
            "travelerExchangeRate": 1.000000000000000000
          },
          {
            "travelerName": "林**",
            "travelerStaffNo": "1**********",
            "travelerDeptCode": "****",
            "travelerDeptName": "研发部",
            "travelerMemberId": "ID1**********",
            "travelerStandard": "200",
            "travelerCurrency": "CNY",
            "travelerExchangeRate": 1.000000000000000000
          }
        ]
      }
    ]
  }
}

火车票付款单明细查询

接口URL

/napi/enterprise/account/payment/train/detail

请求参数定义

参数名参数说明必填参数类型长度值举例备注
msgId消息idYString128企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode企业编码YString101000
paymentNo付款单号YString50AP-20241029VASEGI5HWE
pageIndex起始页码YInteger1最小值1
pageSize每页记录数YInteger20建议20,上限200

响应参数定义

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

TrainDetailPage

参数名参数说明必填参数类型长度值举例备注
pageIndex起始页码YInteger1
pageSize每页记录数YInteger20
totalSize总记录数YLong350
totalPages总计页数YInteger200
trainDetailList火车票明细列表YList<TrainDetailVo>没有数据返回空列表

TrainDetailVo

参数名参数说明必填参数类型长度值举例备注
billNo账单编号YString50TRA20241021ERCSV
invoiceBillNo发票单号YString50
orderItemId订单项IDYString64火车票唯一标识
invoiceTypeList数电发票类型NList<String>["TRAIN_RESIGN_FEE",
"TRAIN_COMMISSION_FEE "]
只有发票类型是火车票时有值
TRAIN_TICKET_PRICE:票价
TRAIN_RESIGN_FEE:改签费
TRAIN_COMMISSION_FEE:退改手续费
ticketPriceInvoiceNo票价发票号NString64只有发票类型是火车票时有值
resignFeeInvoiceNo改签费发票号NString64只有发票类型是火车票时有值
commissionFeeInvoiceNo退改手续费发票号NString64只有发票类型是火车票时有值
enterpriseName企业名称YString200XXXX公司
bizScope业务范围YString20DOMESTICDOMESTIC 国内
INTERNATIONAL 国际
subBizType交易类型YString32ISSUEISSUE:出票
REFUND:退款
CHANGE:改期
INSUR:保险
travelNo申请单号NString200TA412011062慧通申请单号
travelType出差类型NString32BUSINESS因私:PRIVATE
因公:BUSINESS
orderId订单号YString50T0124102409391787937
ticketId客票IDYString40
electronicOrderId电子票号NString32SL20407244供应商订单号
orderTime预定时间YString20200901185020GMT+8格式化字符串 yyyyMMddHHmmss
completeDate出/退/改票时间YString20200901185020GMT+8格式化字符串 yyyyMMddHHmmss
supplierChannel供应商渠道NString6412306
trainNo车次NString40Z271
seatNo座位号Nstring643车14号
departDate乘车时间NString20200901185020实际乘车时间格式化字符串 yyyyMMddHHmmss
ticketStatus票状态NString32CHANGEDISSUE : 已出票
CHANGED: 已改期
REFUNDED 已退票
validTripEndDate有效行程结束日期NString20200901yyyyMMdd
showPrice票面价NBigDecimal20,288.88单位:元保留两位小数
seatType席别NString50硬座
departStation出发车站NString50南京
arrivalStation到达车站NString50上海
tripType中转标识NString32SINGLESINGLE:单程
ROUND:往返
MULTI:联程
TRANSFER:中转
DIRECT:直达
supplierInvoiceType供应商发票类型NString32DIGITAL_INVOICEDIGITAL_INVOICE:电子发票
PAPER_INVOICE:纸质发票
feeEntityName费用实体名称NString100
feeEntityCode费用实体编码NString100
currency币种YString10CNY默认CNY
feeDetail火车费用明细NList<PaymentDetailFeeItem>
trInfoTR信息NTrInfo
bookerInfo预订人信息NBookerInfo
travelerInfo出行人信息NTravelerInfo
benefitInfo受益信息NBenefitInfo

样例

请求示例

{
  "msgId": "3F69EE120241119124511AC5QS",
  "corpCode": "WELINK_B049D9F896BA4760A928AB2A549FBB59",
  "paymentNo": "AP-20241122ZH7XLPWC6E",
  "pageIndex": 1,
  "pageSize": 1
}

响应参数

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "pageSize": 1,
    "pageIndex": 1,
    "totalSize": 17,
    "totalPages": 17,
    "trainDetailList": [
      {
        "billNo": "TRA20241021ERCSV",
        "invoiceBillNo": "IND-20241122I7XZCSTYKJ",
        "enterpriseName": "南京意博软件有限公司",
        "bizScope": "DOMESTIC",
        "travelNo": null,
        "travelType": "BUSINESS",
        "orderId": "T0124102409391787937",
        "feeEntityName": "test003费用实体",
        "feeEntityCode": "test003",
        "currency": "CNY",
        "feeDetail": [
          {
            "feeType": "PRODUCT_PRICE",
            "taxRate": 9,
            "amount": 36.50,
            "canDeductAmount": 3.01,
            "notDeductAmount": 33.49
          },
          {
            "feeType": "SERVICE_FEE",
            "taxRate": 0,
            "amount": 0.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 0.00
          },
          {
            "feeType": "INSURANCE_FEE",
            "taxRate": 0,
            "amount": 10.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 10.00
          },
          {
            "feeType": "COMMISSION_FEE",
            "taxRate": 0,
            "amount": 0.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 0.00
          },
          {
            "feeType": "RESIGN_FEE",
            "taxRate": 0,
            "amount": 0.00,
            "canDeductAmount": 0.00,
            "notDeductAmount": 0.00
          },
          {
            "feeType": "SETTLEMENT_FEE",
            "taxRate": 0,
            "amount": 46.50,
            "canDeductAmount": 3.01,
            "notDeductAmount": 43.49
          }
        ],
        "trInfo": {
          "travelNo": "TAFG12108931",
          "enterpriseTravelNo": "TAFG12108931",
          "travelPurpose": "册数",
          "trStatus": "APPROVED",
          "trStartDate": "20241125",
          "trEndDate": "20241207",
          "trCloseTime": "20241207121112",
          "trCreaterName": "**",
          "trCreaterStaffINo": "1********",
          "trCreaterMobile": "181**********",
          "trCreaterDeptName": "研发部",
          "extendInfo": null
        },
        "bookerInfo": {
          "bookerName": "林**",
          "bookerStaffNo": "1***********",
          "bookerDeptCode": null,
          "bookerDeptName": "差旅拓展部",
          "bookerFullDept": "差旅拓展部",
          "bookerMemberId": "ID012***********"
        },
        "benefitInfo": {
          "benefitType": "COST_CENTER",
          "projectCode": "project1",
          "projectName": "项目1",
          "deptCode": "dept1",
          "deptName": "部门1",
          "costCenterCode": "031321-32132130",
          "costCenterName": "成本中心1",
          "proportion": 30.00,
          "extendInfo": "{\"projectCode\": \"project1\", \"projectName\": \"项目1\", \"costcenterCode\": \"031321-32132130\", \"costcenterName\": \"成本中心1\", \"departmentCode\": \"dept1\", \"departmentName\": \"部门1\"}"
        },
        "invoiceTypeList": [
          "TRAIN_COMMISSION_FEE",
          "TRAIN_TICKET_PRICE",
          "TRAIN_RESIGN_FEE"
        ],
        "ticketPriceInvoiceNo": "123456",
        "resignFeeInvoiceNo": "123456",
        "commissionFeeInvoiceNo": "202411261657045366",
        "orderItemId": "TB2024102409391831636TKT2024102409391829565",
        "subBizType": "ISSUE",
        "ticketId": "TKT2024102409391829565",
        "electronicOrderId": "SL202410240939184275TL",
        "orderTime": "20241024093918",
        "completeDate": "20241024093919",
        "supplierChannel": "12306",
        "trainNo": "G9899",
        "seatNo": "3车15号硬座",
        "departDate": "20241030140300",
        "ticketStatus": "CHANGED",
        "validTripEndDate": "20241030",
        "showPrice": 36.50,
        "seatType": "硬座",
        "departStation": "上海",
        "arrivalStation": "北京",
        "tripType": "DIRECT",
        "supplierInvoiceType": "PAPER_INVOICE",
        "travelerInfo": {
          "travelerName": "林**",
          "travelerStaffNo": "1**********",
          "travelerDeptCode": null,
          "travelerDeptName": "测试部6",
          "travelerMemberId": "ID*****************",
          "travelerStandard": null,
          "travelerCurrency": null,
          "travelerExchangeRate": null
        }
      }
    ]
  }
}

供应商发票下载

1)机票行程单唯一标识通过机票付款单明细接口获取。对接方需要判断机票付款单明细接口返回的数据中,只有数电发票号不为空的记录可以执行下载。
2)火车票数电票唯一标识通过火车票付款单明细接口获取。对接方需要判断火车票付款单明细接口返回的数据中,当发票类型为票价、改签费或退改手续费时,只有对应的票价发票号、改签费发票号、退改手续费发票号不为空的记录可以执行下载。

接口URL

/napi/enterprise/account/supplier/invoice/download

请求参数定义

参数名参数说明必填参数类型长度值举例备注
msgId消息idYString128企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode企业编码YString101000
bizType业务类型YString20AIRAIR:机票
TRAIN:火车票
invoiceDownloadList发票下载列表YList<InvoiceDownloadInfo>每批次最大支持20个文件

InvoiceDownloadInfo

参数名参数说明必填参数类型长度值举例备注
orderItemId订单项号YString64机票/火车票唯一标识
invoiceType发票类型YString32TRAIN_COMMISSION_FEEAIR_ITINERARY:机票行程单
TRAIN_TICKET_PRICE:票价
TRAIN_RESIGN_FEE:改签费
TRAIN_COMMISSION_FEE:退改手续费

响应参数定义

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

InvoiceFileData

参数名参数说明必填参数类型长度值举例备注
invoiceFileList发票文件列表YList<InvoiceFileInfo>

InvoiceFileInfo

参数名参数说明必填参数类型长度值举例备注
orderItemId订单项号YString64机票/火车票唯一标识
invoiceType发票类型YString32AIR_ITINERARY:机票行程单
TRAIN_TICKET_PRICE:票价
TRAIN_RESIGN_FEE:改签费
TRAIN_COMMISSION_FEE:退改手续费
invoiceNo发票号YString1005379631221
invoiceFile文件流YStringBase64 编码过的OFD 文件流

样例

请求示例

{
  "corpCode": "3F69EE",
  "msgId": "3F69EE120241119124511AC5QS",
  "bizType": "TRAIN",
  "invoiceDownloadList": [
    {
      "orderItemId": "TB2024111919060533206TKT2024111919060530906",
      "invoiceType": "TRAIN_RESIGN_FEE"
    }
  ]
}

响应参数

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "invoiceFileList": [
      {
        "orderItemId": "TB2024111211381132621TKT2024111211381130422",
        "invoiceType": "TRAIN_TICKET_PRICE",
        "invoiceNo": "202411170800023944",
        "invoiceFile": "UEsDBBQAAAAIAH04pViUyUQdk"
      }
    ]
  }
}

付款单状态回传

接口URL

/napi/enterprise/account/payment/status/update

请求参数定义

参数名参数说明必填参数类型长度值举例备注
msgId消息idYString128企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode企业编码YString101000
paymentNo付款单号YString50AP-20241029VASEGI5HWE
paymentStatus付款单状态YString20集成成功企业财务系统回传,直接在企业结算门户展示
paymentDescription付款单描述NString2000
operator操作人NString50张三新增

响应参数定义

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

样例

请求示例

{
  "msgId": "3F69EE120241119124511AC5QS",
  "corpCode": "WELINK_B049D9F896BA4760A928AB2A549FBB59",
  "paymentNo": "AP-20241029VASEGI5HWE",
  "paymentStatus": "INTEGRATE_SUCCESS",
  "paymentDescription": "付款单描述"
}

响应参数

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

服务商发票单列表查询

接口URL

/napi/enterprise/account/payment/invoicebill/list

请求参数定义

参数名参数说明必填参数类型长度值举例备注
msgId消息idYString128企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode企业编码YString101000
paymentNo付款单号YString50AP-20241029VASEGI5HWE
pageIndex起始页码YInteger1最小值1
pageSize每页记录数YInteger20建议20,上限200

响应参数定义

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

InvoiceBillPage

参数名参数说明必填参数类型长度值举例备注
pageIndex起始页码YInteger1
pageSize每页记录数YInteger20
totalSize总记录数YLong350
totalPages总计页数YInteger200
invoiceBillList服务商发票单列表YList<InvoiceBillVo>没有数据返回空列表

InvoiceBillVo

参数名参数说明必填参数类型长度值举例备注
invoiceBillNo发票单号YString50
invoiceType开票类型YString32INVOICE:Invoice
RECEIPT:收据
PLAIN_DIGITAL_INVOICE:数电发票(普票)
SPEC_DIGITAL_INVOICE:数电发票(专票)
SUPPLIER:供应商发票
invoiceInfoList发票信息列表YList<InvoiceInfoVo>

InvoiceInfoVo

参数名参数说明必填参数类型长度值举例备注
invoiceNo发票号码NString50仅线上对接场景有值
invoiceAmount发票金额NBigDecimal单位:元。仅线上对接场景有值

样例

请求示例

{
  "corpCode": "WELINK_B049D9F896BA4760A928AB2A549FBB59",
  "msgId": "3F69EE120241119124511AC5QS",
  "paymentNo": "AP-20241029VASEGI5HWE",
  "pageIndex": 1,
  "pageSize": 200
}

响应示例

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "pageSize": 200,
    "pageIndex": 1,
    "totalSize": 1,
    "totalPages": 1,
    "invoiceBillList": [
      {
        "invoiceBillNo": "IND-20241028YLHTOPU8IH",
        "invoiceType": "SPEC_DIGITAL_INVOICE",
        "invoiceInfoList": [
          {
            "invoiceNo": "IND-20241028YLHTOPU8IH",
            "invoiceAmount": 5.00
          }
        ]
      }
    ]
  }
}

服务商发票下载

接口URL:

/napi/enterprise/account/provider/invoice/download

请求参数定义

参数名参数说明必填参数类型长度值举例备注
msgId消息idYString128企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode企业编码YString101000
invoiceBillNoList发票单号列表YList<String>每批次最大支持20个文件

响应参数定义

参数名参数说明必填参数类型长度值举例备注
resultCode返回码YString00表示成功,其他值为失败
description描述YString操作成功描述信息,出错时为错误信息即错误原因
data服务商发票单列表YInvoiceBillData

InvoiceBillData

参数名参数说明必填参数类型长度值举例备注
invoiceBillList服务商发票单列表YList<InvoiceBillInfo>

InvoiceBillInfo

参数名参数说明必填参数类型长度值举例备注
invoiceBillNo发票单号YString50
invoiceFileList发票文件列表YList<InvoiceFileInfo>

InvoiceFileInfo

参数名参数说明必填参数类型长度值举例备注
invoiceNo发票号码NString50仅线上对接场景有值
invoiceAmount发票金额NBigDecimal单位:元。仅线上对接场景有值
invoiceFile文件流YStringBase64 编码过的OFD 文件流

样例

请求示例

{
  "corpCode": "WELINK_B049D9F896BA4760A928AB2A549FBB59",
  "msgId": "3F69EE120241119124511AC5QS",
  "invoiceBillNoList": [
    "IND-20241028YLHTOPU8IH"
  ]
}

响应参数

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "invoiceBillList": [
      {
        "invoiceBillNo": "IND-20241028YLHTOPU8IH",
        "invoiceFileList": [
          {
            "invoiceNo": "test1",
            "invoiceAmount": 5.00,
            "invoiceFile": "UEsDBBQAAAAIAO6e1FjB3iW4/QAAADsCAAASAAAARG9jXzA"
          }
        ]
      }
    ]
  }
}

通用结构定义

预订人信息

BookerInfo

参数名参数说明必填参数类型长度值举例备注
bookerMemberId预订人memberIdNString200
bookerName预订人姓名NString255程XX
bookerStaffNo预订人工号NString5001234567
bookerDeptCode预订人部门编码NString2003000006
bookerDeptName预订人部门名称NString500信息管理本部
bookerFullDept预订人全部门NString2000本部-信息管理本部

出行人信息

TravelerInfo

参数名参数说明必填参数类型长度值举例备注
travelerMemberId出行人memberIdNString200
travelerName出行人姓名NString255程XX
travelerStaffNo出行人工号NString5001234567
travelerDeptCode出行人部门编码NString200信息管理本部
travelerDeptName出行人部门名称NString500信息管理本部
travelerStandard入住人差标NString32仅酒店业务涉及
travelerCurrency差标币种NString20仅酒店业务涉及
travelerExchangeRate差标汇率NBigDecimal23,18仅酒店业务涉及

TR信息

TrInfo

参数名参数说明必填参数类型长度值举例备注
travelNo申请单号NString200TA412011062慧通申请单号
enterpriseTravelNo企业申请单号NString200TA412011062企业客户系统申请单号
travelPurpose出差目的NString2000Customer visit
trStatus审批状态NString10
trStartDate出差开始日期NString20200901yyyyMMdd
trEndDate出差结束日期NString20200901yyyyMMdd
trCloseTime申请单关闭日期NString20200901185020GMT+8格式化字符串 yyyyMMddHHmmss
trCreaterName申请人姓名NString100程XX
trCreaterStaffINo申请人工号NString5001234567
trCreaterMobile申请人手机号NString50
trCreaterDeptName申请人部门名称NString500
extendInfoTr扩展信息NString5000

受益信息

BenefitInfo

参数名参数说明必填参数类型长度值举例备注
benefitType受益类型NString10DEPARTMENTCOST_CENTER:成本中心
PROJECT:受益项目
DEPARTMENT:部门
projectCode受益项目编码NString1009000000
projectName受益项目名称NString2000信息管理本部
deptCode受益部门编码NString1009000000
deptName受益部门NString2000信息管理本部
costCenterCode成本中心编码NString1009000000
costCenterName成本中心名称NString2000信息管理本部
proportion分摊比率NBigDecimal16,2100.00
extendInfo受益扩展属性NString5000

费用明细

PaymentDetailFeeItem

参数名参数说明必填参数类型长度值举例备注
feeType费用类型YString32PRODUCT_PRICE机票:
PRODUCT_PRICE:票价
AIRPORT_TAX:民航基金
FUEL_FEE:燃油附加费
INSURANCE_FEE:保险费
SUPPLEMENT_TAX:补税手续费
COMMISSION_FEE:退改手续费
SERVICE_FEE:服务费
INTER_TAX:国际税费
SETTLEMENT_FEE:结算金额
酒店:
PRODUCT_PRICE:房费
SUPPLEMENT_TAX:补税手续费
SERVICE_FEE:服务费
SERVICE_SUPPLEMENT_TAX:服务费补税手续费
SETTLEMENT_FEE:结算金额
用车:
PRODUCT_PRICE:订单金额
SUPPLEMENT_TAX:补税手续费
SERVICE_FEE:服务费
SETTLEMENT_FEE:结算金额
火车:
PRODUCT_PRICE:票价
COMMISSION_FEE:退票手续费
RESIGN_FEE:改签费
INSURANCE_FEE:保险费
SERVICE_FEE:服务费
SETTLEMENT_FEE:结算金额
taxRate可抵扣税率YBigDecimal20,06费用类型为SETTLEMENT_FEE时可抵扣税率为0
amount结算金额YBigDecimal20,21.01单位:元,保留两位小数
canDeductAmount可抵扣金额YBigDecimal20,21.01单位:元,保留两位小数
notDeductAmount不可抵扣金额YBigDecimal20,21.01单位:元,保留两位小数