付款单


付款单

查询付款单列表

接口URL

/account/payment_list/query

请求参数定义

参数名参数说明必填参数类型长度值举例备注
CorpCode企业账号YString1000系统提供的企业账号
Timestamp时间戳YString1420220808103019服务方允许20分钟内的时间误差
Version版本号YString3.0固定为3.0
LoginName操作人账号YStringzhangsan@huawei.com1、如果是系统维护,写“sysadmin”查询企业下全量数据,用此账号
2、 如果是普通员工维护,写员工登录名。查询员工名下订单,用此账号
MsgID唯一标识流水号YString1000020150511190411000001企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
InvoiceTimeStart付款单开票完成时间起始YString20220101yyyyMMdd
InvoiceTimeEnd付款单开票完成时间结束YString20220102yyyyMMdd
PageIndex起始页码YInteger1最小值1
PageSize每页记录数YInteger20取值范围:1~200
QueryCorpCodeList用于查询的企业账号列表NList<String>['1000']
BillCycle账期,yyyyMM格式NString202201yyyyMM

响应参数定义

参数名参数说明必填参数类型长度值举例备注
ResultCode返回码YString00表示成功,其他值为失败
Description描述YStringSuccess描述信息,出错时为错误信息即错误原因
PageIndex起始页码YInteger1
PageSize每页记录数YInteger20
TotalSize总记录数YLong200
PaymentInfoList付款单信息列表YList<PaymentInfo>

PaymentInfo

参数名参数说明必填参数类型长度值举例备注
PaymentNo付款单号YString50CM-20220716154847D0DF9
InvoiceTime付款单开票完成时间YLocalDateTime2022-01-01 10:10:10yyyy-MM-dd HH:mm:ss
IncludeBizTypes包含业务类型列表YList<String>["AIR", "HOTEL"]CAR:用车,AIR:机票,TRAIN:火车,HOTEL:酒店

样例

请求示例

{
  "CorpCode": "1000",
  "Timestamp": "20220822153000",
  "Version": "3.0",
  "LoginName": "sysadmin",
  "MsgID": "1000020150511190411000001",
  "InvoiceTimeStart": "20220810",
  "InvoiceTimeEnd": "20220818",
  "PageIndex": 1,
  "PageSize": 20,
  "QueryCorpCodeList": ['1000'],
  "BillCycle": "202201"
  
}

响应参数

{
  "ResultCode": "0",
  "Description": "Success",
  "PageIndex": 1,
  "PageSize": 20,
  "TotalSize": 12,
  "PaymentInfoList": [
    {
      "PaymentNo": "ARM-202208151921598A31E",
      "InvoiceTime": "2022-08-15 19:21:59",
      "IncludeBizTypes": ["AIR"]
    },
    {
      "PaymentNo": "ARM-202208161004298B368",
      "InvoiceTime": "2022-08-16 18:04:30",
      "IncludeBizTypes": ["AIR"]
    }
  ]
}

付款单明细查询

接口URL

/account/payment_detail/query

请求参数定义

参数名参数说明必填参数类型长度值举例备注
CorpCode企业账号YString1000系统提供的企业账号
Timestamp时间戳YString1420180811113019服务方允许20分钟内的时间误差
Version版本号YString3.0固定为3.0
LoginName操作人账号YStringzhangsan@huawei.com1、如果是系统维护,写“sysadmin”查询企业下全量数据,用此账号
2、 如果是普通员工维护,写员工登录名。查询员工名下订单,用此账号
MsgID唯一标识流水号YString1000020150511190411000001企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
PaymentNo付款单号YStringCM-20220716154847D0DF9
BizType业务类型YStringTRAINCAR:用车 AIR:机票 TRAIN:火车 HOTEL:酒店
PageIndex起始页码YInteger1最小值1
PageSize每页记录数YInteger20取值范围:1~200

响应参数定义

