Transactions - List By Invoice

Enumera las transacciones de una factura. Las transacciones incluyen compras, reembolsos y cargos de uso de 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}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
billingAccountName
path True

string

pattern: ^([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})?)$

Identificador que identifica de forma única una cuenta de facturación.

invoiceName
path True

string

pattern: ^(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})$

Identificador que identifica de forma única una factura.

api-version
query True

string

minLength: 1

Versión de API que se usará para esta operación.

count
query

boolean

La opción de consulta count permite a los clientes solicitar un recuento de los recursos coincidentes incluidos con los recursos de la respuesta.

filter
query

string

La opción de consulta de filtro permite a los clientes filtrar una colección de recursos que se abordan mediante una dirección URL de solicitud.

orderBy
query

string

La opción de consulta orderby permite a los clientes solicitar recursos en un orden determinado.

search
query

string

La opción de consulta de búsqueda permite a los clientes solicitar elementos dentro de una colección que coincida con una expresión de búsqueda de texto libre. la búsqueda solo se admite para campos de cadena.

skip
query

integer (int64)

La opción omitir consulta solicita el número de elementos de la colección consultada que se omitirán y no se incluirán en el resultado.

top
query

integer (int64)

La opción de consulta superior solicita el número de elementos de la colección consultada que se incluirán en el resultado. El valor máximo admitido para top es 50.

Respuestas

Nombre Tipo Description
200 OK

TransactionListResult

Operación de Azure completada con éxito.

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

TransactionsListByInvoice

Solicitud de ejemplo

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

Respuesta de muestra

{
  "value": [
    {
      "name": "41000000-0000-0000-0000-000000000000",
      "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/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",
        "productType": "VM Instance",
        "productTypeId": "A12345",
        "quantity": 1,
        "servicePeriodEndDate": "2023-09-30T00:00:00Z",
        "servicePeriodStartDate": "2023-05-01T00:00:00Z",
        "subTotal": {
          "currency": "USD",
          "value": 4500
        },
        "tax": {
          "currency": "USD",
          "value": 500
        },
        "transactionAmount": {
          "currency": "USD",
          "value": 5000
        },
        "transactionType": "Purchase",
        "unitOfMeasure": "1 Minute",
        "unitType": "1 Runtime Minute",
        "units": 11.25
      }
    },
    {
      "name": "51000000-0000-0000-0000-000000000000",
      "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",
      "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",
        "productType": "VM Instance",
        "productTypeId": "A12345",
        "quantity": 1,
        "servicePeriodEndDate": "2023-09-30T00:00:00Z",
        "servicePeriodStartDate": "2023-05-01T00:00:00Z",
        "subTotal": {
          "currency": "USD",
          "value": 45
        },
        "tax": {
          "currency": "USD",
          "value": 5
        },
        "transactionAmount": {
          "currency": "USD",
          "value": 50
        },
        "transactionType": "Cancel",
        "unitOfMeasure": "1 Minute",
        "unitType": "1 Runtime Minute",
        "units": 1.25
      }
    }
  ]
}

Definiciones

Nombre Description
createdByType

Tipo de identidad que creó el recurso.

CreditType

Tipo de crédito de la transacción. Solo se aplica a las transacciones con crédito.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

RefundTransactionDetailsAmountRefunded

Importe devuelto.

RefundTransactionDetailsAmountRequested

Cantidad de reembolso solicitada.

SpecialTaxationType

Identifica el tipo de cálculo fiscal utilizado para la factura. El campo solo es aplicable a las facturas con lógica de cálculo fiscal especial.

systemData

Metadatos relativos a la creación y última modificación del recurso.

Transaction

Transacción.

TransactionKind

Tipo de la transacción, facturada o no facturada.

TransactionListResult

Colección paginada de elementos de la transacción

TransactionProperties

Transacción.

TransactionPropertiesAzureCreditApplied

Cantidad de créditos de Azure aplicados automáticamente a esta transacción.

TransactionPropertiesConsumptionCommitmentDecremented

La cantidad de decremento del compromiso de consumo de Microsoft Azure (MACC) a través de la transacción.

