付款单

查询付款单列表

接口URL

/account/payment_list/query

请求参数定义

参数名	参数说明	必填	参数类型	值举例	备注
Version	版本号	Y	String	3.0	固定为3.0。
MsgID	唯一标识	Y	String	1000120150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
CorpCode	操作企业账号	Y	String		企业账号
TenantUserId	操作人帐号	Y	String	HW_000001	1、如果是系统维护，写"sysadmin" 2、如果是普通员工维护，写员工id
InvoiceTimeStart	付款单开票完成时间起始	Y	String	20220101	yyyyMMdd
InvoiceTimeEnd	付款单开票完成时间结束	Y	String	20220102	yyyyMMdd
PageIndex	起始页码	Y	Integer	1	最小值1
PageSize	每页记录数	Y	Integer	20	取值范围：1~200
QueryCorpCodeList	用于查询的企业账号列表	N	List<String>	['1000']
BillCycle	账期，yyyyMM格式	N	String	202201	yyyyMM

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
ResultCode	返回码	Y	String	0	0表示成功，其他值为失败
Description	描述	Y	String	Success	描述信息，出错时为错误信息即错误原因
PageIndex	起始页码	Y	Integer	1
PageSize	每页记录数	Y	Integer	20
TotalSize	总记录数	Y	Long	200
PaymentInfoList	付款单信息列表	Y	List<PaymentInfo>

PaymentInfo

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

样例

请求示例

{
  "Version": "3.0",
  "MsgID": "0008120220929071248283828",
  "CorpCode": "0008",
  "TenantUserId": "sysadmin",
  "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",
      "SettlementStatus": "APPLIED",
      "InvoiceTime": "2022-08-15 19:21:59",
      "IncludeBizTypes": ["AIR"]
    },
    {
      "PaymentNo": "ARM-202208161004298B368",
      "SettlementStatus": "APPLIED",
      "InvoiceTime": "2022-08-16 18:04:30",
      "IncludeBizTypes": ["AIR"]
    }
  ]
}

付款单明细查询

接口URL

/account/payment_detail/query

请求参数定义

参数名	参数说明	必填	参数类型	值举例	备注
Version	版本号	Y	String	3.0	固定为3.0。
MsgID	唯一标识	Y	String	1000120150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
CorpCode	操作企业账号	Y	String		企业账号
TenantUserId	操作人帐号	Y	String	HW_000001	1、如果是系统维护，写"sysadmin" 2、如果是普通员工维护，写员工id
PaymentNo	付款单号	Y	String	CM-20220716154847D0DF9
BizType	业务类型	Y	String	TRAIN	CAR：用车 AIR：机票 TRAIN：火车 HOTEL：酒店
PageIndex	起始页码	Y	Integer	1	最小值1
PageSize	每页记录数	Y	Integer	20	取值范围：1~200

响应参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
ResultCode	返回码	Y	String		0	0表示成功，其他值为失败
Description	描述	Y	String		Success	描述信息，出错时为错误信息即错误原因
PageIndex	起始页码	Y	Integer		1
PageSize	每页记录数	Y	Integer		50
TotalSize	总记录数	Y	Long		200
PaymentNo	付款单号	Y	String	50	CM-20220716154847D0DF9
CreateTime	付款单创建时间	Y	String		20220101202020	yyyyMMddHHmmss
SettlementAmount	结算金额合计	Y	BigDecimal		120.11	单位：元，保留两位小数
InvoiceCompanyName	开票公司名称	Y	String		测试开票公司名称
InvoiceName	发票抬头名称	Y	String	255	测试发票抬头名称
BillCycle	账期	Y	String	6	202201
ServiceProviderId	服务商ID	N	String		HT
ServiceProviderName	服务商名称	N	String		慧通
AirPaymentDetailList	机票明细列表	Y	List<AirPaymentDetail>			无明细时，返回空列表
TrainPaymentDetailList	火车明细列表	Y	List<TrainPaymentDetail>			无明细时，返回空列表
CarPaymentDetailList	用车明细列表	Y	List<CarPaymentDetail>			无明细时，返回空列表
HotelPaymentDetailList	酒店明细列表	Y	List<HotelPaymentDetail>			无明细时，返回空列表

AirPaymentDetail

