QueryInvoicingCustomerList - 发票抬头查询服务

更新时间:

查询阿里云用户发票抬头信息。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
bss:QueryCustomerInvoiceInfoget
*全部资源
*

请求参数

名称类型必填描述示例值
当前API无需请求参数

返回参数

名称类型描述示例值
object
Codestring

状态码。

Success
Messagestring

错误信息。

Successful!
RequestIdstring

请求 ID。

BBEF51A3-E933-4F40-A534-C673CBDB9C80
Successboolean

是否成功。

true
Dataobject

返回数据。

CustomerInvoiceListarray<object>

发票信息列表。

CustomerInvoiceobject
Typelong

默认发票类型,取值示例:

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

发票抬头状态,取值示例:

  • 1:申请中
  • 2:通过
  • 3:拒绝
  • 4:失效
  • 5:撤回
2
AdjustTypelong

抬头变更方式。取值示例:

  • 1:非抬头名称信息修改
  • 4:其他类型抬头修改
  • 5:实名认证抬头修改
1
Bankstring

开户银行名称

测试银行
StartCyclelong

有效开始月份。

202002
TitleChangeInstructionsstring

发票抬头变更情况说明书。

instruction.doc
UserIdlong

用户 ID。

34565465675
OperatingLicenseAddressstring

注册场所地址。

某某省某某市某某区某地址
InvoiceTitlestring

发票抬头。

测试公司
UserNickstring

用户昵称。

testNick
OperatingLicensePhonestring

注册固定电话。

138xxxxxxxx
EndCyclelong

有效结束月份。

202003
DefaultRemarkstring

开票默认备注。选择此抬头开票时,会将改备注添加到发票上。

PO代码:12984554
TaxationLicensestring

税务登记证扫描件路径和文件名。

taxationLicense.jpg
RegisterNostring

统一社会信用代码。

21343245342534
GmtCreatestring

创建时间,格式:yyyy-mm-dd hh:mm:ss。

2025-02-01 00:00:00
TaxpayerTypelong

纳税人类型。取值示例:

  • 1:一般纳税人
  • 2:小规模纳税人
1
CustomerTypelong

客户支付宝认证类型。取值示例:

  • 1:个人。
  • 2:公司。
1
IssueTypelong

抬头类型。取值示例:

  • 0:个人
  • 1:企业
  • 2:事业单位
1
Idlong

发票抬头记录 id

239875502738
BankNostring

基本开户账号。

389576348573296349853476

示例

正常返回示例

JSON格式

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "BBEF51A3-E933-4F40-A534-C673CBDB9C80",
  "Success": true,
  "Data": {
    "CustomerInvoiceList": {
      "CustomerInvoice": [
        {
          "Type": 1,
          "Status": 2,
          "AdjustType": 1,
          "Bank": "测试银行",
          "StartCycle": 202002,
          "TitleChangeInstructions": "instruction.doc",
          "UserId": 34565465675,
          "OperatingLicenseAddress": "某某省某某市某某区某地址",
          "InvoiceTitle": "测试公司",
          "UserNick": "testNick",
          "OperatingLicensePhone": "138xxxxxxxx",
          "EndCycle": 202003,
          "DefaultRemark": "PO代码:12984554",
          "TaxationLicense": "taxationLicense.jpg",
          "RegisterNo": 21343245342534,
          "GmtCreate": "2025-02-01 00:00:00",
          "TaxpayerType": 1,
          "CustomerType": 1,
          "IssueType": 1,
          "Id": 239875502738,
          "BankNo": 3.895763485732963e+23
        }
      ]
    }
  }
}

错误码

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