Obter declaração da fatura

  • Artigo

Aplica-se a: Centro de Parceiros | Centro de Parceiros operado pela 21Vianet | Centro de Parceiros para Microsoft Cloud for US Government

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.

C#

Para obter uma declaração de fatura por ID, utilize a coleção IPartner.Invoices e chame o método ById() com o ID da fatura e, em seguida, chame os métodos Documentos() e Instrução() para aceder à instrução da fatura. Por fim, chame os métodos Get() ou GetAsync( ).

// IPartner scopedPartnerOperations;
// string selectedInvoiceId;

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

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

Pedido REST

Sintaxe do pedido

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

Parâmetro URI

Utilize o seguinte parâmetro de consulta para obter a instrução da 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.

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

Resposta do REST

Se for bem-sucedido, este método devolve um recurso InvoiceStatement no corpo de 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: 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}
}