Manage billing - Get invoice line items

Serviço:

Partner Center Rest

Versão da API:

v1

Obtém itens de linha para cenários de GTM. Uso diário não faturado de primeira e de terceiros para os meses atuais e anteriores. Primeiro e Terceiro cobraram o uso nominal diário para um invoceid. Primeiro e Terceiro recon não faturado para os meses atuais e anteriores.

GET https://api.partnercenter.microsoft.com/v1/invoices/{invoice_id}/lineitems

Com parâmetros opcionais:

GET https://api.partnercenter.microsoft.com/v1/invoices/{invoice_id}/lineitems?provider={provider}&invoiceLineItemType={invoiceLineItemType}&hasPartnerEarnedCredit={hasPartnerEarnedCredit}&currencyCode={currencyCode}&period={period}&size={size}&offset={offset}&seekOperation={seekOperation}

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
invoice_id	path	True	string	O ID da fatura. Para itens de linha não faturados, invoiceId é definido como "unbilled".
currencyCode	query		string	O código da moeda.
hasPartnerEarnedCredit	query		boolean	O valor que indica se os itens da linha devem ser devolvidos com o crédito ganho do parceiro aplicado.
invoiceLineItemType	query		string	O item de linha da fatura. exemplo: BillingLineItems, UsageLineItems.
offset	query		integer int32	O deslocamento da página.
period	query		string	O período para reconhecimento não faturado. exemplo: atual, anterior.
provider	query		string	O tipo de provedor. exemplo: Todos, Marketplace.
seekOperation	query		string	A operação de busca para executar. Apenas Next é suportado.
size	query		integer int32	O tamanho da página.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
Authorization	True	string	Token de portador de autorização
ms-correlationid		string	Usado para rastrear solicitações internamente. Se um ms-correlationid não for fornecido, o servidor gerará um novo para cada solicitação
ms-cv		string	Usado para rastrear solicitações internamente. Se um ms-cv não for fornecido, o servidor gerará um novo para cada solicitação
ms-requestid		string	Usado para idempotência de solicitações. Se um ms-requestid não for fornecido, o servidor gerará um novo para cada solicitação

Respostas

Name	Tipo	Description
200 OK	Collections.PagedResourceCollection[InvoiceLineItem]	O pedido foi bem-sucedido. O corpo da resposta contém os itens de linha de recon solicitados. Media Types: "application/json", "text/json"
400 Bad Request		Havia uma entrada ausente ou inválida. O corpo da resposta fornecerá os detalhes do erro. Media Types: "application/json", "text/json"
401 Unauthorized		O pedido não foi autenticado. O cliente precisa se autenticar com o serviço de API do parceiro primeiro. Media Types: "application/json", "text/json"
403 Forbidden		O pedido foi autenticado, mas foi recusado, uma vez que o autor da chamada não tem o direito de o invocar. Media Types: "application/json", "text/json"
404 Not Found		O recurso não é encontrado ou não está disponível com os parâmetros de entrada fornecidos. Media Types: "application/json", "text/json"
500 Internal Server Error		O serviço de API do parceiro ou uma de suas dependências não conseguiu atender à solicitação. Os chamadores podem tentar novamente. Media Types: "application/json", "text/json"

Definições

Name	Description
Collections.PagedResourceCollection[InvoiceLineItem]
InvoiceLineItem
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]

Collections.PagedResourceCollection[InvoiceLineItem]

Object

Name	Tipo	Description
attributes	ResourceAttributes
continuationToken	string
items	InvoiceLineItem[]
links	ResourceLinks
totalCount	integer

InvoiceLineItem

Object

Name	Tipo	Description
attributes	ResourceAttributes
billingProvider	enum: all azure marketplace none office oneTime
invoiceLineItemType	enum: billingLineItems none usageLineItems

Link

Object

Name	Tipo	Description
headers	System.Collections.Generic.KeyValuePair[System.String,System.String][]
method	string
uri	string

ResourceAttributes

Object

Name	Tipo	Description
etag	string
objectType	string

ResourceLinks

Object

Name	Tipo	Description
next	Link
previous	Link
self	Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

Object

Name	Tipo	Description
key	string
value	string