Partilhar via


Recursos de fatura

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center for Microsoft Cloud for US Government

Os seguintes recursos relacionados a faturas estão disponíveis por meio das APIs do Partner Center.

Invoice

Propriedade Type Descrição
id string O identificador da fatura.
data da fatura string no formato data-hora UTC A data em que a fatura foi gerada.
billingPeriodStartDate string no formato data-hora UTC Data de início do período de faturação em UTC.
billingPeriodEndDate string no formato data-hora UTC Data de término do período de faturamento em UTC.
totalEncargos Número Os encargos totais. Inclui encargos para transações e quaisquer ajustes.
paidAmount Número O valor pago pelo sócio. Negativo se um pagamento foi recebido.
currencyCode string Um código que indica a moeda usada para todos os valores e totais de itens da fatura.
currencySymbol string O símbolo de moeda usado para todos os valores e totais de itens da fatura.
pdfBaixarLink string Um link para descarregar a fatura em formato PDF. Esse link não é retornado como parte dos resultados da pesquisa e é preenchido somente se a fatura for acessada por ID. Este link expira automaticamente em 30 minutos.
detalhes da fatura matriz de objetos InvoiceDetail Os detalhes da fatura.
Alterações matriz de objetos Invoice As alterações a esta fatura.
Tipo de documento string O tipo de documento da fatura: "Nota de Crédito", "Fatura".
emendasOf string O número de referência do documento de que o presente documento constitui uma alteração.
Tipo de fatura string O tipo de fatura: "recorrente", "one_time".
ligações Links de Recursos Os links de recursos.
atributos ResourceAttributes Os atributos de metadados.
collectionOfSummary matriz de objetos TaxReceipt Obtém ou define o link de download do recibo de imposto.
Estado string Obtém o status da fatura, como "ativo", "nulo", etc.

InvoiceDetail

Uma fatura contém uma coleção de itens faturados e cada item é representado por um recurso InvoiceDetail.

Propriedade Type Description
invoiceLineItemType string O tipo de detalhe da fatura: "nenhum", "usage_line_items", "faturação/_line_items".
billingProvider string O fornecedor de faturação: "Nenhum", "Office", "Azure", "OneTime".
ligações Links de Recursos Os links de recursos.
atributos ResourceAttributes Os atributos de metadados.

InvoiceLineItem

Cada cobrança individual dentro de uma fatura é representada como um InvoiceLineItem.

Propriedade Type Description
invoiceLineItemType string O tipo de item de linha da fatura: "nenhum", "usage_line_items", "faturamento/_line_items".
billingProvider string O fornecedor de faturação: "Nenhum", "Office", "Azure", "OneTime".
atributos ResourceAttributes Os atributos de metadados.

Resumo da fatura

Descreve um resumo do saldo e do total de encargos de uma fatura.

Propriedade Type Description
saldoMontante Número O saldo da fatura. Este é o valor total das contas não pagas.
currencyCode string Um código que indica a moeda usada para o valor do saldo.
currencySymbol string O símbolo de moeda usado.
contabilidadeData: string no formato data-hora UTC A data em que o valor do saldo foi atualizado pela última vez.
firstInvoiceCreationDate string no formato data-hora UTC A data em que a primeira fatura para o cliente foi criada.
lastPaymentDate string no formato data-hora UTC A data do último pagamento.
lastPaymentAmount Número O valor do último pagamento.
mais recenteData da fatura string no formato data-hora UTC A data em que a última fatura do cliente foi criada.
detalhes matriz de objetos InvoiceSummaryDetail O detalhe do resumo da fatura.
ligações Links de Recursos Os links de recursos.
atributos ResourceAttributes Os atributos de metadados.

FaturaResumoDetalhe

Representar um resumo dos detalhes individuais de um tipo de fatura (por exemplo, recorrente, one_time).

