查询发票列表
接口约束
该接口可以使用客户AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v1.0/{domain_id}/payments/intl-invoices
|
参数 |
是否必选 |
取值范围 |
描述 |
|---|---|---|---|
|
domain_id |
是 |
最大长度：64 |
客户账号ID。获取方法请参见如何获取客户的customer_id/domain_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 |
Number |
- |
已开票金额（美元） 。 |
|
invoiceMethod |
Integer |
[0-2] |
开票方式。
|
|
invoiceClass |
Integer |
[0-1] |
发票类别。
|
|
invoiceState |
Integer |
- |
开票状态。
|
|
applyOpera |
String |
最大长度：32 |
发票申请人员。 |
|
addressInfo |
PostAddressInfoIntl |
- |
地址信息，参见表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
},
{
"taxClass": "VAT",
"taxRate": "0.01",
"subTaxClass": "VAT",
"taxAmount": 1.0
}
]
},
{
"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
}
]
}
]
}
