Condividi tramite


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
billingAccountName
path True

string

ID che identifica in modo univoco un account di fatturazione.

Criterio di espressione regolare: ^([0-9]+|([Pp][Cc][Nn]\.[A-Za-z0-9]+)|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$

invoiceName
path True

string

ID che identifica in modo univoco una fattura.

Criterio di espressione regolare: ^(H[0-9]-[A-Z0-9]+)$|^(?:([GHT]|HT){1}[A-Z0-9]{9})$|^(?:[D]{1}[A-Z0-9]{9})$|^(?:E{1}[B-Z0-9]{1}[A-Z0-9]{8})$|^(?:EA[A-Z0-9]{8})$

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.

orderBy
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

TransactionListResult

Elenco di transazioni.

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

TransactionsListByInvoice

Esempio di richiesta

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/G123456789/transactions?api-version=2024-04-01

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
AmountRefunded

Importo rimborsato.

AmountRequested

Importo del rimborso richiesto.

AzureCreditApplied

Quantità di crediti Azure applicati automaticamente a questa transazione.

ConsumptionCommitmentDecremented

La quantità di impegno per il consumo di Microsoft Azure (MACC) viene decrementato tramite la transazione.

createdByType

Tipo di identità che ha creato la risorsa.

CreditType

Tipo di credito della transazione. Si applica solo alle transazioni accreditate.

EffectivePrice

Il prezzo del prodotto dopo aver applicato eventuali sconti.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

MarketPrice

Prezzo al dettaglio del prodotto.

RefundTransactionDetails

Dettagli del rimborso di una transazione.

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.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Tax

Importo dell'imposta applicato alla transazione.

Transaction

Transazione.

TransactionAmount

Addebito associato alla transazione.

TransactionKind

Tipo di transazione, fatturata o non fatturata.

TransactionListResult

Contenitore per un elenco di risorse

TransactionProperties

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

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

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

AmountRefunded

Importo rimborsato.

amountRequested

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

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

createdByType

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

TransactionProperties

Transazione.

systemData

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

Transaction[]

Elenco di risorse.

TransactionProperties

Transazione.

Nome Tipo Descrizione
azureCreditApplied

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

ConsumptionCommitmentDecremented

La quantità di impegno per il consumo di Microsoft Azure (MACC) viene decrementato tramite la transazione.

creditType

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

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

TransactionKind

Tipo di transazione, fatturata o non fatturata.

marketPrice

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

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

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

SubTotal

Importo addebitato in base all'imposta precedente per la transazione.

tax

Tax

Importo dell'imposta applicato alla transazione.

transactionAmount

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.