Invoices - List By Billing Profile

Servicio:

Billing

Versión de la API:

2024-04-01

Enumera las facturas de un perfil de facturación para una fecha de inicio y fecha de finalización determinada. La operación es compatible con las cuentas de facturación con el tipo de contrato Microsoft Partner Agreement o El Contrato de cliente de Microsoft.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoices?api-version=2024-04-01

Con parámetros opcionales:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoices?periodStartDate={periodStartDate}&periodEndDate={periodEndDate}&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})?)$
billingProfileName	path	True	string	Identificador que identifica de forma única un perfil de facturación. Patrón de Regex: ^[a-zA-Z\d-_]{1,128}$
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.
periodEndDate	query		string date	Fecha de finalización del período de facturación para el que se genera la factura. La fecha está en formato MM-DD-YYYY.
periodStartDate	query		string date	Fecha de inicio del período de facturación para el que se genera la factura. La fecha está en formato MM-DD-YYYY.
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	InvoiceListResult	Lista de facturas.
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Ejemplos

InvoicesListByBillingProfile

Solicitud de ejemplo

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/invoices?periodStartDate=2023-01-01&periodEndDate=2023-06-30&api-version=2024-04-01

Java

import java.time.LocalDate;

/**
 * Samples for Invoices ListByBillingProfile.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/invoicesListByBillingProfile.
     * json
     */
    /**
     * Sample code: InvoicesListByBillingProfile.
     * 
     * @param manager Entry point to BillingManager.
     */
    public static void invoicesListByBillingProfile(com.azure.resourcemanager.billing.BillingManager manager) {
        manager.invoices().listByBillingProfile(
            "00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31", "xxxx-xxxx-xxx-xxx",
            LocalDate.parse("2023-01-01"), LocalDate.parse("2023-06-30"), null, null, null, null, null, null,
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.billing import BillingManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-billing
# USAGE
    python invoices_list_by_billing_profile.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = BillingManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.invoices.list_by_billing_profile(
        billing_account_name="00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
        billing_profile_name="xxxx-xxxx-xxx-xxx",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/invoicesListByBillingProfile.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armbilling_test

import (
	"context"
	"log"

	"time"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/billing/armbilling"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/c08ac9813477921ad8295b98ced8f82d11b8f913/specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/invoicesListByBillingProfile.json
func ExampleInvoicesClient_NewListByBillingProfilePager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armbilling.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewInvoicesClient().NewListByBillingProfilePager("00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31", "xxxx-xxxx-xxx-xxx", &armbilling.InvoicesClientListByBillingProfileOptions{PeriodStartDate: to.Ptr(func() time.Time { t, _ := time.Parse("2006-01-02", "2023-01-01"); return t }()),
		PeriodEndDate: to.Ptr(func() time.Time { t, _ := time.Parse("2006-01-02", "2023-06-30"); return t }()),
		Filter:        nil,
		OrderBy:       nil,
		Top:           nil,
		Skip:          nil,
		Count:         nil,
		Search:        nil,
	})
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.InvoiceListResult = armbilling.InvoiceListResult{
		// 	Value: []*armbilling.Invoice{
		// 		{
		// 			Name: to.Ptr("G123456789"),
		// 			Type: to.Ptr("Microsoft.Billing/billingAccounts/invoices"),
		// 			ID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/G123456789"),
		// 			Properties: &armbilling.InvoiceProperties{
		// 				AmountDue: &armbilling.InvoicePropertiesAmountDue{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](8.53),
		// 				},
		// 				AzurePrepaymentApplied: &armbilling.InvoicePropertiesAzurePrepaymentApplied{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](25.46),
		// 				},
		// 				BilledAmount: &armbilling.InvoicePropertiesBilledAmount{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](33.99),
		// 				},
		// 				BillingProfileDisplayName: to.Ptr("Contoso Operations Billing"),
		// 				BillingProfileID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx"),
		// 				CreditAmount: &armbilling.InvoicePropertiesCreditAmount{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](0),
		// 				},
		// 				DocumentType: to.Ptr(armbilling.InvoiceDocumentTypeInvoice),
		// 				Documents: []*armbilling.InvoiceDocument{
		// 					{
		// 						Name: to.Ptr("12345678"),
		// 						Kind: to.Ptr(armbilling.InvoiceDocumentTypeInvoice),
		// 					},
		// 					{
		// 						Name: to.Ptr("22345678"),
		// 						Kind: to.Ptr(armbilling.InvoiceDocumentTypeTaxReceipt),
		// 				}},
		// 				DueDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-02-16T17:32:28.000Z"); return t}()),
		// 				FreeAzureCreditApplied: &armbilling.InvoicePropertiesFreeAzureCreditApplied{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](0),
		// 				},
		// 				InvoiceDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-02-01T17:32:28.000Z"); return t}()),
		// 				InvoicePeriodEndDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-02-15T17:32:28.000Z"); return t}()),
		// 				InvoicePeriodStartDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-02-01T17:32:28.000Z"); return t}()),
		// 				IsMonthlyInvoice: to.Ptr(false),
		// 				PurchaseOrderNumber: to.Ptr("123456"),
		// 				RebillDetails: &armbilling.InvoicePropertiesRebillDetails{
		// 					CreditNoteDocumentID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/CreditNote2"),
		// 					InvoiceDocumentID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/I000002"),
		// 					RebillDetails: &armbilling.RebillDetails{
		// 						CreditNoteDocumentID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/CreditNote"),
		// 						InvoiceDocumentID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/I000001"),
		// 					},
		// 				},
		// 				Status: to.Ptr(armbilling.InvoiceStatusDue),
		// 				SubTotal: &armbilling.InvoicePropertiesSubTotal{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](33.99),
		// 				},
		// 				TaxAmount: &armbilling.InvoicePropertiesTaxAmount{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](1),
		// 				},
		// 				TotalAmount: &armbilling.InvoicePropertiesTotalAmount{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](7.53),
		// 				},
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("G987654321"),
		// 			Type: to.Ptr("Microsoft.Billing/billingAccounts/invoices"),
		// 			ID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/G987654321"),
		// 			Properties: &armbilling.InvoiceProperties{
		// 				AmountDue: &armbilling.InvoicePropertiesAmountDue{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](0),
		// 				},
		// 				AzurePrepaymentApplied: &armbilling.InvoicePropertiesAzurePrepaymentApplied{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](25.46),
		// 				},
		// 				BilledAmount: &armbilling.InvoicePropertiesBilledAmount{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](33.99),
		// 				},
		// 				BillingProfileDisplayName: to.Ptr("Contoso Operations Billing"),
		// 				BillingProfileID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx"),
		// 				CreditAmount: &armbilling.InvoicePropertiesCreditAmount{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](0),
		// 				},
		// 				DocumentType: to.Ptr(armbilling.InvoiceDocumentTypeInvoice),
		// 				Documents: []*armbilling.InvoiceDocument{
		// 					{
		// 						Name: to.Ptr("12345678"),
		// 						Kind: to.Ptr(armbilling.InvoiceDocumentTypeInvoice),
		// 					},
		// 					{
		// 						Name: to.Ptr("22345678"),
		// 						Kind: to.Ptr(armbilling.InvoiceDocumentTypeTaxReceipt),
		// 				}},
		// 				DueDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-01-16T17:32:28.000Z"); return t}()),
		// 				FreeAzureCreditApplied: &armbilling.InvoicePropertiesFreeAzureCreditApplied{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](0),
		// 				},
		// 				InvoiceDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-01-01T17:32:28.000Z"); return t}()),
		// 				InvoicePeriodEndDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-01-15T17:32:28.000Z"); return t}()),
		// 				InvoicePeriodStartDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-01-01T17:32:28.000Z"); return t}()),
		// 				IsMonthlyInvoice: to.Ptr(false),
		// 				Payments: []*armbilling.Payment{
		// 					{
		// 						Amount: &armbilling.PaymentAmount{
		// 							Currency: to.Ptr("USD"),
		// 							Value: to.Ptr[float32](33.99),
		// 						},
		// 						Date: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2023-01-14T17:32:28.000Z"); return t}()),
		// 						PaymentMethodFamily: to.Ptr(armbilling.PaymentMethodFamilyCreditCard),
		// 						PaymentMethodType: to.Ptr("visa"),
		// 						PaymentType: to.Ptr("debited"),
		// 				}},
		// 				PurchaseOrderNumber: to.Ptr("123455"),
		// 				RebillDetails: &armbilling.InvoicePropertiesRebillDetails{
		// 					CreditNoteDocumentID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/CreditNote2"),
		// 					InvoiceDocumentID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/I000002"),
		// 					RebillDetails: &armbilling.RebillDetails{
		// 						CreditNoteDocumentID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/CreditNote"),
		// 						InvoiceDocumentID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/I000001"),
		// 					},
		// 				},
		// 				Status: to.Ptr(armbilling.InvoiceStatusPaid),
		// 				SubTotal: &armbilling.InvoicePropertiesSubTotal{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](33.99),
		// 				},
		// 				TaxAmount: &armbilling.InvoicePropertiesTaxAmount{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](1),
		// 				},
		// 				TotalAmount: &armbilling.InvoicePropertiesTotalAmount{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](7.53),
		// 				},
		// 			},
		// 	}},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { BillingManagementClient } = require("@azure/arm-billing");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Lists the invoices for a billing profile for a given start date and end date. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.
 *
 * @summary Lists the invoices for a billing profile for a given start date and end date. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.
 * x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/invoicesListByBillingProfile.json
 */
async function invoicesListByBillingProfile() {
  const billingAccountName =
    "00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31";
  const billingProfileName = "xxxx-xxxx-xxx-xxx";
  const periodStartDate = new Date("2023-01-01");
  const periodEndDate = new Date("2023-06-30");
  const options = {
    periodStartDate,
    periodEndDate,
  };
  const credential = new DefaultAzureCredential();
  const client = new BillingManagementClient(credential);
  const resArray = new Array();
  for await (let item of client.invoices.listByBillingProfile(
    billingAccountName,
    billingProfileName,
    options,
  )) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Billing.Models;
using Azure.ResourceManager.Billing;

// Generated from example definition: specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/invoicesListByBillingProfile.json
// this example is just showing the usage of "Invoices_ListByBillingProfile" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this BillingProfileResource created on azure
// for more information of creating BillingProfileResource, please refer to the document of BillingProfileResource
string billingAccountName = "00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31";
string billingProfileName = "xxxx-xxxx-xxx-xxx";
ResourceIdentifier billingProfileResourceId = BillingProfileResource.CreateResourceIdentifier(billingAccountName, billingProfileName);
BillingProfileResource billingProfile = client.GetBillingProfileResource(billingProfileResourceId);

// invoke the operation and iterate over the result
BillingProfileResourceGetInvoicesOptions options = new BillingProfileResourceGetInvoicesOptions() { PeriodStartDate = DateTimeOffset.Parse("2023-01-01"), PeriodEndDate = DateTimeOffset.Parse("2023-06-30") };
await foreach (BillingInvoiceData item in billingProfile.GetInvoicesAsync(options))
{
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {item.Id}");
}

Console.WriteLine($"Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:

200

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/G123456789",
      "name": "G123456789",
      "properties": {
        "amountDue": {
          "currency": "USD",
          "value": 8.53
        },
        "azurePrepaymentApplied": {
          "currency": "USD",
          "value": 25.46
        },
        "billedAmount": {
          "currency": "USD",
          "value": 33.99
        },
        "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",
        "creditAmount": {
          "currency": "USD",
          "value": 0
        },
        "documents": [
          {
            "kind": "Invoice",
            "name": "12345678"
          },
          {
            "kind": "TaxReceipt",
            "name": "22345678"
          }
        ],
        "documentType": "Invoice",
        "dueDate": "2023-02-16T17:32:28Z",
        "freeAzureCreditApplied": {
          "currency": "USD",
          "value": 0
        },
        "invoiceDate": "2023-02-01T17:32:28Z",
        "invoicePeriodEndDate": "2023-02-15T17:32:28Z",
        "invoicePeriodStartDate": "2023-02-01T17:32:28Z",
        "isMonthlyInvoice": false,
        "purchaseOrderNumber": "123456",
        "rebillDetails": {
          "invoiceDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/I000002",
          "creditNoteDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/CreditNote2",
          "rebillDetails": {
            "invoiceDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/I000001",
            "creditNoteDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/CreditNote"
          }
        },
        "status": "Due",
        "subTotal": {
          "currency": "USD",
          "value": 33.99
        },
        "taxAmount": {
          "currency": "USD",
          "value": 1
        },
        "totalAmount": {
          "currency": "USD",
          "value": 7.53
        }
      },
      "type": "Microsoft.Billing/billingAccounts/invoices"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/G987654321",
      "name": "G987654321",
      "properties": {
        "amountDue": {
          "currency": "USD",
          "value": 0
        },
        "azurePrepaymentApplied": {
          "currency": "USD",
          "value": 25.46
        },
        "billedAmount": {
          "currency": "USD",
          "value": 33.99
        },
        "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",
        "creditAmount": {
          "currency": "USD",
          "value": 0
        },
        "documents": [
          {
            "kind": "Invoice",
            "name": "12345678"
          },
          {
            "kind": "TaxReceipt",
            "name": "22345678"
          }
        ],
        "documentType": "Invoice",
        "dueDate": "2023-01-16T17:32:28Z",
        "freeAzureCreditApplied": {
          "currency": "USD",
          "value": 0
        },
        "invoiceDate": "2023-01-01T17:32:28Z",
        "invoicePeriodEndDate": "2023-01-15T17:32:28Z",
        "invoicePeriodStartDate": "2023-01-01T17:32:28Z",
        "isMonthlyInvoice": false,
        "payments": [
          {
            "amount": {
              "currency": "USD",
              "value": 33.99
            },
            "date": "2023-01-14T17:32:28Z",
            "paymentMethodFamily": "CreditCard",
            "paymentMethodType": "visa",
            "paymentType": "debited"
          }
        ],
        "purchaseOrderNumber": "123455",
        "rebillDetails": {
          "invoiceDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/I000002",
          "creditNoteDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/CreditNote2",
          "rebillDetails": {
            "invoiceDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/I000001",
            "creditNoteDocumentId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/CreditNote"
          }
        },
        "status": "Paid",
        "subTotal": {
          "currency": "USD",
          "value": 33.99
        },
        "taxAmount": {
          "currency": "USD",
          "value": 1
        },
        "totalAmount": {
          "currency": "USD",
          "value": 7.53
        }
      },
      "type": "Microsoft.Billing/billingAccounts/invoices"
    }
  ]
}

Definiciones

Nombre	Description
Amount	Cantidad.
AmountDue	Importe vencido a partir de ahora.
AmountRefunded	Importe devuelto.
AmountRequested	Cantidad de reembolso solicitada.
AzurePrepaymentApplied	El importe del prepago de Azure aplicado a los cargos. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
BilledAmount	Los cargos totales del período de facturación.
createdByType	Tipo de identidad que creó el recurso.
CreditAmount	Reembolso total de devoluciones y cancelaciones durante el período de facturación. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
DocumentSource	Origen del documento. ENF para Brasil y DRS para el resto del mundo.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
FailedPayment	Un pago erróneo.
FailedPaymentReason	Motivo por el que se produjo un error en el pago.
FreeAzureCreditApplied	Cantidad de créditos gratuitos de Azure aplicados a los cargos. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
Invoice	Una factura.
InvoiceDocument	Propiedades de un documento.
InvoiceDocumentType	Tipo del documento.
InvoiceListResult	Un contenedor para obtener una lista de recursos
InvoiceProperties	Una factura.
InvoiceStatus	Estado actual de la factura.
InvoiceType	Tipo de factura.
Payment	Un pago de factura.
PaymentMethodFamily	Familia de métodos de pago.
RebillDetails	Detalles de la facturación de una factura.
RefundDetails	Detalles de una solicitud de reembolso.
RefundReasonCode	Motivo del reembolso.
RefundStatus	Estado de la solicitud 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.
SubTotal	El importe de impuestos previos que se debe. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
systemData	Metadatos relativos a la creación y última modificación del recurso.
TaxAmount	El importe del impuesto que se cobra durante el período de facturación. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
TotalAmount	Importe vencido cuando se generó la factura. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.

Amount

Cantidad.

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.

AmountDue

Importe vencido a partir de ahora.

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.

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.

AzurePrepaymentApplied

El importe del prepago de Azure aplicado a los cargos. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.

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.

BilledAmount

Los cargos totales del período de facturació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

CreditAmount

Reembolso total de devoluciones y cancelaciones durante el período de facturación. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.

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.

DocumentSource

Origen del documento. ENF para Brasil y DRS para el resto del mundo.

Nombre	Tipo	Description
DRS	string
ENF	string
Other	string

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.

FailedPayment

Un pago erróneo.

Nombre	Tipo	Description
date	string	Fecha en que se intentó el pago.
failedPaymentReason	FailedPaymentReason	Motivo por el que se produjo un error en el pago.

FailedPaymentReason

Motivo por el que se produjo un error en el pago.

Nombre	Tipo	Description
BankDeclined	string
CardExpired	string
IncorrectCardDetails	string
Other	string

FreeAzureCreditApplied

Cantidad de créditos gratuitos de Azure aplicados a los cargos. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.

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.

Invoice

Una factura.

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	InvoiceProperties	Una factura.
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"

InvoiceDocument

Propiedades de un documento.

Nombre	Tipo	Description
documentNumbers	string[]	Los números de documento del documento de factura.
externalUrl	string	Dirección URL para descargar el documento de factura si el origen es externo a Microsoft.Billing.
kind	InvoiceDocumentType	Tipo del documento.
name	string	Identificador que identifica de forma única un documento de factura. Este identificador puede ser un identificador para un PDF de factura, una nota de crédito o un recibo fiscal.
source	DocumentSource	Origen del documento. ENF para Brasil y DRS para el resto del mundo.
url	string	Dirección URL para descargar el documento de factura si el origen es interno de Microsoft.Billing.

InvoiceDocumentType

Tipo del documento.

Nombre	Tipo	Description
CreditNote	string
Invoice	string
Other	string
Summary	string
TaxReceipt	string
Transactions	string
VoidNote	string

InvoiceListResult

Un contenedor para obtener una lista de recursos

Nombre	Tipo	Description
nextLink	string	Vínculo (url) a la página siguiente de resultados.
value	Invoice[]	Lista de recursos.

InvoiceProperties

Una factura.

Nombre	Tipo	Description
amountDue	AmountDue	Importe vencido a partir de ahora.
azurePrepaymentApplied	AzurePrepaymentApplied	El importe del prepago de Azure aplicado a los cargos. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
billedAmount	BilledAmount	Los cargos totales del período de facturación.
billedDocumentId	string	Identificador de la factura activa que se factura originalmente después de anular esta factura. Este campo solo se aplica a las facturas nulas.
billingProfileDisplayName	string	Nombre del perfil de facturación para el que se genera la factura.
billingProfileId	string	Identificador del perfil de facturación para el que se genera la factura.
creditAmount	CreditAmount	Reembolso total de devoluciones y cancelaciones durante el período de facturación. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
creditForDocumentId	string	El identificador de la factura que se anuló y esta nota de crédito se emitió como resultado. Este campo solo se aplica a las notas de crédito.
documentType	InvoiceDocumentType	Tipo del documento.
documents	InvoiceDocument[]	Lista de documentos disponibles para descargar y ver, como factura, nota de crédito o recibo fiscal.
dueDate	string	Fecha de vencimiento de la factura.
failedPayments	FailedPayment[]	Lista de pagos erróneos.
freeAzureCreditApplied	FreeAzureCreditApplied	Cantidad de créditos gratuitos de Azure aplicados a los cargos. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
invoiceDate	string	Fecha en que se generó la factura.
invoicePeriodEndDate	string	Fecha de finalización del período de facturación para el que se genera la factura. La fecha está en formato MM-DD-YYYY.
invoicePeriodStartDate	string	Fecha de inicio del período de facturación para el que se genera la factura. La fecha está en formato MM-DD-YYYY.
invoiceType	InvoiceType	Tipo de factura.
isMonthlyInvoice	boolean	Especifica si la factura se genera como parte del ciclo de facturación mensual o no. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
payments	Payment[]	Lista de pagos.
purchaseOrderNumber	string	Número de pedido de compra opcional para la factura.
rebillDetails	RebillDetails	Detalles de la facturación de una factura.
refundDetails	RefundDetails	Detalles de una solicitud de reembolso.
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.
status	InvoiceStatus	Estado actual de la factura.
subTotal	SubTotal	El importe de impuestos previos que se debe. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
subscriptionDisplayName	string	Nombre de la suscripción de facturación para la que se genera la factura.
subscriptionId	string	Identificador de la suscripción para la que se genera la factura.
taxAmount	TaxAmount	El importe del impuesto que se cobra durante el período de facturación. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.
totalAmount	TotalAmount	Importe vencido cuando se generó la factura. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.

InvoiceStatus

Estado actual de la factura.

Nombre	Tipo	Description
Due	string
Locked	string
Other	string
OverDue	string
Paid	string
Void	string

InvoiceType

Tipo de factura.

Nombre	Tipo	Description
AzureMarketplace	string
AzureServices	string
AzureSupport	string
Other	string

Payment

Un pago de factura.

Nombre	Tipo	Description
amount	Amount	Importe pagado.
date	string	Fecha en que se realizó el pago.
paymentMethodFamily	PaymentMethodFamily	Familia de métodos de pago.
paymentMethodId	string	Identificador que identifica de forma única el método de pago usado para la factura.
paymentMethodType	string	Tipo de método de pago.
paymentType	string	Tipo de pago.

PaymentMethodFamily

Familia de métodos de pago.

Nombre	Tipo	Description
CheckWire	string
CreditCard	string
Credits	string
DirectDebit	string
EWallet	string
None	string
Other	string
TaskOrder	string

RebillDetails

Detalles de la facturación de una factura.

Nombre	Tipo	Description
creditNoteDocumentId	string	Identificador de la nota de crédito.
invoiceDocumentId	string	Identificador de la factura.
rebillDetails	RebillDetails	Detalles de la facturación de una factura.

RefundDetails

Detalles de una solicitud de reembolso.

Nombre	Tipo	Description
amountRefunded	AmountRefunded	Importe devuelto.
amountRequested	AmountRequested	Cantidad de reembolso solicitada.
approvedOn	string	Fecha en que se aprobó el reembolso.
completedOn	string	Fecha en que se completó el reembolso.
rebillInvoiceId	string	El identificador de factura de la factura para un reembolso.
refundOperationId	string	Identificador de la operación de reembolso.
refundReason	RefundReasonCode	Motivo del reembolso.
refundStatus	RefundStatus	Estado de la solicitud de reembolso.
requestedOn	string	Fecha en que se solicitó el reembolso.
transactionCount	integer	Número de transacciones reembolsables.

RefundReasonCode

Motivo del reembolso.

Nombre	Tipo	Description
AccidentalConversion	string
AccidentalPurchase	string
ForgotToCancel	string
Other	string
UnclearDocumentation	string
UnclearPricing	string

RefundStatus

Estado de la solicitud de reembolso.

Nombre	Tipo	Description
Approved	string
Cancelled	string
Completed	string
Declined	string
Expired	string
Other	string
Pending	string

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

El importe de impuestos previos que se debe. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.

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.

TaxAmount

El importe del impuesto que se cobra durante el período de facturación. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.

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.

TotalAmount

Importe vencido cuando se generó la factura. Este campo es aplicable a las cuentas de facturación con el tipo de contrato Contrato de cliente de Microsoft.

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.