跳到主要内容

查看发票详情 (V2)

本接口描述当前用户所属组织的指定发票。当前用户须为组织所有者或计费管理员。

GET/v2/invoices/{INVOICE_ID}
连接端点

该 API 的 Base URL 格式如下:

https://api.cloud.zilliz.com

📘说明

控制面接口速率限制为单用户单接口每秒最多 20 个请求。

如果您在使用该接口过程中遇到任何问题,欢迎您联系 Zilliz Cloud 技术支持。

shell
export BASE_URL="https://api.cloud.zilliz.com"
参数
Authorizationstringheader必填项

认证令牌,应为具备适当权限的 API 密钥。

示例值:Bearer {{TOKEN}}
INVOICE_IDstringpath必填项

要描述的发票 ID。

示例值:inv-12312io23810o291
bash
export TOKEN="YOUR_API_KEY"
export INVOICE_ID="inv-12312io23810o291"

curl --request GET \
--url "${BASE_URL}/v2/invoices/${INVOICE_ID}" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json"
响应

返回当前用户所属组织的指定发票的详细信息。

返回指定发票的详细信息。

codeinteger<int32>

响应码。

dataobject

响应负载对象,包含针对所请求发票返回的数据。

idstring

发票 ID。

orgIdstring

发票所属组织 ID。

periodStartstring<date-time>

发票帐期开始时间。

periodEndstring<date-time>

发票帐期结束时间。

invoiceDatestring<date-time>

发票生成日期。

dueDatestring<date-time>

发票逾期时间。

currencystring

发票币种。

statusstring

发票状态。

usageAmountinteger<int64>

发票记录的总金额。

creditsAppliedinteger<int64>

已应用的信用额度,应从总金额中减去。

alreadyBilledAmountinteger<int64>

已开票金额。

subtotalinteger<int64>

发票小计金额,即总金额减去已应用的信用额度。

taxinteger<int64>

发票税额。

totalinteger<int64>

发票含税金额,即小计金额加上税额。

advancePayAmountinteger<int64>

当前用户所属组织预存金额,可用于冲抵待付款。

amountDueinteger<int64>

发票应付金额,即预存金额减去含税金额。

返回错误消息。

codeinteger

响应码。

messagestring

错误描述。

Successjson
{
"code": 0,
"data": {
"id": "inv-12312io23810o291",
"orgId": "org-xxxxxx",
"periodStart": "2024-01-01T00:00:00Z",
"periodEnd": "2024-02-01T00:00:00Z",
"invoiceDate": "2024-02-01T00:00:00Z",
"dueDate": "2024-02-01T00:00:00Z",
"currency": "USD",
"status": "unpaid",
"usageAmount": 52400,
"creditsApplied": 12400,
"alreadyBilledAmount": 0,
"subtotal": 40000,
"tax": 5000,
"total": 45000,
"advancePayAmount": 0,
"amountDue": 45000
}
}