查询发票列表-ListInvoices
功能介绍
伙伴可以查询发票列表。
伙伴登录伙伴中心，选择“伙伴账务 > 发票中心”，即显示发票列表。
接口约束
该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
接口对应的权限项如下：
权限项 | 权限项名称 |
|---|---|
BPC_ITEM_FINANCE_060100 | 销售-账务-发票管理-发票中心-查看发票申请记录 |
URI
GET /v1.0/{domain_id}/payments/intl-invoices
参数 | 是否必选 | 取值范围 | 描述 |
|---|---|---|---|
domain_id | 是 | 最大长度：64 | 合作伙伴ID。获取方法请参见如何获取合作伙伴ID（partner_id）。 |
参数 | 是否必选 | 参数类型 | 取值范围 | 描述 |
|---|---|---|---|---|
start_time | 是 | String | 最大长度：64 | 发票申请开始时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。 |
end_time | 是 | String | 最大长度：64 | 发票申请结束时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。 |
offset | 是 | Integer | [1-99999] | 页码。 |
limit | 是 | Integer | [1-100] | 每页大小。 |
请求消息
请求参数
无。
请求示例
GET https://bss-intl.myhuaweicloud.com/v1.0/{domain_id}/payments/intl-invoices?start_time=2019-01-28T11:48:41Z&end_time=2019-12-28T11:48:41Z&offset=1&limit=10 Content-Type: application/json X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
响应消息
响应参数
参数 | 参数类型 | 取值范围 | 描述 |
|---|---|---|---|
error_code | String | 最大长度：20 | 状态码。具体请参考状态码。只有失败才返回该字段。 |
error_msg | String | 最大长度：1000 | 错误描述信息。只有失败才返回该字段。 |
count | Integer | - | 记录数，只有成功的时候才返回这个字段 |
invoices | List<IntlInvoiceRequestInfo> | - | 发票信息列表，参见表2。 |
参数 | 参数类型 | 取值范围 | 描述 |
|---|---|---|---|
requestId | String | 最大长度：64 | 请求ID。 |
cancelReason | String | 最大长度：256 | 驳回原因。 |
titleType | Integer | [0-1] | 开票类型。
|
channelType | Integer | - | 渠道类型。 0：华为云 |
invoiceType | Integer | [0-1] | 发票种类。
|
invoiceTitle | String | 最大长度：1024 | 发票抬头。 |
invoiceAmount | BigDecimal | - | 已开票金额（美元） 。 |
invoiceMethod | Integer | [0-2] | 开票方式。
|
invoiceClass | Integer | [0-1] | 发票类别。
|
invoiceState | Integer | - | 开票状态。
|
applyOpera | String | 最大长度：32 | 发票申请人员。 |
addressInfo | PostAddressInfoIntl Object | - | 地址信息，参见表3。 |
applyTime | String | 最大长度：64 | 申请时间（UTC时间）。 |
invoiceMode | String | 0 | 发票类型。 0：纸质票 |
String | 最大长度：400 | 电子发票寄送地。 | |
requestMode | String | [0-2] | 申请类型。
|
srcRequestId | String | 最大长度：64 | 退票时的原申请ID。 |
salesId | String | 最大长度：64 | 签约主体ID。 |
invoiceNo | String | 最大长度：32 | 发票号码。 |
tradeType | Integer | - | 交易类型。
|
billCycle | String | 最大长度：64 | 发票账期。 |
taxList | List<TaxInfo> | - | 税务信息列表，参见表4。 |
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
"count": 2,
"invoices": [
{
"requestId": "IV19122807N6S5",
"cancelReason": null,
"titleType": 1,
"channelType": 0,
"invoiceType": 1,
"invoiceTitle": "Dream666",
"invoiceAmount": 102.0,
"invoiceMethod": 1,
"invoiceClass": 1,
"invoiceState": 8,
"applyOpera": "*******",
"addressInfo": {
"address": "********",
"recipients": "王**",
"zipCode": "10****",
"mobilePhone": "188****8888"
},
"applyTime": "2019-12-28T07:02:03Z",
"invoiceMode": "1",
"email": "***@163.com",
"requestMode": "0",
"srcRequestId": null,
"salesId": "1351",
"invoiceNo": "CSER191001322",
"tradeType": 5,
"billCycle": "201912",
"taxList": [
{
"taxClass": "WHT",
"taxRate": "0.01",
"subTaxClass": "WHT",
"taxAmount": 1.0,
"taxVisibleFlag": "Y",
"taxAccountingFlag": "Y"
},
{
"taxClass": "VAT",
"taxRate": "0.01",
"subTaxClass": "VAT",
"taxAmount": 1.0,
"taxVisibleFlag": "Y",
"taxAccountingFlag": "Y"
}
]
},
{
"requestId": "IV19122806VJF8",
"cancelReason": null,
"titleType": 1,
"channelType": 0,
"invoiceType": 1,
"invoiceTitle": "Dream666",
"invoiceAmount": 384.4,
"invoiceMethod": 1,
"invoiceClass": 1,
"invoiceState": 8,
"applyOpera": "*******",
"addressInfo": {
"address": "********",
"recipients": "王**",
"zipCode": "10****",
"mobilePhone": "188****8888"
},
"applyTime": "2019-12-28T06:20:41Z",
"invoiceMode": "1",
"email": "***@163.com",
"requestMode": "0",
"srcRequestId": null,
"salesId": "1351",
"invoiceNo": "CSER191001321",
"tradeType": 7,
"billCycle": "201912",
"taxList": [
{
"taxClass": "WHT",
"taxRate": "0.15",
"subTaxClass": "WHT",
"taxAmount": 54.4
},
{
"taxClass": "VAT",
"taxRate": "0.06",
"subTaxClass": "VAT",
"taxAmount": 21.76
}
]
}
]
} 
