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 |
---|---|---|---|---|
billing
|
path | True |
string |
Identyfikator, który jednoznacznie identyfikuje konto rozliczeniowe. Wzorzec wyrażenia regularnego: |
invoice
|
path | True |
string |
Identyfikator, który jednoznacznie identyfikuje fakturę. Wzorzec wyrażenia regularnego: |
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. |
|
order
|
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 |
Lista transakcji. |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Przykłady
TransactionsListByInvoice
Przykładowe żądanie
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 |
---|---|
Amount |
Zwrócona kwota. |
Amount |
Żądana kwota zwrotu pieniędzy. |
Azure |
Kwota środków na korzystanie z platformy Azure automatycznie zastosowana do tej transakcji. |
Consumption |
Kwota dekrementacji zobowiązania użycia platformy Microsoft Azure (MACC) za pośrednictwem transakcji. |
created |
Typ tożsamości, która utworzyła zasób. |
Credit |
Typ środków transakcji. Dotyczy tylko transakcji kredytowych. |
Effective |
Cena produktu po zastosowaniu wszelkich rabatów. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Market |
Cena detaliczna produktu. |
Refund |
Szczegóły zwrotu transakcji. |
Special |
Określa typ obliczenia podatkowego używanego dla faktury. Pole ma zastosowanie tylko do faktur z specjalną logiką obliczania podatku. |
Sub |
Kwota naliczona przed opodatkowaniem za transakcję. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
Tax |
Kwota podatku zastosowana do transakcji. |
Transaction |
Transakcja. |
Transaction |
Opłata skojarzona z transakcją. |
Transaction |
Typ transakcji, rozliczone lub niezaliczone. |
Transaction |
Kontener dla listy zasobów |
Transaction |
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 |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
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 |
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 |
Zwrócona kwota. |
|
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 |
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 |
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 |
Transakcja. |
|
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 |
Lista zasobów. |
TransactionProperties
Transakcja.
Nazwa | Typ | Opis |
---|---|---|
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 |
Kwota dekrementacji zobowiązania użycia platformy Microsoft Azure (MACC) za pośrednictwem transakcji. |
|
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 |
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 |
Typ transakcji, rozliczone lub niezaliczone. |
|
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 |
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 |
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ę. |
|
tax |
Kwota podatku zastosowana do transakcji. |
|
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. |