Obter declaração do recibo da fatura

Artigo
10/07/2024

Obtém um extrato de recibo de fatura com o ID da fatura e o ID do recibo.

Importante

Esta funcionalidade só é aplicável às receitas fiscais de Taiwan.

Pré-requisitos

Credenciais conforme descrito na autenticação do Centro de Parceiros. Este cenário suporta a autenticação apenas com credenciais de Aplicação+Utilizador.
Um ID de Fatura válido e um ID de recibo correspondente.

C#

Para obter uma declaração de recibo de fatura por ID, a começar pelo SDK do Centro de Parceiros v1.12.0, utilize a coleção IPartner.Invoices e chame o método ById() com o ID da fatura e, em seguida, chame a coleção Recibos e chame ById() e, em seguida, chame os métodos Documentos() e Declarações() para aceder ao extrato de recibo de fatura. Por fim, chame os métodos Get() ou GetAsync( ).

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

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

Exemplo: aplicação de teste da consola. Project: PartnerSDK.FeatureSample Class: GetInvoiceReceiptStatement.cs

Pedido REST

Sintaxe do pedido

Método	URI do pedido
GET	{baseURL}/v1/invoices/{invoice-id}/receipts/{receipt-id}/documents/statement HTTP/1.1

Parâmetro URI

Utilize o parâmetro de consulta seguinte para obter a instrução de recibo de fatura.

Nome	Tipo	Necessário	Descrição
fatura-id	string	Yes	O valor é um ID de fatura que permite ao revendedor filtrar os resultados de uma determinada fatura.
recibo-id	string	Yes	O valor é um id de recibo que permite ao revendedor filtrar os recibos de uma determinada fatura.

Cabeçalhos do pedido

Para obter mais informações, veja Cabeçalhos REST do Centro de Parceiros.

Corpo do pedido

Nenhuma

Exemplo de pedido

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

Resposta do REST

Se for bem-sucedido, este método devolve uma transmissão em pdf no corpo da resposta.

Códigos de erro e êxito da resposta

Cada resposta inclui um código de estado HTTP que indica êxito ou falha e informações adicionais de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, veja Códigos de Erro.

Exemplo de resposta

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

Partilhar via