文档首页 > > API参考> 管理发票> 管理发票> 抵扣欠票后的可开票金额

抵扣欠票后的可开票金额

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

功能介绍

客户可以按照指定账期查询抵扣欠票后的可开票金额,查询结果按照税率分开展示。

Web UI

  1. 进入“发票管理”页面。
  2. 申请开票。

    1. 单击“华为云可开票金额”金额后面的“索取发票”。

    2. 选择需要开票的订单或账期。

      如果当前客户为预付费客户时,仅支持根据订单进行开票(按需消费根据账期每月3号生成上个月的虚拟订单)。

      如果当前客户为后付费客户时,仅支持根据消费账单或里程碑账单进行开票。
      • 消费账单:每月3号生成上个月的账单。客户根据已生成的账单进行开票。
      • 里程碑账单:线下合同中约定的里程碑付款计划。客户根据已付款的账单进行开票。

      当有多个不同税率的订单时,系统会分别展示不同税率的待开票金额。

    即可查看某账期可开票的金额。

REST API

客户可以在客户自建平台上查看抵扣欠票后的可开票金额。

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

  1. URI

    POST /v1.0/{domain_id}/payments/invoices/amount-notdebtinvoice/cycles/query

    表1 路径参数

    参数

    是否必选

    取值范围

    描述

    domain_id

    最大长度:64

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

  2. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    invoiceMethod

    Integer

    0

    开票类型。

    0:按账期

    billCycleInfos

    List<BillCycleInfo>

    最大长度:24

    账期列表,时间跨度不能超过5年。

    表2 BillCycleInfo

    参数

    是否必选

    参数类型

    取值范围

    描述

    billCycle

    String

    最大长度:6

    账期。

    格式:YYYYMM

    请求示例

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

    响应参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    error_code

    String

    最大长度:20

    状态码。

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

    error_msg

    String

    最大长度:1000

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

    taxInvoiceInfos

    List<TaxInvoiceInfo>

    -

    每个税率可开票的金额。

    表3 TaxInvoiceInfo

    参数

    是否必选

    参数类型

    取值范围

    描述

    amountWithoutDebtInvoice

    Number

    -

    可开票总金额(扣除欠票后),如果小于等于0,说明此税率不能开票。

    单位:元

    amountWithDebtInvoice

    Number

    -

    已选开票总额(未扣除欠票前)。

    单位:元

    debtInvoicedAmount

    Number

    -

    欠票金额。

    单位:元

    taxType

    String

    -

    税率。

    响应示例

    HTTP/1.1 204 No Content
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time 
    {
        "taxInvoiceInfos": [
            {
                "amountWithoutDebtInvoice": 95180.45,
                "amountWithDebtInvoice": 95180.45,
                "debtInvoicedAmount": 0,
                "taxType": "0.06"
            }
        ]
    }
  4. 状态码

    HTTP状态码

    错误码

    错误描述

    400

    CBC.5037

    无可开票金额。

    400

    CBC.8003

    客户有负向消费的账期或订单未包含在本次开票账期或订单集合内。

    401

    CBC.0154

    token非法/过期。

    400

    CBC.0100

    输入参数校验失败。

    403

    CBC.0151

    访问拒绝。

    500

    CBC.0999

    其他错误。

    500

    CBC.8005

    消费子表数据为空。

    500

    CBC.8231

    欠费金额错误。

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区