Propriedade Type Description
Tipo de fatura string O tipo de fatura: "recorrente", "one_time".
Resumo Objeto InvoiceSummary O resumo da fatura por tipo de fatura.

Resumos de faturas

Represente uma coleção do tipo InvoiceSummary que contém os detalhes individuais de um tipo de fatura por moeda.

Propriedade Type Description
collectionOfSummary matriz de objetos InvoiceSummary O resumo da fatura por tipo de fatura por moeda.

LicenseBasedLineItem

Representa um item de linha de cobrança de fatura para assinaturas baseadas em licença.

Propriedade Type Description
montante string Obtém ou define o valor total. Montante total = preço unitário * quantidade.
atributos string Obtém os atributos.
billingCycleType string Obtém ou define o tipo de ciclo de faturamento.
billingProvider string Obtém o provedor de cobrança.
chargeEndDate string no formato data-hora UTC Obtém ou define a data de término da cobrança.
chargeStartDate string no formato data-hora UTC Obtém ou define a data de início da cobrança.
chargeType string Obtém ou define o tipo de cobrança.
moeda string Obtém ou define a moeda usada para este item de linha.
customerId string Obtém ou define o identificador exclusivo do cliente na plataforma de cobrança da Microsoft.
nome_do_cliente string no formato data-hora UTC Obtém ou define o nome do cliente.
nome_do_domínio string Obtém ou define o nome do domínio.
durableOfferId string Obtém ou define o identificador exclusivo da oferta durável.
invoiceLineItemType string Obtém o tipo de item de linha da fatura.
ID do parceiro Número Obtém ou define o PartnerID associado a este item de linha. Para revendedores diretos, este é o PartnerID do revendedor. Para revendedores indiretos, este é o PartnerID do Revendedor de Valor Agregado (VAR).
offerId string Obtém ou define o identificador exclusivo da oferta.
offerName string Obtém ou define o nome da oferta.
orderId string Obtém ou define o identificador exclusivo da ordem.
ID do parceiro string Obtém ou define a ID de locatário do Microsoft Entra do parceiro.
quantidade Número Obtém ou define o número de unidades associadas a este item de linha.
subscriçãoDescrição string Obtém ou define a descrição da assinatura.
assinaturaData de Fim string no formato data-hora UTC Obtém ou define a data em que a assinatura expira.
subscriptionId cadeia Obtém ou define o identificador exclusivo da assinatura.
subscriptionName cadeia Obtém ou define o nome da assinatura.
assinaturaStartDate string no formato data-hora UTC Obtém ou define a data de início da assinatura.
Subtotal Número Obtém ou define o valor após o desconto.
syndicationPartnerSubscriptionNumber string Obtém ou define o número de assinatura do parceiro de distribuição.
imposto Número Obtém ou define os impostos cobrados.
tier2MpnId Número Obtém ou define o PartnerID do parceiro de Nível 2 associado a este item de linha.
totalForCustomer Número Obtém ou define o valor total após desconto e imposto.
totalOutroDesconto Número Obtém ou define o desconto associado a esta compra.
unitPrice Número Obtém ou define o preço unitário.

UsageBasedLineItem

Representa um item de linha de cobrança de fatura para assinaturas baseadas em uso.