参数名	参数说明	必填	参数类型	长度	值举例	备注
CustomerBillNo	客户账单编号	N	String	50	AIR202208081XHDA
CustomerName	客户名称	N	String	64	测试客户名称
BookerName	预订人姓名	N	String	200	程XX
BookerStaffNo	预订人工号	N	String	64	01234567
BookerDeptCode	预订人部门编码	N	String	200	3000006
BookerDeptName	预订人部门名称	N	String	500	信息管理本部
BookerExtInfo	预订人扩展信息	N	String	500	{"data":"123"}	拓展字段
OrderDate	预订时间	N	LocalDateTime		20220808100310	yyyyMMddHHmmss
BizType	业务类型	N	String	20	AIR	固定值
BizScope	业务范围	Y	String		DOMESTIC	业务范围: DOMESTIC 国内；INTERNATIONAL 国际
OrderNo	订单号	N	String	32	F118447970
FeeItemList	费用项列表	N	List<PaymentDetailFeeItem>
BenefitInfo	受益信息	N	PaymentBenefitInfo
Currency	币种	Y	String	10	CNY	默认“人民币”，即CNY
PassengerName	乘客姓名	N	String	255	程XX
PassengerStaffNo	乘客工号	N	String	32	01234567
PassengerDeptName	乘客部门名称	N	String	500	信息管理本部
PassengerDeptCode	乘客部门编码	N	String	50	3000006
ItineraryNo	行程单号	N	String	64	5379631221
TicketNo	票号	N	String	40	111-9218536547
CompleteDate	出退改日期	N	LocalDateTime		20220808100603	yyyyMMddHHmmss
FlyingDate	登机日期	N	LocalDateTime		20220808150000	yyyyMMddHHmmss
SubBizType	子业务类型	N	String	20	ISSUE	子业务类型：ISSUE 出票；REFUND 退票；CHANGE 改期
TicketStatus	票状态	N	String	10	USED	票状态 UNUSED: 未使用, USED: 已使用, CHANGED: 已改期, REFUNDED 已退票
ValidTripTicketStatus	有效行程票状态	N	String	10	USED	有效行程票状态 UNUSED: 未使用, USED: 已使用
AirWaysName	承运人名称	N	String	64	南方航空, 南方航空	航司名称, 多个时英文逗号分隔
FlightNo	航班号	N	String	64	MU5151	航班号, 多个时英文逗号分隔
FullTrip	全航程	N	String	100	广州-南京,南京-北京	全航程, 多个时英文逗号分隔
CabinLevel	舱等	N	String	32	经济舱	舱等名称, 多个逗号分隔
Cabin	舱位	N	String	32	Z	舱位名称, 多个时英文逗号分隔
Discount	舱位折扣	N	BigDecimal		37	decimal(20)
CustomerAgreementPrice	是否为客户协议价	N	String		是	取值：是；否
SettlementUnitCode	结算标识编码	N	String	200
SettlementUnitName	结算标识名称	N	String	500

CarPaymentDetail

参数名	参数说明	必填	参数类型	长度	值举例	备注
CustomerBillNo	客户账单编号	N	String	50	CAR202208080B6B4
CustomerName	客户名称	N	String	64	测试部
BookerName	预订人姓名	N	String	32	程XX
BookerStaffNo	预订人工号	N	String	32	01234567
BookerDeptCode	预订人部门编码	N	String	200	CNNC02,970002	多个时，英文逗号分隔
BookerDeptName	预订人部门名称	N	String	100	测试部,测试部2	多个时，英文逗号分隔
BookerExtInfo	预订人扩展信息	N	String	500	{"data":"123"}	拓展字段
OrderDate	预订时间	N	LocalDateTime		20220805100053	yyyyMMddHHmmss
BizType	业务类型	N	String		CAR	固定值
BizScope	业务范围	Y	String		DOMESTIC	业务范围: DOMESTIC 国内；INTERNATIONAL 国际
OrderNo	订单号	N	String	32	U118477230
RideType	运力类型	N	String	32		ECONOMY:经济型, COMFORTABLE:舒适型, BUSINESS:商务型, LUXURY:豪华型, TAXI:出租车
FeeItemList	费用项列表	N	List<PaymentDetailFeeItem>
BenefitInfo	受益信息	N	PaymentBenefitInfo
Currency	币种	Y	String	10	CNY	默认 CNY
PassengerName	乘客姓名	N	String	32	程XX
PassengerStaffNo	乘客工号	N	String	32	01234567
PassengerDeptName	乘客部门名称	N	String	200	测试部,测试部2	多个时，英文逗号分隔
PassengerDeptCode	乘客部门编码	N	String	100	CNNC02,970002
TransactionTime	交易时间	N	LocalDateTime		20220805100106	yyyyMMddHHmmss
DepartAddress	出发地	N	String	500	出发地
ArrivalAddress	目的地	N	String	500	目的地
SupplierName	供应商名称	N	String	32	曹操
CarUseType	用车类型	N	String	32	ECONOMY	NORMAL 普通打车；AIRPORT_PICKUP 接机；AIRPORT_DROP_OFF 送机
CarUseScene	用车场景	N	String	20		PERSONAL:个人用车,COMMON:普通打车,OVERTIME:加班打车,BUSINESS_TRIP:业务用车
DepartTime	出发时间	N	String		20220810030300	yyyyMMddHHmmss
ArrivalTime	到达时间	N	String		20220810030300	yyyyMMddHHmmss
DepartCityName	出发城市名称	N	String	100	南京
ArrivalCityName	到达城市名称	N	String	100	深圳
SettlementUnitCode	结算标识编码	N	String	200
SettlementUnitName	结算标识名称	N	String	500

