Delen via


Factuur ophalen op id

Van toepassing op: Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Opmerking

Voor moderne commerciële aankopen is deze API alleen van toepassing op facturen die vóór 15 mei 2025 zijn gegenereerd.

Haalt een bepaalde factuur op met behulp van de factuur-id.

Vereiste voorwaarden

  • Inloggegevens zoals beschreven in Partner Center-authenticatie. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.

  • Een geldige factuur-id.

C#

Een factuur ophalen met ID:

  1. Gebruik uw verzameling IPartner.Invoices en roep de Methode ById() aan.

  2. Roep de methoden Get() of GetAsync() aan.

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

var invoice = scopedPartnerOperations.Invoices.ById(selectedInvoiceId).Get();

Voorbeeld van: Console-test-app. Project: PartnerSDK.FeatureSample Klasse: GetInvoice.cs

REST-aanvraag

Aanvraagsyntaxis

Methode URI-aanvraag
GET {baseURL}/v1/invoices/{invoice-id} HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter om de factuur op te halen.

Naam Typologie Verplicht Description
factuur-id string Yes De waarde is een factuur-id waarmee de reseller de resultaten voor een bepaalde factuur kan filteren.

Headers aanvragen

Voor meer informatie, zie Partner Center REST headers.

Inhoud van het verzoek

Geen

Vraag om voorbeeld

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

REST-antwoord

Als dit lukt, retourneert deze methode een factuurresource in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of er sprake is van succes of mislukking en aanvullende foutopsporingsinformatie. 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: 676
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 8ac25aa5-9537-4b6d-b782-aa0c8e979e99
Date: Thu, 24 Mar 2016 05:22:14 GMT

{
    "id": "G000024135",
    "invoiceDate": "2018-02-08T22:40:37.5897767Z",
    "billingPeriodStartDate": "2018-02-01T22:40:37.5897767Z",
    "billingPeriodEndDate": "2018-02-28T22:40:37.5897767Z",
    "totalCharges": 2076.63,
    "paidAmount": 0,
    "currencyCode": "USD",
    "currencySymbol": "$",
    "pdfDownloadLink": "/invoices/G000024135/documents/statement",
    "taxReceipts": [
        {
            "id": "123456",
            "taxReceiptPdfDownloadLink": "/invoices/G000024135/receipts/123456/documents/statement"
        }
    ],
    "invoiceDetails": [
        {
            "invoiceLineItemType": "billing_line_items",
            "billingProvider": "one_time",
            "links": {
                "self": {
                    "uri": "/invoices/OneTime-G000024135/lineitems/OneTime/BillingLineItems",
                    "method": "GET",
                    "headers": []
                }
            },
            "attributes": {
                "objectType": "InvoiceDetail"
            }
        }
    ],
    "documentType": "invoice",
    "invoiceType": "OneTime",
    "links": {
        "self": {
            "uri": "/invoices/OneTime-G000024135",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Invoice"
    }
}