Transactions - List By Invoice
Elenca le transazioni per una fattura. Le transazioni includono acquisti, rimborsi e addebiti per l'utilizzo di Azure.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/{invoiceName}/transactions?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/{invoiceName}/transactions?api-version=2024-04-01&filter={filter}&orderBy={orderBy}&top={top}&skip={skip}&count={count}&search={search}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
billing
|
path | True |
string |
ID che identifica in modo univoco un account di fatturazione. Criterio di espressione regolare: |
invoice
|
path | True |
string |
ID che identifica in modo univoco una fattura. Criterio di espressione regolare: |
api-version
|
query | True |
string |
Versione dell'API da usare con la richiesta client. La versione corrente è 2024-04-01. |
count
|
query |
boolean |
L'opzione di query count consente ai client di richiedere un conteggio delle risorse corrispondenti incluse nelle risorse nella risposta. |
|
filter
|
query |
string |
L'opzione di query di filtro consente ai client di filtrare una raccolta di risorse indirizzate da un URL di richiesta. |
|
order
|
query |
string |
L'opzione di query orderby consente ai client di richiedere risorse in un ordine specifico. |
|
search
|
query |
string |
L'opzione di query di ricerca consente ai client di richiedere elementi all'interno di una raccolta corrispondente a un'espressione di ricerca senza testo. la ricerca è supportata solo per i campi stringa. |
|
skip
|
query |
integer int64 |
L'opzione ignora query richiede il numero di elementi nella raccolta di query che devono essere ignorati e non inclusi nel risultato. |
|
top
|
query |
integer int64 |
L'opzione query principale richiede che il numero di elementi nella raccolta di query venga incluso nel risultato. Il valore massimo supportato per top è 50. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Elenco di transazioni. |
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Esempio
TransactionsListByInvoice
Esempio di richiesta
Risposta di esempio
{
"value": [
{
"id": "/providers/Microsoft.Billing/BillingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/BillingProfiles/xxxx-xxxx-xxx-xxx/transactions/41000000-0000-0000-0000-000000000000",
"name": "41000000-0000-0000-0000-000000000000",
"properties": {
"azureCreditApplied": {
"currency": "USD",
"value": 2000
},
"billingCurrency": "USD",
"billingProfileDisplayName": "Contoso operations billing",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
"consumptionCommitmentDecremented": {
"currency": "USD",
"value": 100
},
"date": "2023-05-01T00:00:00Z",
"discount": 0.1,
"effectivePrice": {
"currency": "USD",
"value": 10
},
"exchangeRate": 1,
"invoice": "G123456789",
"invoiceId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/G123456789",
"invoiceSectionDisplayName": "Contoso operations invoiceSection",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/invoiceSections/22000000-0000-0000-0000-000000000000",
"marketPrice": {
"currency": "USD",
"value": 20
},
"partNumber": "0001",
"pricingCurrency": "USD",
"productDescription": "Standard D1, US West 3",
"productFamily": "Storage",
"productTypeId": "A12345",
"productType": "VM Instance",
"quantity": 1,
"servicePeriodStartDate": "2023-05-01T00:00:00Z",
"servicePeriodEndDate": "2023-09-30T00:00:00Z",
"subTotal": {
"currency": "USD",
"value": 4500
},
"tax": {
"currency": "USD",
"value": 500
},
"transactionAmount": {
"currency": "USD",
"value": 5000
},
"transactionType": "Purchase",
"units": 11.25,
"unitOfMeasure": "1 Minute",
"unitType": "1 Runtime Minute"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/transactions"
},
{
"id": "/providers/Microsoft.Billing/BillingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/BillingProfiles/xxxx-xxxx-xxx-xxx/transactions/51000000-0000-0000-0000-000000000000",
"name": "51000000-0000-0000-0000-000000000000",
"properties": {
"azureCreditApplied": {
"currency": "USD",
"value": 20
},
"billingCurrency": "USD",
"billingProfileDisplayName": "Contoso operations billing",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
"consumptionCommitmentDecremented": {
"currency": "USD",
"value": 50
},
"date": "2024-04-01T00:00:00Z",
"discount": 0.1,
"effectivePrice": {
"currency": "USD",
"value": 10
},
"exchangeRate": 1,
"invoice": "pending",
"invoiceSectionDisplayName": "Contoso operations invoiceSection",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/invoiceSections/22000000-0000-0000-0000-000000000000",
"marketPrice": {
"currency": "USD",
"value": 20
},
"partNumber": "0002",
"pricingCurrency": "USD",
"productDescription": "Standard Support",
"productFamily": "Storage",
"productTypeId": "A12345",
"productType": "VM Instance",
"quantity": 1,
"servicePeriodStartDate": "2023-05-01T00:00:00Z",
"servicePeriodEndDate": "2023-09-30T00:00:00Z",
"subTotal": {
"currency": "USD",
"value": 45
},
"tax": {
"currency": "USD",
"value": 5
},
"transactionAmount": {
"currency": "USD",
"value": 50
},
"transactionType": "Cancel",
"units": 1.25,
"unitOfMeasure": "1 Minute",
"unitType": "1 Runtime Minute"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/transactions"
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Amount |
Importo rimborsato. |
Amount |
Importo del rimborso richiesto. |
Azure |
Quantità di crediti Azure applicati automaticamente a questa transazione. |
Consumption |
La quantità di impegno per il consumo di Microsoft Azure (MACC) viene decrementato tramite la transazione. |
created |
Tipo di identità che ha creato la risorsa. |
Credit |
Tipo di credito della transazione. Si applica solo alle transazioni accreditate. |
Effective |
Il prezzo del prodotto dopo aver applicato eventuali sconti. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Market |
Prezzo al dettaglio del prodotto. |
Refund |
Dettagli del rimborso di una transazione. |
Special |
Identifica il tipo di calcolo delle imposte utilizzato per la fattura. Il campo è applicabile solo alle fatture con logica di calcolo fiscale speciale. |
Sub |
Importo addebitato in base all'imposta precedente per la transazione. |
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
Tax |
Importo dell'imposta applicato alla transazione. |
Transaction |
Transazione. |
Transaction |
Addebito associato alla transazione. |
Transaction |
Tipo di transazione, fatturata o non fatturata. |
Transaction |
Contenitore per un elenco di risorse |
Transaction |
Transazione. |
AmountRefunded
Importo rimborsato.
Nome | Tipo | Descrizione |
---|---|---|
currency |
string |
Valuta per il valore dell'importo. |
value |
number |
Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00. |
AmountRequested
Importo del rimborso richiesto.
Nome | Tipo | Descrizione |
---|---|---|
currency |
string |
Valuta per il valore dell'importo. |
value |
number |
Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00. |
AzureCreditApplied
Quantità di crediti Azure applicati automaticamente a questa transazione.
Nome | Tipo | Descrizione |
---|---|---|
currency |
string |
Valuta per il valore dell'importo. |
value |
number |
Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00. |
ConsumptionCommitmentDecremented
La quantità di impegno per il consumo di Microsoft Azure (MACC) viene decrementato tramite la transazione.
Nome | Tipo | Descrizione |
---|---|---|
currency |
string |
Valuta per il valore dell'importo. |
value |
number |
Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00. |
createdByType
Tipo di identità che ha creato la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CreditType
Tipo di credito della transazione. Si applica solo alle transazioni accreditate.
Nome | Tipo | Descrizione |
---|---|---|
AzureCreditOffer |
string |
|
AzureFreeCredit |
string |
|
Other |
string |
|
Refund |
string |
|
ServiceInterruption |
string |
EffectivePrice
Il prezzo del prodotto dopo aver applicato eventuali sconti.
Nome | Tipo | Descrizione |
---|---|---|
currency |
string |
Valuta per il valore dell'importo. |
value |
number |
Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00. |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
MarketPrice
Prezzo al dettaglio del prodotto.
Nome | Tipo | Descrizione |
---|---|---|
currency |
string |
Valuta per il valore dell'importo. |
value |
number |
Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00. |
RefundTransactionDetails
Dettagli del rimborso di una transazione.
Nome | Tipo | Descrizione |
---|---|---|
amountRefunded |
Importo rimborsato. |
|
amountRequested |
Importo del rimborso richiesto. |
|
refundOperationId |
string |
ID dell'operazione di rimborso. |
SpecialTaxationType
Identifica il tipo di calcolo delle imposte utilizzato per la fattura. Il campo è applicabile solo alle fatture con logica di calcolo fiscale speciale.
Nome | Tipo | Descrizione |
---|---|---|
InvoiceLevel |
string |
|
SubtotalLevel |
string |
SubTotal
Importo addebitato in base all'imposta precedente per la transazione.
Nome | Tipo | Descrizione |
---|---|---|
currency |
string |
Valuta per il valore dell'importo. |
value |
number |
Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00. |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
createdAt |
string |
Timestamp della creazione della risorsa (UTC). |
createdBy |
string |
Identità che ha creato la risorsa. |
createdByType |
Tipo di identità che ha creato la risorsa. |
|
lastModifiedAt |
string |
Timestamp dell'ultima modifica della risorsa (UTC) |
lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |
Tax
Importo dell'imposta applicato alla transazione.
Nome | Tipo | Descrizione |
---|---|---|
currency |
string |
Valuta per il valore dell'importo. |
value |
number |
Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00. |
Transaction
Transazione.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Nome della risorsa |
properties |
Transazione. |
|
systemData |
Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy. |
|
tags |
object |
Dizionario dei metadati associati alla risorsa. Potrebbe non essere popolato per tutti i tipi di risorse. Lunghezza massima chiave/valore supportata di 256 caratteri. Chiavi/valore non deve essere vuoto né null. Le chiavi non possono contenere <> % & \ ? / |
type |
string |
Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
TransactionAmount
Addebito associato alla transazione.
Nome | Tipo | Descrizione |
---|---|---|
currency |
string |
Valuta per il valore dell'importo. |
value |
number |
Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00. |
TransactionKind
Tipo di transazione, fatturata o non fatturata.
Nome | Tipo | Descrizione |
---|---|---|
All |
string |
|
Other |
string |
|
Reservation |
string |
TransactionListResult
Contenitore per un elenco di risorse
Nome | Tipo | Descrizione |
---|---|---|
nextLink |
string |
Collegamento (URL) alla pagina successiva dei risultati. |
value |
Elenco di risorse. |
TransactionProperties
Transazione.
Nome | Tipo | Descrizione |
---|---|---|
azureCreditApplied |
Quantità di crediti Azure applicati automaticamente a questa transazione. |
|
azurePlan |
string |
Dettagli del piano di Azure. |
billingCurrency |
string |
Codice ISO 4217 per la valuta in cui viene fatturata la transazione. |
billingProfileDisplayName |
Nome del profilo di fatturazione. |
|
billingProfileId |
string |
ID completo che identifica in modo univoco un profilo di fatturazione. |
consumptionCommitmentDecremented |
La quantità di impegno per il consumo di Microsoft Azure (MACC) viene decrementato tramite la transazione. |
|
creditType |
Tipo di credito della transazione. Si applica solo alle transazioni accreditate. |
|
customerDisplayName |
string |
Nome del cliente. |
customerId |
string |
ID completo che identifica in modo univoco un cliente. |
date |
string |
Data della transazione. |
discount |
number |
Sconto percentuale, se presente, applicato a questa transazione. |
effectivePrice |
Il prezzo del prodotto dopo aver applicato eventuali sconti. |
|
exchangeRate |
number |
Tasso di cambio utilizzato per convertire l'importo addebitato nella valuta di fatturazione, se applicabile. |
invoice |
string |
Nome fattura per cui la transazione è stata fatturata o "In sospeso" se la transazione non viene fatturata. |
invoiceId |
string |
ID completo della fattura in cui è stata fatturata la transazione. Questo campo è applicabile solo per le transazioni fatturate. |
invoiceSectionDisplayName |
string |
Nome della sezione della fattura. |
invoiceSectionId |
string |
ID completo che identifica in modo univoco una sezione della fattura. |
isThirdParty |
boolean |
Indica se la transazione è di terze parti. |
kind |
Tipo di transazione, fatturata o non fatturata. |
|
marketPrice |
Prezzo al dettaglio del prodotto. |
|
partNumber |
string |
Numero di parte del prodotto per il quale è stata eseguita la transazione. Il campo è applicabile solo per le fatture con Contratto Enterprise. |
pricingCurrency |
string |
Codice ISO 4217 per la valuta in cui viene prezzo il prodotto. |
productDescription |
string |
Descrizione del prodotto per il quale è stata eseguita la transazione. |
productFamily |
string |
Famiglia del prodotto per cui è stata eseguita la transazione. |
productType |
string |
Tipo di prodotto per il quale è stata eseguita la transazione. |
productTypeId |
string |
ID del tipo di prodotto per il quale è stata eseguita la transazione. |
quantity |
integer |
Quantità acquistata nella transazione. |
reasonCode |
string |
Codice motivo per la transazione. |
refundTransactionDetails |
Dettagli del rimborso di una transazione. |
|
servicePeriodEndDate |
string |
Data di fine del termine del prodotto o data di fine del mese in cui è terminato l'utilizzo. |
servicePeriodStartDate |
string |
Data dell'acquisto del prodotto o data di inizio del mese in cui è iniziato l'utilizzo. |
specialTaxationType |
Identifica il tipo di calcolo delle imposte utilizzato per la fattura. Il campo è applicabile solo alle fatture con logica di calcolo fiscale speciale. |
|
subTotal |
Importo addebitato in base all'imposta precedente per la transazione. |
|
tax |
Importo dell'imposta applicato alla transazione. |
|
transactionAmount |
Addebito associato alla transazione. |
|
transactionType |
string |
Tipo di transazione. |
unitOfMeasure |
string |
Unità di misura usata per fatturare il prodotto. Ad esempio, i servizi di calcolo vengono fatturati all'ora. |
unitType |
string |
Descrizione dell'unità di misura per un determinato prodotto. |
units |
number |
Numero di unità utilizzate per un determinato prodotto. |