Aracılığıyla paylaş

Transactions - List By Invoice

  • Başvuru
Hizmet:
Billing
API Sürümü:
2024-04-01

Faturanın hareketlerini listeler. İşlemler satın almaları, para iadelerini ve Azure kullanım ücretlerini içerir.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/{invoiceName}/transactions?api-version=2024-04-01
İsteğe bağlı parametrelerle: 
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 Parametreleri

Name İçinde Gerekli Tür Description
billingAccountName
 path True

string

Bir ödeme hesabını benzersiz olarak tanımlayan kimlik.

Normal ifade deseni: ^([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

Bir faturayı benzersiz olarak tanımlayan kimlik.

Normal ifade deseni: ^(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

İstemci isteğiyle kullanılacak API sürümü. Geçerli sürüm 2024-04-01'dir.
count
 query

boolean

Sorgu sayısı seçeneği, istemcilerin yanıttaki kaynaklara dahil edilen eşleşen kaynakların sayısını istemesine olanak tanır.
filter
 query

string

Sorguyu filtrele seçeneği, istemcilerin istek URL'si tarafından ele alınan bir kaynak koleksiyonunu filtrelemesine olanak tanır.
orderBy
 query

string

Orderby sorgu seçeneği istemcilerin belirli bir sırada kaynak istemesine olanak tanır.
search
 query

string

Arama sorgusu seçeneği, istemcilerin serbest metin arama ifadesiyle eşleşen bir koleksiyon içindeki öğeleri istemesine olanak tanır. arama yalnızca dize alanları için desteklenir.
skip
 query

integer

int64

Sorgu atla seçeneği sorgulanan koleksiyonda atlanacak ve sonube dahil edilmeyecek öğe sayısını istemektedir.
top
 query

integer

int64

En üstteki sorgu seçeneği sorgulanan koleksiyondaki öğelerin sayısının sonube eklenmesini istemektedir. En üst için desteklenen en yüksek değer 50'dir.

Yanıtlar

Name Tür Description
200 OK

TransactionListResult

İşlem listesi.
Other Status Codes

ErrorResponse

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Örnekler

TransactionsListByInvoice

Örnek isteği

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

Örnek yanıt

Durum kodu:
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"
    }
  ]
}

Tanımlar

Name Description
AmountRefunded

Para iadesi yapılan tutar.
AmountRequested

İstenen para iadesi miktarı.
AzureCreditApplied

Bu işleme otomatik olarak uygulanan Tüm Azure kredilerinin miktarı.
ConsumptionCommitmentDecremented

İşlem aracılığıyla Microsoft Azure Tüketim Taahhüdü(MACC) azalma miktarı.
createdByType

Kaynağı oluşturan kimliğin türü.
CreditType

İşlemin kredi türü. Yalnızca alacaklandırılan işlemler için geçerlidir.
EffectivePrice

Herhangi bir indirim uygulandıktan sonra ürünün fiyatı.
ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.
ErrorDetail

Hata ayrıntısı.
ErrorResponse

Hata yanıtı
MarketPrice

Ürünün perakende fiyatı.
RefundTransactionDetails

İşlemin para iadesi ayrıntıları.
SpecialTaxationType

Fatura için kullanılan vergi hesaplamasının türünü tanımlar. Bu alan yalnızca özel vergi hesaplama mantığına sahip faturalar için geçerlidir.
SubTotal

İşlem için vergi öncesi tahsil edilen tutar.
systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Tax

İşlem için uygulanan vergi tutarı.
Transaction

Bir işlem.
TransactionAmount

hareketle ilişkili ücret.
TransactionKind

İşlemin türü, faturalandırılan veya faturalandırılmamış.
TransactionListResult

Kaynak listesi için kapsayıcı
TransactionProperties

Bir işlem.

AmountRefunded

Para iadesi yapılan tutar.

Name Tür Description
currency

string

Tutar değerinin para birimi.
value

number

Tutar değeri. Örneğin, para birimi ABD doları ise 600 ABD doları değeri 600,00 TL olacaktır.

AmountRequested

İstenen para iadesi miktarı.

Name Tür Description
currency

string

Tutar değerinin para birimi.
value

number

