结算查询

  • 接口：common/statements/findByPage

  • Method：GET

  • 接口说明：根据请求条件分页查询结算

参数

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制(字节)
bizId String 业务唯一识别码 TRUE 255
timestamp Long 时间戳 TRUE 无
page_num Integer 分页页数 (最小1) FALSE 无
page_size Integer 分页条数 (仅支持传20，50，100) FALSE 无
order_ids List<String> 订单号列表 FALSE 无
statement_ids List<String> 结算id列表 FALSE 无
link_header_ids List<Long> 关联申请单id列表 FALSE 无
user_names List<String> 用户名列表 FALSE 无
employee_numbers List<String> 员工号列表 FALSE 无
check_status Integer 校验状态 FLASE 无
expense_ids List<Long> 修复记录id列表 FALSE 无
journey_ids List<String> 申请单号列表 FALSE 无
order_datetime_from Date 订单时间-开始时间 FALSE 无
order_datetime_to Date 订单时间-开始时间 FALSE 无
statement_datetime_from Date 结算时间-开始时间 FALSE 13
statement_datetime_to Date 结算时间-结束时间 FALSE 13
start_date_from Date 结算开始时间-开始时间 FALSE 13
start_date_to Date 结算开始时间-结束时间 FALSE 13
userIds List<Long> 创建人的userId的list FALSE 13

返回参数

字段名称 字段类型 字段描述
resCode Integer 响应状态码（见附录）
resMsg String 返回信息描述
bizId String 业务唯一识别码
data Data 分页查询到的订单信息

Data

字段名称 字段类型 字段描述
page_size Integer 分页条数
page_num Integer 分页页数
total_count Long 订单总数
total_page Integer 总页数
is_first_page Boolean 是否是是首页
is_last_page Boolean 是否是最后一页
page_info List 结算数据集合

StatementVo

字段名称 字段类型 字段描述
statement_id String 结算id
statement_type String 结算类型
bind_id String 第三方平台的员工绑定id
user_id Long 员工id
order_id String 订单编号（云间系统内渠道唯一，如果订单号重复，会根据此订单编号做更新）
source String 订单来源，标准值列表 -附录1：渠道
source_type String 订单类型，标准值列表 -附录2：订单类型
detail detail 详细信息，具体分为机票（flightDetail）、酒店（hotelDetail）、火车票（trainDetail）、用车（taxiDetail）
check_batch_no String 结算单批次号
balance_batch_no String 付款批次号
data String 第三方回传元数据
amount Decimal 订单总额
company_pay Decimal 公司支付金额
journey_id String 第三方传回的申请单号
link_header_id Long 申请单的header_id
link_line_id Long 申请单的line_id
destination_city Integer 出发城市在云简的城市编号
destination_city_to Integer 到达城市在云简的城市编号
passengers List<String> 出行人/入住人的姓名数组
order_datetime Date 订单时间
start_datetime Date 开始时间
end_datetime Date 结束时间
statement_datetime Date 结算创建时间
pay_type Integer 支付方式，标准值列表 -附录3：支付方式，空值默认为公司支付
description String 描述
comments String 备注

flightDetail

字段名称 字段类型 字段描述
flight_no string 航班号
is_share boolean 是否是共享航班
carrier string 共享航班号
air_company string 航空公司
air_company_code string 航司代码
seat int 舱位在云简的代码，附录6：舱位
cabin string 舱位中文名字
cabin_type string 舱位的航司编码
dep_city int 出发城市在云简系统内的城市编号
dep_datetime string 出发时间yy-MM-DD hh:mm:ss
dep_term string 出发航站楼
dep_city_name string 出发城市名字
dep_airport string 出发机场
dep_airport_code string 出发机场代码
arr_city int 到达城市在云简系统内的城市编号
arr_datetime string 到达时间yy-MM-DD hh:mm:ss
arr_term string 到达航站楼
arr_city_name string 到达城市
arr_airport string 到达机场
arr_airport_code string 到达机场的代码
currency string 价格币种
order_id string 订单号，渠道内唯一
fly_time int 飞行时间，秒
discount decimal 折扣，经济舱按1计，例8折为0.80
yprice decimal 经济舱价格，没有可不填或填0
price decimal 机票价格（改签结算单时，是升舱费），没有可不填或填0
amount decimal 结算总价，没有可不填或填0
taxation decimal 总税费（国际机票就是税费，国内机是基建费+燃油费），没有可不填或填0
oil_fee decimal 燃油费，没有可不填或填0
airport_fee decimal 机建费，没有可不填或填0
service_price decimal 预定服务费，没有可不填或填0
statement_id string 结算单号，渠道内唯一
full_name string 预定人名字
ticket_no string 票号，有的话尽量提供
document_num string 云简的申请单号，有的话尽量提供
change_price decimal 改签费，没有可不填或填0
change_service_price decimal 改签服务费，没有可不填或填0
refund_price decimal 退票费，没有可不填或填0
refund_service_price decimal 退票服务费，没有可不填或填0
passenger_name List<string> 出行人名字列表，这里机票原则上是单人
statement_date string 结算日期yy-MM-DD hh:mm:ss
order_date string 预定日期yy-MM-DD hh:mm:ss
send_ticket_price decimal 送票费，没有可不填或填0
send_invoice_price decimal 配送报销行程单的费用，没有可不填或填0
insurance_price decimal 保险费，没有可不填或填0
other_price List<otherPrice> 其他价格，没有不填，otherPrice

