获取发票收据声明书

使用发票 ID 和收据 ID 检索发票收据对帐单。

重要

此功能仅适用于台湾税务收据。

必备条件

  • 合作伙伴中心身份验证中所述的凭据。 此方案只支持使用应用凭据和用户凭据进行身份验证。

  • 有效的发票 ID 和相应的收据 ID。

C#

若要按 ID 获取发票收据对帐单,从合作伙伴中心 SDK v1.12.0 开始,请使用 IPartner.Invoices 集合并使用发票 ID 调用 ById () 方法,然后调用 收据 集合并调用 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 字符串 该值是一个发票 ID,允许经销商筛选给定发票的结果。
receipt-id 字符串 该值是一个收据 ID,允许经销商筛选给定发票的收据。

请求标头

有关详细信息,请参阅合作伙伴中心 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: 57eb2ca7-755f-450f-9187-eae1e75a0114

REST 响应

如果成功,此方法在响应正文中返回 pdf 流。

响应的成功和错误代码

每个响应都带有一个 HTTP 状态代码,用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 有关完整列表,请参阅错误代码

响应示例

HTTP/1.1 200 OK
Content-Length: 195556
Content-Type: application/pdf
MS-CorrelationId: a1d6ab41-5a30-4643-898b-b30d65d3a0a1
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}
}