Transactions - List By Invoice
Répertorie les transactions d’une facture. Les transactions incluent les achats, les remboursements et les frais d’utilisation 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}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
billing
|
path | True |
string |
ID qui identifie de façon unique un compte de facturation. Modèle d’expression régulière: |
invoice
|
path | True |
string |
ID qui identifie de façon unique une facture. Modèle d’expression régulière: |
api-version
|
query | True |
string |
Version de l’API à utiliser avec la demande cliente. La version actuelle est 2024-04-01. |
count
|
query |
boolean |
L’option de requête count permet aux clients de demander le nombre de ressources correspondantes incluses dans la réponse. |
|
filter
|
query |
string |
L’option de requête de filtre permet aux clients de filtrer une collection de ressources qui sont traitées par une URL de requête. |
|
order
|
query |
string |
L’option de requête orderby permet aux clients de demander des ressources dans un ordre particulier. |
|
search
|
query |
string |
L’option de requête de recherche permet aux clients de demander des éléments dans une collection correspondant à une expression de recherche en texte libre. la recherche n’est prise en charge que pour les champs de chaîne. |
|
skip
|
query |
integer int64 |
L’option ignorer la requête demande le nombre d’éléments de la collection interrogée à ignorer et non inclus dans le résultat. |
|
top
|
query |
integer int64 |
L’option de requête supérieure demande le nombre d’éléments de la collection interrogée à inclure dans le résultat. La valeur maximale prise en charge pour le haut est 50. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Liste des transactions. |
|
Other Status Codes |
Réponse d’erreur décrivant pourquoi l’opération a échoué. |
Exemples
TransactionsListByInvoice
Exemple de requête
Exemple de réponse
{
"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"
}
]
}
Définitions
Nom | Description |
---|---|
Amount |
Montant remboursé. |
Amount |
Montant du remboursement demandé. |
Azure |
Montant des crédits Azure appliqués automatiquement à cette transaction. |
Consumption |
Montant de décrémentation de Microsoft Azure Consumption Commitment (MACC) par le biais de la transaction. |
created |
Type d’identité qui a créé la ressource. |
Credit |
Type de crédit de la transaction. S’applique uniquement aux transactions créditées. |
Effective |
Prix du produit après avoir appliqué toutes les remises. |
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Error |
Détail de l’erreur. |
Error |
Réponse d’erreur |
Market |
Prix de vente au détail du produit. |
Refund |
Détails du remboursement d’une transaction. |
Special |
Identifie le type de calcul fiscal utilisé pour la facture. Le champ s’applique uniquement aux factures avec une logique de calcul fiscal spéciale. |
Sub |
Montant facturé avant impôt pour la transaction. |
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
Tax |
Montant fiscal appliqué à la transaction. |
Transaction |
Une transaction. |
Transaction |
Frais associés à la transaction. |
Transaction |
Type de la transaction, facturée ou non facturée. |
Transaction |
Conteneur pour une liste de ressources |
Transaction |
Une transaction. |
AmountRefunded
Montant remboursé.
Nom | Type | Description |
---|---|---|
currency |
string |
Devise de la valeur de montant. |
value |
number |
Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $. |
AmountRequested
Montant du remboursement demandé.
Nom | Type | Description |
---|---|---|
currency |
string |
Devise de la valeur de montant. |
value |
number |
Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $. |
AzureCreditApplied
Montant des crédits Azure appliqués automatiquement à cette transaction.
Nom | Type | Description |
---|---|---|
currency |
string |
Devise de la valeur de montant. |
value |
number |
Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $. |
ConsumptionCommitmentDecremented
Montant de décrémentation de Microsoft Azure Consumption Commitment (MACC) par le biais de la transaction.
Nom | Type | Description |
---|---|---|
currency |
string |
Devise de la valeur de montant. |
value |
number |
Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $. |
createdByType
Type d’identité qui a créé la ressource.
Nom | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CreditType
Type de crédit de la transaction. S’applique uniquement aux transactions créditées.
Nom | Type | Description |
---|---|---|
AzureCreditOffer |
string |
|
AzureFreeCredit |
string |
|
Other |
string |
|
Refund |
string |
|
ServiceInterruption |
string |
EffectivePrice
Prix du produit après avoir appliqué toutes les remises.
Nom | Type | Description |
---|---|---|
currency |
string |
Devise de la valeur de montant. |
value |
number |
Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $. |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
Nom | Type | Description |
---|---|---|
info |
object |
Informations supplémentaires. |
type |
string |
Type d’informations supplémentaire. |
ErrorDetail
Détail de l’erreur.
Nom | Type | Description |
---|---|---|
additionalInfo |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d’erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
Nom | Type | Description |
---|---|---|
error |
Objet d’erreur. |
MarketPrice
Prix de vente au détail du produit.
Nom | Type | Description |
---|---|---|
currency |
string |
Devise de la valeur de montant. |
value |
number |
Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $. |
RefundTransactionDetails
Détails du remboursement d’une transaction.
Nom | Type | Description |
---|---|---|
amountRefunded |
Montant remboursé. |
|
amountRequested |
Montant du remboursement demandé. |
|
refundOperationId |
string |
ID de l’opération de remboursement. |
SpecialTaxationType
Identifie le type de calcul fiscal utilisé pour la facture. Le champ s’applique uniquement aux factures avec une logique de calcul fiscal spéciale.
Nom | Type | Description |
---|---|---|
InvoiceLevel |
string |
|
SubtotalLevel |
string |
SubTotal
Montant facturé avant impôt pour la transaction.
Nom | Type | Description |
---|---|---|
currency |
string |
Devise de la valeur de montant. |
value |
number |
Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $. |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
Nom | Type | Description |
---|---|---|
createdAt |
string |
Horodatage de la création de ressources (UTC). |
createdBy |
string |
Identité qui a créé la ressource. |
createdByType |
Type d’identité qui a créé la ressource. |
|
lastModifiedAt |
string |
Horodatage de la dernière modification de ressource (UTC) |
lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |
Tax
Montant fiscal appliqué à la transaction.
Nom | Type | Description |
---|---|---|
currency |
string |
Devise de la valeur de montant. |
value |
number |
Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $. |
Transaction
Une transaction.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
name |
string |
Nom de la ressource |
properties |
Une transaction. |
|
systemData |
Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy. |
|
tags |
object |
Dictionnaire de métadonnées associées à la ressource. Il peut ne pas être rempli pour tous les types de ressources. Longueur maximale de clé/valeur prise en charge de 256 caractères. Les clés/valeur ne doivent pas être vides ni null. Les clés ne peuvent pas contenir <> % & \ ? / |
type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
TransactionAmount
Frais associés à la transaction.
Nom | Type | Description |
---|---|---|
currency |
string |
Devise de la valeur de montant. |
value |
number |
Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $. |
TransactionKind
Type de la transaction, facturée ou non facturée.
Nom | Type | Description |
---|---|---|
All |
string |
|
Other |
string |
|
Reservation |
string |
TransactionListResult
Conteneur pour une liste de ressources
Nom | Type | Description |
---|---|---|
nextLink |
string |
Lien (URL) vers la page suivante des résultats. |
value |
Liste des ressources. |
TransactionProperties
Une transaction.
Nom | Type | Description |
---|---|---|
azureCreditApplied |
Montant des crédits Azure appliqués automatiquement à cette transaction. |
|
azurePlan |
string |
Détails du plan Azure. |
billingCurrency |
string |
Code ISO 4217 pour la devise dans laquelle cette transaction est facturée. |
billingProfileDisplayName |
Nom du profil de facturation. |
|
billingProfileId |
string |
ID complet qui identifie de façon unique un profil de facturation. |
consumptionCommitmentDecremented |
Montant de décrémentation de Microsoft Azure Consumption Commitment (MACC) par le biais de la transaction. |
|
creditType |
Type de crédit de la transaction. S’applique uniquement aux transactions créditées. |
|
customerDisplayName |
string |
Nom du client. |
customerId |
string |
ID complet qui identifie de façon unique un client. |
date |
string |
Date de la transaction. |
discount |
number |
Remise en pourcentage, le cas échéant, appliquée à cette transaction. |
effectivePrice |
Prix du produit après avoir appliqué toutes les remises. |
|
exchangeRate |
number |
Taux de change utilisé pour convertir le montant facturé en devise de facturation, le cas échéant. |
invoice |
string |
Nom de facture sur lequel la transaction a été facturée ou « En attente » si la transaction n’est pas facturée. |
invoiceId |
string |
ID complet de la facture sur laquelle la transaction a été facturée. Ce champ s’applique uniquement aux transactions facturées. |
invoiceSectionDisplayName |
string |
Nom de la section de facture. |
invoiceSectionId |
string |
ID complet qui identifie de manière unique une section de facture. |
isThirdParty |
boolean |
Indique si la transaction est tierce ou non. |
kind |
Type de la transaction, facturée ou non facturée. |
|
marketPrice |
Prix de vente au détail du produit. |
|
partNumber |
string |
Numéro de partie du produit pour lequel la transaction a eu lieu. Le champ s’applique uniquement aux factures contrat Entreprise. |
pricingCurrency |
string |
Code ISO 4217 pour la devise dans laquelle le produit est facturé. |
productDescription |
string |
Description du produit pour lequel la transaction a eu lieu. |
productFamily |
string |
Famille du produit pour lequel la transaction a eu lieu. |
productType |
string |
Type du produit pour lequel la transaction a eu lieu. |
productTypeId |
string |
ID du type de produit pour lequel la transaction a eu lieu. |
quantity |
integer |
Quantité achetée dans la transaction. |
reasonCode |
string |
Il y a du code pour la transaction. |
refundTransactionDetails |
Détails du remboursement d’une transaction. |
|
servicePeriodEndDate |
string |
Date de fin du terme du produit ou date de fin du mois dans lequel l’utilisation s’est terminée. |
servicePeriodStartDate |
string |
Date de l’achat du produit, ou date de début du mois dans lequel l’utilisation a démarré. |
specialTaxationType |
Identifie le type de calcul fiscal utilisé pour la facture. Le champ s’applique uniquement aux factures avec une logique de calcul fiscal spéciale. |
|
subTotal |
Montant facturé avant impôt pour la transaction. |
|
tax |
Montant fiscal appliqué à la transaction. |
|
transactionAmount |
Frais associés à la transaction. |
|
transactionType |
string |
Type de transaction. |
unitOfMeasure |
string |
Unité de mesure utilisée pour facturer le produit. Par exemple, les services de calcul sont facturés par heure. |
unitType |
string |
Description de l’unité de mesure pour un produit donné. |
units |
number |
Nombre d’unités utilisées pour un produit donné. |