TransactionPropertiesEffectivePrice

El precio del producto después de aplicar cualquier descuento.

TransactionPropertiesMarketPrice

Precio de venta al por menor del producto.

TransactionPropertiesRefundTransactionDetails

Detalles de reembolso de una transacción.

TransactionPropertiesSubTotal

Importe de cargo por impuestos previos para la transacción.

TransactionPropertiesTax

Importe fiscal aplicado a la transacción.

TransactionPropertiesTransactionAmount

Cargo asociado a la transacción.

createdByType

Tipo de identidad que creó el recurso.

Valor Description
User
Application
ManagedIdentity
Key

CreditType

Tipo de crédito de la transacción. Solo se aplica a las transacciones con crédito.

Valor Description
Other

Otros

AzureFreeCredit

AzureFreeCredit

AzureCreditOffer

AzureCreditOffer

ServiceInterruption

Interrupción del servicio

Refund

Reembolso

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

RefundTransactionDetailsAmountRefunded

Importe devuelto.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number (float)

Valor de la cantidad. Por ejemplo, si la moneda es USD, un valor de 600 sería $600.00.

RefundTransactionDetailsAmountRequested

Cantidad de reembolso solicitada.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number (float)

Valor de la cantidad. Por ejemplo, si la moneda es USD, un valor de 600 sería $600.00.

SpecialTaxationType

Identifica el tipo de cálculo fiscal utilizado para la factura. El campo solo es aplicable a las facturas con lógica de cálculo fiscal especial.

Valor Description
SubtotalLevel

SubtotalLevel

InvoiceLevel

FacturLevel

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string (date-time)

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.

Transaction

Transacción.

Nombre Tipo Description
id

string (arm-id)

Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nombre del recurso

properties

TransactionProperties

Transacción.

systemData

systemData

Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.

tags

object

Diccionario de metadatos asociados al recurso. Es posible que no se rellene para todos los tipos de recursos. Longitud máxima de clave/valor admitida de 256 caracteres. Las claves y el valor no deben estar vacíos ni null. Las claves no pueden contener <> % & \ ? /

type

string

Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

TransactionKind

Tipo de la transacción, facturada o no facturada.

Valor Description
Other

Otros

All

Todos

Reservation

Reserva

TransactionListResult

Colección paginada de elementos de la transacción

Nombre Tipo Description
nextLink

string (uri)

Vínculo a la página siguiente de elementos

value

Transaction[]

Los ítems de transacciones en esta página

TransactionProperties

Transacción.

Nombre Tipo Description
azureCreditApplied

TransactionPropertiesAzureCreditApplied

Cantidad de créditos de Azure aplicados automáticamente a esta transacción.

azurePlan

string

Detalles del plan de Azure.

billingCurrency

string

Código ISO 4217 para la moneda en la que se factura esta transacción.

billingProfileDisplayName

Nombre del perfil de facturación.

billingProfileId

string

Identificador completo que identifica de forma única un perfil de facturación.

consumptionCommitmentDecremented

TransactionPropertiesConsumptionCommitmentDecremented

La cantidad de decremento del compromiso de consumo de Microsoft Azure (MACC) a través de la transacción.

creditType

CreditType

Tipo de crédito de la transacción. Solo se aplica a las transacciones con crédito.

customerDisplayName

string

Nombre del cliente.

customerId

string

Identificador completo que identifica de forma única a un cliente.

date

string (date-time)

Fecha de transacción.

discount

number (float)

El descuento porcentual, si existe, aplicado a esta transacción.

effectivePrice

TransactionPropertiesEffectivePrice

El precio del producto después de aplicar cualquier descuento.

exchangeRate

number (float)

Tipo de cambio usado para convertir el importe de la facturación a la moneda de facturación, si procede.

invoice

string

Nombre de factura en el que se facturaba la transacción o "Pendiente" si la transacción no se factura.

invoiceId

string

Identificador completo de la factura en la que se factura la transacción. Este campo solo es aplicable a las transacciones que se facturan.

invoiceSectionDisplayName

string

Nombre de la sección de factura.

