Compartilhar via

Recursos de fatura

  • Artigo

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

Os recursos relacionados à fatura a seguir estão disponíveis por meio das APIs do Partner Center.

Fatura

Propriedade Type Descrição
id string O identificador da fatura.
faturaData da fatura string no formato de data e hora UTC A data em que a fatura foi gerada.
billingPeriodStartDate string no formato de data e hora UTC Data de início do período de cobrança em UTC.
billingPeriodEndDate string no formato de data e hora UTC Data de término do período de cobrança em UTC.
totalEncargos número O total de encargos. Inclui encargos por transações e eventuais ajustes.
Valor pago número O valor pago pelo sócio. Negativado 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.
pdfDownloadLink string Um link para baixar a fatura em formato PDF. Esse link não é retornado como parte dos resultados da pesquisa e é preenchido somente se a fatura for acessada pela ID. Este link expira automaticamente em 30 minutos.
faturaDetalhes matriz de objetos InvoiceDetail Os detalhes da fatura.
Alterações matriz de objetos Invoice As alterações a esta fatura.
documentType string O tipo de documento da fatura: "Nota de crédito", "Nota fiscal".
emendasDe string O número de referência do documento de que este documento é uma alteração.
Tipo de fatura string O tipo de fatura: "recorrente", "one_time".
links ResourceLinks Os links de recursos.
attributes ResourceAttributes Os atributos de metadados.
collectionOfSummary matriz de objetos TaxReceipt Obtém ou define o link de download do recibo fiscal.
Status 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 Descrição
invoiceLineItemType string O tipo de detalhe da fatura: "nenhuma", "usage_line_items", "faturamento/_line_items".
faturamentoProvedor string O provedor de cobrança: "Nenhum", "Office", "Azure", "OneTime".
links ResourceLinks Os links de recursos.
attributes ResourceAttributes Os atributos de metadados.

InvoiceLineItem

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

Propriedade Type Descrição
invoiceLineItemType string O tipo de item de linha da fatura: "nenhum", "usage_line_items", "faturamento/_line_items".
faturamentoProvedor string O provedor de cobrança: "Nenhum", "Office", "Azure", "OneTime".
attributes ResourceAttributes Os atributos de metadados.

Resumo da Fatura

Descreve um resumo do saldo e dos encargos totais de uma fatura.

Propriedade Type Descrição
saldoMontante número O saldo da fatura. Este é o valor total de 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 de data e hora UTC A data em que o valor do saldo foi atualizado pela última vez.
primeiroInvoiceCreationDate string no formato de data e hora UTC A data em que a primeira fatura para o cliente foi criada.
últimoData de Pagamento string no formato de data e hora UTC A data do último pagamento.
lastPaymentAmount número O valor do último pagamento.
mais recenteData da fatura string no formato de data e hora UTC A data em que a última fatura do cliente foi criada.
detalhes matriz de objetos InvoiceSummaryDetail O detalhe do resumo da fatura.
links ResourceLinks Os links de recursos.
attributes ResourceAttributes Os atributos de metadados.

InvoiceSummaryDetail

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

Propriedade Type Descrição
Tipo de fatura string O tipo de fatura: "recorrente", "one_time".
summary Objeto InvoiceSummary O resumo da fatura por tipo de fatura.

Resumos de Faturas

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

Propriedade Type Descrição
collectionOfSummary matriz de objetos InvoiceSummary O resumo da fatura por tipo de fatura por moeda.

LicenseBasedLineItem

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

