文档首页 > > API参考> 管理发票> 管理发票> 申请开票

申请开票

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

功能介绍

客户可以按账期或按订单向华为云申请发票,也可以按客户分账期向华为云申请发票。对于普通客户而言,后付费类的用户只能按照账期开票。开票的账期跨度不能超过5年。

Web UI

  1. 进入“发票管理”页面。
  2. 设置发票模板。

    1. 在“发票信息”区域,单击“管理发票信息”。
    2. 单击“新增发票信息”。
    3. 设置发票模板信息。

      • 实名认证为个人的客户,创建抬头类型为企业的增值税专用发票模板时,请仔细阅读《申请开具增值税发票协议书》并勾选“我已阅读并同意《申请开具增值税发票协议书》”。
      • 抬头类型为个人或者组织时,只能创建发票类型为增值税普通发票的模板。
      • 企业客户创建增值税专用发票模板时,发票抬头必须和实名认证的名称保持一致,不能修改。
      • 当前客户已经有增值税专用发票模板时,则只能对已存在的增值税专用发票模板进行修改,不能再次新增。
    4. 单击“新增”。

  3. 添加发票的收件地址。

    1. 在“收件地址”区域,单击“管理收件地址”。
    2. 单击“新增收件地址”。
    3. 设置收件地址信息。

    4. 单击“新增”。

  4. 申请开票。

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

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

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

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

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

    3. 选择发票模板。

      如果没有合适的发票模板,也可以单击“新增发票信息”,新增一个发票模板。

    4. 选择发票介质。

      客户可以根据需要选择开电子票还是纸质票。电子票申请通过后,可以直接在费用中心进行下载。纸质票申请通过后,需要华为云的客服人员邮寄给客户。

    5. 当发票种类为纸质票时,客户需要选择寄送地址。

      如果没有合适的寄送地址,也可以单击“新增收件地址”,新增一个发票接收地址。

    6. 填写备注信息。

      备注信息会生成在发票的备注内容区域。

    7. 单击“提交”。

      完成开票申请,进入发票预览页面,不同税率的发票会分页展示。

      图1 增值税普通发票样例
      图2 增值税专用发票样例

      提交开票申请后,您还可以执行以下操作:

      • 当开票申请状态为“待审核”或“开票中”时,您可以撤销该开票申请。
      • 当开票申请状态为“待签收”时,您可以查看到快递单号。收到发票后,需要单击“确认”进行回执确认操作。
      • 当电子票的申请状态为“完成”时,可以单击“下载”进行下载电子票。

REST API

客户可以在客户自建平台上申请开票。

  • 该接口可以使用客户AK/SK或者Token调用。
  • 个人用户不能开增值税专用发票。
  • 未实名认证不能开票。
  • 账号被冻结不能开票。
  • 每次开票,不能小于最小可开票金额,最小可开票金额通过按账期查询可开票金额接口的响应额minAmount来获取。
  • 如果存在金额为负的账期,开票申请中必须包含该账期,否则无法开票。
  • 发票抬头不能为华为软件技术有限公司。
  • 未对接发票云的情况下不能开电子发票
  • 电子发票不可开具增值税专用发票
  1. URI

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

    表1 路径参数

    参数

    是否必选

    取值范围

    描述

    domain_id

    最大长度:64

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

  2. 请求消息

    请求参数

    参数

    是否必选

    参数类型

    取值范围

    描述

    templateId

    String

    最大长度:64

    发票信息模板ID。

    invoiceMethod

    Integer

    0

    开票方式。

    0:账期

    invoiceMode

    Integer

    [0-1]

    发票类型。

    • 0:纸质票(默认)
    • 1:电子票

    说明:电子发票不可开具增值税专用发票。

    channelType

    Integer

    0

    开票渠道类型。

    • 0:华为云(默认)
    • 1:云市场

    postalAddressId

    String

    最大长度:64

    邮寄地址ID,只有纸质发票才需要填写。

    billArray

    List<BillCycleInfo>

    最大长度:24

    开票的账期信息列表,时间跨度不能超过5年,参见表2

    表2 BillCycleInfo

    参数

    是否必选

    参数类型

    取值范围

    描述

    billCycle

    String

    最大长度:6

    需要开票的账期,格式为YYYYMM。

    请求示例

    POST 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

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

    requestIdList

    List<RequestIdInfo>

    -

    不同税率申请ID列表,参见表3

    表3 RequestIdInfo

    参数

    是否必选

    参数类型

    取值范围

    描述

    requestID

    String

    最大长度:64

    开票申请ID。

    taxType

    String

    最大长度:256

    税率。

    invoiceAmount

    Number

    -

    开票金额。

    debtAmount

    Number

    -

    欠票核销金额。

    响应示例

    HTTP/1.1 204 No Content
    Content-Type: application/json;charset=UTF-8
    Content-Length: length
    Date: response time 
    {
        "requestIdList": [
            {
                "requestID": "IV19103109OOR6",
                "taxType": "0.06",
                "invoiceAmount": 400,
                "debtAmount": 0
            }
        ]
    }
  4. 状态码

    HTTP状态码

    错误码

    错误描述

    400

    CBC.5037

    无可开票金额。

    400

    CBC.8003

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

    403

    CBC.0151

    访问拒绝。

    400

    CBC.0100

    输入参数校验失败。

    400

    CBC.8016

    电子票的开票金额不得高于100万。

    403

    CBC.8225

    按到款开票只允许从CBC发起(预留)。

    401

    CBC.0154

    token非法/过期。

    400

    CBC.8202

    未对接发票云,暂不支持开具电子发票。

    400

    CBC.8203

    电子发票不可开具增值税专用发票。

    500

    CBC.8207

    开票金额不正确。

    400

    CBC.8209

    按账期开票,账期列表为空或者超过最大条数。

    500

    CBC.8210

    开票金额不能大于实际可开票金额。

    400

    CBC.8211

    开票金额小于最低可开票金额。

    500

    CBC.8006

    获取用户所在签约主体失败。

    400

    CBC.8214

    用户账号已被冻结。

    400

    CBC.8215

    用户实名认证失败。

    400

    CBC.8216

    个人发票不允许开专票。

    400

    CBC.8217

    纳税人识别号或统一社会信用代码校验失败。

    400

    CBC.8218

    按订单开票,订单列表为空或者超过最大条数(预留)。

    400

    CBC.8222

    发票抬头不能为华为软件技术有限公司。

    400

    CBC.8224

    后付费用户华为云开票不支持按订单开票。

    400

    CBC.8232

    电子发票不可开具增值税普通发票。

    400

    CBC.8007

    云市场开票不支持按账期开票。

    400

    CBC.8008

    按订单开票,请求中存在多个相同的订单(预留)。

    400

    CBC.8009

    按账期开票,请求中存在多个相同的账期。

    400

    CBC.8012

    发票备注或企业注册地址中包含gbk无法解析的字符。

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区