hotelDetail

字段名称 字段类型 字段描述
order_id string 订单号
statement_id string 结算单号，渠道内唯一
document_num string 云简的申请单号
price decimal 房费，没有可不填或填0
amount decimal 结算总价，没有可不填或填0
service_price decimal 预定服务费，没有可不填或填0
extra_charge decimal 后收服务费（补税点的费用），没有可不填或填0
send_invoice_price decimal 配送发票的费用，没有可不填或填0
invoice_type int 发票类型，附录12：发票类型
currency String 币种
star int 星级
hotel_name String 酒店名字
hotel_address String 酒店地址
rooms int 房间数
room_type String 房型名
city_id int 云简的城市编号
city_name string 城市名字
end_date String 离店日期yyyy-MM-DD
start_date String 入住日期yyyy-MM-DD
full_name String 预定人名字
order_date String 预定日期 yyyy-MM-DD hh:mm:ss
passenger_name List<String> 入住人名字数组
statement_date String 结算时间 yyyy-MM-DD hh:mm:ss
other_price List<otherPrice> 其他价格，没有不填，otherPrice

trainDetail

字段名称 字段类型 字段描述
statement_id string 结算单号
order_id string 订单号
train_no string 车次，例，G235
train_code string 第三方车次编码
train_class int 舱位代码，附录21：火车票坐席代码
train_class_name string 舱位名字，例2等座。
train_type int 火车类型编码，附录22：火车类型代码
train_type_name string 火车类型，比如动车、快车等
price decimal 价格，单个行程，没有可不填或填0
dep_city int 出发城市在云简系统内的城市编号
dep_date_time string 出发日期 YYYY-MM-DD hh:mm:ss
dep_station_code int 出发火车站编码
dep_station_name string 出发火车站名称
dep_station_en string 出发火车站名称英文
dep_city_name string 出发城市名字
arr_city int 到达城市在云简系统内的城市编号
arr_date_time string 到达日期 YYYY-MM-DD hh:mm:ss
arr_station_code integer 到达火车站编码
arr_station_name string 到达火车站名称
arr_station_en string 到达火车站名称英文
arr_city_name string 到达城市
amount decimal 总的支付金额，没有可不填或填0
service_price decimal 预定服务费，没有可不填或填0
change_price decimal 改签费，没有可不填或填0
change_service_price decimal 总改签服务费，没有可不填或填0
refund_price decimal 退票金额，没有可不填或填0
refund_service_price decimal 总退票服务费，没有可不填或填0
insurance_price decimal 总保险费，没有可不填或填0
send_ticket_price decimal 配送费，没有可不填或填0
paper_ticket_fee decimal 纸质票出票费，没有可不填或填0
grab_service_fee decimal 抢票费，没有可不填或填0
card_no String 证件号码
card_type String 证件类型
card_type_id int 证件类型编号，附录7：证件类型
passenger_name String 用户名字（证件上的名字）
passenger_type String 乘客类型的描述
passenger_type_id Int 乘客类型编号附录8：乘客类型
gender String F为女，M为男附录19：性别
user_id Int 云简提供的员工序号，非本公司员工可不填
ticket_no String 票号

taxiDetail

字段名称 字段类型 字段描述
statement_id string 结算单号，渠道内唯一
amount decimal 实际变动金额（结算的本质是和月度账单能够对齐），没有可不填或填0，amount = price - refund_price；amount = company_pay + person_pay
price decimal 原始总价，没有可不填或填0，price = amount + refund_price；price = company_pay + company_refund + person_pay + person _refund
order_id string 订单号
refund_price decimal 实际退款金额，没有可不填或填0
document_num string 申请单号
mileage decimal 里程
pay_time string 支付时间 YYYY-MM-DD hh:mm:ss
phone string 预定人手机号
city_name string 城市名字
city_id int 城市编号
company_pay decimal 公司实际支付金额，没有可不填或填0
person_pay decimal 个人实际支付金额，没有可不填或填0
is_invoice int 0，未开票，1已开票
use_car_type int 用车类型，附录10：用车方式
location_from string 出发地址
location_to string 到达地址
order_date string YYYY-MM-DD hh:mm:ss
start_datetime string 出发时间YYYY-MM-DD hh:mm:ss
end_datetime string 到达时间YYYY-MM-DD hh:mm:ss
company_refund decimal 公司实际退款，没有可不填或填0
person _refund decimal 个人实际退款，没有可不填或填0
passenger_phone string 乘客手机号
passenger_name string 乘客名字
refund_time string 退款时间 YYYY-MM-DD hh:mm:ss