Propriedade Type Description
atributos string Obtém os atributos.
billingCycleType string Obtém ou define o tipo de ciclo de faturamento.
billingProvider string Obtém o provedor de cobrança.
chargeEndDate string no formato data-hora UTC Obtém ou define a data de término da cobrança.
chargeStartDate string no formato data-hora UTC Obtém ou define a data de início da cobrança.
chargeType string Obtém ou define o tipo de cobrança.
consumidoQuantidade Número Obtém ou define o total de unidades consumidas.
consumoDesconto string Obtém ou define o desconto no consumo.
consumoPreço string Obtém ou define o preço da quantidade consumida.
moeda string Obtém ou define a moeda associada aos preços.
nome_do_cliente string Obtém ou define o nome do cliente.
customerId string Obtém ou define o identificador exclusivo do cliente.
detailLineItemId Número Obtém ou define a ID do item de linha de detalhes. Identifica exclusivamente os itens de linha para casos em que o cálculo é diferente para unidades consumidas. Exemplo: Total consumido = 1338, 1024 é cobrado com uma taxa, 314 é cobrado com uma taxa diferente.
nome_do_domínio string Obtém ou define o nome do domínio.
includedQuantity Número Obtém ou define as unidades incluídas na ordem.
invoiceLineItemType string Obtém o tipo de item de linha da fatura.
Número da fatura string Obtém ou define o número da fatura.
listaPreço Número Obtém ou define o preço de cada unidade.
ID do parceiro Número Obtém ou define o PartnerID associado a este item de linha. Para revendedores diretos, este é o PartnerID do revendedor. Para revendedores indiretos, este é o PartnerID do Revendedor de Valor Agregado (VAR).
orderId string Obtém ou define o identificador exclusivo da ordem.
overageQuantidade Número Obtém ou define a quantidade consumida acima do uso permitido.
partnerBillableAccountId string Obtém ou define o ID da conta faturável do parceiro.
ID do parceiro string Obtém ou define a ID de locatário do Microsoft Entra do parceiro.
Nome do parceiro string Obtém ou define o nome do parceiro.
pósTaxEffectiveRate Número Obtém ou define o preço efetivo após impostos.
pósTaxTotal Número Obtém ou define o total de cobranças após impostos. Encargos antes de impostos + Valor do imposto
pré-impostosEncargos Número Obtém ou define o preço cobrado antes de impostos.
préTaxEffectiveRate Número Obtém ou define o preço efetivo antes de impostos.
region string Obtém ou define a região associada à instância do recurso.
resourceGuid string Obtém ou define o identificador de recurso.
resourceName string Obtém ou define o nome do recurso. Exemplo: Banco de dados (GB/mês).
nome_do_serviço string Obtém ou define o nome do serviço. Exemplo: Azure Data Service.
Tipo de serviço string Obtém ou define o tipo de serviço. Exemplo: Azure SQL Azure DB.
sku string Obtém ou define a SKU de serviço.
subscriçãoDescrição string Obtém ou define a descrição da assinatura.
subscriptionId cadeia Obtém ou define o identificador exclusivo da assinatura.
subscriptionName cadeia Obtém ou define o nome da assinatura.
taxMontante Número Obtém ou define o valor do imposto cobrado.
tier2MpnId Número Obtém ou define o PartnerID do parceiro de Nível 2 associado a este item de linha.
unit string Obtém ou define a unidade de medida para uso do Azure.

InvoiceStatement

Representa as operações disponíveis em um extrato de fatura no aplicativo/pdf.

Propriedade Type Description
httpResponseMessage objeto ByteArrayContent com contentType = application/pdf.

OneTimeInvoiceLineItem

Representa um item de linha de cobrança de fatura para assinaturas baseadas em licença.

