Fatura makbuz ekstresi alma

Makale
10/07/2024

Fatura kimliğini ve makbuz kimliğini kullanarak fatura makbuzu ekstresini alır.

Önemli

Bu özellik yalnızca Tayvan vergi makbuzları için geçerlidir.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Geçerli bir Fatura Kimliği ve karşılık gelen makbuz kimliği.

C#

İş Ortağı Merkezi SDK'sı v1.12.0'dan başlayarak kimliğe göre fatura makbuzu ekstresi almak için , IPartner.Invoices koleksiyonunuzu kullanın ve fatura kimliğini kullanarak ById() yöntemini çağırın, sonra Receipts koleksiyonunu çağırın ve ById() yöntemini çağırın, ardından fatura makbuzu ekstresine erişmek için Documents() ve Statement() yöntemlerini çağırın. Son olarak Get() veya GetAsync() yöntemlerini çağırın.

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

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

Örnek: Konsol test uygulaması. Proje: PartnerSDK.FeatureSample Sınıfı: GetInvoiceReceiptStatement.cs

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
GET	{baseURL}/v1/invoices/{invoice-id}/receipts/{receipt-id}/documents/statement HTTP/1.1

URI parametresi

Fatura alındı ekstresini almak için aşağıdaki sorgu parametresini kullanın.

Ad	Tür	Gerekli	Açıklama
invoice-id	string	Yes	Değer, kurumsal bayinin belirli bir faturanın sonuçlarını filtrelemesine olanak tanıyan bir fatura kimliğidir.
makbuz kimliği	string	Yes	Değer, satıcının belirli bir faturanın makbuzlarını filtrelemesine olanak tanıyan bir makbuz kimliğidir.

İstek üst bilgileri

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

Hiçbiri

İstek örneği

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 yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde bir pdf akışı döndürür.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu ve ek hata ayıklama bilgilerini gösteren bir HTTP durum koduyla birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Hata Kodları.

Yanıt örneği

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}
}

Aracılığıyla paylaş