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 |
|---|---|---|---|---|
|
billing
|
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. |
|
invoice
|
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. |
|
|
order
|
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 |
Operación de Azure completada con éxito. |
|
| Other Status Codes |
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 |
|---|---|
|
created |
Tipo de identidad que creó el recurso. |
|
Credit |
Tipo de crédito de la transacción. Solo se aplica a las transacciones con crédito. |
|
Error |
Información adicional sobre el error de administración de recursos. |
|
Error |
Detalle del error. |
|
Error |
Respuesta de error |
|
Refund |
Importe devuelto. |
|
Refund |
Cantidad de reembolso solicitada. |
|
Special |
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. |
|
system |
Metadatos relativos a la creación y última modificación del recurso. |
| Transaction |
Transacción. |
|
Transaction |
Tipo de la transacción, facturada o no facturada. |
|
Transaction |
Colección paginada de elementos de la transacción |
|
Transaction |
Transacción. |
|
Transaction |
Cantidad de créditos de Azure aplicados automáticamente a esta transacción. |
|
Transaction |
La cantidad de decremento del compromiso de consumo de Microsoft Azure (MACC) a través de la transacción. |
|
Transaction |
El precio del producto después de aplicar cualquier descuento. |
|
Transaction |
Precio de venta al por menor del producto. |
|
Transaction |
Detalles de reembolso de una transacción. |
|
Transaction |
Importe de cargo por impuestos previos para la transacción. |
|
Transaction |
Importe fiscal aplicado a la transacción. |
|
Transaction |
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 |
Información adicional del error. |
|
| code |
string |
Código de error. |
| details |
Detalles del error. |
|
| message |
string |
Mensaje de error. |
| target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
| Nombre | Tipo | Description |
|---|---|---|
| error |
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 |
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 |
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 |
Transacción. |
|
| 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 |
Los ítems de transacciones en esta página |
TransactionProperties
Transacción.
| Nombre | Tipo | Description |
|---|---|---|
| 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 |
La cantidad de decremento del compromiso de consumo de Microsoft Azure (MACC) a través de la transacción. |
|
| 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 |
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 |
Tipo de la transacción, facturada o no facturada. |
|
| 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 (int32) |
Cantidad comprada en la transacción. |
| reasonCode |
string |
Hay código de motivo para la transacción. |
| refundTransactionDetails |
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 |
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. |
|
| tax |
Importe fiscal aplicado a la transacción. |
|
| 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 (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 |
Importe devuelto. |
|
| amountRequested |
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. |