Condividi tramite

Risorse della fattura

  • Articolo

Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

Le risorse correlate alla fattura seguenti sono disponibili tramite le API del Centro per i partner.

Fattura

Proprietà Type Descrizione
id string Identificatore della fattura.
invoiceDate stringa nel formato di data e ora UTC Data di generazione della fattura.
billingPeriodStartDate stringa nel formato di data e ora UTC Data di inizio del periodo di fatturazione in formato UTC.
billingPeriodEndDate stringa nel formato di data e ora UTC Data di fine del periodo di fatturazione in formato UTC.
totalCharges number Addebiti totali. Include gli addebiti per le transazioni e le eventuali rettifiche.
paidAmount number Importo pagato dal partner. Negativo se è stato ricevuto un pagamento.
currencyCode string Codice che indica la valuta utilizzata per tutti gli importi e i totali dell'articolo fattura.
currencySymbol string Simbolo di valuta utilizzato per tutti gli importi e i totali dell'articolo della fattura.
pdfDownloadLink string Collegamento per scaricare la fattura in formato PDF. Questo collegamento non viene restituito come parte dei risultati della ricerca e viene popolato solo se la fattura è accessibile in base all'ID. Questo collegamento scade automaticamente in 30 minuti.
invoiceDetails matrice di oggetti InvoiceDetail Dettagli della fattura.
Modifiche matrice di oggetti Invoice Le modifiche apportate alla fattura.
documentType string Tipo di documento della fattura: "Nota di credito", "Fattura".
modificatoOf string Il numero di riferimento del documento di cui questo documento è un emendamento.
invoiceType string Tipo di fattura: "ricorrente", "one_time".
collegamenti ResourceLinks Collegamenti alle risorse.
Attributi ResourceAttributes Attributi dei metadati.
collectionOfSummary matrice di oggetti TaxReceipt Ottiene o imposta il collegamento per il download della ricevuta fiscale.
Stato string Ottiene lo stato della fattura, ad esempio "attivo", "void" e così via.

InvoiceDetail

Una fattura contiene una raccolta di articoli fatturati e ogni articolo è rappresentato da una risorsa InvoiceDetail.

Proprietà Type Descrizione
invoiceLineItemType string Tipo di dettaglio fattura: "none", "usage_line_items", "billing/_line_items".
billingProvider string Provider di fatturazione: "None", "Office", "Azure", "OneTime".
collegamenti ResourceLinks Collegamenti alle risorse.
Attributi ResourceAttributes Attributi dei metadati.

InvoiceLineItem

Ogni addebito individuale all'interno di una fattura è rappresentato come InvoiceLineItem.

Proprietà Type Descrizione
invoiceLineItemType string Tipo di voce della fattura: "none", "usage_line_items", "billing/_line_items".
billingProvider string Provider di fatturazione: "None", "Office", "Azure", "OneTime".
Attributi ResourceAttributes Attributi dei metadati.

InvoiceSummary

Descrive un riepilogo del saldo e degli addebiti totali di una fattura.

Proprietà Type Descrizione
balanceAmount number Saldo della fattura. Si tratta dell'importo totale delle fatture non pagate.
currencyCode string Codice che indica la valuta utilizzata per l'importo del saldo.
currencySymbol string Simbolo di valuta utilizzato.
accountingDate stringa nel formato di data e ora UTC Data dell'ultimo aggiornamento dell'importo del saldo.
firstInvoiceCreationDate stringa nel formato di data e ora UTC Data di creazione della prima fattura per il cliente.
lastPaymentDate stringa nel formato di data e ora UTC Data dell'ultimo pagamento.
lastPaymentAmount number Importo dell'ultimo pagamento.
latestInvoiceDate stringa nel formato di data e ora UTC Data di creazione dell'ultima fattura per il cliente.
dettagli matrice di oggetti InvoiceSummaryDetail Dettagli riepilogo fattura.
collegamenti ResourceLinks Collegamenti alle risorse.
Attributi ResourceAttributes Attributi dei metadati.

InvoiceSummaryDetail

Rappresenta un riepilogo dei singoli dettagli per un tipo di fattura(ad esempio, ricorrente, one_time).

