Obtenir l’instruction de factureGet invoice statement

S’applique àApplies To

  • Espace partenairesPartner Center
  • Espace partenaires géré par 21VianetPartner Center operated by 21Vianet
  • Espace partenaires de Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Espace partenaires de Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Récupère une déclaration de facture à l’aide de l’ID de facture.Retrieves an invoice statement using the invoice ID.

PrérequisPrerequisites

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.This scenario supports authentication with App+User credentials only.

  • Un ID de facture valide.A valid Invoice ID.

C#C#

Pour récupérer une instruction de facture par ID, utilisez votre collection collection ipartner. Invoices et appelez la méthode méthode BYID () à l’aide de l’ID de facture, puis appelez les méthodes documents () et Statement () pour accéder à l’instruction de facture.To get an invoice statement by ID, use your IPartner.Invoices collection and call the ById() method using the invoice ID, then call the Documents() and Statement() methods to access the invoice statement. Enfin, appelez les méthodes d' extraction () ou de GetAsync () .Finally, call the Get() or GetAsync() methods.

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

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

Exemple: application de test console.Sample: Console test app. Projet: PartnerSDK. FeatureSample, classe: GetInvoiceStatement.csProject: PartnerSDK.FeatureSample Class: GetInvoiceStatement.cs

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
GETGET {baseURL}/v1/Invoices/{Invoice-ID}/documents/Statement http/1.1{baseURL}/v1/invoices/{invoice-id}/documents/statement HTTP/1.1

Paramètre d’URIURI parameter

Utilisez le paramètre de requête suivant pour obtenir l’instruction de facture.Use the following query parameter to get the invoice statement.

NomName TypeType ObligatoireRequired DescriptionDescription
ID de la factureinvoice-id stringstring OuiYes La valeur est un ID de facture qui permet au revendeur de filtrer les résultats pour une facture donnée.The value is an invoice-id that allows the reseller to filter the results for a given invoice.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

NoneNone

Exemple de requêteRequest example

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

Réponse RESTREST response

En cas de réussite, cette méthode retourne une ressource InvoiceStatement dans le corps de la réponse.If successful, this method returns an InvoiceStatement resource in the response body.

Codes d’erreur et de réussite de la réponseResponse success and error codes

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir la liste complète, consultez Codes d’erreur.For the full list, see Error Codes.

Exemple de réponseResponse example

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