Ottenere la dichiarazione di ricevimento fattura

Articolo
10/07/2024

Recupera un estratto conto fattura utilizzando l'ID fattura e l'ID ricevuta.

Importante

Questa funzionalità è applicabile solo alle ricevute fiscali di Taiwan.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con le credenziali app + utente.
UN ID fattura valido e un ID di ricevuta corrispondente.

C#

Per ottenere un estratto conto fattura in base all'ID, a partire da Partner Center SDK v1.12.0, usare la raccolta IPartner.Invoices e chiamare il metodo ById() usando l'ID fattura, quindi chiamare la raccolta Ricevute e chiamare ById() e quindi chiamare i metodi Documents() e Statement() per accedere all'estratto conto della fattura. Infine, chiamare i metodi Get() o GetAsync().

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

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

Esempio: App di test della console. Progetto: Classe PartnerSDK.FeatureSample: GetInvoiceReceiptStatement.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
GET	{baseURL}/v1/invoices/{invoice-id}/receipts/{receipt-id}/documents/statement HTTP/1.1

Parametro URI

Usare il parametro di query seguente per ottenere l'estratto conto della fattura.

Nome	Tipo	Obbligatoria	Descrizione
invoice-id	string	Sì	Il valore è un ID fattura che consente al rivenditore di filtrare i risultati per una determinata fattura.
receipt-id	string	Sì	Il valore è un ID ricevuta che consente al rivenditore di filtrare le ricevute per una determinata fattura.

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Nessuno

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questo metodo restituisce un flusso pdf nel corpo della risposta.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore.

Esempio di risposta

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

Condividi tramite