Tutar değeri. Örneğin, para birimi ABD doları ise 600 ABD doları değeri 600,00 TL olacaktır.

AzureCreditApplied

Bu işleme otomatik olarak uygulanan Tüm Azure kredilerinin miktarı.

Name Tür Description
currency

string

Tutar değerinin para birimi.
value

number

Tutar değeri. Örneğin, para birimi ABD doları ise 600 ABD doları değeri 600,00 TL olacaktır.

ConsumptionCommitmentDecremented

İşlem aracılığıyla Microsoft Azure Tüketim Taahhüdü(MACC) azalma miktarı.

Name Tür Description
currency

string

Tutar değerinin para birimi.
value

number

Tutar değeri. Örneğin, para birimi ABD doları ise 600 ABD doları değeri 600,00 TL olacaktır.

createdByType

Kaynağı oluşturan kimliğin türü.

Name Tür Description
Application

string

Key

string

ManagedIdentity

string

User

string

CreditType

İşlemin kredi türü. Yalnızca alacaklandırılan işlemler için geçerlidir.

Name Tür Description
AzureCreditOffer

string

AzureFreeCredit

string

Other

string

Refund

string

ServiceInterruption

string

EffectivePrice

Herhangi bir indirim uygulandıktan sonra ürünün fiyatı.

Name Tür Description
currency

string

Tutar değerinin para birimi.
value

number

Tutar değeri. Örneğin, para birimi ABD doları ise 600 ABD doları değeri 600,00 TL olacaktır.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.
type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.
code

string

Hata kodu.
details

ErrorDetail[]

Hata ayrıntıları.
message

string

Hata iletisi.
target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

MarketPrice

Ürünün perakende fiyatı.

Name Tür Description
currency

string

Tutar değerinin para birimi.
value

number

Tutar değeri. Örneğin, para birimi ABD doları ise 600 ABD doları değeri 600,00 TL olacaktır.

RefundTransactionDetails

İşlemin para iadesi ayrıntıları.

Name Tür Description
amountRefunded

AmountRefunded

Para iadesi yapılan tutar.
amountRequested

AmountRequested

İstenen para iadesi miktarı.
refundOperationId

string

Para iadesi işleminin kimliği.

SpecialTaxationType

Fatura için kullanılan vergi hesaplamasının türünü tanımlar. Bu alan yalnızca özel vergi hesaplama mantığına sahip faturalar için geçerlidir.

Name Tür Description
InvoiceLevel

string

SubtotalLevel

string

SubTotal

İşlem için vergi öncesi tahsil edilen tutar.

Name Tür Description
currency

string

Tutar değerinin para birimi.
value

number

Tutar değeri. Örneğin, para birimi ABD doları ise 600 ABD doları değeri 600,00 TL olacaktır.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string

Kaynak oluşturma (UTC) zaman damgası.
createdBy

string

Kaynağı oluşturan kimlik.
createdByType

createdByType

Kaynağı oluşturan kimliğin türü.
lastModifiedAt

string

Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy

string

Kaynağı en son değiştiren kimlik.
lastModifiedByType

createdByType

Kaynağı en son değiştiren kimlik türü.

Tax

İşlem için uygulanan vergi tutarı.

Name Tür Description
currency

string

Tutar değerinin para birimi.
value

number

Tutar değeri. Örneğin, para birimi ABD doları ise 600 ABD doları değeri 600,00 TL olacaktır.

Transaction

Bir işlem.

Name Tür Description
id

string

Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

Kaynağın adı
properties

TransactionProperties

Bir işlem.
systemData

systemData

createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags

object

Kaynakla ilişkilendirilmiş meta verilerin sözlüğü. Tüm kaynak türleri için doldurulmayabilir. Desteklenen en fazla anahtar/değer uzunluğu 256 karakterdir. Anahtarlar/değer boş değer veya null olmamalıdır. Anahtarlar <> % & \ ? içeremez /
type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

TransactionAmount

hareketle ilişkili ücret.

Name Tür Description
currency

string

Tutar değerinin para birimi.
value

number

Tutar değeri. Örneğin, para birimi ABD doları ise 600 ABD doları değeri 600,00 TL olacaktır.

TransactionKind

