Invoices - Get By Billing Account

Service:

Billing

API-versie:

2024-04-01

Hiermee haalt u een factuur op op basis van de naam en id van de factureringsrekening. De bewerking wordt ondersteund voor factureringsaccounts met het overeenkomsttype Microsoft Partner-overeenkomst of Microsoft-klantovereenkomst.

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

URI-parameters

Name	In	Vereist	Type	Description
billingAccountName	path	True	string	De id waarmee een factureringsrekening uniek wordt geïdentificeerd. Regex-patroon: ^([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})?)$
invoiceName	path	True	string	De id waarmee een factuur uniek wordt geïdentificeerd. Regex-patroon: ^(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	De versie van de API die moet worden gebruikt met de clientaanvraag. De huidige versie is 2024-04-01.

Antwoorden

Name	Type	Description
200 OK	Invoice	De lijst met facturen.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Voorbeelden

InvoicesGetByBillingAccount

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/invoices/G123456789?api-version=2024-04-01

Voorbeeldrespons

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

Definities

Name	Description
Amount	Het bedrag.
AmountDue	Het verschuldigde bedrag vanaf nu.
AmountRefunded	Het bedrag is terugbetaald.
AmountRequested	Het aangevraagde restitutiebedrag.
AzurePrepaymentApplied	Het bedrag van de Azure-vooruitbetaling die is toegepast op de kosten. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.
BilledAmount	De totale kosten voor de factuurfactureringsperiode.
createdByType	Het type identiteit waarmee de resource is gemaakt.
CreditAmount	De totale restitutie voor retouren en annuleringen tijdens de factuurfactureringsperiode. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.
DocumentSource	De bron van het document. ENF voor Brazilië en DRS voor de rest van de wereld.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
FailedPayment	Een mislukte betaling.
FailedPaymentReason	De reden dat de betaling is mislukt.
FreeAzureCreditApplied	Het bedrag van het gratis Azure-tegoed dat is toegepast op de kosten. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.
Invoice	Een factuur.
InvoiceDocument	De eigenschappen van een document.
InvoiceDocumentType	Het type document.
InvoiceProperties	Een factuur.
InvoiceStatus	De huidige status van de factuur.
InvoiceType	Factuurtype.
Payment	Een factuurbetaling.
PaymentMethodFamily	De familie van de betalingswijze.
RebillDetails	De herfactureren gegevens van een factuur.
RefundDetails	De details van een restitutieaanvraag.
RefundReasonCode	De reden voor terugbetaling.
RefundStatus	De status van de restitutieaanvraag.
SpecialTaxationType	Hiermee geeft u het type belastingberekening aan dat voor de factuur wordt gebruikt. Het veld is alleen van toepassing op facturen met speciale belastingberekeningslogica.
SubTotal	Het verschuldigde voorbelastingbedrag. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
TaxAmount	Het belastingbedrag dat in rekening wordt gebracht voor de factureringsperiode. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.
TotalAmount	Het verschuldigde bedrag toen de factuur werd gegenereerd. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.

Amount

Het bedrag.

Name	Type	Description
currency	string	De valuta voor de waarde van het bedrag.
value	number	De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00.

AmountDue

Het verschuldigde bedrag vanaf nu.

Name	Type	Description
currency	string	De valuta voor de waarde van het bedrag.
value	number	De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00.

AmountRefunded

Het bedrag is terugbetaald.

Name	Type	Description
currency	string	De valuta voor de waarde van het bedrag.
value	number	De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00.

AmountRequested

Het aangevraagde restitutiebedrag.

Name	Type	Description
currency	string	De valuta voor de waarde van het bedrag.
value	number	De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00.

AzurePrepaymentApplied

Het bedrag van de Azure-vooruitbetaling die is toegepast op de kosten. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.

Name	Type	Description
currency	string	De valuta voor de waarde van het bedrag.
value	number	De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00.

BilledAmount

De totale kosten voor de factuurfactureringsperiode.

Name	Type	Description
currency	string	De valuta voor de waarde van het bedrag.
value	number	De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CreditAmount

De totale restitutie voor retouren en annuleringen tijdens de factuurfactureringsperiode. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.

Name	Type	Description
currency	string	De valuta voor de waarde van het bedrag.
value	number	De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00.

DocumentSource

De bron van het document. ENF voor Brazilië en DRS voor de rest van de wereld.

Name	Type	Description
DRS	string
ENF	string
Other	string

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

FailedPayment

Een mislukte betaling.

Name	Type	Description
date	string	De datum waarop de betaling is geprobeerd.
failedPaymentReason	FailedPaymentReason	De reden dat de betaling is mislukt.

FailedPaymentReason

De reden dat de betaling is mislukt.

Name	Type	Description
BankDeclined	string
CardExpired	string
IncorrectCardDetails	string
Other	string

FreeAzureCreditApplied

Het bedrag van het gratis Azure-tegoed dat is toegepast op de kosten. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.

Name	Type	Description
currency	string	De valuta voor de waarde van het bedrag.
value	number	De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00.

Invoice

Een factuur.

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
name	string	De naam van de resource
properties	InvoiceProperties	Een factuur.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Woordenlijst met metagegevens die zijn gekoppeld aan de resource. Deze kan niet worden ingevuld voor alle resourcetypen. Maximale lengte van sleutel/waarde die wordt ondersteund door 256 tekens. Sleutels/waarde mogen geen lege waarde of null zijn. Sleutels kunnen geen <> % & \ bevatten? /
type	string	Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

InvoiceDocument

De eigenschappen van een document.

Name	Type	Description
documentNumbers	string[]	De documentnummers voor het factuurdocument.
externalUrl	string	De URL voor het downloaden van het factuurdocument als de bron zich buiten Microsoft.Billing bevindt.
kind	InvoiceDocumentType	Het type document.
name	string	De id waarmee een factuurdocument uniek wordt geïdentificeerd. Deze id kan een id zijn voor een pdf-factuur, een creditnota of een btw-ontvangstbewijs.
source	DocumentSource	De bron van het document. ENF voor Brazilië en DRS voor de rest van de wereld.
url	string	De URL voor het downloaden van het factuurdocument als de bron intern is voor Microsoft.Billing.

InvoiceDocumentType

Het type document.

Name	Type	Description
CreditNote	string
Invoice	string
Other	string
Summary	string
TaxReceipt	string
Transactions	string
VoidNote	string

InvoiceProperties

Een factuur.

Name	Type	Description
amountDue	AmountDue	Het verschuldigde bedrag vanaf nu.
azurePrepaymentApplied	AzurePrepaymentApplied	Het bedrag van de Azure-vooruitbetaling die is toegepast op de kosten. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.
billedAmount	BilledAmount	De totale kosten voor de factuurfactureringsperiode.
billedDocumentId	string	De id van de actieve factuur die oorspronkelijk wordt gefactureerd nadat deze factuur is geannuleerd. Dit veld is alleen van toepassing op de ongeldige facturen.
billingProfileDisplayName	string	De naam van het factureringsprofiel waarvoor de factuur wordt gegenereerd.
billingProfileId	string	De id van het factureringsprofiel waarvoor de factuur wordt gegenereerd.
creditAmount	CreditAmount	De totale restitutie voor retouren en annuleringen tijdens de factuurfactureringsperiode. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.
creditForDocumentId	string	De id van de factuur die ongeldig is geworden en deze creditnota is als gevolg hiervan uitgegeven. Dit veld is alleen van toepassing op de creditnota's.
documentType	InvoiceDocumentType	Het type document.
documents	InvoiceDocument[]	Lijst met documenten die beschikbaar zijn om te downloaden en weer te geven, zoals factuur, creditnota of btw-ontvangstbewijs.
dueDate	string	De vervaldatum voor de factuur.
failedPayments	FailedPayment[]	Lijst met mislukte betalingen.
freeAzureCreditApplied	FreeAzureCreditApplied	Het bedrag van het gratis Azure-tegoed dat is toegepast op de kosten. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.
invoiceDate	string	De datum waarop de factuur is gegenereerd.
invoicePeriodEndDate	string	De einddatum van de factureringsperiode waarvoor de factuur wordt gegenereerd. De datum heeft de notatie MM-DD-YYYY.
invoicePeriodStartDate	string	De begindatum van de factureringsperiode waarvoor de factuur wordt gegenereerd. De datum heeft de notatie MM-DD-YYYY.
invoiceType	InvoiceType	Factuurtype.
isMonthlyInvoice	boolean	Hiermee geeft u op of de factuur wordt gegenereerd als onderdeel van de maandelijkse factureringscyclus of niet. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.
payments	Payment[]	Lijst met betalingen.
purchaseOrderNumber	string	Een optioneel inkoopordernummer voor de factuur.
rebillDetails	RebillDetails	Herfactureren van gegevens voor een factuur.
refundDetails	RefundDetails	De details van een restitutieaanvraag.
specialTaxationType	SpecialTaxationType	Hiermee geeft u het type belastingberekening aan dat voor de factuur wordt gebruikt. Het veld is alleen van toepassing op facturen met speciale belastingberekeningslogica.
status	InvoiceStatus	De huidige status van de factuur.
subTotal	SubTotal	Het verschuldigde voorbelastingbedrag. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.
subscriptionDisplayName	string	De naam van het factureringsabonnement waarvoor de factuur wordt gegenereerd.
subscriptionId	string	De id van het abonnement waarvoor de factuur wordt gegenereerd.
taxAmount	TaxAmount	Het belastingbedrag dat in rekening wordt gebracht voor de factureringsperiode. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.
totalAmount	TotalAmount	Het verschuldigde bedrag toen de factuur werd gegenereerd. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.

InvoiceStatus

De huidige status van de factuur.

Name	Type	Description
Due	string
Locked	string
Other	string
OverDue	string
Paid	string
Void	string

InvoiceType

Factuurtype.

Name	Type	Description
AzureMarketplace	string
AzureServices	string
AzureSupport	string
Other	string

Payment

Een factuurbetaling.

Name	Type	Description
amount	Amount	Het betaalde bedrag.
date	string	De datum waarop de betaling is verricht.
paymentMethodFamily	PaymentMethodFamily	De familie van de betalingswijze.
paymentMethodId	string	De id waarmee de betalingswijze die voor de factuur wordt gebruikt, uniek wordt geïdentificeerd.
paymentMethodType	string	Het type betalingswijze.
paymentType	string	Het type betaling.

PaymentMethodFamily

De familie van de betalingswijze.

Name	Type	Description
CheckWire	string
CreditCard	string
Credits	string
DirectDebit	string
EWallet	string
None	string
Other	string
TaskOrder	string

RebillDetails

De herfactureren gegevens van een factuur.

Name	Type	Description
creditNoteDocumentId	string	De id van de creditnota.
invoiceDocumentId	string	De id van de factuur.
rebillDetails	RebillDetails	De herfactureren gegevens van een factuur.

RefundDetails

De details van een restitutieaanvraag.

Name	Type	Description
amountRefunded	AmountRefunded	Het bedrag is terugbetaald.
amountRequested	AmountRequested	Het aangevraagde restitutiebedrag.
approvedOn	string	Datum waarop de restitutie is goedgekeurd.
completedOn	string	Datum waarop de terugbetaling is voltooid.
rebillInvoiceId	string	De factuur-id van de opnieuw gefactureerde factuur voor een restitutie.
refundOperationId	string	De id van de restitutiebewerking.
refundReason	RefundReasonCode	De reden voor terugbetaling.
refundStatus	RefundStatus	De status van de restitutieaanvraag.
requestedOn	string	De datum waarop de restitutie is aangevraagd.
transactionCount	integer	Het aantal transacties dat is terugbetaald.

RefundReasonCode

De reden voor terugbetaling.

Name	Type	Description
AccidentalConversion	string
AccidentalPurchase	string
ForgotToCancel	string
Other	string
UnclearDocumentation	string
UnclearPricing	string

RefundStatus

De status van de restitutieaanvraag.

Name	Type	Description
Approved	string
Cancelled	string
Completed	string
Declined	string
Expired	string
Other	string
Pending	string

SpecialTaxationType

Hiermee geeft u het type belastingberekening aan dat voor de factuur wordt gebruikt. Het veld is alleen van toepassing op facturen met speciale belastingberekeningslogica.

Name	Type	Description
InvoiceLevel	string
SubtotalLevel	string

SubTotal

Het verschuldigde voorbelastingbedrag. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.

Name	Type	Description
currency	string	De valuta voor de waarde van het bedrag.
value	number	De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

TaxAmount

Het belastingbedrag dat in rekening wordt gebracht voor de factureringsperiode. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.

Name	Type	Description
currency	string	De valuta voor de waarde van het bedrag.
value	number	De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00.

TotalAmount

Het verschuldigde bedrag toen de factuur werd gegenereerd. Dit veld is van toepassing op factureringsaccounts met het type Microsoft-klantovereenkomst.

Name	Type	Description
currency	string	De valuta voor de waarde van het bedrag.
value	number	De waarde van het bedrag. Als de valuta bijvoorbeeld USD is, is een waarde van 600 $ 600,00.