Freigeben über


Invoices - Get

Ruft eine Rechnung nach ID ab. Der Vorgang wird für Abrechnungskonten mit dem Vertragstyp Microsoft Partner Agreement oder Microsoft Customer Agreement unterstützt.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
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})$

Die ID, die eine Rechnung eindeutig identifiziert.

api-version
query True

string

Die Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2024-04-01.

Antworten

Name Typ Beschreibung
200 OK

Invoice

Eine Rechnung.

Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

InvoicesGet

Beispielanforderung

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

Beispiel für eine Antwort

{
  "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"
}

Definitionen

Name Beschreibung
Amount

Der Betrag.

AmountDue

Der fällige Betrag ab sofort.

AmountRefunded

Der Erstattungsbetrag.

AmountRequested

Der Betrag der angeforderten Rückerstattung.

AzurePrepaymentApplied

Der Betrag der Azure-Vorzahlung auf die Gebühren. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

BilledAmount

Die Gesamtgebühren für den Abrechnungszeitraum der Rechnung.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

CreditAmount

Die Gesamterstattung für Rückgaben und Stornierungen während des Abrechnungszeitraums der Rechnung. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

DocumentSource

Die Quelle des Dokuments. ENF für Brasilien und DRS für den Rest der Welt.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

FailedPayment

Eine fehlgeschlagene Zahlung.

FailedPaymentReason

Der Grund, warum die Zahlung fehlgeschlagen ist.

FreeAzureCreditApplied

Der Betrag der kostenlosen Azure-Gutschriften, die auf die Gebühren angewendet wurden. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

Invoice

Eine Rechnung.

InvoiceDocument

Die Eigenschaften eines Dokuments.

InvoiceDocumentType

Der Typ des Dokuments.

InvoiceProperties

Eine Rechnung.

InvoiceStatus

Der aktuelle Status der Rechnung.

InvoiceType

Rechnungstyp.

Payment

Eine Rechnungszahlung.

PaymentMethodFamily

Die Familie der Zahlungsmethode.

RebillDetails

Die Abrechnungsdetails einer Rechnung.

RefundDetails

Die Details einer Rückerstattungsanforderung.

RefundReasonCode

Der Grund für die Rückerstattung.

RefundStatus

Der Status der Rückerstattungsanforderung.

SpecialTaxationType

Gibt die Art der Steuerberechnung an, die für die Rechnung verwendet wird. Das Feld gilt nur für Rechnungen mit spezieller Steuerberechnungslogik.

SubTotal

Der fällige Vorsteuerbetrag. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

TaxAmount

Der Für den Abrechnungszeitraum berechnete Steuerbetrag. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

TotalAmount

Der fällige Betrag, wenn die Rechnung generiert wurde. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

Amount

Der Betrag.

Name Typ Beschreibung
currency

string

Die Währung für den Betragswert.

value

number

Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00.

AmountDue

Der fällige Betrag ab sofort.

Name Typ Beschreibung
currency

string

Die Währung für den Betragswert.

value

number

Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00.

AmountRefunded

Der Erstattungsbetrag.

Name Typ Beschreibung
currency

string

Die Währung für den Betragswert.

value

number

Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00.

AmountRequested

Der Betrag der angeforderten Rückerstattung.

Name Typ Beschreibung
currency

string

Die Währung für den Betragswert.

value

number

Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00.

AzurePrepaymentApplied

Der Betrag der Azure-Vorzahlung auf die Gebühren. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

Name Typ Beschreibung
currency

string

Die Währung für den Betragswert.

value

number

Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00.

BilledAmount

Die Gesamtgebühren für den Abrechnungszeitraum der Rechnung.

Name Typ Beschreibung
currency

string

Die Währung für den Betragswert.

value

number

Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Wert Beschreibung
Application
Key
ManagedIdentity
User

CreditAmount

Die Gesamterstattung für Rückgaben und Stornierungen während des Abrechnungszeitraums der Rechnung. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

Name Typ Beschreibung
currency

string

Die Währung für den Betragswert.

value

number

Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00.

DocumentSource

Die Quelle des Dokuments. ENF für Brasilien und DRS für den Rest der Welt.

Wert Beschreibung
DRS
ENF
Other

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

FailedPayment

Eine fehlgeschlagene Zahlung.

Name Typ Beschreibung
date

string (date-time)

Das Datum, an dem die Zahlung versucht wurde.

failedPaymentReason

FailedPaymentReason

Der Grund, warum die Zahlung fehlgeschlagen ist.

FailedPaymentReason

Der Grund, warum die Zahlung fehlgeschlagen ist.

