Udostępnij za pośrednictwem


Transactions - List By Invoice

Wyświetla listę transakcji dla faktury. Transakcje obejmują zakupy, zwroty kosztów i opłaty za użycie platformy 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 identyfikatora URI

Nazwa W Wymagane Typ Opis
billingAccountName
path True

string

Identyfikator, który jednoznacznie identyfikuje konto rozliczeniowe.

Wzorzec wyrażenia regularnego: ^([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

Identyfikator, który jednoznacznie identyfikuje fakturę.

Wzorzec wyrażenia regularnego: ^(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

Wersja interfejsu API, która ma być używana z żądaniem klienta. Bieżąca wersja to 2024-04-01.

count
query

boolean

Opcja liczby zapytań umożliwia klientom zażądanie liczby pasujących zasobów uwzględnionych w zasobach w odpowiedzi.

filter
query

string

Opcja zapytania filtru umożliwia klientom filtrowanie kolekcji zasobów, które są adresowane przez adres URL żądania.

orderBy
query

string

Opcja zapytania orderby umożliwia klientom żądanie zasobów w określonej kolejności.

search
query

string

Opcja kwerendy wyszukiwania umożliwia klientom żądanie elementów w kolekcji zgodnej z wyrażeniem wyszukiwania w tekście. wyszukiwanie jest obsługiwane tylko w przypadku pól ciągów.

skip
query

integer

int64

Opcja pomiń zapytanie żąda liczby elementów w kolekcji zapytań, które mają zostać pominięte i nie zostaną uwzględnione w wyniku.

top
query

integer

int64

Opcja zapytania najwyższego poziomu żąda liczby elementów w kolekcji zapytań, które mają zostać uwzględnione w wyniku. Maksymalna obsługiwana wartość dla góry to 50.

Odpowiedzi

Nazwa Typ Opis
200 OK

TransactionListResult

Lista transakcji.

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Przykłady

TransactionsListByInvoice

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
AmountRefunded

Zwrócona kwota.

AmountRequested

Żądana kwota zwrotu pieniędzy.

AzureCreditApplied

Kwota środków na korzystanie z platformy Azure automatycznie zastosowana do tej transakcji.

ConsumptionCommitmentDecremented

Kwota dekrementacji zobowiązania użycia platformy Microsoft Azure (MACC) za pośrednictwem transakcji.

createdByType

Typ tożsamości, która utworzyła zasób.

CreditType

Typ środków transakcji. Dotyczy tylko transakcji kredytowych.

EffectivePrice

Cena produktu po zastosowaniu wszelkich rabatów.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

MarketPrice

Cena detaliczna produktu.

RefundTransactionDetails

Szczegóły zwrotu transakcji.

SpecialTaxationType

Określa typ obliczenia podatkowego używanego dla faktury. Pole ma zastosowanie tylko do faktur z specjalną logiką obliczania podatku.

SubTotal

Kwota naliczona przed opodatkowaniem za transakcję.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Tax

Kwota podatku zastosowana do transakcji.

Transaction

Transakcja.

TransactionAmount

Opłata skojarzona z transakcją.

TransactionKind

Typ transakcji, rozliczone lub niezaliczone.

TransactionListResult

Kontener dla listy zasobów

TransactionProperties

Transakcja.

AmountRefunded

Zwrócona kwota.

Nazwa Typ Opis
currency

string

Waluta dla wartości kwoty.

value

number

Wartość kwoty. Jeśli na przykład waluta to USD, wartość 600 USD będzie wynosić 600,00 USD.

AmountRequested

Żądana kwota zwrotu pieniędzy.

Nazwa Typ Opis
currency

string

Waluta dla wartości kwoty.

value

number

Wartość kwoty. Jeśli na przykład waluta to USD, wartość 600 USD będzie wynosić 600,00 USD.

AzureCreditApplied

Kwota środków na korzystanie z platformy Azure automatycznie zastosowana do tej transakcji.

Nazwa Typ Opis
currency

string

Waluta dla wartości kwoty.

value

number

Wartość kwoty. Jeśli na przykład waluta to USD, wartość 600 USD będzie wynosić 600,00 USD.

ConsumptionCommitmentDecremented

Kwota dekrementacji zobowiązania użycia platformy Microsoft Azure (MACC) za pośrednictwem transakcji.

Nazwa Typ Opis
currency

string

Waluta dla wartości kwoty.

value

number

Wartość kwoty. Jeśli na przykład waluta to USD, wartość 600 USD będzie wynosić 600,00 USD.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

CreditType

Typ środków transakcji. Dotyczy tylko transakcji kredytowych.

Nazwa Typ Opis
AzureCreditOffer

string

AzureFreeCredit

string

Other

string

Refund

string

ServiceInterruption

string

EffectivePrice

Cena produktu po zastosowaniu wszelkich rabatów.

Nazwa Typ Opis
currency

string

Waluta dla wartości kwoty.

value

number

Wartość kwoty. Jeśli na przykład waluta to USD, wartość 600 USD będzie wynosić 600,00 USD.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

MarketPrice

Cena detaliczna produktu.

Nazwa Typ Opis
currency

string

Waluta dla wartości kwoty.

value

number

Wartość kwoty. Jeśli na przykład waluta to USD, wartość 600 USD będzie wynosić 600,00 USD.

RefundTransactionDetails

Szczegóły zwrotu transakcji.

Nazwa Typ Opis
amountRefunded

AmountRefunded

Zwrócona kwota.

amountRequested

AmountRequested

Żądana kwota zwrotu pieniędzy.

refundOperationId

string

Identyfikator operacji zwrotu.

SpecialTaxationType

Określa typ obliczenia podatkowego używanego dla faktury. Pole ma zastosowanie tylko do faktur z specjalną logiką obliczania podatku.

Nazwa Typ Opis
InvoiceLevel

string

SubtotalLevel

string

SubTotal

Kwota naliczona przed opodatkowaniem za transakcję.

Nazwa Typ Opis
currency

string

Waluta dla wartości kwoty.

value

number

Wartość kwoty. Jeśli na przykład waluta to USD, wartość 600 USD będzie wynosić 600,00 USD.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string

Znacznik czasu ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.

Tax

Kwota podatku zastosowana do transakcji.

Nazwa Typ Opis
currency

string

Waluta dla wartości kwoty.

value

number

Wartość kwoty. Jeśli na przykład waluta to USD, wartość 600 USD będzie wynosić 600,00 USD.

Transaction

Transakcja.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nazwa zasobu

properties

TransactionProperties

Transakcja.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

tags

object

Słownik metadanych skojarzonych z zasobem. Nie można go wypełnić dla wszystkich typów zasobów. Maksymalna długość klucza/wartości obsługiwana przez 256 znaków. Klucze/wartość nie powinny być puste ani mieć wartości null. Klucze nie mogą zawierać <> % & \ ? /

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

TransactionAmount

Opłata skojarzona z transakcją.

Nazwa Typ Opis
currency

string

Waluta dla wartości kwoty.

value

number

Wartość kwoty. Jeśli na przykład waluta to USD, wartość 600 USD będzie wynosić 600,00 USD.

TransactionKind

Typ transakcji, rozliczone lub niezaliczone.

Nazwa Typ Opis
All

string

Other

string

Reservation

string

TransactionListResult

Kontener dla listy zasobów

Nazwa Typ Opis
nextLink

string

Link (adres URL) do następnej strony wyników.

value

Transaction[]

Lista zasobów.

TransactionProperties

Transakcja.

Nazwa Typ Opis
azureCreditApplied

AzureCreditApplied

Kwota środków na korzystanie z platformy Azure automatycznie zastosowana do tej transakcji.

azurePlan

string

Szczegóły planu platformy Azure.

billingCurrency

string

Kod ISO 4217 dla waluty, w której ta transakcja jest rozliczana.

billingProfileDisplayName

Nazwa profilu rozliczeniowego.

billingProfileId

string

W pełni kwalifikowany identyfikator, który jednoznacznie identyfikuje profil rozliczeniowy.

consumptionCommitmentDecremented

ConsumptionCommitmentDecremented

Kwota dekrementacji zobowiązania użycia platformy Microsoft Azure (MACC) za pośrednictwem transakcji.

creditType

CreditType

Typ środków transakcji. Dotyczy tylko transakcji kredytowych.

customerDisplayName

string

Nazwa klienta.

customerId

string

W pełni kwalifikowany identyfikator, który jednoznacznie identyfikuje klienta.

date

string

Data transakcji.

discount

number

Rabat procentowy, jeśli istnieje, zastosowany do tej transakcji.

effectivePrice

EffectivePrice

Cena produktu po zastosowaniu wszelkich rabatów.

exchangeRate

number

Kurs wymiany używany do konwersji naliczonej kwoty na walutę rozliczeniową, jeśli ma to zastosowanie.

invoice

string

Nazwa faktury, na podstawie której transakcja została rozliczone lub "Oczekująca", jeśli transakcja nie jest rozliczana.

invoiceId

string

W pełni kwalifikowany identyfikator faktury, na której rozliczano transakcję. To pole ma zastosowanie tylko w przypadku transakcji, które są rozliczane.

invoiceSectionDisplayName

string

Nazwa sekcji faktury.

invoiceSectionId

string

W pełni kwalifikowany identyfikator, który jednoznacznie identyfikuje sekcję faktury.

isThirdParty

boolean

Bez względu na to, czy transakcja jest inną stroną.

kind

TransactionKind

Typ transakcji, rozliczone lub niezaliczone.

marketPrice

MarketPrice

Cena detaliczna produktu.

partNumber

string

Numer części produktu, dla którego miała miejsce transakcja. Pole dotyczy tylko faktur z umową Enterprise Agreement.

pricingCurrency

string

Kod ISO 4217 dla waluty, w której produkt jest wyceniany.

productDescription

string

Opis produktu, dla którego miała miejsce transakcja.

productFamily

string

Rodzina produktu, dla którego miała miejsce transakcja.

productType

string

Typ produktu, dla którego miała miejsce transakcja.

productTypeId

string

Identyfikator typu produktu, dla którego miała miejsce transakcja.

quantity

integer

Ilość zakupiona w transakcji.

reasonCode

string

Kod przyczyny transakcji.

refundTransactionDetails

RefundTransactionDetails

Szczegóły zwrotu transakcji.

servicePeriodEndDate

string

Data zakończenia okresu produktu lub data zakończenia miesiąca, w którym zakończyło się użycie.

servicePeriodStartDate

string

Data zakupu produktu lub data rozpoczęcia miesiąca, w którym rozpoczęto użycie.

specialTaxationType

SpecialTaxationType

Określa typ obliczenia podatkowego używanego dla faktury. Pole ma zastosowanie tylko do faktur z specjalną logiką obliczania podatku.

subTotal

SubTotal

Kwota naliczona przed opodatkowaniem za transakcję.

tax

Tax

Kwota podatku zastosowana do transakcji.

transactionAmount

TransactionAmount

Opłata skojarzona z transakcją.

transactionType

string

Typ transakcji.

unitOfMeasure

string

Jednostka miary używana do naliczania opłat za produkt. Na przykład usługi obliczeniowe są rozliczane za godzinę.

unitType

string

Opis jednostki miary dla danego produktu.

units

number

Liczba jednostek używanych dla danego produktu.