Sdílet prostřednictvím


Transactions - List By Invoice

Zobrazí seznam transakcí pro fakturu. Transakce zahrnují nákupy, refundace a poplatky za využití 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}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
billingAccountName
path True

string

ID, které jednoznačně identifikuje fakturační účet.

Vzor regulárního výrazu: ^([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, které jednoznačně identifikuje fakturu.

Vzor regulárního výrazu: ^(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

Verze rozhraní API, která se má použít s požadavkem klienta. Aktuální verze je 2024-04-01.

count
query

boolean

Možnost dotazování počtu umožňuje klientům požadovat počet odpovídajících prostředků, které jsou součástí prostředků v odpovědi.

filter
query

string

Možnost dotazu filtru umožňuje klientům filtrovat kolekci prostředků adresovaných adresou URL požadavku.

orderBy
query

string

Možnost dotazu orderby umožňuje klientům požadovat prostředky v určitém pořadí.

search
query

string

Možnost vyhledávacího dotazu umožňuje klientům požadovat položky v kolekci odpovídající výrazu pro vyhledávání volného textu. Vyhledávání je podporováno pouze pro pole řetězců.

skip
query

integer

int64

Možnost přeskočit dotaz vyžaduje počet položek v dotazované kolekci, které se mají přeskočit a nejsou zahrnuty do výsledku.

top
query

integer

int64

Horní možnost dotazu požaduje, aby se do výsledku zahrnul počet položek v dotazované kolekci. Maximální podporovaná hodnota pro top je 50.

Odpovědi

Name Typ Description
200 OK

TransactionListResult

Seznam transakcí.

Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Příklady

TransactionsListByInvoice

Ukázkový požadavek

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

Ukázková odpověď

{
  "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"
    }
  ]
}

Definice

Name Description
AmountRefunded

Částka byla vrácena.

AmountRequested

Požadovaná částka refundace.

AzureCreditApplied

Množství kreditů Azure automaticky uplatněných na tuto transakci.

ConsumptionCommitmentDecremented

Objem závazku služby Microsoft Azure Consumption (MACC) se dekrementuje prostřednictvím transakce.

createdByType

Typ identity, která prostředek vytvořila.

CreditType

Typ kreditu transakce. Platí pouze pro kreditované transakce.

EffectivePrice

Cena produktu po uplatnění jakýchkoli slev.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

MarketPrice

Maloobchodní cena produktu.

RefundTransactionDetails

Podrobnosti o refundaci transakce.

SpecialTaxationType

Určuje typ výpočtu daně použitého pro fakturu. Pole se vztahuje pouze na faktury se speciální logikou výpočtu daně.

SubTotal

Částka účtovaná před zdaněním za transakci.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Tax

Částka daně uplatněná na transakci.

Transaction

Transakce.

TransactionAmount

Poplatek přidružený k transakci.

TransactionKind

Typ transakce, fakturované nebo nefakturované.

TransactionListResult

Kontejner pro seznam prostředků

TransactionProperties

Transakce.

AmountRefunded

Částka byla vrácena.

Name Typ Description
currency

string

Měna pro hodnotu částky.

value

number

Hodnota částky. Pokud je například měna USD, pak by hodnota 600 USD byla 600,00 USD.

AmountRequested

Požadovaná částka refundace.

Name Typ Description
currency

string

Měna pro hodnotu částky.

value

number

Hodnota částky. Pokud je například měna USD, pak by hodnota 600 USD byla 600,00 USD.

AzureCreditApplied

Množství kreditů Azure automaticky uplatněných na tuto transakci.

Name Typ Description
currency

string

Měna pro hodnotu částky.

value

number

Hodnota částky. Pokud je například měna USD, pak by hodnota 600 USD byla 600,00 USD.

ConsumptionCommitmentDecremented

Objem závazku služby Microsoft Azure Consumption (MACC) se dekrementuje prostřednictvím transakce.

Name Typ Description
currency

string

Měna pro hodnotu částky.

value

number

Hodnota částky. Pokud je například měna USD, pak by hodnota 600 USD byla 600,00 USD.

createdByType

Typ identity, která prostředek vytvořila.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

CreditType

Typ kreditu transakce. Platí pouze pro kreditované transakce.

Name Typ Description
AzureCreditOffer

string

AzureFreeCredit

string

Other

string

Refund

string

ServiceInterruption

string

EffectivePrice

Cena produktu po uplatnění jakýchkoli slev.

Name Typ Description
currency

string

Měna pro hodnotu částky.

value

number

Hodnota částky. Pokud je například měna USD, pak by hodnota 600 USD byla 600,00 USD.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby.

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva.

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

MarketPrice

Maloobchodní cena produktu.

Name Typ Description
currency

string

Měna pro hodnotu částky.

value

number

Hodnota částky. Pokud je například měna USD, pak by hodnota 600 USD byla 600,00 USD.

RefundTransactionDetails

Podrobnosti o refundaci transakce.

Name Typ Description
amountRefunded

AmountRefunded

Částka byla vrácena.

amountRequested

AmountRequested

Požadovaná částka refundace.

refundOperationId

string

ID operace refundace.

SpecialTaxationType

Určuje typ výpočtu daně použitého pro fakturu. Pole se vztahuje pouze na faktury se speciální logikou výpočtu daně.

Name Typ Description
InvoiceLevel

string

SubtotalLevel

string

SubTotal

Částka účtovaná před zdaněním za transakci.

Name Typ Description
currency

string

Měna pro hodnotu částky.

value

number

Hodnota částky. Pokud je například měna USD, pak by hodnota 600 USD byla 600,00 USD.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string

Časové razítko vytvoření prostředku (UTC).

createdBy

string

Identita, která prostředek vytvořila.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string

Časové razítko poslední změny zdroje (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.

Tax

Částka daně uplatněná na transakci.

Name Typ Description
currency

string

Měna pro hodnotu částky.

value

number

Hodnota částky. Pokud je například měna USD, pak by hodnota 600 USD byla 600,00 USD.

Transaction

Transakce.

Name Typ Description
id

string

Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Název prostředku

properties

TransactionProperties

Transakce.

systemData

systemData

Metadata Azure Resource Manageru obsahující informace createdBy a modifiedBy

tags

object

Slovník metadat přidružených k prostředku Nemusí být vyplněna pro všechny typy prostředků. Maximální podporovaná délka klíče a hodnoty 256 znaků. Klíče nebo hodnota by neměly být prázdné ani null. Klíče nemohou obsahovat <> % & \ ? /

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

TransactionAmount

Poplatek přidružený k transakci.

Name Typ Description
currency

string

Měna pro hodnotu částky.

value

number

Hodnota částky. Pokud je například měna USD, pak by hodnota 600 USD byla 600,00 USD.

TransactionKind

Typ transakce, fakturované nebo nefakturované.

Name Typ Description
All

string

Other

string

Reservation

string

TransactionListResult

Kontejner pro seznam prostředků

Name Typ Description
nextLink

string

Odkaz (url) na další stránku výsledků.

value

Transaction[]

Seznam prostředků.

TransactionProperties

Transakce.

Name Typ Description
azureCreditApplied

AzureCreditApplied

Množství kreditů Azure automaticky uplatněných na tuto transakci.

azurePlan

string

Podrobnosti o plánu Azure

billingCurrency

string

Kód ISO 4217 pro měnu, ve které se tato transakce účtuje.

billingProfileDisplayName

Název fakturačního profilu.

billingProfileId

string

Plně kvalifikované ID, které jednoznačně identifikuje fakturační profil.

consumptionCommitmentDecremented

ConsumptionCommitmentDecremented

Objem závazku služby Microsoft Azure Consumption (MACC) se dekrementuje prostřednictvím transakce.

creditType

CreditType

Typ kreditu transakce. Platí pouze pro kreditované transakce.

customerDisplayName

string

Jméno zákazníka.

customerId

string

Plně kvalifikované ID, které jednoznačně identifikuje zákazníka.

date

string

Datum transakce.

discount

number

Procentuální sleva, pokud existuje, uplatněna na tuto transakci.

effectivePrice

EffectivePrice

Cena produktu po uplatnění jakýchkoli slev.

exchangeRate

number

Směnný kurz použitý k převodu účtované částky na fakturační měnu, pokud je to možné.

invoice

string

Název faktury, na který se transakce fakturovala, nebo Čeká na vyřízení, pokud se transakce nefakturuje.

invoiceId

string

Plně kvalifikované ID faktury, na které se transakce fakturovala. Toto pole platí pouze pro transakce, které se účtují.

invoiceSectionDisplayName

string

Název oddílu faktury.

invoiceSectionId

string

Plně kvalifikované ID, které jednoznačně identifikuje oddíl faktury.

isThirdParty

boolean

Zda transakce je třetí stranou.

kind

TransactionKind

Typ transakce, fakturované nebo nefakturované.

marketPrice

MarketPrice

Maloobchodní cena produktu.

partNumber

string

Číslo dílu produktu, pro který se transakce uskutečnila. Pole se vztahuje pouze na faktury za smlouvu Enterprise.

pricingCurrency

string

Kód ISO 4217 pro měnu, ve které je produkt cenován.

productDescription

string

Popis produktu, pro který se transakce uskutečnila.

productFamily

string

Rodina produktu, pro který se transakce uskutečnila.

productType

string

Typ produktu, pro který se transakce uskutečnila.

productTypeId

string

ID typu produktu, pro který se transakce uskutečnila.

quantity

integer

Množství zakoupené v transakci.

reasonCode

string

Existuje důvod kód transakce.

refundTransactionDetails

RefundTransactionDetails

Podrobnosti o refundaci transakce.

servicePeriodEndDate

string

Koncové datum období produktu nebo koncové datum měsíce, ve kterém bylo využití ukončeno.

servicePeriodStartDate

string

Datum nákupu produktu nebo počáteční datum měsíce, ve kterém bylo využití zahájeno.

specialTaxationType

SpecialTaxationType

Určuje typ výpočtu daně použitého pro fakturu. Pole se vztahuje pouze na faktury se speciální logikou výpočtu daně.

subTotal

SubTotal

Částka účtovaná před zdaněním za transakci.

tax

Tax

Částka daně uplatněná na transakci.

transactionAmount

TransactionAmount

Poplatek přidružený k transakci.

transactionType

string

Typ transakce.

unitOfMeasure

string

Měrná jednotka použitá k vyúčtování produktu. Například výpočetní služby se účtují za hodinu.

unitType

string

Popis měrné jednotky pro daný produkt.

units

number

Počet jednotek použitých pro daný produkt.