Wert Beschreibung
BankDeclined
CardExpired
IncorrectCardDetails
Other

FreeAzureCreditApplied

Der Betrag der kostenlosen Azure-Gutschriften, die auf die Gebühren angewendet wurden. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

Name Typ Beschreibung
currency

string

Die Währung für den Betragswert.

value

number

Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00.

Invoice

Eine Rechnung.

Name Typ Beschreibung
id

string (arm-id)

Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Der Name der Ressource

properties

InvoiceProperties

Eine Rechnung.

systemData

systemData

Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.

tags

object

Wörterbuch der Metadaten, die der Ressource zugeordnet sind. Möglicherweise wird sie nicht für alle Ressourcentypen aufgefüllt. Maximale Schlüssel-/Wertlänge unterstützt von 256 Zeichen. Schlüssel/Wert dürfen keinen leeren Wert oder null sein. Schlüssel können nicht <> % & \ enthalten? /

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

InvoiceDocument

Die Eigenschaften eines Dokuments.

Name Typ Beschreibung
documentNumbers

string[]

Die Dokumentnummern für das Rechnungsdokument.

externalUrl

string

Die URL zum Herunterladen des Rechnungsdokuments, wenn die Quelle nicht zu Microsoft.Billing gehört.

kind

InvoiceDocumentType

Der Typ des Dokuments.

name

string

Die ID, die ein Rechnungsdokument eindeutig identifiziert. Diese ID kann ein Bezeichner für eine PDF-Rechnung, eine Gutschrift oder ein Steuerbeleg sein.

source

DocumentSource

Die Quelle des Dokuments. ENF für Brasilien und DRS für den Rest der Welt.

url

string

Die URL zum Herunterladen des Rechnungsdokuments, wenn die Quelle für Microsoft.Billing intern ist.

InvoiceDocumentType

Der Typ des Dokuments.

Wert Beschreibung
CreditNote
Invoice
Other
Summary
TaxReceipt
Transactions
VoidNote

InvoiceProperties

Eine Rechnung.

Name Typ Beschreibung
amountDue

AmountDue

Der fällige Betrag ab sofort.

azurePrepaymentApplied

AzurePrepaymentApplied

Der Betrag der Azure-Vorzahlung auf die Gebühren. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

billedAmount

BilledAmount

Die Gesamtgebühren für den Abrechnungszeitraum der Rechnung.

billedDocumentId

string

Die ID der aktiven Rechnung, die ursprünglich nach der Ungültigkeit dieser Rechnung in Rechnung gestellt wurde. Dieses Feld gilt nur für die ungültigen Rechnungen.

billingProfileDisplayName

string

Der Name des Abrechnungsprofils, für das die Rechnung generiert wird.

billingProfileId

string

Die ID des Abrechnungsprofils, für das die Rechnung generiert wird.

creditAmount

CreditAmount

Die Gesamterstattung für Rückgaben und Stornierungen während des Abrechnungszeitraums der Rechnung. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

creditForDocumentId

string

Die ID der Rechnung, die ungültig wurde und diese Gutschrift als Ergebnis ausgegeben wurde. Dieses Feld gilt nur für die Gutschrift.

documentType

InvoiceDocumentType

Der Typ des Dokuments.

documents

InvoiceDocument[]

Liste der Dokumente, die zum Herunterladen und Anzeigen verfügbar sind, z. B. Rechnung, Gutschrift oder Steuerbeleg.

dueDate

string (date-time)

Das Fälligkeitsdatum für die Rechnung.

failedPayments

FailedPayment[]

Liste der fehlgeschlagenen Zahlungen.

freeAzureCreditApplied

FreeAzureCreditApplied

Der Betrag der kostenlosen Azure-Gutschriften, die auf die Gebühren angewendet wurden. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

invoiceDate

string (date-time)

Das Datum, an dem die Rechnung generiert wurde.

invoicePeriodEndDate

string (date-time)

Das Enddatum des Abrechnungszeitraums, für den die Rechnung generiert wird. Das Datum ist im MM-DD-YYYY Format.

invoicePeriodStartDate

string (date-time)

Das Startdatum des Abrechnungszeitraums, für den die Rechnung generiert wird. Das Datum ist im MM-DD-YYYY Format.

invoiceType

InvoiceType

Rechnungstyp.

isMonthlyInvoice

boolean

Gibt an, ob die Rechnung als Teil des monatlichen Rechnungszyklus generiert wird oder nicht. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

payments

Payment[]

Liste der Zahlungen.

purchaseOrderNumber

string

Eine optionale Bestellnummer für die Rechnung.

rebillDetails

RebillDetails

