付款单
付款单
查询付款单列表
接口URL
/account/payment_list/query
请求参数定义
参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
---|---|---|---|---|---|---|
CorpCode | 企业账号 | Y | String | 1000 | 系统提供的企业账号 | |
Timestamp | 时间戳 | Y | String | 14 | 20220808103019 | 服务方允许20分钟内的时间误差 |
Version | 版本号 | Y | String | 3.0 | 固定为3.0 | |
LoginName | 操作人账号 | Y | String | zhangsan@huawei.com | 1、如果是系统维护,写“sysadmin”查询企业下全量数据,用此账号 2、 如果是普通员工维护,写员工登录名。查询员工名下订单,用此账号 | |
MsgID | 唯一标识流水号 | Y | String | 1000020150511190411000001 | 企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN | |
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:酒店 |
样例
请求示例
{
"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 | 企业账号 | Y | String | 1000 | 系统提供的企业账号 | |
Timestamp | 时间戳 | Y | String | 14 | 20180811113019 | 服务方允许20分钟内的时间误差 |
Version | 版本号 | Y | String | 3.0 | 固定为3.0 | |
LoginName | 操作人账号 | Y | String | zhangsan@huawei.com | 1、如果是系统维护,写“sysadmin”查询企业下全量数据,用此账号 2、 如果是普通员工维护,写员工登录名。查询员工名下订单,用此账号 | |
MsgID | 唯一标识流水号 | Y | String | 1000020150511190411000001 | 企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN | |
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
请求参数定义
参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
---|---|---|---|---|---|---|
CorpCode | 企业账号 | Y | String | 1000 | 系统提供的企业账号 | |
Timestamp | 时间戳 | Y | String | 14 | 20220808103019 | 服务方允许20分钟内的时间误差 |
Version | 版本号 | Y | String | 3.0 | 固定为3.0 | |
LoginName | 操作人账号 | Y | String | zhangsan@huawei.com | 1、如果是系统维护,写“sysadmin”查询企业下全量数据,用此账号 2、 如果是普通员工维护,写员工登录名。查询员工名下订单,用此账号 | |
MsgID | 唯一标识流水号 | Y | String | 1000020150511190411000001 | 企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN | |
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",
"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 | 企业账号 | Y | String | 1000 | 系统提供的企业账号 | |
Timestamp | 时间戳 | Y | String | 14 | 20220808103019 | 服务方允许20分钟内的时间误差 |
Version | 版本号 | Y | String | 3.0 | 固定为3.0 | |
LoginName | 操作人账号 | Y | String | zhangsan@huawei.com | 1、如果是系统维护,写“sysadmin”查询企业下全量数据,用此账号 2、 如果是普通员工维护,写员工登录名。查询员工名下订单,用此账号 | |
MsgID | 唯一标识流水号 | Y | String | 1000020150511190411000001 | 企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN | |
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": "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"
}
]
}