otherPrice

字段名称 字段类型 字段描述
price decimal 金额
price_type decimal 费用的描述（比如：餐费）

示例：

请求数据

https://topenapi.cloudpense.com/common/statements/findByPage?bizId=1695540440000&timestamp=1695540440000&order_ids=100424293497216

返回数据

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "1695540440000",
  "data": {
    "page_size": 100,
    "page_num": 1,
    "total_count": 4,
    "total_page": 1,
    "is_first_page": true,
    "is_last_page": true,
    "page_info": [
      {
        "source": "ctrip_chengxi",
        "detail": {
          "oil_fee": 50.0,
          "dep_city": 1,
          "discount": 0.79,
          "send_invoice_price": 0.0,
          "change_service_price": 0.0,
          "refund_price": 0.0,
          "dep_city_name": "上海",
          "statement_date": "2024-12-02 14:10:50.000",
          "bind_id": "TP20240628",
          "flight_no": "MU5099",
          "price": 1680.0,
          "ticket_no": "781-3023110045",
          "document_num": "",
          "air_company_code": "MU",
          "currency": "CNY",
          "fly_time": 140,
          "passenger_list": [
            0
          ],
          "refund_service_price": 0.0,
          "amount": 1791.0,
          "passengers": [
            "白兰地"
          ],
          "coupon": 0.0,
          "arr_airport": "首都国际机场",
          "dep_datetime": "2024-12-04 07:00:00.000",
          "service_price": 11.0,
          "arr_city_name": "北京",
          "yprice": 2150.0,
          "statement_id": "3800424653918888",
          "dep_airport": "虹桥国际机场",
          "order_date": "2024-12-02 14:09:36.000",
          "full_name": "测试结算",
          "arr_datetime": "2024-12-04 09:20:00.000",
          "insurance_price": 0.0,
          "user_id": 0,
          "send_ticket_price": 0.0,
          "service_package_price": 0.0,
          "change_price": 0.0,
          "order_id": "100424293497216",
          "taxation": 50.0,
          "airport_fee": 50.0
        },
        "passengers": [
          "白兰地"
        ],
        "amount": 1791.00,
        "source_type": "flight",
        "statement_id": "3800424653918888",
        "statement_type": 1,
        "order_id": "100424293497216",
        "passenger_list": [
          0
        ],
        "company_pay": 1791.00,
        "bind_id": "TP20240306",
        "order_datetime": 1733119776000,
        "start_datetime": 1733266800000,
        "end_datetime": 1733275200000,
        "statement_datetime": 1733119850000,
        "destination_city": 1
      },
      {
        "source": "ctrip_chengxi",
        "detail": {
          "oil_fee": 50.0,
          "dep_city": 1,
          "discount": 0.79,
          "send_invoice_price": 0.0,
          "change_service_price": 0.0,
          "refund_price": 0.0,
          "dep_city_name": "上海",
          "statement_date": "2024-12-02 14:10:50.000",
          "bind_id": "TP20240306",
          "flight_no": "MU5099",
          "price": 1680.0,
          "ticket_no": "781-3023110046",
          "document_num": "",
          "air_company_code": "MU",
          "currency": "CNY",
          "fly_time": 140,
          "passenger_list": [
            0
          ],
          "refund_service_price": 0.0,
          "amount": 1791.0,
          "passengers": [
            "测试结算"
          ],
          "coupon": 0.0,
          "arr_airport": "首都国际机场",
          "dep_datetime": "2024-12-04 07:00:00.000",
          "service_price": 11.0,
          "arr_city_name": "北京",
          "yprice": 2150.0,
          "statement_id": "3800424653917768",
          "dep_airport": "虹桥国际机场",
          "order_date": "2024-12-02 14:09:36.000",
          "full_name": "测试结算",
          "arr_datetime": "2024-12-04 09:20:00.000",
          "insurance_price": 0.0,
          "user_id": 0,
          "send_ticket_price": 0.0,
          "service_package_price": 0.0,
          "change_price": 0.0,
          "order_id": "100424293497216",
          "taxation": 50.0,
          "airport_fee": 50.0
        },
        "passengers": [
          "测试结算"
        ],
        "amount": 1791.00,
        "source_type": "flight",
        "statement_id": "3800424653917768",
        "statement_type": 1,
        "order_id": "100424293497216",
        "passenger_list": [
          0
        ],
        "company_pay": 1791.00,
        "bind_id": "TP20240306",
        "order_datetime": 1733119776000,
        "start_datetime": 1733266800000,
        "end_datetime": 1733275200000,
        "statement_datetime": 1733119850000,
        "destination_city": 1
      },
      {
        "source": "ctrip_chengxi",
        "detail": {
          "arr_city": 1,
          "oil_fee": 50.0,
          "discount": 0.79,
          "send_invoice_price": 0.0,
          "change_service_price": 0.0,
          "refund_price": 0.0,
          "dep_city_name": "北京",
          "statement_date": "2024-12-02 14:10:50.000",
          "bind_id": "TP20240628",
          "flight_no": "MU5100",
          "price": 1680.0,
          "ticket_no": "781-3023110040",
          "document_num": "",
          "air_company_code": "MU",
          "currency": "CNY",
          "fly_time": 135,
          "passenger_list": [
            0
          ],
          "refund_service_price": 0.0,
          "amount": 1791.0,
          "passengers": [
            "白兰地"
          ],
          "coupon": 0.0,
          "arr_airport": "浦东国际机场",
          "dep_datetime": "2024-12-03 07:00:00.000",
          "service_price": 11.0,
          "arr_city_name": "上海",
          "yprice": 2150.0,
          "statement_id": "3800424653916616",
          "dep_airport": "首都国际机场",
          "order_date": "2024-12-02 14:09:36.000",
          "full_name": "测试结算",
          "arr_datetime": "2024-12-03 09:15:00.000",
          "insurance_price": 0.0,
          "user_id": 0,
          "send_ticket_price": 0.0,
          "service_package_price": 0.0,
          "change_price": 0.0,
          "order_id": "100424293497216",
          "taxation": 50.0,
          "airport_fee": 50.0
        },
        "passengers": [
          "白兰地"
        ],
        "amount": 1791.00,
        "source_type": "flight",
        "statement_id": "3800424653916616",
        "statement_type": 1,
        "order_id": "100424293497216",
        "check_batch_no": "TMCN3EA206SMJ06P07U",
        "passenger_list": [
          0
        ],
        "company_pay": 1791.00,
        "bind_id": "TP20240306",
        "order_datetime": 1733119776000,
        "start_datetime": 1733180400000,
        "end_datetime": 1733188500000,
        "statement_datetime": 1733119850000,
        "destination_city_to": 1
      },
      {
        "source": "ctrip_chengxi",
        "detail": {
          "arr_city": 1,
          "oil_fee": 50.0,
          "discount": 0.79,
          "send_invoice_price": 0.0,
          "change_service_price": 0.0,
          "refund_price": 0.0,
          "dep_city_name": "北京",
          "statement_date": "2024-12-02 14:10:50.000",
          "bind_id": "TP20240306",
          "flight_no": "MU5100",
          "price": 1680.0,
          "ticket_no": "781-3023080178",
          "document_num": "",
          "air_company_code": "MU",
          "currency": "CNY",
          "fly_time": 135,
          "passenger_list": [
            0
          ],
          "refund_service_price": 0.0,
          "amount": 1791.0,
          "passengers": [
            "测试结算"
          ],
          "coupon": 0.0,
          "arr_airport": "浦东国际机场",
          "dep_datetime": "2024-12-03 07:00:00.000",
          "service_price": 11.0,
          "arr_city_name": "上海",
          "yprice": 2150.0,
          "statement_id": "3800424653915272",
          "dep_airport": "首都国际机场",
          "order_date": "2024-12-02 14:09:36.000",
          "full_name": "测试结算",
          "arr_datetime": "2024-12-03 09:15:00.000",
          "insurance_price": 0.0,
          "user_id": 0,
          "send_ticket_price": 0.0,
          "service_package_price": 0.0,
          "change_price": 0.0,
          "order_id": "100424293497216",
          "taxation": 50.0,
          "airport_fee": 50.0
        },
        "passengers": [
          "测试结算"
        ],
        "amount": 1791.00,
        "source_type": "flight",
        "statement_id": "3800424653915272",
        "statement_type": 1,
        "order_id": "100424293497216",
        "check_batch_no": "TMCN3EA206SMJ06P07U",
        "passenger_list": [
          0
        ],
        "company_pay": 1791.00,
        "bind_id": "TP20240306",
        "order_datetime": 1733119776000,
        "start_datetime": 1733180400000,
        "end_datetime": 1733188500000,
        "statement_datetime": 1733119850000,
        "destination_city_to": 1
      }
    ]
  }
}

results matching ""

    No results matching ""