Abrechnungsdetails für eine Rechnung.

refundDetails

RefundDetails

Die Details einer Rückerstattungsanforderung.

specialTaxationType

SpecialTaxationType

Gibt die Art der Steuerberechnung an, die für die Rechnung verwendet wird. Das Feld gilt nur für Rechnungen mit spezieller Steuerberechnungslogik.

status

InvoiceStatus

Der aktuelle Status der Rechnung.

subTotal

SubTotal

Der fällige Vorsteuerbetrag. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

subscriptionDisplayName

string

Der Name des Abrechnungsabonnements, für das die Rechnung generiert wird.

subscriptionId

string

Die ID des Abonnements, für das die Rechnung generiert wird.

taxAmount

TaxAmount

Der Für den Abrechnungszeitraum berechnete Steuerbetrag. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

totalAmount

TotalAmount

Der fällige Betrag, wenn die Rechnung generiert wurde. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

InvoiceStatus

Der aktuelle Status der Rechnung.

Wert Beschreibung
Due
Locked
Other
OverDue
Paid
Void

InvoiceType

Rechnungstyp.

Wert Beschreibung
AzureMarketplace
AzureServices
AzureSupport
Other

Payment

Eine Rechnungszahlung.

Name Typ Beschreibung
amount

Amount

Der bezahlte Betrag.

date

string (date-time)

Das Datum, an dem die Zahlung getätigt wurde.

paymentMethodFamily

PaymentMethodFamily

Die Familie der Zahlungsmethode.

paymentMethodId

string

Die ID, die die für die Rechnung verwendete Zahlungsmethode eindeutig identifiziert.

paymentMethodType

string

Die Art der Zahlungsmethode.

paymentType

string

Die Art der Zahlung.

PaymentMethodFamily

Die Familie der Zahlungsmethode.

Wert Beschreibung
CheckWire
CreditCard
Credits
DirectDebit
EWallet
None
Other
TaskOrder

RebillDetails

Die Abrechnungsdetails einer Rechnung.

Name Typ Beschreibung
creditNoteDocumentId

string

Die ID der Gutschrift.

invoiceDocumentId

string

Die ID der Rechnung.

rebillDetails

RebillDetails

Die Abrechnungsdetails einer Rechnung.

RefundDetails

Die Details einer Rückerstattungsanforderung.

Name Typ Beschreibung
amountRefunded

AmountRefunded

Der Erstattungsbetrag.

amountRequested

AmountRequested

Der Betrag der angeforderten Rückerstattung.

approvedOn

string (date-time)

Datum, an dem die Rückerstattung genehmigt wurde.

completedOn

string (date-time)

Datum, an dem die Rückerstattung abgeschlossen wurde.

rebillInvoiceId

string

Die Rechnungs-ID der Rechnung für eine Rückerstattung.

refundOperationId

string

Die ID des Erstattungsvorgangs.

refundReason

RefundReasonCode

Der Grund für die Rückerstattung.

refundStatus

RefundStatus

Der Status der Rückerstattungsanforderung.

requestedOn

string (date-time)

Datum, an dem die Rückerstattung angefordert wurde.

transactionCount

integer (int32)

Die Anzahl der Transaktionen, die erstattet wurden.

RefundReasonCode

Der Grund für die Rückerstattung.

Wert Beschreibung
AccidentalConversion
AccidentalPurchase
ForgotToCancel
Other
UnclearDocumentation
UnclearPricing

RefundStatus

Der Status der Rückerstattungsanforderung.

Wert Beschreibung
Approved
Cancelled
Completed
Declined
Expired
Other
Pending

SpecialTaxationType

Gibt die Art der Steuerberechnung an, die für die Rechnung verwendet wird. Das Feld gilt nur für Rechnungen mit spezieller Steuerberechnungslogik.

Wert Beschreibung
InvoiceLevel
SubtotalLevel

SubTotal

Der fällige Vorsteuerbetrag. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

Name Typ Beschreibung
currency

string

Die Währung für den Betragswert.

value

number

Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Typ Beschreibung
createdAt

string (date-time)

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string (date-time)

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.

TaxAmount

Der Für den Abrechnungszeitraum berechnete Steuerbetrag. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

Name Typ Beschreibung
currency

string

Die Währung für den Betragswert.

value

number

Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00.

TotalAmount

Der fällige Betrag, wenn die Rechnung generiert wurde. Dieses Feld gilt für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag.

Name Typ Beschreibung
currency

string

Die Währung für den Betragswert.

value

number

Der Betragswert. Wenn die Währung beispielsweise USD ist, wäre ein Wert von 600 $ 600,00.