Invoices - List By Billing Subscription

Servizio:

Billing

Versione API:

2024-04-01

Elenca le fatture per una sottoscrizione.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string	ID che identifica in modo univoco una sottoscrizione di fatturazione. Criterio di espressione regolare: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$
api-version	query	True	string	Versione dell'API da usare con la richiesta client. La versione corrente è 2024-04-01.
count	query		boolean	L'opzione di query count consente ai client di richiedere un conteggio delle risorse corrispondenti incluse nelle risorse nella risposta.
filter	query		string	L'opzione di query di filtro consente ai client di filtrare una raccolta di risorse indirizzate da un URL di richiesta.
orderBy	query		string	L'opzione di query orderby consente ai client di richiedere risorse in un ordine specifico.
periodEndDate	query		string date	Data di fine del periodo di fatturazione per cui viene generata la fattura. La data è in formato MM-DD-YYYY.
periodStartDate	query		string date	Data di inizio del periodo di fatturazione per il quale viene generata la fattura. La data è in formato MM-DD-YYYY.
search	query		string	L'opzione di query di ricerca consente ai client di richiedere elementi all'interno di una raccolta corrispondente a un'espressione di ricerca senza testo. la ricerca è supportata solo per i campi stringa.
skip	query		integer int64	L'opzione ignora query richiede il numero di elementi nella raccolta di query che devono essere ignorati e non inclusi nel risultato.
top	query		integer int64	L'opzione query principale richiede che il numero di elementi nella raccolta di query venga incluso nel risultato. Il valore massimo supportato per top è 50.

Risposte

Nome	Tipo	Descrizione
200 OK	InvoiceListResult	Elenco delle fatture.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

InvoicesListByBillingSubscription

Esempio di richiesta

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/11111111-1111-1111-1111-111111111111/invoices?periodStartDate=2023-01-01&periodEndDate=2023-06-30&api-version=2024-04-01

Risposta di esempio

Codice di stato:

200

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/11111111-1111-1111-1111-111111111111/invoices/E123456789",
      "name": "E123456789",
      "properties": {
        "amountDue": {
          "currency": "USD",
          "value": 8.53
        },
        "billedAmount": {
          "currency": "USD",
          "value": 33.99
        },
        "dueDate": "2023-02-16T17:32:28Z",
        "invoiceDate": "2023-02-01T17:32:28Z",
        "invoicePeriodEndDate": "2023-02-15T17:32:28Z",
        "invoicePeriodStartDate": "2023-02-01T17:32:28Z",
        "invoiceType": "AzureServices",
        "purchaseOrderNumber": "123456",
        "status": "Due",
        "subscriptionDisplayName": "Contoso Operations Billing",
        "subscriptionId": "11111111-1111-1111-1111-111111111111"
      },
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions/invoices"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/11111111-1111-1111-1111-111111111111/invoices/G123456789",
      "name": "G123456789",
      "properties": {
        "amountDue": {
          "currency": "USD",
          "value": 15.53
        },
        "billedAmount": {
          "currency": "USD",
          "value": 55.99
        },
        "dueDate": "2023-02-16T17:32:28Z",
        "invoiceDate": "2023-02-01T17:32:28Z",
        "invoicePeriodEndDate": "2023-02-15T17:32:28Z",
        "invoicePeriodStartDate": "2023-02-01T17:32:28Z",
        "invoiceType": "AzureMarketplace",
        "purchaseOrderNumber": "123456",
        "status": "Due",
        "subscriptionDisplayName": "Contoso Operations Billing",
        "subscriptionId": "11111111-1111-1111-1111-111111111111"
      },
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions/invoices"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/11111111-1111-1111-1111-111111111111/invoices/E987654321",
      "name": "E987654321",
      "properties": {
        "amountDue": {
          "currency": "USD",
          "value": 8.53
        },
        "billedAmount": {
          "currency": "USD",
          "value": 33.99
        },
        "documents": [
          {
            "kind": "Invoice",
            "name": "12345678"
          }
        ],
        "dueDate": "2023-01-16T17:32:28Z",
        "invoiceDate": "2023-01-01T17:32:28Z",
        "invoicePeriodEndDate": "2023-01-15T17:32:28Z",
        "invoicePeriodStartDate": "2023-01-01T17:32:28Z",
        "invoiceType": "AzureSupport",
        "payments": [
          {
            "amount": {
              "currency": "USD",
              "value": 2000
            },
            "date": "2023-01-14T17:32:28Z",
            "paymentMethodFamily": "CreditCard",
            "paymentMethodType": "visa",
            "paymentType": "credited"
          }
        ],
        "purchaseOrderNumber": "123456",
        "status": "Due",
        "subscriptionDisplayName": "Contoso Operations Billing",
        "subscriptionId": "11111111-1111-1111-1111-111111111111"
      },
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions/invoices"
    }
  ]
}

