Factuur ophalen

  • Artikel

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud for US Government

Vereisten

  • Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met alleen App+User-referenties.

  • Een geldige factuur-id.

C#

Als u een factuuroverzicht op id wilt ophalen, gebruikt u uw IPartner.Invoices-verzameling en roept u de methode ById() aan met behulp van de factuur-id. Roep vervolgens de methoden Documents() en Statement() aan om toegang te krijgen tot het factuuroverzicht. Roep ten slotte de methoden Get() of GetAsync() aan.

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

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

Voorbeeld: Consoletest-app. Project: PartnerSDK.FeatureSample Klasse: GetInvoiceStatement.cs

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
GET {baseURL}/v1/invoices/{invoice-id}/documents/statement HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter om het factuuroverzicht op te halen.

Naam Type Vereist Beschrijving
factuur-id tekenreeks Ja De waarde is een factuur-id waarmee de reseller de resultaten voor een bepaalde factuur kan filteren.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen

Voorbeeld van aanvraag

GET https://api.partnercenter.microsoft.com/v1/invoices/<invoice-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-antwoord

Als dit lukt, retourneert deze methode een InvoiceStatement-resource in de hoofdtekst van het antwoord.

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.

Voorbeeld van antwoord

HTTP/1.1 200 OK
Content-Length: 219753
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 57eb2ca7-755f-450f-9187-eae1e75a0114
MS-RequestId: a45e6643-1caf-4429-8f90-07c03d85bc2b
Date: Thu, 24 Mar 2016 05:21:01 GMT

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