HotelPaymentDetail

参数名	参数说明	必填	参数类型	长度	值举例	备注
CustomerBillNo	客户账单编号	N	String	50	HOT202208080XXU9
CustomerName	客户名称	N	String	64	测试客户名称
BookerName	预订人姓名	N	String	64	郭XX
BookerStaffNo	预订人工号	N	String	50	00111100
BookerDeptCode	预订人部门编码	N	String	200	UG100402134302
BookerDeptName	预订人部门名称	N	String	200	测试部门名称
BookerExtInfo	预订人扩展信息	N	String	500	{"data":"123"}	拓展字段
OrderDate	预订时间	N	LocalDateTime		20220117142847	yyyyMMddHHmmss
BizType	业务类型	N	String		HOTEL	固定值
BizScope	业务范围	Y	String		DOMESTIC	业务范围: DOMESTIC 国内；INTERNATIONAL 国际
OrderNo	订单号	N	String	32	H0122011714284272287
FeeItemList	费用项列表	N	List<PaymentDetailFeeItem>
BenefitInfo	受益信息	N	PaymentBenefitInfo
Currency	币种	Y	String	10	CNY	默认 CNY
RecheckOrderNo	复核单号	N	String	32	ARH0122011714284272287-1
CheckinPersonInfoList	入住人信息列表	Y	List<CheckinPersonInfo>
CityName	城市名称	N	String	64	松原
CountryName	国家名称	N	String	32	中国
RoomTypeName	房型名称	N	String	100	商务大床房
CheckinDate	入住日期	N	LocalDate		20200101	yyyyMMdd
CheckoutDate	离店日期	N	LocalDate		20220102	yyyyMMdd
BillingWay	开票方式	N	String	100	SALER	SALER:平台开票,HOTEL:酒店开票
UnitPrice	单价	N	BigDecimal		10.00	单位：元，保留两位小数
RoomNight	间夜	N	BigDecimal		2.00
SettlementUnitCode	结算标识编码	N	String	200
SettlementUnitName	结算标识名称	N	String	500

TrainPaymentDetail

参数名	参数说明	必填	参数类型	长度	值举例	备注
CustomerBillNo	客户账单编号	N	String	50	TRA20220808OYWTD
CustomerName	客户名称	N	String	64	测试客户名称
BookerName	预订人姓名	N	String	200	程xx
BookerStaffNo	预订人工号	N	String	200	01234567
BookerDeptCode	预订人部门编码	N	String	200	3000006
BookerDeptName	预订人部门名称	N	String	500	信息管理本部
BookerExtInfo	预订人扩展信息	N	String	500	{"data":"123"}	拓展字段
OrderDate	预订时间	N	LocalDateTime		20220808145025	yyyyMMddHHmmss
BizType	业务类型	N	String		TRAIN	固定值
BizScope	业务范围	Y	String		DOMESTIC	业务范围: DOMESTIC 国内；INTERNATIONAL 国际
OrderNo	订单号	N	String	32	T0122080814502534803
FeeItemList	费用项列表	N	List<PaymentDetailFeeItem>
BenefitInfo	受益信息	N	PaymentBenefitInfo
Currency	币种	Y	String	10	CNY	默认 CNY
PassengerName	乘客姓名	N	String	255	程XX
PassengerStaffNo	乘客工号	N	String	32	01234567
PassengerDeptName	乘客部门名称	N	String	500	信息管理本部
PassengerDeptCode	乘客部门编码	N	String	50	3000006
SubBizType	子业务类型	N	String	20	ISSUE	子业务类型：ISSUE 出票；REFUND 退票；CHANGE 改期
ElectronicOrderId	电子订单号	N	String	32	E2081179GT
TrainNo	车次	N	String	40	Z271
DepartTime	出发日期	N	LocalDateTime		20220810030300	yyyyMMddHHmmss
TicketStatus	票状态	N	String	20	CHANGED	票状态 ISSUED: 已出票, CHANGED: 已改期, REFUNDED 已退票
ValidTripDepartTime	有效行程出发时间	N	LocalDateTime		20220808195800	yyyyMMddHHmmss
SeatType	席别	N	String		硬座
DepartStation	出发车站名称	N	String	50	南京
ArrivalStation	到达车站名称	N	String	50	上海
TicketId	客票ID	Y	String		TKT2022102913523201235
SettlementUnitCode	结算标识编码	N	String	200
SettlementUnitName	结算标识名称	N	String	500
TripType	中转标识	N	String	20	中转/直达	火车中转

PaymentBenefitInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
TravelNo	审批单号	N	String	200	TA412011062
BenefitType	受益类型	N	String	4	1	1：成本中心；2：项目；3：部门
EntCostOneNum	企业一级成本中心或项目编号	N	String	200	B1010101	受益类型是项目时，为项目编号；受益类型是部门时或成本中心时，为对应部门的编码
EntCostTwoNum	企业二级成本中心或项目编号	N	String	200	1010101	受益类型是项目时，为项目编号；受益类型是部门时或成本中心时，为对应部门的编码
CustomerCoa	客户COA	N	String	100	0021	受益部门编码如：0021.000.0001.068254
BelongCompanyCode	员工所属公司编码	N	String	100	0021
BenefitProjectCode	受益项目编码	N	String	100	90000000
BenefitProjectName	受益项目名称	N	String	2000	XXX项目
BenefitDeptId	受益部门编码	N	String	100	0021.000.0001.069134
BenefitDeptName	受益部门名称	N	String	2000	测试部门名称
BenefitCostCode	受益成本中心编码	N	String	100	测试受益成本中心编码
BenefitCostName	受益成本中心名称	N	String	2000	测试受益成本中心名称
Proportion	分摊比率	N	BigDecimal		33.34	decimal(16, 2) 精度保留两位小数
BenefitExtInfo	扩展信息	N	Text		xx

PaymentDetailFeeItem

参数名	参数说明	必填	参数类型	值举例	备注
FeeType	费用类型	Y	String	TICKET_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	税率	Y	BigDecimal	1.000000000000000000	decimal(23, 18)
ApplyAmount	申请结算金额	Y	BigDecimal	1.01	单位：元，保留两位小数
CanDeductAmount	可抵扣金额	Y	BigDecimal	1.01	单位：元，保留两位小数
NotDeductAmount	不可抵扣金额	Y	BigDecimal	1.01	单位：元，保留两位小数

CheckinPersonInfo

参数名	参数说明	必填	参数类型	长度
CheckinPersonName	入住人姓名	Y	String	50
CheckinPersonStaffNo	入住人工号	N	String	50
CheckinPersonDeptCode	入住人部门编码	N	String	50
CheckinPersonDeptName	入住人部门名称	N	String	200

样例

请求示例

{
    "CorpCode": "chery",
    "Timestamp": "20240828101207",
    "Version": "3.0",
    "LoginName": "sysadmin",
    "TenantUserId": "sysadmin",
    "MsgID": "chery1202408281012071613",
    "PaymentNo": "CM-202312275EFFFCE242",
    "BizType": "CAR",
    "PageIndex": 1,
    "PageSize": 200
}

响应参数

