Condividi tramite


Invoices - Get

Ottiene una fattura in base all'ID. L'operazione è supportata per gli account di fatturazione con tipo di contratto Microsoft Partner Agreement o Contratto del cliente Microsoft.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
invoiceName
path True

string

pattern: ^(H[0-9]-[A-Z0-9]+)$|^(?:([GHT]|HT){1}[A-Z0-9]{9})$|^(?:[D]{1}[A-Z0-9]{9})$|^(?:E{1}[B-Z0-9]{1}[A-Z0-9]{8})$|^(?:EA[A-Z0-9]{8})$

ID che identifica in modo univoco una fattura.

api-version
query True

string

Versione dell'API da usare con la richiesta client. La versione corrente è 2024-04-01.

Risposte

Nome Tipo Descrizione
200 OK

Invoice

Una fattura.

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

InvoicesGet

Esempio di richiesta

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

Risposta di esempio

{
  "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",
    "specialTaxationType": "SubtotalLevel",
    "subTotal": {
      "currency": "USD",
      "value": 33.99
    },
    "taxAmount": {
      "currency": "USD",
      "value": 1
    },
    "totalAmount": {
      "currency": "USD",
      "value": 7.53
    }
  },
  "type": "Microsoft.Billing/billingAccounts/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.

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.

Valore Descrizione
Application
Key
ManagedIdentity
User

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.

Valore Descrizione
DRS
ENF
Other

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 (date-time)

Data di tentativo di pagamento.

failedPaymentReason

FailedPaymentReason

Motivo per cui il pagamento non è riuscito.

FailedPaymentReason

Motivo per cui il pagamento non è riuscito.

Valore Descrizione
BankDeclined
CardExpired
IncorrectCardDetails
Other

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 (arm-id)

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.

Valore Descrizione
CreditNote
Invoice
Other
Summary
TaxReceipt
Transactions
VoidNote

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 (date-time)

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 (date-time)

Data di generazione della fattura.

invoicePeriodEndDate

string (date-time)

Data di fine del periodo di fatturazione per cui viene generata la fattura. La data è in formato MM-DD-YYYY.

invoicePeriodStartDate

string (date-time)

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.

Valore Descrizione
Due
Locked
Other
OverDue
Paid
Void

InvoiceType

Tipo di fattura.

Valore Descrizione
AzureMarketplace
AzureServices
AzureSupport
Other

Payment

Pagamento con fattura.

Nome Tipo Descrizione
amount

Amount

Importo pagato.

date

string (date-time)

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.

Valore Descrizione
CheckWire
CreditCard
Credits
DirectDebit
EWallet
None
Other
TaskOrder

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 (date-time)

Data di approvazione del rimborso.

completedOn

string (date-time)

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 (date-time)

Data in cui è stato richiesto il rimborso.

transactionCount

integer (int32)

Numero di transazioni rimborsate.

RefundReasonCode

Motivo del rimborso.

Valore Descrizione
AccidentalConversion
AccidentalPurchase
ForgotToCancel
Other
UnclearDocumentation
UnclearPricing

RefundStatus

Stato della richiesta di rimborso.

Valore Descrizione
Approved
Cancelled
Completed
Declined
Expired
Other
Pending

SpecialTaxationType

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

Valore Descrizione
InvoiceLevel
SubtotalLevel

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 (date-time)

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 (date-time)

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.