票据查询

  • url:/common/invoiceOutput/query
  • method:post
  • 数据格式:json

说明

  • 销项开票票据信息查询口

请求参数

字段类型和长度限制可参照java类型。例Date: 2022-07-21T17:07:42.000Z

字段名称 字段类型 字段描述 是否必填 长度限制
bizId String 业务唯一识别码 true 36
timestamp Long 当前次接口同步时间对应的时间戳 true 13
data.page_num Integer 分页页数 (默认1,最小1) false
data.page_size Integer 分页条数 (默认50) false
data.field Object Array 需要查询的字段 true
data.invoice_type Object Array 发票类型列表 false
data.invoice_code String 发票代码 false
data.invoice_num String 发票号码 false
data.receipt_date_from long 发票日期-开始时间(13位数字时间戳) false 13
data.receipt_date_to long 发票日期-结束时间(13位数字时间戳) false 13
data.buyer_name String 购买方 false
data.saler_name String 销售方 false
data.amount_from decimal 发票金额范围起 false
data.amount_to decimal 发票金额范围止 false
data.header_type_id Object Array 单据类型列表 false
data.output_status String 开票状态 false
data.cancel_status String 作废状态 false
data.abnormal_status String 异常状态 false
data.document_num String 开票单号 false
data.creation_date_from long 创建日期-开始时间(13位数字时间戳) false 13
data.creation_date_to long 创建日期止-结束时间(13位数字时间戳) false 13
data.approved_date_from long 审批通过日期-开始时间(13位数字时间戳) false 13
data.approved_date_to long 审批通过日期-结束时间(13位数字时间戳) false 13
data.branch_id long 分公司id false
data.header_id long 开票单据id false
data.cancel_header_id long 作废or红冲单据id false
data.cancel_document_num String 作废or红冲单号 false
data.type String 发票目前状态 false

data.field字段可选值

字段名称 字段描述
output_invoice_id 销项发票主键
company_id 公司id
branch_id 分公司id
header_type_id 单据类型
document_num 单据号
header_id 开票申请单据id
cancel_header_id 作废/红冲单据id
cancel_document_num 作废/红冲单据号
cancel_header_type_id 作废/红冲单据类型
invoice_type 发票类型
invoice_num 发票号码
invoice_code 发票代码
invoice_serial 发票校验码
receipt_date 开票日期
buyer_name 购买方名称
buyer_tax_code 购买方税号
saler_name 销售方名称
saler_tax_code 销售方税号
amount 含税金额
net_amount 不含税金额
tax_amount 税额
payee 收款人
reviewer 复核人
drawer 开票人
invoice_attachments 发票影像
invoice_detail 发票明细
comments 备注
fail_message 失败信息
output_status 开票状态 submitted待开票 approving开票中 approved开票成功 rejected开票失败
cancel_status 作废状态 submitted未作废 approving作废中 approved已作废 rejected作废失败
abnormal_status 异常状态 normal正常 cancel作废 reverse红冲
type 单据类型 cancel 作废 reverse 红冲
approved_date 审批通过日期
cancel_date 作废日期
creation_date 创建日期
last_update_date 最后更新日期

data.invoice_type可选值

字段名称 字段描述
01 增值税专用发票
04 增值税普通发票
08 增值税电子专用发票
10 增值税电子普通发票
11 增值税普通发票(卷票)

data.output_status可选值

字段名称 字段描述
submitted 待开票
approving 开票中
approved 开票成功
rejected 开票失败

data.cancel_status可选值

字段名称 字段描述
submitted 未作废
approving 作废中
approved 已作废
rejected 作废失败

data.abnormal_status可选值

字段名称 字段描述
normal 正常
cancel 作废
reverse 红冲

data.type可选值

字段名称 字段描述
cancel 作废
reverse 红冲

请求示例