Proprietà Type Descrizione
invoiceType string Tipo di fattura: "ricorrente", "one_time".
riepilogo Oggetto InvoiceSummary Riepilogo della fattura per ogni tipo di fattura.

InvoiceSummaries

Rappresenta una raccolta di tipo InvoiceSummary che contiene i singoli dettagli per un tipo di fattura per valuta.

Proprietà Type Descrizione
collectionOfSummary matrice di oggetti InvoiceSummary Riepilogo della fattura per tipo di fattura per valuta.

LicenseBasedLineItem

Rappresenta un elemento della riga di fatturazione della fattura per le sottoscrizioni basate su licenza.

Proprietà Type Descrizione
amount string Ottiene o imposta l'importo totale. Importo totale = prezzo unitario * quantità.
Attributi string Ottiene gli attributi.
billingCycleType string Ottiene o imposta il tipo di ciclo di fatturazione.
billingProvider string Ottiene il provider di fatturazione.
chargeEndDate stringa nel formato di data e ora UTC Ottiene o imposta la data di fine dell'addebito.
chargeStartDate stringa nel formato di data e ora UTC Ottiene o imposta la data di inizio dell'addebito.
chargeType string Ottiene o imposta il tipo di addebito.
Valuta string Ottiene o imposta la valuta utilizzata per questa voce.
customerId string Ottiene o imposta l'identificatore univoco del cliente nella piattaforma di fatturazione Microsoft.
customerName stringa nel formato di data e ora UTC Ottiene o imposta il nome del cliente.
domainName string Ottiene o imposta il nome di dominio.
durableOfferId string Ottiene o imposta l'identificatore univoco dell'offerta durevole.
invoiceLineItemType string Ottiene il tipo di voce della fattura.
partnerId number Ottiene o imposta l'ID partner associato a questa voce. Per i rivenditori diretti, questo è l'ID partner del rivenditore. Per i rivenditori indiretti, si tratta dell'ID partner del rivenditore con valore aggiunto (VAR).
offerId string Ottiene o imposta l'identificatore univoco dell'offerta.
offerName string Ottiene o imposta il nome dell'offerta.
orderId string Ottiene o imposta l'identificatore univoco dell'ordine.
partnerId string Ottiene o imposta l'ID tenant microsoft Entra del partner.
quantity number Ottiene o imposta il numero di unità associate a questa voce.
subscriptionDescription string Ottiene o imposta la descrizione della sottoscrizione.
subscriptionEndDate stringa nel formato di data e ora UTC Ottiene o imposta la data di scadenza della sottoscrizione.
subscriptionId string Ottiene o imposta l'identificatore univoco della sottoscrizione.
subscriptionName string Ottiene o imposta il nome della sottoscrizione.
subscriptionStartDate stringa nel formato di data e ora UTC Ottiene o imposta la data di inizio della sottoscrizione.
subtotale number Ottiene o imposta l'importo dopo lo sconto.
syndicationPartnerSubscriptionNumber string Ottiene o imposta il numero di sottoscrizione del partner di diffusione.
tax number Ottiene o imposta le imposte addebitate.
tier2MpnId number Ottiene o imposta l'ID partner del partner di livello 2 associato a questa voce.
totalForCustomer number Ottiene o imposta l'importo totale dopo lo sconto e l'imposta.
totalOtherDiscount number Ottiene o imposta lo sconto associato all'acquisto.
unitPrice number Ottiene o imposta il prezzo unitario.

UsageBasedLineItem

Rappresenta un elemento della riga di fatturazione della fattura per le sottoscrizioni basate sull'utilizzo.

