Transactions - List By Invoice

Usługa:

Billing

Wersja interfejsu API:

2024-04-01

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

Z parametrami opcjonalnymi:

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

HTTP

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ź

Kod stanu:

200

{
  "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.