İşlemin türü, faturalandırılan veya faturalandırılmamış.

Name Tür Description
All

string

Other

string

Reservation

string

TransactionListResult

Kaynak listesi için kapsayıcı

Name Tür Description
nextLink

string

Sonuçların sonraki sayfasına bağlantı (URL).
value

Transaction[]

Kaynak listesi.

TransactionProperties

Bir işlem.

Name Tür Description
azureCreditApplied

AzureCreditApplied

Bu işleme otomatik olarak uygulanan Tüm Azure kredilerinin miktarı.
azurePlan

string

Azure planının ayrıntıları.
billingCurrency

string

Bu işlemin faturalandırıldığı para birimi için ISO 4217 kodu.
billingProfileDisplayName

Faturalama profilinin adı.
billingProfileId

string

Faturalama profilini benzersiz olarak tanımlayan tam kimlik.
consumptionCommitmentDecremented

ConsumptionCommitmentDecremented

İşlem aracılığıyla Microsoft Azure Tüketim Taahhüdü(MACC) azalma miktarı.
creditType

CreditType

İşlemin kredi türü. Yalnızca alacaklandırılan işlemler için geçerlidir.
customerDisplayName

string

Müşterinin adı.
customerId

string

Bir müşteriyi benzersiz olarak tanımlayan tam kimlik.
date

string

İşlem tarihi.
discount

number

Varsa bu işleme uygulanan yüzde indirimi.
effectivePrice

EffectivePrice

Herhangi bir indirim uygulandıktan sonra ürünün fiyatı.
exchangeRate

number

Varsa, ücretlendirilen tutarı faturalama para birimine dönüştürmek için kullanılan döviz kuru.
invoice

string

İşlemin faturalandırıldığı fatura adı veya işlem faturalanmıyorsa 'Beklemede'.
invoiceId

string

İşlemin faturalandığı faturanın tam kimliği. Bu alan yalnızca faturalandırılan hareketler için geçerlidir.
invoiceSectionDisplayName

string

Fatura bölümünün adı.
invoiceSectionId

string

Bir fatura bölümünü benzersiz olarak tanımlayan tam kimlik.
isThirdParty

boolean

İşlemin üçüncü taraf olup olmadığı.
kind

TransactionKind

İşlemin türü, faturalandırılan veya faturalandırılmamış.
marketPrice

MarketPrice

Ürünün perakende fiyatı.
partNumber

string

İşlemin gerçekleştiği ürünün parça numarası. Bu alan yalnızca Kurumsal Anlaşma faturaları için geçerlidir.
pricingCurrency

string

Ürünün fiyatlandığı para birimi için ISO 4217 kodu.
productDescription

string

İşlemin gerçekleştiği ürünün açıklaması.
productFamily

string

İşlemin gerçekleştiği ürünün ailesi.
productType

string

İşlemin gerçekleştiği ürünün türü.
productTypeId

string

İşlemin gerçekleştiği ürün türünün kimliği.
quantity

integer

Harekette satın alınan miktar.
reasonCode

string

İşlemin neden kodu var.
refundTransactionDetails

RefundTransactionDetails

İşlemin para iadesi ayrıntıları.
servicePeriodEndDate

string

Ürün döneminin bitiş tarihi veya kullanımın sona erdiği ayın bitiş tarihi.
servicePeriodStartDate

string

Ürünün satın alındığı tarih veya kullanımın başladığı ayın başlangıç tarihi.
specialTaxationType

SpecialTaxationType

Fatura için kullanılan vergi hesaplamasının türünü tanımlar. Bu alan yalnızca özel vergi hesaplama mantığına sahip faturalar için geçerlidir.
subTotal

SubTotal

İşlem için vergi öncesi tahsil edilen tutar.
tax

Tax

İşlem için uygulanan vergi tutarı.
transactionAmount

TransactionAmount

hareketle ilişkili ücret.
transactionType

string

İşlem türü.
unitOfMeasure

string

Ürünün faturasını almak için kullanılan ölçü birimi. Örneğin işlem hizmetleri saat başına faturalandırılır.
unitType

string

Belirli bir ürünün ölçü biriminin açıklaması.
units

number

Belirli bir ürün için kullanılan birim sayısı.