参数名参数说明必填参数类型长度值举例备注
ResultCode返回码YString00表示成功,其他值为失败
Description描述YStringSuccess描述信息,出错时为错误信息即错误原因
PageIndex起始页码YInteger1
PageSize每页记录数YInteger50
TotalSize总记录数YLong200
PaymentNo付款单号YString50CM-20220716154847D0DF9
CreateTime付款单创建时间YString20220101202020yyyyMMddHHmmss
SettlementAmount结算金额合计YBigDecimal120.11单位:元,保留两位小数
InvoiceCompanyName开票公司名称YString测试开票公司名称
InvoiceName发票抬头名称YString255测试发票抬头名称
BillCycle账期YString6202201
ServiceProviderId服务商IDNStringHT
ServiceProviderName服务商名称NString慧通
AirPaymentDetailList机票明细列表YList<AirPaymentDetail>无明细时,返回空列表
TrainPaymentDetailList火车明细列表YList<TrainPaymentDetail>无明细时,返回空列表
CarPaymentDetailList用车明细列表YList<CarPaymentDetail>无明细时,返回空列表
HotelPaymentDetailList酒店明细列表YList<HotelPaymentDetail>无明细时,返回空列表

AirPaymentDetail

参数名参数说明必填参数类型长度值举例备注
CustomerBillNo客户账单编号NString50AIR202208081XHDA
CustomerName客户名称NString64测试客户名称
BookerName预订人姓名NString200程XX
BookerStaffNo预订人工号NString6401234567
BookerDeptCode预订人部门编码NString2003000006
BookerDeptName预订人部门名称NString500信息管理本部
OrderDate预订时间NLocalDateTime20220808100310yyyyMMddHHmmss
BizType业务类型NString20AIR固定值
BizScope业务范围YStringDOMESTIC业务范围: DOMESTIC 国内;INTERNATIONAL 国际
OrderNo订单号NString32F118447970
FeeItemList费用项列表NList<PaymentDetailFeeItem>
BenefitInfo受益信息NPaymentBenefitInfo
Currency币种YString10CNY默认“人民币”,即CNY
PassengerName乘客姓名NString255程XX
PassengerStaffNo乘客工号NString3201234567
PassengerDeptName乘客部门名称NString500信息管理本部
PassengerDeptCode乘客部门编码NString503000006
ItineraryNo行程单号NString645379631221
TicketNo票号NString40111-9218536547
CompleteDate出退改日期NLocalDateTime20220808100603yyyyMMddHHmmss
FlyingDate登机日期NLocalDateTime20220808150000yyyyMMddHHmmss
SubBizType子业务类型NString20ISSUE子业务类型:ISSUE 出票;REFUND 退票;CHANGE 改期
TicketStatus票状态NString10USED票状态 UNUSED: 未使用, USED: 已使用, CHANGED: 已改期, REFUNDED 已退票
ValidTripTicketStatus有效行程票状态NString10USED有效行程票状态 UNUSED: 未使用, USED: 已使用
AirWaysName承运人名称NString64南方航空, 南方航空航司名称, 多个时英文逗号分隔
FlightNo航班号NString64MU5151航班号, 多个时英文逗号分隔
FullTrip全航程NString100广州-南京,南京-北京全航程, 多个时英文逗号分隔
CabinLevel舱等NString32经济舱舱等名称, 多个逗号分隔
Cabin舱位NString32Z舱位名称, 多个时英文逗号分隔
Discount舱位折扣NBigDecimal37decimal(20)
CustomerAgreementPrice是否为客户协议价NString取值:是;否

CarPaymentDetail