Proprietà Type Descrizione
Attributi string Ottiene gli attributi.
billingCycleType string Ottiene o imposta il tipo di ciclo di fatturazione.
billingProvider string Ottiene il provider di fatturazione.
chargeEndDate stringa nel formato di data e ora UTC Ottiene o imposta la data di fine dell'addebito.
chargeStartDate stringa nel formato di data e ora UTC Ottiene o imposta la data di inizio dell'addebito.
chargeType string Ottiene o imposta il tipo di addebito.
consumedQuantity number Ottiene o imposta le unità totali utilizzate.
consumptionDiscount string Ottiene o imposta lo sconto sul consumo.
consumptionPrice string Ottiene o imposta il prezzo della quantità utilizzata.
Valuta string Ottiene o imposta la valuta associata ai prezzi.
customerName string Ottiene o imposta il nome del cliente.
customerId string Ottiene o imposta l'identificatore univoco del cliente.
detailLineItemId number Ottiene o imposta l'ID dell'elemento della riga di dettaglio. Identifica in modo univoco le voci per i casi in cui il calcolo è diverso per le unità utilizzate. Esempio: totale utilizzato = 1338, 1024 viene addebitato con una tariffa, 314 viene addebitato con una tariffa diversa.
domainName string Ottiene o imposta il nome di dominio.
includedQuantity number Ottiene o imposta le unità incluse nell'ordine.
invoiceLineItemType string Ottiene il tipo di voce della fattura.
invoiceNumber string Ottiene o imposta il numero di fattura.
listPrice number Ottiene o imposta il prezzo di ogni unità.
partnerId number Ottiene o imposta l'ID partner associato a questa voce. Per i rivenditori diretti, questo è l'ID partner del rivenditore. Per i rivenditori indiretti, si tratta dell'ID partner del rivenditore con valore aggiunto (VAR).
orderId string Ottiene o imposta l'identificatore univoco dell'ordine.
overageQuantity number Ottiene o imposta la quantità utilizzata sopra l'utilizzo consentito.
partnerBillableAccountId string Ottiene o imposta l'ID account fatturabile del partner.
partnerId string Ottiene o imposta l'ID tenant microsoft Entra del partner.
partnerName string Ottiene o imposta il nome del partner.
postTaxEffectiveRate number Ottiene o imposta il prezzo effettivo dopo le imposte.
postTaxTotal number Ottiene o imposta gli addebiti totali dopo l'imposta. Pretax Charges + Tax Amount
preTaxCharges number Ottiene o imposta il prezzo addebitato prima delle imposte.
preTaxEffectiveRate number Ottiene o imposta il prezzo effettivo prima delle imposte.
area geografica string Ottiene o imposta l'area associata all'istanza della risorsa.
resourceGuid string Ottiene o imposta l'identificatore della risorsa.
resourceName string Ottiene o imposta il nome della risorsa. Esempio: Database (GB/mese).
serviceName string Ottiene o imposta il nome del servizio. Esempio: Servizio dati di Azure.
serviceType string Ottiene o imposta il tipo di servizio. Esempio: database di Azure SQL di Azure.
sku string Ottiene o imposta lo SKU del servizio.
subscriptionDescription string Ottiene o imposta la descrizione della sottoscrizione.
subscriptionId string Ottiene o imposta l'identificatore univoco della sottoscrizione.
subscriptionName string Ottiene o imposta il nome della sottoscrizione.
taxAmount number Ottiene o imposta l'importo delle imposte addebitate.
tier2MpnId number Ottiene o imposta l'ID partner del partner di livello 2 associato a questa voce.
unitàà string Ottiene o imposta l'unità di misura per l'utilizzo di Azure.

InvoiceStatement

Rappresenta le operazioni disponibili in un estratto conto in application/pdf.

Proprietà Type Descrizione
httpResponseMessage oggetto ByteArrayContent con contentType = application/pdf.

OneTimeInvoiceLineItem

Rappresenta un elemento della riga di fatturazione della fattura per le sottoscrizioni basate su licenza.

