Transactions - List By Invoice
Toont de transacties voor een factuur. Transacties omvatten aankopen, restituties en Azure-gebruikskosten.
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}
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
billing
|
path | True |
string |
De id waarmee een factureringsrekening uniek wordt geïdentificeerd. Regex-patroon: |
invoice
|
path | True |
string |
De id waarmee een factuur uniek wordt geïdentificeerd. Regex-patroon: |
api-version
|
query | True |
string |
De versie van de API die moet worden gebruikt met de clientaanvraag. De huidige versie is 2024-04-01. |
count
|
query |
boolean |
Met de optie aantalquery's kunnen clients een telling aanvragen van de overeenkomende resources die bij de resources in het antwoord zijn opgenomen. |
|
filter
|
query |
string |
Met de filterqueryoptie kunnen clients een verzameling resources filteren die worden geadresseerd door een aanvraag-URL. |
|
order
|
query |
string |
Met de queryoptie orderby kunnen clients resources in een bepaalde volgorde aanvragen. |
|
search
|
query |
string |
Met de zoekqueryoptie kunnen clients items binnen een verzameling aanvragen die overeenkomen met een zoekexpressie in vrije tekst. zoeken wordt alleen ondersteund voor tekenreeksvelden. |
|
skip
|
query |
integer int64 |
De optie voor het overslaan van query's vraagt het aantal items in de opgevraagde verzameling op die moeten worden overgeslagen en niet in het resultaat worden opgenomen. |
|
top
|
query |
integer int64 |
De bovenste queryoptie vraagt het aantal items in de opgevraagde verzameling op om in het resultaat te worden opgenomen. De maximaal ondersteunde waarde voor top is 50. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
De lijst met transacties. |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Voorbeelden
TransactionsListByInvoice
Voorbeeldaanvraag
Voorbeeldrespons
{
"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"
}
]
}
Definities
Name | Description |
---|---|
Amount |
Het bedrag is terugbetaald. |
Amount |
Het aangevraagde restitutiebedrag. |
Azure |
Het bedrag van eventuele Azure-tegoed dat automatisch op deze transactie wordt toegepast. |
Consumption |
Het bedrag van de Microsoft Azure Consumption Commitment (MACC) door de transactie wordt afgebroken. |
created |
Het type identiteit waarmee de resource is gemaakt. |
Credit |
Het krediettype van de transactie. Alleen van toepassing op gecrediteerde transacties. |
Effective |
De prijs van het product na het toepassen van kortingen. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
De foutdetails. |
Error |
Foutreactie |
Market |
De verkoopprijs van het product. |
Refund |
De restitutiegegevens van een transactie. |
Special |
Hiermee geeft u het type belastingberekening aan dat voor de factuur wordt gebruikt. Het veld is alleen van toepassing op facturen met speciale belastingberekeningslogica. |
Sub |
Het vooraf belaste bedrag voor de transactie. |
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
Tax |
Het belastingbedrag dat op de transactie is toegepast. |
Transaction |
Een transactie. |
Transaction |
De kosten die aan de transactie zijn gekoppeld. |
Transaction |
Type transactie, gefactureerd of niet-gefactureerd. |
Transaction |
Een container voor een lijst met resources |
Transaction |
Een transactie. |
AmountRefunded
Het bedrag is terugbetaald.
Name | Type | Description |
---|---|---|
currency |
string |
De valuta voor de waarde van het bedrag. |
value |
number |
De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00. |
AmountRequested
Het aangevraagde restitutiebedrag.
Name | Type | Description |
---|---|---|
currency |
string |
De valuta voor de waarde van het bedrag. |
value |
number |
De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00. |
AzureCreditApplied
Het bedrag van eventuele Azure-tegoed dat automatisch op deze transactie wordt toegepast.
Name | Type | Description |
---|---|---|
currency |
string |
De valuta voor de waarde van het bedrag. |
value |
number |
De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00. |
ConsumptionCommitmentDecremented
Het bedrag van de Microsoft Azure Consumption Commitment (MACC) door de transactie wordt afgebroken.
Name | Type | Description |
---|---|---|
currency |
string |
De valuta voor de waarde van het bedrag. |
value |
number |
De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00. |
createdByType
Het type identiteit waarmee de resource is gemaakt.
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CreditType
Het krediettype van de transactie. Alleen van toepassing op gecrediteerde transacties.
Name | Type | Description |
---|---|---|
AzureCreditOffer |
string |
|
AzureFreeCredit |
string |
|
Other |
string |
|
Refund |
string |
|
ServiceInterruption |
string |
EffectivePrice
De prijs van het product na het toepassen van kortingen.
Name | Type | Description |
---|---|---|
currency |
string |
De valuta voor de waarde van het bedrag. |
value |
number |
De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00. |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
Name | Type | Description |
---|---|---|
info |
object |
De aanvullende informatie. |
type |
string |
Het extra informatietype. |
ErrorDetail
De foutdetails.
Name | Type | Description |
---|---|---|
additionalInfo |
De fout bevat aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
error |
Het foutobject. |
MarketPrice
De verkoopprijs van het product.
Name | Type | Description |
---|---|---|
currency |
string |
De valuta voor de waarde van het bedrag. |
value |
number |
De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00. |
RefundTransactionDetails
De restitutiegegevens van een transactie.
Name | Type | Description |
---|---|---|
amountRefunded |
Het bedrag is terugbetaald. |
|
amountRequested |
Het aangevraagde restitutiebedrag. |
|
refundOperationId |
string |
De id van de restitutiebewerking. |
SpecialTaxationType
Hiermee geeft u het type belastingberekening aan dat voor de factuur wordt gebruikt. Het veld is alleen van toepassing op facturen met speciale belastingberekeningslogica.
Name | Type | Description |
---|---|---|
InvoiceLevel |
string |
|
SubtotalLevel |
string |
SubTotal
Het vooraf belaste bedrag voor de transactie.
Name | Type | Description |
---|---|---|
currency |
string |
De valuta voor de waarde van het bedrag. |
value |
number |
De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00. |
systemData
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
Name | Type | Description |
---|---|---|
createdAt |
string |
De tijdstempel van het maken van resources (UTC). |
createdBy |
string |
De identiteit waarmee de resource is gemaakt. |
createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
lastModifiedAt |
string |
De tijdstempel van de laatste wijziging van de resource (UTC) |
lastModifiedBy |
string |
De identiteit die de resource voor het laatst heeft gewijzigd. |
lastModifiedByType |
Het type identiteit dat de resource voor het laatst heeft gewijzigd. |
Tax
Het belastingbedrag dat op de transactie is toegepast.
Name | Type | Description |
---|---|---|
currency |
string |
De valuta voor de waarde van het bedrag. |
value |
number |
De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00. |
Transaction
Een transactie.
Name | Type | Description |
---|---|---|
id |
string |
Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}" |
name |
string |
De naam van de resource |
properties |
Een transactie. |
|
systemData |
Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens. |
|
tags |
object |
Woordenlijst met metagegevens die zijn gekoppeld aan de resource. Deze kan niet worden ingevuld voor alle resourcetypen. Maximale lengte van sleutel/waarde die wordt ondersteund door 256 tekens. Sleutels/waarde mogen geen lege waarde of null zijn. Sleutels kunnen geen <> % & \ bevatten? / |
type |
string |
Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts' |
TransactionAmount
De kosten die aan de transactie zijn gekoppeld.
Name | Type | Description |
---|---|---|
currency |
string |
De valuta voor de waarde van het bedrag. |
value |
number |
De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00. |
TransactionKind
Type transactie, gefactureerd of niet-gefactureerd.
Name | Type | Description |
---|---|---|
All |
string |
|
Other |
string |
|
Reservation |
string |
TransactionListResult
Een container voor een lijst met resources
Name | Type | Description |
---|---|---|
nextLink |
string |
De koppeling (URL) naar de volgende pagina met resultaten. |
value |
De lijst met resources. |
TransactionProperties
Een transactie.
Name | Type | Description |
---|---|---|
azureCreditApplied |
Het bedrag van eventuele Azure-tegoed dat automatisch op deze transactie wordt toegepast. |
|
azurePlan |
string |
Details van het Azure-plan. |
billingCurrency |
string |
De ISO 4217-code voor de valuta waarin deze transactie wordt gefactureerd. |
billingProfileDisplayName |
De naam van het factureringsprofiel. |
|
billingProfileId |
string |
De volledig gekwalificeerde id waarmee een factureringsprofiel uniek wordt geïdentificeerd. |
consumptionCommitmentDecremented |
Het bedrag van de Microsoft Azure Consumption Commitment (MACC) door de transactie wordt afgebroken. |
|
creditType |
Het krediettype van de transactie. Alleen van toepassing op gecrediteerde transacties. |
|
customerDisplayName |
string |
De naam van de klant. |
customerId |
string |
De volledig gekwalificeerde id waarmee een klant uniek wordt geïdentificeerd. |
date |
string |
De datum van de transactie. |
discount |
number |
De percentagekorting, indien van toepassing, op deze transactie. |
effectivePrice |
De prijs van het product na het toepassen van kortingen. |
|
exchangeRate |
number |
De wisselkoers die wordt gebruikt om het bedrag te converteren naar factureringsvaluta, indien van toepassing. |
invoice |
string |
Factuurnaam waarop de transactie is gefactureerd of 'In behandeling' als de transactie niet wordt gefactureerd. |
invoiceId |
string |
De volledig gekwalificeerde id van de factuur waarop de transactie is gefactureerd. Dit veld is alleen van toepassing op transacties die worden gefactureerd. |
invoiceSectionDisplayName |
string |
De naam van de factuursectie. |
invoiceSectionId |
string |
De volledig gekwalificeerde id waarmee een factuursectie uniek wordt geïdentificeerd. |
isThirdParty |
boolean |
Of de transactie al dan niet een derde partij is. |
kind |
Type transactie, gefactureerd of niet-gefactureerd. |
|
marketPrice |
De verkoopprijs van het product. |
|
partNumber |
string |
Het onderdeelnummer van het product waarvoor de transactie heeft plaatsgevonden. Het veld is alleen van toepassing op Enterprise Agreement-facturen. |
pricingCurrency |
string |
De ISO 4217-code voor de valuta waarin het product wordt geprijsd. |
productDescription |
string |
De beschrijving van het product waarvoor de transactie plaatsvond. |
productFamily |
string |
De familie van het product waarvoor de transactie plaatsvond. |
productType |
string |
Het type product waarvoor de transactie heeft plaatsgevonden. |
productTypeId |
string |
De id van het producttype waarvoor de transactie heeft plaatsgevonden. |
quantity |
integer |
De hoeveelheid die in de transactie is gekocht. |
reasonCode |
string |
Er is redencode voor de transactie. |
refundTransactionDetails |
De restitutiegegevens van een transactie. |
|
servicePeriodEndDate |
string |
De einddatum van de productterm of de einddatum van de maand waarin het gebruik is beëindigd. |
servicePeriodStartDate |
string |
De datum van de aankoop van het product of de begindatum van de maand waarin het gebruik is gestart. |
specialTaxationType |
Hiermee geeft u het type belastingberekening aan dat voor de factuur wordt gebruikt. Het veld is alleen van toepassing op facturen met speciale belastingberekeningslogica. |
|
subTotal |
Het vooraf belaste bedrag voor de transactie. |
|
tax |
Het belastingbedrag dat op de transactie is toegepast. |
|
transactionAmount |
De kosten die aan de transactie zijn gekoppeld. |
|
transactionType |
string |
Het type transactie. |
unitOfMeasure |
string |
De maateenheid die wordt gebruikt voor het factureren van het product. Rekenservices worden bijvoorbeeld per uur gefactureerd. |
unitType |
string |
De beschrijving van de maateenheid voor een bepaald product. |
units |
number |
Het aantal eenheden dat voor een bepaald product wordt gebruikt. |