{
	"ServiceProviderName": "",
	"Description": "SUCCESS",
	"PageSize": 200,
	"ServiceFeeAmount": 0.0,
	"ServiceProviderId": "",
	"CreateTime": "20231227182027",
	"BillCycle": "202312",
	"PageIndex": 1,
	"TotalSize": 2,
	"PaymentNo": "CM-202312275EFFFCE242",
	"CarPaymentDetailList": [
		{
			"DepartCityName": "南京",
			"PassengerName": "周蓉蓉",
			"CustomerBillNo": "CAR202312275YFZP",
			"BizScope": "DOMESTIC",
			"OrderNo": "U1100679840",
			"BookerExtInfo": "{\"settlementUnitCode\": \"TEST-002\", \"settlementUnitName\": \"测试实体名称2\", \"employeePositionLevel\": \"3616\"}",
			"DepartTime": "20231113163341",
			"Currency": "CNY",
			"DepartAddress": "南京市江宁区梅香路21号龙西新寓",
			"RideType": "COMFORTABLE",
			"BenefitInfo": {
				"TrBenefitId": 112087237,
				"TravelNo": "TA612076353",
				"BenefitDeptName": "信息管理本部",
				"BenefitCostCode": "001",
				"BenefitDeptId": "3000006",
				"BenefitType": "1",
				"BenefitCostName": "信息管理本部",
				"Proportion": 100.0,
				"BenefitProjectName": "",
				"BenefitProjectCode": "",
				"BenefitExtInfo": "{\"costcenterCode\":\"001\",\"costcenterName\":\"信息管理本部\",\"projectCode\":null,\"projectName\":null,\"departmentCode\":\"3000006\",\"departmentName\":\"信息管理本部\",\"settlementUnitCode\":null,\"settlementUnitName\":null}"
			},
			"CustomerName": "奇瑞控股集团有限公司",
			"BookerName": "周蓉蓉",
			"PassengerDeptName": "信息管理本部,测试部zy",
			"BookerDeptName": "信息管理本部,测试部zy",
			"FeeItemList": [
				{
					"CanDeductAmount": 0.28,
					"FeeType": "ORDER_SETTLE_PRICE",
					"ApplyAmount": 5.0,
					"NotDeductAmount": 4.72,
					"TaxRate": 6
				},
				{
					"CanDeductAmount": 0.0,
					"FeeType": "BACK_TAX",
					"ApplyAmount": 0.3,
					"NotDeductAmount": 0.3,
					"TaxRate": 0
				},
				{
					"CanDeductAmount": 0.0,
					"FeeType": "SERVICE_FEE",
					"ApplyAmount": 0.0,
					"NotDeductAmount": 0.0,
					"TaxRate": 6
				},
				{
					"CanDeductAmount": 0.28,
					"FeeType": "TOTAL_AMOUNT",
					"ApplyAmount": 5.3,
					"NotDeductAmount": 5.02,
					"TaxRate": 0
				}
			],
			"CarUseType": "COMFORTABLE",
			"ArrivalTime": "20231113163343",
			"BookerStaffNo": "zwx1266296",
			"PassengerStaffNo": "zwx1266296",
			"ArrivalCityName": "南京",
			"BizType": "CAR",
			"CarUseScene": "COMMON",
			"OrderDate": "20231113163317",
			"TransactionTime": "20231113163348",
			"ArrivalAddress": "江宁西",
			"SupplierName": "首约出行",
			"BookerDeptCode": "3000006,885226",
			"PassengerDeptCode": "3000006,885226"
		},
		{
			"DepartCityName": "深圳",
			"PassengerName": "陆瑶",
			"CustomerBillNo": "CAR202312275YFZP",
			"BizScope": "DOMESTIC",
			"OrderNo": "U1100082830",
			"BookerExtInfo": "{\"settlementUnitCode\": \"TEST-001\", \"settlementUnitName\": \"测试实体名称\", \"employeePositionLevel\": \"3616\"}",
			"DepartTime": "20231129153124",
			"Currency": "CNY",
			"DepartAddress": "深圳宝安国际机场-T3航站楼",
			"RideType": "COMFORTABLE",
			"BenefitInfo": {
				"Proportion": 0.0
			},
			"CustomerName": "奇瑞控股集团有限公司",
			"BookerName": "陆瑶",
			"PassengerDeptName": "信息管理本部",
			"BookerDeptName": "信息管理本部",
			"FeeItemList": [
				{
					"CanDeductAmount": 1.13,
					"FeeType": "ORDER_SETTLE_PRICE",
					"ApplyAmount": 20.0,
					"NotDeductAmount": 18.87,
					"TaxRate": 6
				},
				{
					"CanDeductAmount": 0.0,
					"FeeType": "BACK_TAX",
					"ApplyAmount": 1.2,
					"NotDeductAmount": 1.2,
					"TaxRate": 0
				},
				{
					"CanDeductAmount": 0.0,
					"FeeType": "SERVICE_FEE",
					"ApplyAmount": 0.0,
					"NotDeductAmount": 0.0,
					"TaxRate": 6
				},
				{
					"CanDeductAmount": 1.13,
					"FeeType": "TOTAL_AMOUNT",
					"ApplyAmount": 21.2,
					"NotDeductAmount": 20.07,
					"TaxRate": 0
				}
			],
			"CarUseType": "COMFORTABLE",
			"ArrivalTime": "20231129153126",
			"BookerStaffNo": "lwx1268267",
			"PassengerStaffNo": "lwx1268267",
			"ArrivalCityName": "深圳",
			"BizType": "CAR",
			"CarUseScene": "BUSINESS_TRIP",
			"OrderDate": "20231129153039",
			"TransactionTime": "20231129153201",
			"ArrivalAddress": "深圳站-南进站口",
			"SupplierName": "首约出行",
			"BookerDeptCode": "3000006",
			"PassengerDeptCode": "3000006",
			"BookerFullDept": ""
		}
	],
	"InvoiceCompanyName": "深圳慧通商务有限公司",
	"AirPaymentDetailList": [],
	"success": true,
	"HotelPaymentDetailList": [],
	"OrderAmount": 26.5,
	"TrainPaymentDetailList": [],
	"InvoiceName": "奇瑞集团",
	"ResultCode": "0",
	"SettlementAmount": 26.5
}

