Obter o demonstrativo de recebimento da fatura

Artigo
10/07/2024

Recupera uma declaração de recibo da fatura usando a ID da fatura e a ID do recibo.

Importante

Esse recurso só é aplicável às receitas fiscais de Taiwan.

Pré-requisitos

Credenciais, conforme descrito em Autenticação do Partner Center. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de usuário.
Uma ID de fatura válida e uma ID de recibo correspondente.

C#

Para obter uma declaração de recibo de fatura por ID, começando com o SDK do Partner Center v1.12.0, use sua coleção IPartner.Invoices e chame o método ById() usando a ID da fatura e chame a coleção Receipts e chame ById() e chame os métodos Documents() e Statement() para acessar a instrução de recibo da 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: aplicativo de teste de console. Projeto: Classe PartnerSDK.FeatureSample: GetInvoiceReceiptStatement.cs

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
GET	{baseURL}/v1/invoices/{invoice-id}/receipts/{receipt-id}/documents/statement HTTP/1.1

Parâmetro do URI

Use o parâmetro de consulta a seguir para obter a instrução de recibo da fatura.

Nome	Type	Obrigatório	Descrição
invoice-id	string	Sim	O valor é uma id de fatura que permite que o revendedor filtre os resultados de uma determinada fatura.
receipt-id	string	Sim	O valor é uma ID de recibo que permite que o revendedor filtre os recibos de uma determinada fatura.

Cabeçalhos de solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nenhum

Exemplo de solicitação

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 REST

Se tiver êxito, esse método retornará um fluxo de pdf no corpo da resposta.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira 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}
}

Compartilhar via