invoiceSectionId

string

Identificador completo que identifica de forma única una sección de factura.

isThirdParty

boolean

Si la transacción es de terceros o no.

kind

TransactionKind

Tipo de la transacción, facturada o no facturada.

marketPrice

TransactionPropertiesMarketPrice

Precio de venta al por menor del producto.

partNumber

string

Número de pieza del producto para el que tuvo lugar la transacción. El campo solo es aplicable a las facturas del Contrato Enterprise.

pricingCurrency

string

Código ISO 4217 para la moneda en la que el producto tiene un precio.

productDescription

string

Descripción del producto para el que tuvo lugar la transacción.

productFamily

string

Familia del producto para el que tuvo lugar la transacción.

productType

string

Tipo del producto para el que tuvo lugar la transacción.

productTypeId

string

Identificador del tipo de producto para el que tuvo lugar la transacción.

quantity

integer (int32)

Cantidad comprada en la transacción.

reasonCode

string

Hay código de motivo para la transacción.

refundTransactionDetails

TransactionPropertiesRefundTransactionDetails

Detalles de reembolso de una transacción.

servicePeriodEndDate

string (date-time)

Fecha de finalización del término del producto o la fecha de finalización del mes en el que finalizó el uso.

servicePeriodStartDate

string (date-time)

Fecha de la compra del producto o la fecha de inicio del mes en el que se inició el uso.

specialTaxationType

SpecialTaxationType

Identifica el tipo de cálculo fiscal utilizado para la factura. El campo solo es aplicable a las facturas con lógica de cálculo fiscal especial.

subTotal

TransactionPropertiesSubTotal

Importe de cargo por impuestos previos para la transacción.

tax

TransactionPropertiesTax

Importe fiscal aplicado a la transacción.

transactionAmount

TransactionPropertiesTransactionAmount

Cargo asociado a la transacción.

transactionType

string

Tipo de transacción.

unitOfMeasure

string

Unidad de medida utilizada para facturar el producto. Por ejemplo, los servicios de proceso se facturan por hora.

unitType

string

Descripción de la unidad de medida de un producto determinado.

units

number (float)

Número de unidades usadas para un producto determinado.

TransactionPropertiesAzureCreditApplied

Cantidad de créditos de Azure aplicados automáticamente a esta transacción.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number (float)

Valor de la cantidad. Por ejemplo, si la moneda es USD, un valor de 600 sería $600.00.

TransactionPropertiesConsumptionCommitmentDecremented

La cantidad de decremento del compromiso de consumo de Microsoft Azure (MACC) a través de la transacción.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number (float)

Valor de la cantidad. Por ejemplo, si la moneda es USD, un valor de 600 sería $600.00.

TransactionPropertiesEffectivePrice

El precio del producto después de aplicar cualquier descuento.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number (float)

Valor de la cantidad. Por ejemplo, si la moneda es USD, un valor de 600 sería $600.00.

TransactionPropertiesMarketPrice

Precio de venta al por menor del producto.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number (float)

Valor de la cantidad. Por ejemplo, si la moneda es USD, un valor de 600 sería $600.00.

TransactionPropertiesRefundTransactionDetails

Detalles de reembolso de una transacción.

Nombre Tipo Description
amountRefunded

RefundTransactionDetailsAmountRefunded

Importe devuelto.

amountRequested

RefundTransactionDetailsAmountRequested

Cantidad de reembolso solicitada.

refundOperationId

string

Identificador de la operación de reembolso.

TransactionPropertiesSubTotal

Importe de cargo por impuestos previos para la transacción.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number (float)

Valor de la cantidad. Por ejemplo, si la moneda es USD, un valor de 600 sería $600.00.

TransactionPropertiesTax

Importe fiscal aplicado a la transacción.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number (float)

Valor de la cantidad. Por ejemplo, si la moneda es USD, un valor de 600 sería $600.00.

TransactionPropertiesTransactionAmount

Cargo asociado a la transacción.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number (float)

Valor de la cantidad. Por ejemplo, si la moneda es USD, un valor de 600 sería $600.00.