文档首页 > > API参考> 管理发票> 管理发票> 查询发票列表

查询发票列表

分享
更新时间: 2020/01/09 GMT+08:00

功能介绍

客户可以查询发票列表。

Web UI

进入“发票管理”页面。“发票管理”页面显示发票列表。

REST API

客户可以在客户自建平台上查询发票列表。

该接口可以使用客户AK/SK或者Token调用。

  1. URI

    GET /v1.0/{domain_id}/payments/invoices

    参数

    是否必选

    取值范围

    描述

    domain_id

    最大长度:64

    客户账号ID。获取方法请参见如何获取customer_id/domain_id

  2. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    start_time

    String

    最大长度:64

    发票申请开始时间。

    end_time

    String

    最大长度:64

    发票申请结束时间。

    offset

    Integer

    [1-99999]

    页码。

    limit

    Integer

    [1-100]

    每页大小。

    请求示例

    GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/payments/invoices
    Content-Type: application/json
    Authorization: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ 
  3. 响应消息

    响应参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    error_code

    String

    最大长度:20

    状态码。具体请参考4。只有失败才返回该字段。

    error_msg

    String

    最大长度:1000

    错误描述信息。只有失败才返回该字段。

    count

    integer

    [1-最大整数]

    记录数,只有成功的时候才返回这个字段。

    invoices

    list<InvoiceRequestInfo>

    -

    发票信息列表,具体参见表1

    表1 RequestIdInfo

    参数

    是否必选

    参数类型

    取值范围

    描述

    requestId

    String

    最大长度:64

    请求ID。

    cancelReason

    String

    最大长度:256

    驳回原因。

    titleType

    Integer

    [0-2]

    开票类型。

    • 0:个人
    • 1:企业
    • 2:组织

    channelType

    Integer

    [0-1]

    渠道类型。

    • 0:华为云
    • 1:云市场

    invoiceType

    Integer

    [0-1]

    发票类型

    • 0:增值税专用发票
    • 1:增值税普通发票

    invoiceTitle

    String

    最大长度:2048

    发票抬头。

    invoiceAmount

    Number

    -

    开票金额。

    invoiceMethod

    Integer

    [0-2]

    开票方式

    • 0:账期
    • 1:到账
    • 2:订单

    invoiceState

    Integer

    -

    开票状态。

    • 0:草稿
    • 1:待审核
    • 4:等待导出发票文件
    • 5:等待发票文件回填
    • 6:等待邮寄确认
    • 7:等待回执确认
    • 8:完成
    • 9:已退票
    • 11:等待驳回审核
    • 13:退票待审核
    • 14:待退票状态回填
    • 15:退票失败

    postAddres

    PostAddressInfo

    -

    邮寄地址信息,具体参见表2

    applyOpera

    String

    最大长度:32

    申请人员的用户名

    auditMemo

    String

    最大长度:256

    审核意见。

    trackNo

    String

    最大长度:128

    快递单号。

    taxRegNo

    String

    最大长度:32

    税务登记号。

    salesId

    String

    -

    签约主体。

    • 0041:华为软件
    • 0021:华为技术

    taxRate

    String

    最大长度:64

    税率。

    applyTime

    String

    最大长度:64

    申请时间。

    invoiceMode

    Integer

    [0-1]

    发票模式。

    • 0:纸质票
    • 1:电子票

    isvId

    String

    最大长度:64

    服务商ID。

    isvName

    String

    最大长度:256

    服务商名称。

    invoiceNo

    String

    最大长度:32

    发票号码。

    表2 PostAddressInfo

    参数

    是否必选

    参数类型

    取值范围

    描述

    address

    String

    最大长度:1024

    邮寄收件人地址。

    recipients

    String

    最大长度:1024

    邮寄收件人。

    zipCode

    String

    最大长度:256

    收件人地址所在地邮编。

    mobilephone

    String

    最大长度:256

    收件人手机号码。

    响应示例

    HTTP/1.1 204 No Content
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time 
    
    {
        "count": 2,
        "invoices": [
            {
                "requestId": "IV191024068F72",
                "cancelReason": null,
                "titleType": 1,
                "channelType": 0,
                "invoiceType": 0,
                "invoiceTitle": "q1",
                "invoiceAmount": 12.0,
                "invoiceMethod": 1,
                "invoiceState": 1,
                "postAddress": {
                    "address": "中国 北京市  北京市 东城区 大",
                    "recipients": "达到",
                    "zipCode": "100100",
                    "mobilePhone": "14356789878"
                },
                "applyOpera": "wWX168032",
                "auditMemo": null,
                "trackNo": null,
                "taxRegNo": null,
                "salesId": "0041",
                "taxRate": "0.06",
                "applyTime": "2019-10-24T06:38:42Z",
                "invoiceMode": 0,
                "isvId": "0",
                "isvName": "华为云",
                "invoiceNo": null
            },
            {
                "requestId": "IV19102402FV78",
                "cancelReason": null,
                "titleType": 1,
                "channelType": 0,
                "invoiceType": 0,
                "invoiceTitle": "q1",
                "invoiceAmount": 12.0,
                "invoiceMethod": 1,
                "invoiceState": 1,
                "postAddress": {
                    "address": "中国 北京市  北京市 东城区 大",
                    "recipients": "撒打算",
                    "zipCode": "100101",
                    "mobilePhone": "155425233544"
                },
                "applyOpera": "wWX168032",
                "auditMemo": null,
                "trackNo": null,
                "taxRegNo": null,
                "salesId": "0041",
                "taxRate": "0.06",
                "applyTime": "2019-10-24T02:44:00Z",
                "invoiceMode": 0,
                "isvId": "0",
                "isvName": "华为云",
                "invoiceNo": null
            }
        ]
    }
  4. 状态码

    HTTP状态码

    错误码

    错误描述

    403

    CBC.0151

    访问拒绝。

    400

    CBC.0100

    输入参数校验失败。

    500

    CBC.0999

    其他错误。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区