Propriedade Type Description
Identificação do parceiro string Obtém ou define a ID do locatário parceiro.
ID do Cliente string Obtém ou define a ID do locatário do cliente.
CustomerName string Obtém ou define o nome do cliente.
CustomerDomainName string Obtém ou define o nome de domínio do cliente.
País do Cliente string Obtém ou define o país/região do cliente.
Número da fatura string Obtém ou define o número da fatura.
MpnId string Obtém ou define o PartnerID associado a este item de linha.
RevendedorMpnId número inteiro Obtém ou define o PartnerID do parceiro de Nível 2 associado a este item de linha.
OrderDate DateTime Obtém ou define a data em que a ordem foi criada.
OrderId string Identificador exclusivo de uma encomenda na plataforma de faturação da Microsoft.
ProductId string Obtém ou define o identificador exclusivo do produto.
SkuId string Obtém ou define o identificador exclusivo de SKU.
AvailabilityId string Obtém ou define o identificador exclusivo de disponibilidade.
ProductName string Obtém ou define o nome do produto.
SkuName string Obtém ou define o nome da SKU.
ChargeType string Obtém ou define o tipo de cobrança.
UnitPrice decimal Obtém ou define o preço unitário.
EffectiveUnitPrice decimal Obtém ou define o preço unitário efetivo.
Tipo de Unidade string Obtém ou define o tipo de unidade.
Quantidade número inteiro Obtém ou define o número de unidades associadas a este item de linha.
Subtotal decimal Obtém ou define o valor após o desconto.
TaxTotal decimal Obtém ou define os impostos cobrados.
TotalForCustomer decimal Obtém ou define o valor total após desconto e imposto.
Moeda string Obtém ou define a moeda usada para este item de linha.
Nome do Editor string Obtém ou define o nome do editor associado a esta compra.
PublisherId string Obtém ou define o ID do editor associado a esta compra.
SubscriçãoDescrição string Obtém ou define a descrição da subscrição associada a esta compra.
SubscriptionId cadeia Obtém ou define o ID de subscrição associado a esta compra.
ChargeStartDate DateTime Obtém ou define a data de início da cobrança associada a esta compra.
ChargeEndDate DateTime Obtém ou define a data de término da cobrança associada a esta compra.
TermAndBillingCycle string Obtém ou define o prazo e o ciclo de faturamento associados a essa compra.
AlternateId string Obtém ou define a ID alternativa (ID da cotação).
PreçoAjusteDescrição string Obtém ou define a descrição do ajuste de preço.
CreditReasonCode string Obtém ou define o código de motivo de crédito.
DescontoDetalhes string Preterido. Obtém ou define os detalhes do desconto associados a esta compra.
PricingCurrency string Obtém ou define o código de moeda de preço.
PCToBCExchangeRate decimal Obtém ou define a moeda de preço para a taxa de câmbio da moeda de cobrança.
PCToBCExchangeRateDate DateTime Obtém ou define a data da taxa de câmbio na qual a moeda de preço para a taxa de câmbio da moeda de cobrança foi determinada.
FaturávelQuantidade decimal Obtém ou define as unidades compradas. Para cada coluna de design nomeada como BillableQuantity.
MedidorDescrição string Obtém ou define a descrição do medidor para o item de linha de consumo.
ReservationOrderId string Obtém ou define o identificador de ordem de reserva para uma Compra do Azure RI.
FaturaçãoFrequência string Obtém ou define a frequência de faturamento.
InvoiceLineItemType InvoiceLineItemType Retorna o tipo de item de linha da fatura.
BillingProvider BillingProvider Devolve o fornecedor de faturação.
Qualificadores de Produto string O identificador para saber as compras de complementos ou avaliações.
PromotionId string O identificador para recuperar informações promocionais.

DailyRatedUsageLineItem

Representa itens de linha de reconciliação não faturados e faturados para uso diário avaliado.

