取得發票收據對帳單

發行項
10/07/2024

使用發票識別碼和收據識別碼擷取發票收據語句。

重要

這項功能僅適用于臺灣稅務收據。

必要條件

認證，如合作夥伴中心驗證所述。此案例僅支援使用「應用程式+使用者」認證來進行驗證。
有效的發票識別碼和對應的收據識別碼。

C#

若要依識別碼取得發票收據聲明，從合作夥伴中心 SDK v1.12.0 開始，請使用 您的 IPartner.Invoices 集合，並使用發票識別碼呼叫 ById () 方法，然後呼叫 Receipts 集合並呼叫 ById () 然後呼叫 Documents () 和 Statement () 方法來存取發票收據語句。最後，呼叫 Get () 或 GetAsync () 方法。

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

var invoiceStatement = scopedPartnerOperations.Invoices.ById(selectedInvoiceId).Receipts.ById(selectedReceipt).Documents.Statement.Get();

範例：主控台測試應用程式。專案：PartnerSDK.FeatureSample 類別：GetInvoiceReceiptStatement.cs

REST 要求

要求的語法

方法	要求 URI
GET	{baseURL}/v1/invoices/{invoice-id}/receipts/{receipt-id}/documents/statement HTTP/1.1

URI 參數

使用下列查詢參數來取得發票收據語句。

名稱	類型	必要	描述
invoice-id	string	Yes	此值是一個發票識別碼，可讓轉銷商篩選指定發票的結果。
receipt-id	string	Yes	此值是收據識別碼，可讓轉銷商篩選指定發票的收據。

要求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

要求本文

無

要求範例

GET https://api.partnercenter.microsoft.com/v1/invoices/<invoice-id>/receipts/<receipt-id>/documents/statement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 8ac25aa5-9537-4b6d-b782-aa0c8e979e99
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST 回應

如果成功，這個方法會在回應本文中傳回 pdf 資料流程。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。如需完整清單，請參閱錯誤碼。

回應範例

HTTP/1.1 200 OK
Content-Length: 195556
Content-Type: application/pdf
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cc1ba6db-ab26-404a-9196-712b6395f518
Date: Tue, 05 Feb 2019 04:08:23 GMT

{
    _content    {System.Net.Http.ByteArrayContent}    System.Net.Http.HttpContent {System.Net.Http.ByteArrayContent}
    _content    {byte[195556]}    byte[]
    _headers    {Content-Type: application/pdf Content-Disposition: attachment; filename=E-Tax-8602768.pdf}
}

共用方式為