Invoices - Get

Referenz

Dienst:: Billing

API-Version:: 2024-04-01

Ruft eine Rechnung nach ID ab. Der Vorgang wird für alle Abrechnungskontotypen 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

Name	In	Erforderlich	Typ	Beschreibung
invoiceName	path	True	string	Die ID, die eine Rechnung eindeutig identifiziert. RegEx-Muster: `^(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})$`
api-version	query	True	string	Die Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2024-04-01.

invoiceName

path

True

string

Die ID, die eine Rechnung eindeutig identifiziert.

RegEx-Muster: ^(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})$

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

HTTP

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

Beispiel für eine Antwort

Statuscode:: 200

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

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

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.

Name	Typ	Beschreibung
DRS	string
ENF	string
Other	string

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	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.

Name	Typ	Beschreibung
BankDeclined	string
CardExpired	string
IncorrectCardDetails	string
Other	string

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	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.

Name	Typ	Beschreibung
CreditNote	string
Invoice	string
Other	string
Summary	string
TaxReceipt	string
Transactions	string
VoidNote	string

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	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	Das Datum, an dem die Rechnung generiert wurde.
invoicePeriodEndDate	string	Das Enddatum des Abrechnungszeitraums, für den die Rechnung generiert wird. Das Datum ist im MM-DD-YYYY Format.
invoicePeriodStartDate	string	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.

Name	Typ	Beschreibung
Due	string
Locked	string
Other	string
OverDue	string
Paid	string
Void	string

InvoiceType

Rechnungstyp.

Name	Typ	Beschreibung
AzureMarketplace	string
AzureServices	string
AzureSupport	string
Other	string

Payment

Eine Rechnungszahlung.

Name	Typ	Beschreibung
amount	Amount	Der bezahlte Betrag.
date	string	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.

Name	Typ	Beschreibung
CheckWire	string
CreditCard	string
Credits	string
DirectDebit	string
EWallet	string
None	string
Other	string
TaskOrder	string

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	Datum, an dem die Rückerstattung genehmigt wurde.
completedOn	string	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	Datum, an dem die Rückerstattung angefordert wurde.
transactionCount	integer	Die Anzahl der Transaktionen, die erstattet wurden.

RefundReasonCode

Der Grund für die Rückerstattung.

Name	Typ	Beschreibung
AccidentalConversion	string
AccidentalPurchase	string
ForgotToCancel	string
Other	string
UnclearDocumentation	string
UnclearPricing	string

RefundStatus

Der Status der Rückerstattungsanforderung.

Name	Typ	Beschreibung
Approved	string
Cancelled	string
Completed	string
Declined	string
Expired	string
Other	string
Pending	string

SpecialTaxationType

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

Name	Typ	Beschreibung
InvoiceLevel	string
SubtotalLevel	string

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	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	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.

Freigeben über