ListInvoiceTitle - 发票抬头查询服务

更新时间:
复制 MD 格式

查询可用的发票抬头列表

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

bss:DescribeQueryInvoice

list

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

当前API无需请求参数

无需传入参数,接口会直接查询当前登录 UID 可用的发票抬头列表

返回参数

名称

类型

描述

示例值

object

BssApiListResult

Data

array<object>

抬头列表

object

AccountBankName

string

开户银行名称

招商银行

AccountId

integer

账号 ID

1990699401005016

BankAccountNumber

string

基本开户账号

1234567890

CreateTime

string

发票抬头创建时间,格式为 YYYY-MM-DD HH:mm:ss。

2025-06-01 00:00:00

Id

string

发票抬头 ID

123456

InvoiceTitle

string

发票抬头

xx公司

RegisteredAddress

string

注册场所地址

北京市朝阳区

RegisteredLandline

string

注册固定电话

010-12345678

UnifiedSocialCreditCode

string

统一社会信用代码。15、17、18、20 位字符。

111111111111111

Metadata

any

返回结构元数据

{}

RequestId

string

请求 ID

6000EE23-274B-4E07-A697-FF2E999520A4

示例

正常返回示例

JSON格式

{
  "Data": [
    {
      "AccountBankName": "招商银行",
      "AccountId": 1990699401005016,
      "BankAccountNumber": "1234567890",
      "CreateTime": "2025-06-01 00:00:00",
      "Id": "123456",
      "InvoiceTitle": "xx公司",
      "RegisteredAddress": "北京市朝阳区",
      "RegisteredLandline": "010-12345678",
      "UnifiedSocialCreditCode": "111111111111111"
    }
  ],
  "Metadata": "{}",
  "RequestId": "6000EE23-274B-4E07-A697-FF2E999520A4"
}

错误码

HTTP status code

错误码

错误信息

描述

400 AccountNoQueryPricePermission This page cannot be accessed because you do not have discount rights query permissions. Please contact the main account to go to the cost center for authorization. The permission point that needs authorization is queryprice. 由于您没有折扣查询权限,无法访问该页面。请联系主账号前往费用中心授权,需要授权的权限点为 queryprice
400 InnerAccountNoQueryPricePermission In view of data security and compliance requirements, please understand the inconvenience caused to you by controlling the amount-related information and permissions of the group's cloud account. More questions please refer to the document. 因数据安全及合规要求,对集团上云账号金额信息权限管控,由此带来的不便敬请谅解。您可以通过HCRM/云间平台查看,详见:https://aliyuque.antfin.com/yunfei.xyf/kr0b8h/yvdm6izaeulmq8g2。
400 InnerSubAccountNoQueryPricePermission In view of data security and compliance requirements, please understand the inconvenience caused to you by controlling the amount-related information and permissions of the group's cloud account. 因数据安全及合规要求,对集团上云账号金额信息权限管控,由此带来的不便敬请谅解。您可以通过HCRM/云间平台查看,详见:https://aliyuque.antfin.com/yunfei.xyf/kr0b8h/yvdm6izaeulmq8g2。
400 SubAccountNoQueryPricePermission This page cannot be accessed because you do not have discount rights query permissions. Contact the main account to go to the RAM console for authorization. The Action to be authorized is bss:QueryPrice. 由于您没有折扣查询权限,无法访问该页面。请联系主账号前往RAM控制台授权,需要授权的Action为 bss:QueryPrice
400 InvalidParameter The specified request contains invalid parameters.
400 NoPermission You are not authorized to perform this action. 您无权执行此操作。
500 InternalError The request processing has failed due to some unknown error.

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。