参数名参数说明必填参数类型长度值举例备注
CustomerBillNo客户账单编号NString50CAR202208080B6B4
CustomerName客户名称NString64测试部
BookerName预订人姓名NString32程XX
BookerStaffNo预订人工号NString3201234567
BookerDeptCode预订人部门编码NString200CNNC02,970002多个时,英文逗号分隔
BookerDeptName预订人部门名称NString100测试部,测试部2多个时,英文逗号分隔
OrderDate预订时间NLocalDateTime20220805100053yyyyMMddHHmmss
BizType业务类型NStringCAR固定值
BizScope业务范围YStringDOMESTIC业务范围: DOMESTIC 国内;INTERNATIONAL 国际
OrderNo订单号NString32U118477230
FeeItemList费用项列表NList<PaymentDetailFeeItem>
BenefitInfo受益信息NPaymentBenefitInfo
Currency币种YString10CNY默认 CNY
PassengerName乘客姓名NString32程XX
PassengerStaffNo乘客工号NString3201234567
PassengerDeptName乘客部门名称NString200测试部,测试部2多个时,英文逗号分隔
PassengerDeptCode乘客部门编码NString100CNNC02,970002
TransactionTime交易时间NLocalDateTime20220805100106yyyyMMddHHmmss
DepartAddress出发地NString500出发地
ArrivalAddress目的地NString500目的地
SupplierName供应商名称NString32曹操
CarUseType用车类型NString32ECONOMYNORMAL: 普通打车;AIRPORT_PICKUP: 接机;AIRPORT_DROP_OFF: 送机
DepartTime出发时间NString20220810030300yyyyMMddHHmmss
ArrivalTime到达时间NString20220810030300yyyyMMddHHmmss
DepartCityName出发城市名称NString100南京
ArrivalCityName到达城市名称NString100深圳

HotelPaymentDetail

参数名参数说明必填参数类型长度值举例备注
CustomerBillNo客户账单编号NString50HOT202208080XXU9
CustomerName客户名称NString64测试客户名称
BookerName预订人姓名NString64郭XX
BookerStaffNo预订人工号NString5000111100
BookerDeptCode预订人部门编码NString200UG100402134302
BookerDeptName预订人部门名称NString200测试部门名称
OrderDate预订时间NLocalDateTime20220117142847yyyyMMddHHmmss
BizType业务类型NStringHOTEL固定值
BizScope业务范围YStringDOMESTIC业务范围: DOMESTIC 国内;INTERNATIONAL 国际
OrderNo订单号NString32H0122011714284272287
FeeItemList费用项列表NList<PaymentDetailFeeItem>
BenefitInfo受益信息NPaymentBenefitInfo
Currency币种YString10CNY默认 CNY
RecheckOrderNo复核单号NString32ARH0122011714284272287-1
CheckinPersonName入住人姓名NString255郭XX,陈XX多个时英文逗号分隔
CheckinPersonStaffNo入住人工号NString25500111100,11111111多个时英文逗号分隔
CheckinPersonDeptCode入住人部门编码NString255101,102多个时英文逗号分隔
CheckinPersonDeptName入住人部门名称NString500测试部门名称,测试部门名称2多个时英文逗号分隔
CityName城市名称NString64松原
CountryName国家名称NString32中国
RoomTypeName房型名称NString100商务大床房
CheckinDate入住日期NLocalDate20200101yyyyMMdd
CheckoutDate离店日期NLocalDate20220102yyyyMMdd
BillingWay开票方式NString100SALERSALER: 平台开票,HOTEL: 酒店开票
UnitPrice单价NBigDecimal10.00单位:元,保留两位小数
RoomNight间夜NBigDecimal2.00

TrainPaymentDetail

参数名参数说明必填参数类型长度值举例备注
CustomerBillNo客户账单编号NString50TRA20220808OYWTD
CustomerName客户名称NString64测试客户名称
BookerName预订人姓名NString200程xx
BookerStaffNo预订人工号NString20001234567
BookerDeptCode预订人部门编码NString2003000006
BookerDeptName预订人部门名称NString500信息管理本部
OrderDate预订时间NLocalDateTime20220808145025yyyyMMddHHmmss
BizType业务类型NStringTRAIN固定值
BizScope业务范围YStringDOMESTIC业务范围: DOMESTIC 国内;INTERNATIONAL 国际
OrderNo订单号NString32T0122080814502534803
FeeItemList费用项列表NList<PaymentDetailFeeItem>
BenefitInfo受益信息NPaymentBenefitInfo
Currency币种YString10CNY默认 CNY
PassengerName乘客姓名NString255程XX
PassengerStaffNo乘客工号NString3201234567
PassengerDeptName乘客部门名称NString500信息管理本部
PassengerDeptCode乘客部门编码NString503000006
SubBizType子业务类型NString20ISSUE子业务类型:ISSUE 出票;REFUND 退票;CHANGE 改期
ElectronicOrderId电子订单号NString32E2081179GT
TrainNo车次NString40Z271
DepartTime出发日期NLocalDateTime20220810030300yyyyMMddHHmmss
TicketStatus票状态NString20CHANGED票状态 ISSUED: 已出票, CHANGED: 已改期, REFUNDED: 已退票
ValidTripDepartTime有效行程出发时间NLocalDateTime20220808195800yyyyMMddHHmmss
SeatType席别NString硬座
DepartStation出发车站名称NString50南京
ArrivalStation到达车站名称NString50上海
TicketId客票IDYStringTKT2022102913523201235

