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