Invoices - List By Billing Account

Référence

Service:: Billing

Version d'API:: 2024-04-01

Répertorie les factures d’un compte de facturation pour une date de début et une date de fin donnée. L’opération est prise en charge pour tous les types de comptes de facturation.

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

Avec des paramètres facultatifs:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices?periodStartDate={periodStartDate}&periodEndDate={periodEndDate}&api-version=2024-04-01&filter={filter}&orderBy={orderBy}&top={top}&skip={skip}&count={count}&search={search}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
billingAccountName	path	True	string 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})?)$	ID qui identifie de façon unique un compte de facturation.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente. La version actuelle est 2024-04-01.
count	query		boolean	L’option de requête count permet aux clients de demander le nombre de ressources correspondantes incluses dans la réponse.
filter	query		string	L’option de requête de filtre permet aux clients de filtrer une collection de ressources qui sont traitées par une URL de requête.
orderBy	query		string	L’option de requête orderby permet aux clients de demander des ressources dans un ordre particulier.
periodEndDate	query		string (date)	Date de fin de la période de facturation pour laquelle la facture est générée. La date est au format MM-DD-YYYY.
periodStartDate	query		string (date)	Date de début de la période de facturation pour laquelle la facture est générée. La date est au format MM-DD-YYYY.
search	query		string	L’option de requête de recherche permet aux clients de demander des éléments dans une collection correspondant à une expression de recherche en texte libre. la recherche n’est prise en charge que pour les champs de chaîne.
skip	query		integer (int64)	L’option ignorer la requête demande le nombre d’éléments de la collection interrogée à ignorer et non inclus dans le résultat.
top	query		integer (int64)	L’option de requête supérieure demande le nombre d’éléments de la collection interrogée à inclure dans le résultat. La valeur maximale prise en charge pour le haut est 50.

Réponses

Nom	Type	Description
200 OK	InvoiceListResult	Liste des factures.
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Exemples

InvoicesListByBillingAccount

Exemple de requête

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


import java.time.LocalDate;