PaymentBenefitInfo

参数名参数说明必填参数类型长度值举例备注
TravelNo审批单号NString200TA412011062
BenefitType受益类型NString411:成本中心;2:项目;3:部门
EntCostOneNum企业一级成本中心或项目编号NString200B1010101受益类型是项目时,为项目编号;受益类型是部门时或成本中心时,为对应部门的编码
EntCostTwoNum企业二级成本中心或项目编号NString2001010101受益类型是项目时,为项目编号;受益类型是部门时或成本中心时,为对应部门的编码
CustomerCoa客户COANString1000021受益部门编码如:0021.000.0001.068254
BelongCompanyCode员工所属公司编码NString1000021
BenefitProjectCode受益项目编码NString10090000000
BenefitProjectName受益项目名称NString2000XXX项目
BenefitDeptId受益部门编码NString1000021.000.0001.069134
BenefitDeptName受益部门名称NString2000测试部门名称
BenefitCostCode受益成本中心编码NString100测试受益成本中心编码
BenefitCostName受益成本中心名称NString2000测试受益成本中心名称
Proportion分摊比率NBigDecimal33.34decimal(16, 2) 精度保留两位小数
BenefitExtInfo扩展信息NTextxx

PaymentDetailFeeItem

参数名参数说明必填参数类型长度值举例备注
FeeType费用类型YStringTICKET_PRICE【机票】TICKET_PRICE:票价, CONSTRUCTION_FEE:基建费, FUEL_FEE:燃油费, INSURANCE_FEE:保险费, REFUND_COMM_TAX:退票费税额, REFUND_FEE:退票费, CHANGE_FEE:改期费, SERVICE_FEE:服务费, TOTAL_AMOUNT:总结算金额; INTER_TAX:国际税费;
【酒店】ROOM_PRICE:房费, SERVICE_FEE:服务费, TOTAL_AMOUNT:总结算金额
【火车票】TICKET_PRICE:票价(改期差价), COMMISION_FEE:退改手续费, INSURANCE_FEE:保险费, SERVICE_FEE:服务费, TOTAL_AMOUNT:总结算金额
【打车】ORDER_SETTLE_PRICE:结算用车费, BACK_TAX:补税金额, SERVICE_FEE:服务费, TOTAL_AMOUNT:总结算金额
TaxRate税率YBigDecimal1.000000000000000000decimal(23, 18)
ApplyAmount结算金额YBigDecimal1.01单位:元,保留两位小数
CanDeductAmount可抵扣金额YBigDecimal1.01单位:元,保留两位小数
NotDeductAmount不可抵扣金额YBigDecimal1.01单位:元,保留两位小数

样例

请求示例

{
  "CorpCode": "1000",
  "Timestamp": "20220825150900",
  "Version": "3.0",
  "LoginName": "op001",
  "MsgID": "1000020150511190411000001",
  "PaymentNo": "CM-20231227C456CF3A59",
  "BizType": "TRAIN",
  "PageIndex": 1,
  "PageSize": 10
}

响应参数