Propriedade Type Descrição
valor string Obtém ou define o valor total. Valor total = preço unitário * quantidade.
attributes string Obtém os atributos.
billingCycleType string Obtém ou define o tipo de ciclo de faturamento.
faturamentoProvedor string Obtém o provedor de cobrança.
chargeEndDate string no formato de data e hora UTC Obtém ou define a data de término da cobrança.
chargeStartDate string no formato de data e 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 esse item de linha.
customerId string Obtém ou define o identificador exclusivo do cliente na plataforma de cobrança da Microsoft.
customerName string no formato de data e hora UTC Obtém ou define o nome do cliente.
domainName string Obtém ou define o nome de domínio.
durableOfferId string Obtém ou define o identificador exclusivo de oferta durável.
invoiceLineItemType string Obtém o tipo de item de linha de fatura.
partnerId 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 do pedido.
partnerId string Obtém ou define a ID do locatário do Microsoft Entra parceiro.
quantity número Obtém ou define o número de unidades associadas a este item de linha.
subscriptionDescription string Obtém ou define a descrição da assinatura.
subscriptionEndDate string no formato de data e hora UTC Obtém ou define a data em que a assinatura expira.
subscriptionId string Obtém ou define o identificador exclusivo da assinatura.
subscriptionName string Obtém ou define o nome da assinatura.
subscriptionStartDate string no formato de data e 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.
tax 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.
totalOtherDiscount 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 Descrição
attributes string Obtém os atributos.
billingCycleType string Obtém ou define o tipo de ciclo de faturamento.
faturamentoProvedor string Obtém o provedor de cobrança.
chargeEndDate string no formato de data e hora UTC Obtém ou define a data de término da cobrança.
chargeStartDate string no formato de data e 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.
consumedQuantity 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.
customerName 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 os casos em que o cálculo é diferente para as unidades consumidas. Exemplo: Total consumido = 1338, 1024 é cobrado com uma taxa, 314 é cobrado com uma taxa diferente.
domainName string Obtém ou define o nome de domínio.
includedQuantity número Obtém ou define as unidades incluídas no pedido.
invoiceLineItemType string Obtém o tipo de item de linha de fatura.
invoiceNumber string Obtém ou define o número da fatura.
listPrice número Obtém ou define o preço de cada unidade.
partnerId 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 do pedido.
excesso de idadeQuantidade 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.
partnerId string Obtém ou define a ID do locatário do Microsoft Entra parceiro.
partnerName string Obtém ou define o nome do parceiro.
postTaxEffectiveRate número Obtém ou define o preço efetivo após os impostos.
postTaxTotal número Obtém ou define o total de cobranças após o imposto. Encargos antes de impostos + valor do imposto
preTaxCharges número Obtém ou define o preço cobrado antes dos impostos.
preTaxEffectiveRate número Obtém ou define o preço efetivo antes dos 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).
serviceName string Obtém ou define o nome do serviço. Exemplo: Serviço de Dados do Azure.
serviceType string Obtém ou define o tipo de serviço. Exemplo: Banco de Dados do Azure SQL Azure.
sku string Obtém ou define a SKU do serviço.
subscriptionDescription string Obtém ou define a descrição da assinatura.
subscriptionId string Obtém ou define o identificador exclusivo da assinatura.
subscriptionName string Obtém ou define o nome da assinatura.
Valor do imposto 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.
unidade 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 em aplicativo/pdf.

Propriedade Type Descrição
httpResponseMessage objeto ByteArrayContent com contentType = application/pdf.

OneTimeInvoiceLineItem

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

Propriedade Type Descrição
PartnerId string Obtém ou define a ID do locatário parceiro.
CustomerId 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.
CustomerCountry string Obtém ou define o país/região do cliente.
InvoiceNumber string Obtém ou define o número da fatura.
MpnId string Obtém ou define o PartnerID associado a este item de linha.
ResellerMpnId int 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 o pedido foi criado.
OrderId string Identificador exclusivo para um pedido na plataforma de cobrança do 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.
UnitType string Obtém ou define o tipo de unidade.
Quantidade int 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 esse item de linha.
PublisherName 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.
SubscriptionDescription string Obtém ou define a descrição da assinatura associada a esta compra.
SubscriptionId string Obtém ou define o ID de assinatura 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 de aspas).
PriceAdjustmentDescription 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 de 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 de 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 faturamento foi determinada.
BillableQuantity decimal Obtém ou define as unidades adquiridas. Para cada coluna de design nomeada como BillableQuantity.
MeterDescription 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 de RI do Azure.
BillingFrequency string Obtém ou define a frequência de cobrança.
InvoiceLineItemType InvoiceLineItemType Retorna o tipo de item de linha da fatura.
Provedor de Faturamento Provedor de Faturamento Retorna o provedor de cobrança.
ProductQualifiers string Identificador para distinguir compras de Complemento ou de Avaliação.
PromotionId string O identificador para recuperar informações de promoção.

DailyRatedUsageLineItem

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

Propriedade Type Descrição
PartnerId string Obtém ou define a ID do locatário parceiro.
PartnerName string Obtém ou define o nome do parceiro.
CustomerId 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.
InvoiceNumber 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.
PublisherName string Obtém ou define o nome do editor.
PublisherId string Obtém ou define a ID do editor.
SubscriptionId string Obtém ou define a ID de assinatura.
SubscriptionDescription 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.
MeterType 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.
Marcações 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 para uma máquina virtual.
ServiceInfo1 string Obtém ou define metadados de serviço internos 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 Rota Expressa.
CustomerCountry 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.
ResellerMpnId 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.
UnitType string Obtém ou define o tipo de unidade (como 1 hora).
BillingPreTaxTotal decimal Obtém ou define o custo estendido ou o custo total antes do imposto na moeda local do cliente ou na moeda de faturamento.
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.
PricingPreTaxTotal decimal Obtém ou define o custo estendido ou o custo total antes do imposto 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 a moeda de catálogo usada para classificação.
EntitlementId string Obtém ou define a ID de direito (assinatura do Azure).
EntitlementDescription 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 de 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.
RateOfPartnerEarnedCredit decimal Obtém ou define a taxa de crédito ganho pelo parceiro.
HasPartnerEarnedCredit bool Obtém ou define o crédito ganho pelo parceiro aplicado.
Taxa de Crédito decimal Obtém ou define a taxa de crédito para o tipo de crédito determinado.
CreditType string Obtém ou define o tipo de crédito.
InvoiceLineItemType InvoiceLineItemType Retorna o tipo de item de linha da fatura.
Provedor de Faturamento Provedor de Faturamento Retorna o provedor de cobrança.