账单附件分页查询

  • 接口：/common/billAttachment/findPageByBill
  • Method：GET
  • 接口说明：根据渠道和账单编码分页查询账单附件信息

参数

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制(字节)
source String 渠道 TRUE 无
bill_code String 账单编码 TRUE 无
page_num Integer 页码 FALSE 默认值：1
page_size Integer 每页大小 FALSE 默认值：100，最大2000

返回参数

字段名称 字段类型 字段描述
resCode Integer 响应状态码（见附录）
resMsg String 返回信息描述
data PageHelper<BillAttachmentVo> 账单附件分页信息

PageHelper<BillAttachmentVo>

字段名称 字段类型 字段描述
page_size Integer 每页大小
page_num Integer 当前页码
total_count Integer 总记录数
total_page Integer 总页数
is_first_page Boolean 是否首页
is_last_page Boolean 是否末页
page_info List<BillAttachmentVo> 账单附件信息列表

BillAttachmentVo

字段名称 字段类型 字段描述
attachment_url String 附件地址
file_name String 文件名
file_type String 文件类型
source String 渠道
source_type String 产品类型
order_id String 订单号
bill_code String 账单编码
bill_code_sub String 账单子编码（有些渠道没子账单，该是空的）
type String 附件类型
description String 描述信息
detail Object 票据格式化后的信息

detail字段说明：

detail字段包含票据格式化后的信息，不同附件类型包含的字段如下：

字段名称 字段类型 字段描述 是否必填
amount BigDecimal 总金额 否
amount_without_tax BigDecimal 不含税金额 否
attachment_type String 附件类型，可选值：itinerary（行程单）、invoice（发票） 否
ticket_no String 票号 否
order_list Array 订单列表 否
passenger_name String 乘客姓名 否
invoice_code String 发票号码 否

示例：

请求数据

GET /common/billAttachment/findPageByBill?source=alibtrip&bill_code=2025-07-01&page_num=1&page_size=100

返回数据

{
    "resCode": 200000,
    "resMsg": "success",
    "data": {
        "page_size": 100,
        "page_num": 1,
        "total_count": 2,
        "total_page": 1,
        "is_first_page": true,
        "is_last_page": true,
        "page_info": [
            {
                "attachment_url": "test/url/测试/v6",
                "file_name": "测试文件名.xml",
                "file_type": "xml",
                "source": "alibtrip",
                "source_type": "flight",
                "order_id": "32369548858",
                "bill_code": "2025-07-01",
                "bill_code_sub": "",
                "type": "receipt",
                "description": "测试的描述信息v3",
                "detail": {
                    "invoice_code": "INV20240710A",
                    "amount": 1500.75,
                    "amount_without_tax": 1200.0,
                    "attachment_type": "invoice"
                }
            },
            {
                "attachment_url": "test/url/测试/v5",
                "file_name": "测试文件名.ofd",
                "file_type": "ofd",
                "source": "alibtrip",
                "source_type": "flight",
                "order_id": "32369548858",
                "bill_code": "2025-07-01",
                "bill_code_sub": "",
                "type": "receipt",
                "description": "测试的描述信息v2",
                "detail": {
                    "amount": 123.45,
                    "amount_without_tax": 100.0,
                    "attachment_type": "itinerary",
                    "ticket_no": "TICKET12345",
                    "order_list": [
                        "ORDER67890"
                    ],
                    "passenger_name": "John Doe"
                }
            }
        ]
    }
}

results matching ""

    No results matching ""