{
  "success": true,
  "ResultCode": "0",
  "Description": "SUCCESS",
  "PageIndex": 1,
  "PageSize": 10,
  "TotalSize": 6,
  "PaymentNo": "CM-20231227C456CF3A59",
  "CreateTime": "20231227172004",
  "SettlementAmount": 320.50,
  "InvoiceName": "奇瑞集团",
  "BillCycle": "202312",
  "ServiceProviderId": "",
  "ServiceProviderName": "",
  "AirPaymentDetailList": [],
  "TrainPaymentDetailList": [
      {
          "CustomerBillNo": "TRA20231227LLE0L",
          "CustomerName": "奇瑞控股集团有限公司",
          "BookerName": "xxxx",
          "BookerStaffNo": "zwx1266296",
          "BookerDeptCode": "3000006,885226",
          "BookerDeptName": "信息管理本部,测试部zy",
          "OrderDate": "20231121200245",
          "BizType": "TRAIN",
          "BizScope": "DOMESTIC",
          "OrderNo": "T0123112120020771666",
          "FeeItemList": [
              {
                  "FeeType": "TICKET_PRICE",
                  "Amount": 0.00,
                  "TaxRate": 0,
                  "ApplyAmount": 0.00,
                  "CanDeductAmount": 0.00,
                  "NotDeductAmount": 0.00
              },
              {
                  "FeeType": "INSURANCE_FEE",
                  "Amount": 0.00,
                  "TaxRate": 0,
                  "ApplyAmount": 0.00,
                  "CanDeductAmount": 0.00,
                  "NotDeductAmount": 0.00
              },
              {
                  "FeeType": "COMMISSION_FEE",
                  "Amount": 0.00,
                  "TaxRate": 0,
                  "ApplyAmount": 0.00,
                  "CanDeductAmount": 0.00,
                  "NotDeductAmount": 0.00
              },
              {
                  "FeeType": "SERVICE_FEE",
                  "Amount": 15.00,
                  "TaxRate": 6,
                  "ApplyAmount": 15.00,
                  "CanDeductAmount": 0.85,
                  "NotDeductAmount": 14.15
              },
              {
                  "FeeType": "TOTAL_AMOUNT",
                  "Amount": 15.00,
                  "TaxRate": 0,
                  "ApplyAmount": 15.00,
                  "CanDeductAmount": 0.85,
                  "NotDeductAmount": 14.15
              }
          ],
          "BenefitInfo": {
              "TravelNo": "TA612079309",
              "EntCostOneNum": null,
              "EntCostTwoNum": null,
              "CustomerCoa": null,
              "BelongCompanyCode": null,
              "TrBenefitId": 112087799,
              "BenefitType": "1",
              "BenefitProjectCode": "",
              "BenefitProjectName": "",
              "BenefitDeptId": "3000006",
              "BenefitDeptName": "信息管理本部",
              "BenefitCostCode": "001",
              "BenefitCostName": "信息管理本部",
              "Proportion": 100.00,
              "BenefitExtInfo": "{\"costcenterCode\":\"001\",\"costcenterName\":\"信息管理本部\",\"projectCode\":null,\"projectName\":null,\"departmentCode\":\"3000006\",\"departmentName\":\"信息管理本部\",\"settlementUnitCode\":null,\"settlementUnitName\":null}"
          },
          "Currency": "CNY",
          "PassengerName": "周蓉蓉",
          "PassengerStaffNo": "zwx1266296",
          "PassengerDeptName": "信息管理本部,测试部zy",
          "PassengerDeptCode": "3000006,885226",
          "SubBizType": "CHANGE",
          "ElectronicOrderId": "E1894564GT",
          "TrainNo": "F001",
          "DepartTime": "20231205040300",
          "TicketStatus": "REFUNDED",
          "ValidTripDepartTime": null,
          "SeatType": "硬座",
          "DepartStation": "南京",
          "ArrivalStation": "北京",
          "Discount": null,
          "TicketId": "TKT2023112120024517001"
      }
  ],
  "CarPaymentDetailList": [],
  "HotelPaymentDetailList": []
}

付款单附件列表查询

接口URL

/account/payment_file/query

请求参数定义

参数名参数说明必填参数类型长度值举例备注
CorpCode企业账号YString1000系统提供的企业账号
Timestamp时间戳YString1420220808103019服务方允许20分钟内的时间误差
Version版本号YString3.0固定为3.0
LoginName操作人账号YStringzhangsan@huawei.com1、如果是系统维护,写“sysadmin”查询企业下全量数据,用此账号
2、 如果是普通员工维护,写员工登录名。查询员工名下订单,用此账号
MsgID唯一标识流水号YString1000020150511190411000001企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
PaymentNo付款单号YStringCM-20220716154847D0DF9
FileType附件类型YString10:机票、火车影印件 1:电子发票扫描件
PageIndex起始页码YInteger1最小值1
PageSize每页记录数YInteger20取值范围:1~200