Proprietà Type Descrizione
PartnerId string Ottiene o imposta l'ID tenant del partner.
CustomerId string Ottiene o imposta l'ID tenant del cliente.
CustomerName string Ottiene o imposta il nome del cliente.
CustomerDomainName string Ottiene o imposta il nome di dominio del cliente.
CustomerCountry string Ottiene o imposta il paese/area geografica del cliente.
InvoiceNumber string Ottiene o imposta il numero di fattura.
MpnId string Ottiene o imposta l'ID partner associato a questa voce.
ResellerMpnId int Ottiene o imposta l'ID partner del partner di livello 2 associato a questa voce.
DataOrdine Data/Ora Ottiene o imposta la data di creazione dell'ordine.
OrderId string Identificatore univoco per un ordine nella piattaforma di fatturazione Microsoft.
ProductId string Ottiene o imposta l'identificatore univoco del prodotto.
SkuId string Ottiene o imposta l'identificatore univoco dello SKU.
AvailabilityId string Ottiene o imposta l'identificatore univoco della disponibilità.
ProductName string Ottiene o imposta il nome del prodotto.
SkuName string Ottiene o imposta il nome dello SKU.
ChargeType string Ottiene o imposta il tipo di addebito.
UnitPrice decimale Ottiene o imposta il prezzo unitario.
EffectiveUnitPrice decimale Ottiene o imposta il prezzo unitario effettivo.
UnitType string Ottiene o imposta il tipo di unità.
Quantità int Ottiene o imposta il numero di unità associate a questa voce.
Subtotale decimale Ottiene o imposta l'importo dopo lo sconto.
TaxTotal decimale Ottiene o imposta le imposte addebitate.
TotalForCustomer decimale Ottiene o imposta l'importo totale dopo lo sconto e l'imposta.
Valuta string Ottiene o imposta la valuta utilizzata per questa voce.
PublisherName string Ottiene o imposta il nome dell'editore associato all'acquisto.
PublisherId string Ottiene o imposta l'ID editore associato all'acquisto.
SubscriptionDescription string Ottiene o imposta la descrizione della sottoscrizione associata all'acquisto.
SubscriptionId string Ottiene o imposta l'ID sottoscrizione associato all'acquisto.
ChargeStartDate Data/Ora Ottiene o imposta la data di inizio dell'addebito associata all'acquisto.
ChargeEndDate Data/Ora Ottiene o imposta la data di fine dell'addebito associata all'acquisto.
TermAndBillingCycle string Ottiene o imposta il periodo e il ciclo di fatturazione associati a questo acquisto.
AlternateId string Ottiene o imposta l'ID alternativo (ID virgolette).
PriceAdjustmentDescription string Ottiene o imposta la descrizione dell'rettifica del prezzo.
CreditReasonCode string Ottiene o imposta il codice motivo del credito.
ScontoDetails string Deprecato. Ottiene o imposta i dettagli dello sconto associati all'acquisto.
PricingCurrency string Ottiene o imposta il codice di valuta dei prezzi.
PCToBCExchangeRate decimale Ottiene o imposta la valuta dei prezzi sul tasso di cambio della valuta di fatturazione.
PCToBCExchangeRateDate Data/Ora Ottiene o imposta la data del tasso di cambio in corrispondenza della quale è stata determinata la valuta dei prezzi al tasso di cambio della valuta di fatturazione.
BillableQuantity decimale Ottiene o imposta le unità acquistate. Per ogni colonna di progettazione denominata BillableQuantity.
MeterDescription string Ottiene o imposta la descrizione del contatore per l'elemento della riga di consumo.
ReservationOrderId string Ottiene o imposta l'identificatore dell'ordine di prenotazione per un acquisto dell'istanza riservata di Azure.
BillingFrequency string Ottiene o imposta la frequenza di fatturazione.
InvoiceLineItemType InvoiceLineItemType Restituisce il tipo di voce della fattura.
BillingProvider BillingProvider Restituisce il provider di fatturazione.
ProductQualifiers string Identificatore per conoscere gli acquisti di componenti aggiuntivi o di valutazione.
PromotionId string Identificatore per il recupero delle informazioni di promozione.

DailyRatedUsageLineItem

Rappresenta le voci di riconciliazione fatturate non fatturate per l'utilizzo valutato giornaliero.