Propriedade Type Description
Identificação do parceiro string Obtém ou define a ID do locatário parceiro.
PartnerName string Obtém ou define o nome do parceiro.
ID do Cliente string Obtém ou define a ID do locatário do cliente ao qual o uso pertence.
CustomerName string Obtém ou define o nome da empresa cliente à qual o uso pertence.
CustomerDomainName string Obtém ou define o nome de domínio do cliente ao qual o uso pertence.
Número da fatura string Obtém ou define a ID da fatura à qual o uso pertence.
ProductId string Obtém ou define o identificador exclusivo do produto.
SkuId string Obtém ou define o identificador exclusivo de SKU.
AvailabilityId string Obtém ou define o identificador exclusivo de disponibilidade.
SkuName string Obtém ou define o nome da SKU para o serviço.
ProductName string Obtém ou define o nome do produto.
Nome do Editor string Obtém ou define o nome do editor.
PublisherId string Obtém ou define a ID do editor.
SubscriptionId cadeia Obtém ou define a ID da assinatura.
SubscriçãoDescrição string Obtém ou define a descrição da assinatura.
ChargeStartDate DateTime Obtém ou define a data de início da cobrança.
ChargeEndDate DateTime Obtém ou define a data de término da cobrança.
UsageDate DateTime Obtém ou define a data de uso.
Tipo de Medidor string Obtém ou define o tipo de medidor.
MeterCategory string Obtém ou define a categoria do medidor.
MeterId string Obtém ou define o ID do medidor (GUID).
MeterSubCategory string Obtém ou define a subcategoria do medidor.
MeterName string Obtém ou define o nome do medidor.
MeterRegion string Obtém ou define a região do medidor.
UnitOfMeasure string Obtém ou define a unidade de medida.
ResourceLocation string Obtém ou define o local do recurso.
ConsumedService string Obtém ou define o nome do serviço consumido.
ResourceGroup string Obtém ou define o nome do grupo de recursos.
ResourceUri string Obtém ou define o uri da instância de recurso sobre a qual o uso se refere.
Etiquetas string Obtém ou define as tags adicionadas pelo cliente.
AdditionalInfo string Obtém ou define os metadados específicos do serviço. Por exemplo, um tipo de imagem de uma máquina virtual.
ServiceInfo1 string Obtém ou define metadados internos do Serviço do Azure.
ServiceInfo2 string Obtém ou define informações de serviço, por exemplo, um tipo de imagem para uma máquina virtual e um nome de ISP para a Rota Expressa.
País do Cliente string Obtém ou define o país/região do cliente.
MpnId string Obtém ou define o PartnerID associado a este item de linha.
RevendedorMpnId string Obtém ou define o Reseller PartnerID do parceiro de Nível 2 associado a este item de linha.
ChargeType string Obtém ou define o tipo de cobrança.
UnitPrice decimal Obtém ou define o preço da unidade.
Quantidade decimal Obtém ou define a quantidade de uso.
Tipo de Unidade string Obtém ou define o tipo de unidade (como 1 hora).
FaturamentoPreTaxTotal decimal Obtém ou define o custo estendido ou o custo total antes de impostos na moeda local do cliente ou na moeda de cobrança.
BillingCurrency string Obtém ou define a moeda ISO na qual o medidor é cobrado na moeda local do cliente ou na moeda de cobrança.
PreçosPreTaxTotal decimal Obtém ou define o custo estendido ou o custo total antes de impostos em USD ou na moeda do catálogo usada para classificação.
PricingCurrency string Obtém ou define a moeda ISO na qual o medidor é cobrado em USD ou na moeda do catálogo usada para classificação.
EntitlementId string Obtém ou define a ID de direito (assinatura do Azure).
DireitoDescrição string Obtém ou define a descrição do direito (assinatura do Azure).
PCToBCExchangeRate string Obtém ou define a moeda de preço para a taxa de câmbio da moeda de cobrança.
PCToBCExchangeRateDate DateTime Obtém ou define a moeda de preço para a data da taxa de câmbio da moeda de cobrança.
EffectiveUnitPrice decimal Obtém ou define o preço unitário efetivo.
TaxadeParceiroEarnedCredit decimal Obtém ou define a taxa de crédito ganho pelo parceiro.
HasPartnerEarnedCredit booleano Obtém ou define é o crédito ganho pelo parceiro aplicado.
TaxadeCrédito decimal Obtém ou define a taxa de crédito para determinado tipo de crédito.
Tipo de Crédito string Obtém ou define o tipo de crédito.
InvoiceLineItemType InvoiceLineItemType Retorna o tipo de item de linha da fatura.
BillingProvider BillingProvider Devolve o fornecedor de faturação.