Partager via

Transactions - List By Invoice

  • Référence
Service:
Billing
Version d'API:
2024-04-01

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
Avec des paramètres facultatifs: 
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
billingAccountName
 path True

string

ID qui identifie de façon unique un compte de facturation.

Modèle d’expression régulière: ^([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

ID qui identifie de façon unique une facture.

Modèle d’expression régulière: ^(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

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.
orderBy
 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

TransactionListResult

Liste des transactions.
Other Status Codes

ErrorResponse

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Exemples

TransactionsListByInvoice

Exemple de requête

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

Exemple de réponse

Code d’état:
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"
    }
  ]
}

Définitions

Nom Description
AmountRefunded

Montant remboursé.
AmountRequested

Montant du remboursement demandé.
AzureCreditApplied

Montant des crédits Azure appliqués automatiquement à cette transaction.
ConsumptionCommitmentDecremented

Montant de décrémentation de Microsoft Azure Consumption Commitment (MACC) par le biais de la transaction.
createdByType

Type d’identité qui a créé la ressource.
CreditType

Type de crédit de la transaction. S’applique uniquement aux transactions créditées.
EffectivePrice

Prix du produit après avoir appliqué toutes les remises.
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail

Détail de l’erreur.
ErrorResponse

Réponse d’erreur
MarketPrice

Prix de vente au détail du produit.
RefundTransactionDetails

Détails du remboursement d’une transaction.
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.
systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.
Tax

Montant fiscal appliqué à la transaction.
Transaction

Une transaction.
TransactionAmount

Frais associés à la transaction.
TransactionKind

Type de la transaction, facturée ou non facturée.
TransactionListResult

Conteneur pour une liste de ressources
TransactionProperties

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

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.
code

string

Code d’erreur.
details

ErrorDetail[]

Détails de l’erreur.
message

string

Message d’erreur.
target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

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

AmountRefunded

Montant remboursé.
amountRequested

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

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

createdByType

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

TransactionProperties

Une transaction.
systemData

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

Transaction[]

Liste des ressources.

TransactionProperties

Une transaction.

Nom Type Description
azureCreditApplied

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

ConsumptionCommitmentDecremented

Montant de décrémentation de Microsoft Azure Consumption Commitment (MACC) par le biais de la transaction.
creditType

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

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

TransactionKind

Type de la transaction, facturée ou non facturée.
marketPrice

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

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

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

SubTotal

Montant facturé avant impôt pour la transaction.
tax

Tax

Montant fiscal appliqué à la transaction.
transactionAmount

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é.