{
    "bizId": "123456789",
    "timestamp": 1662536452000,
    "data": {
        "page_num": 1,
        "page_size": 50,
        "invoice_type":["01"],
        "field": [
            "invoice_type",
            "buyer_name",
            "buyer_tax_code",
            "header_type_id",
            "document_num",
            "net_amount",
            "tax_amount",
            "amount",
            "creation_date",
            "comments",
            "fail_message",
            "invoice_attachments",
            "invoice_detail"
        ]
    }
}

返回参数

字段名称 字段类型 字段描述
resCode Integer 状态码
resMsg String 描述
data.page_num Integer 分页数
data.total_page Integer 总页数
data.page_size Integer 分页大小
data.total_count Integer 总条数
data.page_info Object Array 数据结果列表
data.page_info.company_id Integer 公司id
data.page_info.output_invoice_id Integer 发票id
data.page_info.branch_id Integer 分公司id
data.page_info.header_type_id Integer 单据类型
data.page_info.cancel_header_type_id Integer 作废/红冲单据类型
data.page_info.header_id Integer 开票申请单据id
data.page_info.cancel_header_id Integer 作废/红冲单据id
data.page_info.document_num String 单据号
data.page_info.cancel_document_num String 作废/红冲单据号
data.page_info.invoice_type String 发票类型
data.page_info.invoice_type_vo Object 发票类型对应vo
data.page_info.invoice_type_vo.invoice_type String 票据类型编号
data.page_info.invoice_type_vo.type_meaning String 票据类型编号对应含义
data.page_info.invoice_type_vo.enabled_flag String
data.page_info.invoice_type_vo.invoice_class String 票据的大类别
data.page_info.invoice_type_vo.icon_url String 显示图标
data.page_info.invoice_type_vo.einvoice_flag String 电子发票标志
data.page_info.invoice_type_vo.vat_flag String
data.page_info.invoice_type_vo.group_type String
data.page_info.invoice_type_vo.output_invoice_flag String
data.page_info.invoice_num String 发票号码
data.page_info.invoice_code String 发票代码
data.page_info.receipt_date Long 开票日期
data.page_info.buyer_name String 购买方名称
data.page_info.buyer_tax_code String 购买方税号
data.page_info.saler_name String 销售方名称
data.page_info.saler_tax_code String 销售方税号
data.page_info.amount decimal 含税金额
data.page_info.net_amount decimal 不含税金额
data.page_info.tax_amount decimal 税额
data.page_info.payee String 收款人
data.page_info.reviewer String 复核人
data.page_info.drawer String 开票人
data.page_info.invoice_attachments Object Array 发票影像
data.page_info.invoice_attachments.file_name String 文件名
data.page_info.invoice_attachments.created_by Integer 创建人
data.page_info.invoice_attachments.attachment_url String 文件url
data.page_info.comments String 备注
data.page_info.fail_message String 失败信息
data.page_info.output_status String 开票状态
data.page_info.cancel_status String 作废状态
data.page_info.abnormal_status String 异常状态
data.page_info.creation_date Long 创建日期
data.page_info.last_update_date Long 最后更新日期
data.page_info.type String 单据类型
data.page_info.invoice_serial String 发票校验码
data.page_info.approved_date Long 审批通过日期
data.page_info.cancel_date Long 作废日期
data.page_info.invoice_detail Object 发票明细
data.page_info.invoice_detail.TaxAmount decimal 税额
data.page_info.invoice_detail.Saler.TaxCode String 销售方税号
data.page_info.invoice_detail.Saler.AccountBank String 销售方开户行及账号
data.page_info.invoice_detail.Saler.AddressPhone String 销售方地址电话
data.page_info.invoice_detail.Saler.Name String 销售方名称
data.page_info.invoice_detail.Amount decimal 不含税金额
data.page_info.invoice_detail.SummaryAmount decimal 含税金额
data.page_info.invoice_detail.Buyer Object 购买方信息
data.page_info.invoice_detail.Buyer.TaxCode String 购买方税号
data.page_info.invoice_detail.Buyer.AccountBank String 购买方开户行及账号
data.page_info.invoice_detail.Buyer.AddressPhone String 购买方地址电话
data.page_info.invoice_detail.Buyer.Name String 购买方名称
data.page_info.invoice_detail.Items Object Array 销货清单
data.page_info.invoice_detail.Items.Price decimal 单价
data.page_info.invoice_detail.Items.Amount decimal 金额
data.page_info.invoice_detail.Items.TaxRate decimal 税率
data.page_info.invoice_detail.Items.Quantity decimal 数量
data.page_info.invoice_detail.Items.Specification String 规格型号
data.page_info.invoice_detail.Items.Unit String 单位
data.page_info.invoice_detail.Items.Name String 货物或应税劳务、服务

