全部产品
Search
文档中心

阿里云交易和账单管理API:QueryInvoicingCustomerList - 发票抬头查询服务

更新时间:Mar 01, 2024

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

调试

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

授权信息

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

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

请求参数

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

返回参数

名称类型描述示例值
object
Codestring

状态码。

Success
Messagestring

错误信息。

Successful!
RequestIdstring

请求 ID。

BBEF51A3-E933-4F40-A534-C673CBDB9C80
Successboolean

是否成功。

true
Dataobject

返回数据。

CustomerInvoiceListobject []

发票信息列表。

Typelong

类型,取值:

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

发票抬头状态。

2
AdjustTypelong

变更类型。

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。

2018-09-07 15:26:20
TaxpayerTypelong

取值:

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

客户支付宝认证类型,取值:

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

开具类型。

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": "2018-09-07 15:26:20",
          "TaxpayerType": 1,
          "CustomerType": 1,
          "IssueType": 1,
          "Id": 239875502738,
          "BankNo": "389576348573296349853476"
        }
      ]
    }
  }
}

错误码

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