付款单附件列表查询

接口URL

/account/payment_file/query

请求参数定义

参数名	参数说明	必填	参数类型	值举例	备注
Version	版本号	Y	String	3.0	固定为3.0。
MsgID	唯一标识	Y	String	1000120150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
CorpCode	操作企业账号	Y	String		企业账号
TenantUserId	操作人帐号	Y	String	HW_000001	1、如果是系统维护，写"sysadmin" 2、如果是普通员工维护，写员工id
PaymentNo	付款单号	Y	String	CM-20220716154847D0DF9
FileType	附件类型	Y	String	1	0：机票、火车影印件 1：电子发票扫描件
PageIndex	起始页码	Y	Integer	1	最小值1
PageSize	每页记录数	Y	Integer	20	取值范围：1~200

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
ResultCode	返回码	Y	String	0	0表示成功，其他值为失败
Description	描述	Y	String	Success	描述信息，出错时为错误信息即错误原因
PageIndex	起始页码	Y	Integer	1
PageSize	每页记录数	Y	Integer	20
TotalSize	总记录数	Y	Long	200
PaymentNo	付款单号	Y	String	CM-20220716154847D0DF9
FileList	附件列表	Y	List<PaymentFileInfo>

PaymentFileInfo

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

样例

请求示例

{
  "CorpCode": "FAW_13723",
  "Timestamp": "20240117165800",
  "Version": "3.0",
  "TenantUserId": "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

请求参数定义

参数名	参数说明	必填	参数类型	值举例	备注
Version	版本号	Y	String	3.0	固定为3.0。
MsgID	唯一标识	Y	String	1000120150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
CorpCode	操作企业账号	Y	String		企业账号
TenantUserId	操作人帐号	Y	String	HW_000001	1、如果是系统维护，写"sysadmin" 2、如果是普通员工维护，写员工id
ObjectNameList	对象名称列表	Y	List		最大100条

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
ResultCode	返回码	Y	String	0	0表示成功，其他值为失败
Description	描述	Y	String	Success	描述信息，出错时为错误信息即错误原因
SignedUrlList	签名地址列表	Y	List<SignedUrlInfo>

SignedUrlInfo

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

样例

请求示例

{
  "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"
      }
  ]
}

付款单

# 付款单

# 查询付款单列表

# 接口URL

# 请求参数定义

# 响应参数定义

# PaymentInfo

# 样例

# 付款单明细查询

# 接口URL

# 请求参数定义

# 响应参数定义

# AirPaymentDetail

# CarPaymentDetail

# HotelPaymentDetail

# TrainPaymentDetail

# PaymentBenefitInfo

# PaymentDetailFeeItem

# CheckinPersonInfo

# 样例

# 付款单附件列表查询

# 接口URL

# 请求参数定义

# 响应参数定义

# PaymentFileInfo

# 样例

# 附件签名URL获取

# 接口URL

# 请求参数定义

# 响应参数定义

# SignedUrlInfo

# 样例

付款单

查询付款单列表

接口URL

请求参数定义

响应参数定义

PaymentInfo

样例

付款单明细查询

接口URL

请求参数定义

响应参数定义

AirPaymentDetail

CarPaymentDetail

HotelPaymentDetail

TrainPaymentDetail

PaymentBenefitInfo

PaymentDetailFeeItem

CheckinPersonInfo

样例

付款单附件列表查询

接口URL

请求参数定义

响应参数定义

PaymentFileInfo

样例

附件签名URL获取

接口URL

请求参数定义

响应参数定义

SignedUrlInfo

样例