返回示例

{
    "resCode": 200000,
    "resMsg": "success",
    "data": {
        "page_num": 1,
        "total_page": 1,
        "page_size": 50,
        "total_count": 1,
        "page_info": [
            {
                "invoiceAttachments": "[{\"file_name\": \"34a70631-1e4f-4eb5-be1e-43da5151c036.pdf\", \"created_by\": 224148, \"attachment_url\": \"21774/2022/01-13/formatFileBuild/84f3fe89-9ec9-4eb7-8ccc-370b0cf4078c.pdf\"}]",
                "company_id": 3809,
                "output_invoice_id": 46204032,
                "branch_id": 100001,
                "header_type_id": 144625,
                "header_id": 731249,
                "invoice_type": "01",
                "invoice_type_vo": {
                    "invoice_type": "01",
                    "type_meaning": "增值税专用发票",
                    "enabled_flag": "Y",
                    "invoice_class": "VAT",
                    "icon_url": "rec_invoice_z.png",
                    "vat_flag": "Y",
                    "group_type": "01",
                    "output_invoice_flag": "Y"
                },
                "invoice_attachments": [
                    {
                        "file_name": "34a70631-1e4f-4eb5-be1e-43da5151c036.pdf",
                        "created_by": 224148,
                        "attachment_url": "21774/2022/01-13/formatFileBuild/84f3fe89-9ec9-4eb7-8ccc-370b0cf4078c.pdf"
                    }
                ],
                "invoice_detail": {
                    "TaxAmount": 627.63,
                    "Saler": {
                        "TaxCode": "12131231",
                        "AccountBank": "123123 123123123",
                        "AddressPhone": "12312312 123123",
                        "Name": "销项开票公司0002"
                    },
                    "Amount": 5958.37,
                    "SummaryAmount": 6586,
                    "Buyer": {
                        "TaxCode": "1231231",
                        "AccountBank": "123 213123",
                        "AddressPhone": "123 123123",
                        "Name": "customer0006"
                    },
                    "Items": [
                        {
                            "Price": 287.5,
                            "Amount": 862.5,
                            "TaxRate": 0.12,
                            "Quantity": 3,
                            "Specification": "asddd",
                            "Unit": "千克",
                            "Name": "测试商品0024"
                        },
                        {
                            "Price": 970.87,
                            "Amount": 970.87,
                            "TaxRate": 0.03,
                            "Quantity": 1,
                            "Specification": "asddd",
                            "Unit": "盒",
                            "Name": "测试商品0003"
                        },
                        {
                            "Price": 198.21,
                            "Amount": 1982.14,
                            "TaxRate": 0.12,
                            "Quantity": 10,
                            "Specification": "CMCT87300",
                            "Unit": "千克",
                            "Name": "测试商品0031"
                        },
                        {
                            "Price": 1071.43,
                            "Amount": 2142.86,
                            "TaxRate": 0.12,
                            "Quantity": 2,
                            "Specification": "asddd",
                            "Unit": "盒",
                            "Name": "测试商品0019"
                        }
                    ]
                }
            }
        ]
    }
}

results matching ""

    No results matching ""