Compartir a través de


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

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

Patrón de Regex: ^([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

Identificador que identifica de forma única una factura.

Patrón de Regex: ^(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

Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2024-04-01.

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

Lista de transacciones.

Other Status Codes

ErrorResponse

Respuesta de error que describe por qué se produjo un error en la operación.

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": [
    {
      "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"
    }
  ]
}

Definiciones

Nombre Description
AmountRefunded

Importe devuelto.

AmountRequested

Cantidad de reembolso solicitada.

AzureCreditApplied

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

ConsumptionCommitmentDecremented

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

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.

EffectivePrice

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

ErrorAdditionalInfo

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

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

MarketPrice

Precio de venta al por menor del producto.

RefundTransactionDetails

Detalles de reembolso de una transacción.

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

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

systemData

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

Tax

Importe fiscal aplicado a la transacción.

Transaction

Transacción.

TransactionAmount

Cargo asociado a la transacción.

TransactionKind

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

TransactionListResult

Un contenedor para obtener una lista de recursos

TransactionProperties

Transacción.

AmountRefunded

Importe devuelto.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number

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

AmountRequested

Cantidad de reembolso solicitada.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number

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

AzureCreditApplied

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

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

ConsumptionCommitmentDecremented

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

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

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

CreditType

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

Nombre Tipo Description
AzureCreditOffer

string

AzureFreeCredit

string

Other

string

Refund

string

ServiceInterruption

string

EffectivePrice

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

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number

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

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.

MarketPrice

Precio de venta al por menor del producto.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number

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

RefundTransactionDetails

Detalles de reembolso de una transacción.

Nombre Tipo Description
amountRefunded

AmountRefunded

Importe devuelto.

amountRequested

AmountRequested

Cantidad de reembolso solicitada.

refundOperationId

string

Identificador de la operación de reembolso.

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.

Nombre Tipo Description
InvoiceLevel

string

SubtotalLevel

string

SubTotal

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

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number

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

systemData

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

Nombre Tipo Description
createdAt

string

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

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.

Tax

Importe fiscal aplicado a la transacción.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number

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

Transaction

Transacción.

Nombre Tipo Description
id

string

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"

TransactionAmount

Cargo asociado a la transacción.

Nombre Tipo Description
currency

string

Moneda del valor de la cantidad.

value

number

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

TransactionKind

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

Nombre Tipo Description
All

string

Other

string

Reservation

string

TransactionListResult

Un contenedor para obtener una lista de recursos

Nombre Tipo Description
nextLink

string

Vínculo (url) a la página siguiente de resultados.

value

Transaction[]

Lista de recursos.

TransactionProperties

Transacción.

Nombre Tipo Description
azureCreditApplied

AzureCreditApplied

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

ConsumptionCommitmentDecremented

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

Fecha de transacción.

discount

number

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

effectivePrice

EffectivePrice

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

exchangeRate

number

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

MarketPrice

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

Cantidad comprada en la transacción.

reasonCode

string

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

refundTransactionDetails

RefundTransactionDetails

Detalles de reembolso de una transacción.

servicePeriodEndDate

string

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

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

SubTotal

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

tax

Tax

Importe fiscal aplicado a la transacción.

transactionAmount

TransactionAmount

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

Número de unidades usadas para un producto determinado.