Definizioni

Nome	Descrizione
Amount	Quantità.
AmountDue	Importo dovuto al momento.
AmountRefunded	Importo rimborsato.
AmountRequested	Importo del rimborso richiesto.
AzurePrepaymentApplied	Importo del pagamento anticipato di Azure applicato agli addebiti. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
BilledAmount	Addebiti totali per il periodo di fatturazione della fattura.
createdByType	Tipo di identità che ha creato la risorsa.
CreditAmount	Rimborso totale per i resi e gli annullamenti durante il periodo di fatturazione della fattura. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
DocumentSource	Origine del documento. ENF per Brasile e DRS per il resto del mondo.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
FailedPayment	Un pagamento non riuscito.
FailedPaymentReason	Motivo per cui il pagamento non è riuscito.
FreeAzureCreditApplied	Importo dei crediti Azure gratuiti applicati agli addebiti. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
Invoice	Una fattura.
InvoiceDocument	Proprietà di un documento.
InvoiceDocumentType	Tipo del documento.
InvoiceListResult	Contenitore per un elenco di risorse
InvoiceProperties	Una fattura.
InvoiceStatus	Stato corrente della fattura.
InvoiceType	Tipo di fattura.
Payment	Pagamento con fattura.
PaymentMethodFamily	Famiglia di metodi di pagamento.
RebillDetails	Dettagli della fattura.
RefundDetails	Dettagli di una richiesta di rimborso.
RefundReasonCode	Motivo del rimborso.
RefundStatus	Stato della richiesta di rimborso.
SpecialTaxationType	Identifica il tipo di calcolo delle imposte utilizzato per la fattura. Il campo è applicabile solo alle fatture con logica di calcolo fiscale speciale.
SubTotal	Importo pre-imposta dovuto. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
TaxAmount	Importo delle imposte addebitate per il periodo di fatturazione. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
TotalAmount	Importo dovuto al momento della generazione della fattura. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.

Amount

Quantità.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00.

AmountDue

Importo dovuto al momento.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00.

AmountRefunded

Importo rimborsato.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00.

AmountRequested

Importo del rimborso richiesto.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00.

AzurePrepaymentApplied

Importo del pagamento anticipato di Azure applicato agli addebiti. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00.

BilledAmount

Addebiti totali per il periodo di fatturazione della fattura.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

CreditAmount

Rimborso totale per i resi e gli annullamenti durante il periodo di fatturazione della fattura. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00.

DocumentSource

Origine del documento. ENF per Brasile e DRS per il resto del mondo.

Nome	Tipo	Descrizione
DRS	string
ENF	string
Other	string

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

FailedPayment

Un pagamento non riuscito.

Nome	Tipo	Descrizione
date	string	Data di tentativo di pagamento.
failedPaymentReason	FailedPaymentReason	Motivo per cui il pagamento non è riuscito.

FailedPaymentReason

Motivo per cui il pagamento non è riuscito.