/**
 * Samples for Invoices ListByBillingAccount.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/invoicesListByBillingAccount.
     * json
     */
    /**
     * Sample code: InvoicesListByBillingAccount.
     * 
     * @param manager Entry point to BillingManager.
     */
    public static void invoicesListByBillingAccount(com.azure.resourcemanager.billing.BillingManager manager) {
        manager.invoices().listByBillingAccount(
            "00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
            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

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_account.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_account(
        billing_account_name="00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/invoicesListByBillingAccount.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

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/invoicesListByBillingAccount.json
func ExampleInvoicesClient_NewListByBillingAccountPager() {
	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().NewListByBillingAccountPager("00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31", &armbilling.InvoicesClientListByBillingAccountOptions{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

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

/**
 * This sample demonstrates how to Lists the invoices for a billing account for a given start date and end date. The operation is supported for all billing account types.
 *
 * @summary Lists the invoices for a billing account for a given start date and end date. The operation is supported for all billing account types.
 * x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2024-04-01/examples/invoicesListByBillingAccount.json
 */
async function invoicesListByBillingAccount() {
  const billingAccountName =
    "00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31";
  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.listByBillingAccount(billingAccountName, 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

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/invoicesListByBillingAccount.json
// this example is just showing the usage of "Invoices_ListByBillingAccount" 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 BillingAccountResource created on azure
// for more information of creating BillingAccountResource, please refer to the document of BillingAccountResource
string billingAccountName = "00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31";
ResourceIdentifier billingAccountResourceId = BillingAccountResource.CreateResourceIdentifier(billingAccountName);
BillingAccountResource billingAccount = client.GetBillingAccountResource(billingAccountResourceId);

// get the collection of this BillingInvoiceResource
BillingInvoiceCollection collection = billingAccount.GetBillingInvoices();

// invoke the operation and iterate over the result
BillingInvoiceCollectionGetAllOptions options = new BillingInvoiceCollectionGetAllOptions { PeriodStartDate = DateTimeOffset.Parse("2023-01-01"), PeriodEndDate = DateTimeOffset.Parse("2023-06-30") };
await foreach (BillingInvoiceResource item in collection.GetAllAsync(options))
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    BillingInvoiceData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.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

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/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"
    }
  ]
}

Définitions

Nom	Description
Amount	Montant.
AmountDue	Montant dû à l’heure actuelle.
AmountRefunded	Montant remboursé.
AmountRequested	Montant du remboursement demandé.
AzurePrepaymentApplied	Montant du paiement anticipé Azure appliqué aux frais. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.
BilledAmount	Frais totaux pour la période de facturation de la facture.
createdByType	Type d’identité qui a créé la ressource.
CreditAmount	Remboursement total des retours et annulations pendant la période de facturation de la facture. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.
DocumentSource	Source du document. ENF pour le Brésil et drS pour le reste du monde.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
FailedPayment	Un échec de paiement.
FailedPaymentReason	Raison pour laquelle le paiement a échoué.
FreeAzureCreditApplied	Montant des crédits Azure gratuits appliqués aux frais. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.
Invoice	Facture.
InvoiceDocument	Propriétés d’un document.
InvoiceDocumentType	Type du document.
InvoiceListResult	Conteneur pour une liste de ressources
InvoiceProperties	Facture.
InvoiceStatus	État actuel de la facture.
InvoiceType	Type de facture.
Payment	Paiement par facture.
PaymentMethodFamily	Famille de modes de paiement.
RebillDetails	Détails du refacturation d’une facture.
RefundDetails	Détails d’une demande de remboursement.
RefundReasonCode	Motif du remboursement.
RefundStatus	État de la demande de remboursement.
SpecialTaxationType	Identifie le type de calcul fiscal utilisé pour la facture. Le champ s’applique uniquement aux factures avec une logique de calcul fiscal spéciale.
SubTotal	Montant avant impôts dû. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
TaxAmount	Montant de la taxe facturée pour la période de facturation. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.
TotalAmount	Montant dû lors de la génération de la facture. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.

Amount

Object

Montant.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $.

AmountDue

Object

Montant dû à l’heure actuelle.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $.

AmountRefunded

Object

Montant remboursé.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $.

AmountRequested

Object

Montant du remboursement demandé.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $.

AzurePrepaymentApplied

Object

Montant du paiement anticipé Azure appliqué aux frais. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $.

BilledAmount

Object

Frais totaux pour la période de facturation de la facture.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $.

createdByType

Énumération

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

Valeur	Description
Application
Key
ManagedIdentity
User

CreditAmount

Object

Remboursement total des retours et annulations pendant la période de facturation de la facture. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $.

DocumentSource

Énumération

Source du document. ENF pour le Brésil et drS pour le reste du monde.

Valeur	Description
DRS
ENF
Other

ErrorAdditionalInfo

Object

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

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

FailedPayment

Object

Un échec de paiement.

Nom	Type	Description
date	string (date-time)	Date à laquelle le paiement a été tenté.
failedPaymentReason	FailedPaymentReason	Raison pour laquelle le paiement a échoué.

FailedPaymentReason

Énumération

Raison pour laquelle le paiement a échoué.

Valeur	Description
BankDeclined
CardExpired
IncorrectCardDetails
Other

FreeAzureCreditApplied

Object

Montant des crédits Azure gratuits appliqués aux frais. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $.

Invoice

Object

Facture.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name	string	Nom de la ressource
properties	InvoiceProperties	Facture.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Dictionnaire de métadonnées associées à la ressource. Il peut ne pas être rempli pour tous les types de ressources. Longueur maximale de clé/valeur prise en charge de 256 caractères. Les clés/valeur ne doivent pas être vides ni null. Les clés ne peuvent pas contenir <> % & \ ? /
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

InvoiceDocument

Object

Propriétés d’un document.

Nom	Type	Description
documentNumbers	string[]	Numéros de document pour le document de facture.
externalUrl	string	URL permettant de télécharger le document de facture si la source est externe à Microsoft.Billing.
kind	InvoiceDocumentType	Type du document.
name	string	ID qui identifie de façon unique un document de facture. Cet ID peut être un identificateur d’une facture PDF, d’une note de crédit ou d’un reçu fiscal.
source	DocumentSource	Source du document. ENF pour le Brésil et drS pour le reste du monde.
url	string	URL permettant de télécharger le document de facture si la source est interne à Microsoft.Billing.

InvoiceDocumentType

Énumération

Type du document.

Valeur	Description
CreditNote
Invoice
Other
Summary
TaxReceipt
Transactions
VoidNote

InvoiceListResult

Object

Conteneur pour une liste de ressources

Nom	Type	Description
nextLink	string	Lien (URL) vers la page suivante des résultats.
value	Invoice[]	Liste des ressources.

InvoiceProperties

Object

Facture.

Nom	Type	Description
amountDue	AmountDue	Montant dû à l’heure actuelle.
azurePrepaymentApplied	AzurePrepaymentApplied	Montant du paiement anticipé Azure appliqué aux frais. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.
billedAmount	BilledAmount	Frais totaux pour la période de facturation de la facture.
billedDocumentId	string	ID de la facture active qui est initialement facturée après l’annulation de cette facture. Ce champ s’applique uniquement aux factures void.
billingProfileDisplayName	string	Nom du profil de facturation pour lequel la facture est générée.
billingProfileId	string	ID du profil de facturation pour lequel la facture est générée.
creditAmount	CreditAmount	Remboursement total des retours et annulations pendant la période de facturation de la facture. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.
creditForDocumentId	string	Id de la facture qui a été annulée et cette note de crédit a été émise en conséquence. Ce champ s’applique uniquement aux notes de crédit.
documentType	InvoiceDocumentType	Type du document.
documents	InvoiceDocument[]	Liste des documents disponibles pour télécharger et afficher tels que la facture, la note de crédit ou le reçu fiscal.
dueDate	string (date-time)	Date d’échéance de la facture.
failedPayments	FailedPayment[]	Liste des paiements ayant échoué.
freeAzureCreditApplied	FreeAzureCreditApplied	Montant des crédits Azure gratuits appliqués aux frais. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.
invoiceDate	string (date-time)	Date à laquelle la facture a été générée.
invoicePeriodEndDate	string (date-time)	Date de fin de la période de facturation pour laquelle la facture est générée. La date est au format MM-DD-YYYY.
invoicePeriodStartDate	string (date-time)	Date de début de la période de facturation pour laquelle la facture est générée. La date est au format MM-DD-YYYY.
invoiceType	InvoiceType	Type de facture.
isMonthlyInvoice	boolean	Spécifie si la facture est générée dans le cadre du cycle de facturation mensuel ou non. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.
payments	Payment[]	Liste des paiements.
purchaseOrderNumber	string	Numéro de bon de commande facultatif pour la facture.
rebillDetails	RebillDetails	Refacturez les détails d’une facture.
refundDetails	RefundDetails	Détails d’une demande de remboursement.
specialTaxationType	SpecialTaxationType	Identifie le type de calcul fiscal utilisé pour la facture. Le champ s’applique uniquement aux factures avec une logique de calcul fiscal spéciale.
status	InvoiceStatus	État actuel de la facture.
subTotal	SubTotal	Montant avant impôts dû. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.
subscriptionDisplayName	string	Nom de l’abonnement de facturation pour lequel la facture est générée.
subscriptionId	string	ID de l’abonnement pour lequel la facture est générée.
taxAmount	TaxAmount	Montant de la taxe facturée pour la période de facturation. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.
totalAmount	TotalAmount	Montant dû lors de la génération de la facture. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.

InvoiceStatus

Énumération

État actuel de la facture.

Valeur	Description
Due
Locked
Other
OverDue
Paid
Void

InvoiceType

Énumération

Type de facture.

Valeur	Description
AzureMarketplace
AzureServices
AzureSupport
Other

Payment

Object

Paiement par facture.

Nom	Type	Description
amount	Amount	Montant payé.
date	string (date-time)	Date à laquelle le paiement a été effectué.
paymentMethodFamily	PaymentMethodFamily	Famille de modes de paiement.
paymentMethodId	string	ID qui identifie de manière unique le mode de paiement utilisé pour la facture.
paymentMethodType	string	Type de mode de paiement.
paymentType	string	Type de paiement.

PaymentMethodFamily

Énumération

Famille de modes de paiement.

Valeur	Description
CheckWire
CreditCard
Credits
DirectDebit
EWallet
None
Other
TaskOrder

RebillDetails

Object

Détails du refacturation d’une facture.

Nom	Type	Description
creditNoteDocumentId	string	ID de note de crédit.
invoiceDocumentId	string	ID de la facture.
rebillDetails	RebillDetails	Détails du refacturation d’une facture.

RefundDetails

Object

Détails d’une demande de remboursement.

Nom	Type	Description
amountRefunded	AmountRefunded	Montant remboursé.
amountRequested	AmountRequested	Montant du remboursement demandé.
approvedOn	string (date-time)	Date à laquelle le remboursement a été approuvé.
completedOn	string (date-time)	Date à laquelle le remboursement a été effectué.
rebillInvoiceId	string	ID de facture de la facture de refacturation pour un remboursement.
refundOperationId	string	ID de l’opération de remboursement.
refundReason	RefundReasonCode	Motif du remboursement.
refundStatus	RefundStatus	État de la demande de remboursement.
requestedOn	string (date-time)	Date à laquelle le remboursement a été demandé.
transactionCount	integer (int32)	Nombre de transactions remboursées.

RefundReasonCode

Énumération

Motif du remboursement.

Valeur	Description
AccidentalConversion
AccidentalPurchase
ForgotToCancel
Other
UnclearDocumentation
UnclearPricing

RefundStatus

Énumération

État de la demande de remboursement.

Valeur	Description
Approved
Cancelled
Completed
Declined
Expired
Other
Pending

SpecialTaxationType

Énumération

Identifie le type de calcul fiscal utilisé pour la facture. Le champ s’applique uniquement aux factures avec une logique de calcul fiscal spéciale.

Valeur	Description
InvoiceLevel
SubtotalLevel

SubTotal

Object

Montant avant impôts dû. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $.

systemData

Object

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

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

TaxAmount

Object

Montant de la taxe facturée pour la période de facturation. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $.

TotalAmount

Object

Montant dû lors de la génération de la facture. Ce champ s’applique aux comptes de facturation avec le type de contrat Client Microsoft.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur du montant. Par exemple, si la devise est USD, une valeur de 600 $ serait de 600,00 $.