Obtenir l’instruction de réception de facture

  • Article

Récupère un relevé de reçu de facture à l’aide de l’ID de facture et de l’ID de reçu.

Important

Cette fonctionnalité s’applique uniquement aux reçus fiscaux taïwanais.

Prérequis

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.

  • ID de facture valide et ID de reçu correspondant.

C#

Pour obtenir un relevé de reçu de facture par ID, à compter du KIT de développement logiciel (SDK) espace partenaires v1.12.0, utilisez votre collection IPartner.Invoices et appelez la méthode ById() à l’aide de l’ID de facture, puis appelez la collection de reçus et appelez ById(), puis appelez les méthodes Documents() et Statement() pour accéder à l’relevé de reçu de facture. Enfin, appelez les méthodes Get() ou GetAsync().

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

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

Exemple : application de test console. Projet : Classe PartnerSDK.FeatureSample : GetInvoiceReceiptStatement.cs

Demande REST

Syntaxe de la requête

Méthode URI de requête
GET {baseURL}/v1/invoices/{invoice-id}/receipts/{receipt-id}/documents/statement HTTP/1.1

Paramètre d’URI

Utilisez le paramètre de requête suivant pour obtenir le relevé de facture.

Nom Type Obligatoire Description
id de facture string Oui La valeur est un id de facture qui permet au revendeur de filtrer les résultats d’une facture donnée.
receipt-id string Oui La valeur est un id de reçu qui permet au revendeur de filtrer les reçus d’une facture donnée.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de demande

None

Exemple de requête

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

Réponse REST

Si elle réussit, cette méthode retourne un flux pdf dans le corps de la réponse.

Codes d’erreur et de réussite de la réponse

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. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

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