Proprietà Type Descrizione
PartnerId string Ottiene o imposta l'ID tenant del partner.
PartnerName string Ottiene o imposta il nome del partner.
CustomerId string Ottiene o imposta l'ID tenant del cliente a cui appartiene l'utilizzo.
CustomerName string Ottiene o imposta il nome della società del cliente a cui appartiene l'utilizzo.
CustomerDomainName string Ottiene o imposta il nome di dominio del cliente a cui appartiene l'utilizzo.
InvoiceNumber string Ottiene o imposta l'ID della fattura a cui appartiene l'utilizzo.
ProductId string Ottiene o imposta l'identificatore univoco del prodotto.
SkuId string Ottiene o imposta l'identificatore univoco dello SKU.
AvailabilityId string Ottiene o imposta l'identificatore univoco della disponibilità.
SkuName string Ottiene o imposta il nome dello SKU per il servizio.
ProductName string Ottiene o imposta il nome del prodotto.
PublisherName string Ottiene o imposta il nome del server di pubblicazione.
PublisherId string Ottiene o imposta l'ID del server di pubblicazione.
SubscriptionId string Ottiene o imposta l'ID della sottoscrizione.
SubscriptionDescription string Ottiene o imposta la descrizione della sottoscrizione.
ChargeStartDate Data/Ora Ottiene o imposta la data di inizio dell'addebito.
ChargeEndDate Data/Ora Ottiene o imposta la data di fine dell'addebito.
UsageDate Data/Ora Ottiene o imposta la data di utilizzo.
MeterType string Ottiene o imposta il tipo di contatore.
MeterCategory string Ottiene o imposta la categoria del contatore.
ID contatore string Ottiene o imposta l'ID del contatore (GUID).
MeterSubCategory string Ottiene o imposta la sottocategoria del contatore.
MeterName string Ottiene o imposta il nome del contatore.
MeterRegion string Ottiene o imposta l'area del contatore.
UnitOfMeasure string Ottiene o imposta l'unità di misura.
ResourceLocation string Ottiene o imposta la posizione della risorsa.
ConsumedService string Ottiene o imposta il nome del servizio utilizzato.
ResourceGroup string Ottiene o imposta il nome del gruppo di risorse.
ResourceUri string Ottiene o imposta l'URI dell'istanza della risorsa su cui si basa l'utilizzo.
Tag string Ottiene o imposta i tag aggiunti dal cliente.
AdditionalInfo string Ottiene o imposta i metadati specifici del servizio. Ad esempio un tipo di immagine per una macchina virtuale.
ServiceInfo1 string Ottiene o imposta i metadati interni del servizio di Azure.
ServiceInfo2 string Ottiene o imposta le informazioni sul servizio, ad esempio un tipo di immagine per una macchina virtuale e un nome ISP per ExpressRoute.
CustomerCountry string Ottiene o imposta il paese o l'area geografica del cliente.
MpnId string Ottiene o imposta l'ID partner associato a questa voce.
ResellerMpnId string Ottiene o imposta l'ID partner rivenditore del partner di livello 2 associato a questa voce.
ChargeType string Ottiene o imposta il tipo di addebito.
UnitPrice decimale Ottiene o imposta il prezzo dell'unità.
Quantità decimale Ottiene o imposta la quantità di utilizzo.
UnitType string Ottiene o imposta il tipo di unità, ad esempio 1 ora.
BillingPreTaxTotal decimale Ottiene o imposta il costo esteso o il costo totale prima dell'imposta nella valuta locale del cliente o della valuta di fatturazione.
BillingCurrency string Ottiene o imposta la valuta ISO in cui il contatore viene addebitato nella valuta locale del cliente o della valuta di fatturazione.
PricingPreTaxTotal decimale Ottiene o imposta il costo esteso o il costo totale prima dell'imposta in USD o valuta del catalogo utilizzata per la classificazione.
PricingCurrency string Ottiene o imposta la valuta ISO in cui il contatore viene addebitato in valuta usd o catalogo utilizzata per la classificazione.
EntitlementId string Ottiene o imposta l'ID entitlement (sottoscrizione di Azure).
EntitlementDescription string Ottiene o imposta la descrizione del diritto (sottoscrizione di Azure).
PCToBCExchangeRate string Ottiene o imposta la valuta dei prezzi sul tasso di cambio della valuta di fatturazione.
PCToBCExchangeRateDate Data/Ora Ottiene o imposta la valuta dei prezzi sulla data del tasso di cambio della valuta di fatturazione.
EffectiveUnitPrice decimale Ottiene o imposta il prezzo unitario effettivo.
RateOfPartnerEarnedCredit decimale Ottiene o imposta il tasso di credito ottenuto dai partner.
HasPartnerEarnedCredit bool Ottiene o imposta il credito ottenuto dai partner applicato.
RateOfCredit decimale Ottiene o imposta il tasso di credito per il tipo di credito specificato.
CreditType string Ottiene o imposta il tipo di credito.
InvoiceLineItemType InvoiceLineItemType Restituisce il tipo di voce della fattura.
BillingProvider BillingProvider Restituisce il provider di fatturazione.