Nome	Tipo	Descrizione
BankDeclined	string
CardExpired	string
IncorrectCardDetails	string
Other	string

FreeAzureCreditApplied

Importo dei crediti Azure gratuiti applicati agli addebiti. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00.

Invoice

Una fattura.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nome della risorsa
properties	InvoiceProperties	Una fattura.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Dizionario dei metadati associati alla risorsa. Potrebbe non essere popolato per tutti i tipi di risorse. Lunghezza massima chiave/valore supportata di 256 caratteri. Chiavi/valore non deve essere vuoto né null. Le chiavi non possono contenere <> % & \ ? /
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

InvoiceDocument

Proprietà di un documento.

Nome	Tipo	Descrizione
documentNumbers	string[]	Numeri di documento per il documento di fattura.
externalUrl	string	URL per scaricare il documento della fattura se l'origine è esterna a Microsoft.Billing.
kind	InvoiceDocumentType	Tipo del documento.
name	string	ID che identifica in modo univoco un documento di fattura. Questo ID può essere un identificatore per un PDF della fattura, una nota di credito o una ricevuta fiscale.
source	DocumentSource	Origine del documento. ENF per Brasile e DRS per il resto del mondo.
url	string	URL per scaricare il documento della fattura se l'origine è interna a Microsoft.Billing.

InvoiceDocumentType

Tipo del documento.

Nome	Tipo	Descrizione
CreditNote	string
Invoice	string
Other	string
Summary	string
TaxReceipt	string
Transactions	string
VoidNote	string

InvoiceListResult

Contenitore per un elenco di risorse

Nome	Tipo	Descrizione
nextLink	string	Collegamento (URL) alla pagina successiva dei risultati.
value	Invoice[]	Elenco di risorse.

InvoiceProperties

Una fattura.

Nome	Tipo	Descrizione
amountDue	AmountDue	Importo dovuto al momento.
azurePrepaymentApplied	AzurePrepaymentApplied	Importo del pagamento anticipato di Azure applicato agli addebiti. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
billedAmount	BilledAmount	Addebiti totali per il periodo di fatturazione della fattura.
billedDocumentId	string	ID della fattura attiva fatturata originariamente dopo che la fattura è stata annullata. Questo campo è applicabile solo alle fatture void.
billingProfileDisplayName	string	Nome del profilo di fatturazione per il quale viene generata la fattura.
billingProfileId	string	ID del profilo di fatturazione per cui viene generata la fattura.
creditAmount	CreditAmount	Rimborso totale per i resi e gli annullamenti durante il periodo di fatturazione della fattura. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
creditForDocumentId	string	Id della fattura che è stata annullata e questa nota di credito è stata emessa di conseguenza. Questo campo è applicabile solo alle note di credito.
documentType	InvoiceDocumentType	Tipo del documento.
documents	InvoiceDocument[]	Elenco di documenti disponibili per il download e la visualizzazione, ad esempio fattura, nota di credito o ricevuta fiscale.
dueDate	string	Data di scadenza della fattura.
failedPayments	FailedPayment[]	Elenco dei pagamenti non riusciti.
freeAzureCreditApplied	FreeAzureCreditApplied	Importo dei crediti Azure gratuiti applicati agli addebiti. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
invoiceDate	string	Data di generazione della fattura.
invoicePeriodEndDate	string	Data di fine del periodo di fatturazione per cui viene generata la fattura. La data è in formato MM-DD-YYYY.
invoicePeriodStartDate	string	Data di inizio del periodo di fatturazione per il quale viene generata la fattura. La data è in formato MM-DD-YYYY.
invoiceType	InvoiceType	Tipo di fattura.
isMonthlyInvoice	boolean	Specifica se la fattura viene generata come parte del ciclo di fatturazione mensile o meno. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
payments	Payment[]	Elenco dei pagamenti.
purchaseOrderNumber	string	Numero di ordine di acquisto facoltativo per la fattura.
rebillDetails	RebillDetails	Dettagli della fattura.
refundDetails	RefundDetails	Dettagli di una richiesta di rimborso.
specialTaxationType	SpecialTaxationType	Identifica il tipo di calcolo delle imposte utilizzato per la fattura. Il campo è applicabile solo alle fatture con logica di calcolo fiscale speciale.
status	InvoiceStatus	Stato corrente della fattura.
subTotal	SubTotal	Importo pre-imposta dovuto. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
subscriptionDisplayName	string	Nome della sottoscrizione di fatturazione per cui viene generata la fattura.
subscriptionId	string	ID della sottoscrizione per cui viene generata la fattura.
taxAmount	TaxAmount	Importo delle imposte addebitate per il periodo di fatturazione. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
totalAmount	TotalAmount	Importo dovuto al momento della generazione della fattura. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.

