Delen via


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

string

De id waarmee een factureringsrekening uniek wordt geïdentificeerd.

Regex-patroon: ^([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

De id waarmee een factuur uniek wordt geïdentificeerd.

Regex-patroon: ^(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

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.

orderBy
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

TransactionListResult

De lijst met transacties.

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Voorbeelden

TransactionsListByInvoice

Voorbeeldaanvraag

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

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
AmountRefunded

Het bedrag is terugbetaald.

AmountRequested

Het aangevraagde restitutiebedrag.

AzureCreditApplied

Het bedrag van eventuele Azure-tegoed dat automatisch op deze transactie wordt toegepast.

ConsumptionCommitmentDecremented

Het bedrag van de Microsoft Azure Consumption Commitment (MACC) door de transactie wordt afgebroken.

createdByType

Het type identiteit waarmee de resource is gemaakt.

CreditType

Het krediettype van de transactie. Alleen van toepassing op gecrediteerde transacties.

EffectivePrice

De prijs van het product na het toepassen van kortingen.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

MarketPrice

De verkoopprijs van het product.

RefundTransactionDetails

De restitutiegegevens van een transactie.

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.

systemData

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.

TransactionAmount

De kosten die aan de transactie zijn gekoppeld.

TransactionKind

Type transactie, gefactureerd of niet-gefactureerd.

TransactionListResult

Een container voor een lijst met resources

TransactionProperties

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

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

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

AmountRefunded

Het bedrag is terugbetaald.

amountRequested

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

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

createdByType

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

TransactionProperties

Een transactie.

systemData

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

Transaction[]

De lijst met resources.

TransactionProperties

Een transactie.

Name Type Description
azureCreditApplied

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

ConsumptionCommitmentDecremented

Het bedrag van de Microsoft Azure Consumption Commitment (MACC) door de transactie wordt afgebroken.

creditType

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

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

TransactionKind

Type transactie, gefactureerd of niet-gefactureerd.

marketPrice

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

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

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

SubTotal

Het vooraf belaste bedrag voor de transactie.

tax

Tax

Het belastingbedrag dat op de transactie is toegepast.

transactionAmount

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.