响应参数定义

参数名参数说明必填参数类型长度值举例备注
ResultCode返回码YString00表示成功,其他值为失败
Description描述YStringSuccess描述信息,出错时为错误信息即错误原因
PageIndex起始页码YInteger1
PageSize每页记录数YInteger20
TotalSize总记录数YLong200
PaymentNo付款单号YStringCM-20220716154847D0DF9
FileList附件列表YList<PaymentFileInfo>

PaymentFileInfo

参数名参数说明必填参数类型长度值举例备注
FileName文件名称YString255
ObjectName对象名称YString255用于获取签名后的附件URL

样例

请求示例

{
  "CorpCode": "FAW_13723",
  "Timestamp": "20240117165800",
  "Version": "3.0",
  "LoginName": "sysadmin",
  "MsgID": "df906f0063418da41688903b72530592252604ec62229056e8ad70ff7b3d58a0",
  "PaymentNo": "CM-202401174A6A6D5FE7",
  "FileType": "1",
  "PageIndex": 1,
  "PageSize": 20  
}

响应参数

{
  "success": true,
  "ResultCode": "0",
  "Description": "SUCCESS",
  "PageIndex": 1,
  "PageSize": 20,
  "TotalSize": 1,
  "PaymentNo": "CM-202401174A6A6D5FE7",
  "FileList": [
      {
          "FileName": "tempFile截图(1)(1).png",
          "ObjectName": "account-static/202401171116486c605727.png"
      }
  ]
}

附件签名URL获取

接口URL

/account/payment_file/file_sign

请求参数定义

参数名参数说明必填参数类型长度值举例备注
CorpCode企业账号YString1000系统提供的企业账号
Timestamp时间戳YString1420220808103019服务方允许20分钟内的时间误差
Version版本号YString3.0固定为3.0
LoginName操作人账号YStringzhangsan@huawei.com1、如果是系统维护,写“sysadmin”查询企业下全量数据,用此账号
2、 如果是普通员工维护,写员工登录名。查询员工名下订单,用此账号
MsgID唯一标识流水号YString1000020150511190411000001企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
ObjectNameList对象名称列表YList最大100条

响应参数定义

参数名参数说明必填参数类型长度值举例备注
ResultCode返回码YString00表示成功,其他值为失败
Description描述YStringSuccess描述信息,出错时为错误信息即错误原因
PaymentNo付款单号YStringCM-20220716154847D0DF9
SignedUrlList签名地址列表YList<SignedUrlInfo>

SignedUrlInfo

参数名参数说明必填参数类型长度值举例备注
ObjectName对象名称YString255用于获取签名后的附件URL
SignedUrl签名后URL地址YString255可直接访问的附件URL公网地址,不需要进行OpenAPI 鉴权 默认有效期5分钟

样例

请求示例

{
  "CorpCode": "1000",
  "Timestamp": "20220822153000",
  "Version": "3.0",
  "CorpCode": "FAW_13723",
  "Timestamp": "20240117165800",
  "Version": "3.0",
  "TenantUserId": "sysadmin",
  "MsgID": "df906f0063418da41688903b72530592252604ec62229056e8ad70ff7b3d58a0",
  "ObjectNameList": [
"account-static/202401171116486c605727.png"
  
}

响应参数

{
  "ResultCode": "0",
  "Description": "Success",
  "SignedUrlList": [
      {
          "ObjectName": "account-static/202401171116486c605727.png",
          "SignedUrl": "https://obs-test.hwht.com:443/account-static/202401171116486c605727.png?AWSAccessKeyId=JUOFIHIRAK6KHZQR1SDP&Expires=1705482576&Signature=PdBAZAshi1We7ZKV8gSUGV5%2BvpA%3D"
      }
  ]
}