InvoiceStatus

Stato corrente della fattura.

Nome	Tipo	Descrizione
Due	string
Locked	string
Other	string
OverDue	string
Paid	string
Void	string

InvoiceType

Tipo di fattura.

Nome	Tipo	Descrizione
AzureMarketplace	string
AzureServices	string
AzureSupport	string
Other	string

Payment

Pagamento con fattura.

Nome	Tipo	Descrizione
amount	Amount	Importo pagato.
date	string	Data in cui è stato effettuato il pagamento.
paymentMethodFamily	PaymentMethodFamily	Famiglia di metodi di pagamento.
paymentMethodId	string	ID che identifica in modo univoco il metodo di pagamento utilizzato per la fattura.
paymentMethodType	string	Tipo di metodo di pagamento.
paymentType	string	Tipo di pagamento.

PaymentMethodFamily

Famiglia di metodi di pagamento.

Nome	Tipo	Descrizione
CheckWire	string
CreditCard	string
Credits	string
DirectDebit	string
EWallet	string
None	string
Other	string
TaskOrder	string

RebillDetails

Dettagli della fattura.

Nome	Tipo	Descrizione
creditNoteDocumentId	string	ID della nota di credito.
invoiceDocumentId	string	ID della fattura.
rebillDetails	RebillDetails	Dettagli della fattura.

RefundDetails

Dettagli di una richiesta di rimborso.

Nome	Tipo	Descrizione
amountRefunded	AmountRefunded	Importo rimborsato.
amountRequested	AmountRequested	Importo del rimborso richiesto.
approvedOn	string	Data di approvazione del rimborso.
completedOn	string	Data di completamento del rimborso.
rebillInvoiceId	string	ID fattura della fattura di fatturazione per un rimborso.
refundOperationId	string	ID dell'operazione di rimborso.
refundReason	RefundReasonCode	Motivo del rimborso.
refundStatus	RefundStatus	Stato della richiesta di rimborso.
requestedOn	string	Data in cui è stato richiesto il rimborso.
transactionCount	integer	Numero di transazioni rimborsate.

RefundReasonCode

Motivo del rimborso.

Nome	Tipo	Descrizione
AccidentalConversion	string
AccidentalPurchase	string
ForgotToCancel	string
Other	string
UnclearDocumentation	string
UnclearPricing	string

RefundStatus

Stato della richiesta di rimborso.

Nome	Tipo	Descrizione
Approved	string
Cancelled	string
Completed	string
Declined	string
Expired	string
Other	string
Pending	string

SpecialTaxationType

Identifica il tipo di calcolo delle imposte utilizzato per la fattura. Il campo è applicabile solo alle fatture con logica di calcolo fiscale speciale.

Nome	Tipo	Descrizione
InvoiceLevel	string
SubtotalLevel	string

SubTotal

Importo pre-imposta dovuto. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

TaxAmount

Importo delle imposte addebitate per il periodo di fatturazione. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00.

TotalAmount

Importo dovuto al momento della generazione della fattura. Questo campo è applicabile agli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00.