Method: customers.invoices.list

Gibt alle Rechnungen für einen bestimmten Monat zurück, die mit einer Abrechnungseinrichtung verknüpft sind.

Liste der ausgegebenen Fehler: AuthenticationError AuthorizationError FieldError HeaderError InternalError InvoiceError QuotaError RequestError

HTTP-Anfrage

GET https://googleads.googleapis.com/v14/customers/{customerId}/invoices

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die ID des Kunden, für den Rechnungen abgerufen werden sollen.

Abfrageparameter

Parameter
billingSetup

string

Erforderlich. Der Ressourcenname der Abrechnungseinrichtung der angeforderten Rechnungen.

customers/{customerId}/billingSetups/{billing_setup_id}
issueYear

string

Erforderlich. Das Ausstellungsjahr für den Abruf von Rechnungen im Format JJJJ. Es können nur Rechnungen abgerufen werden, die im Jahr 2019 oder später ausgestellt wurden.
issueMonth

enum (MonthOfYear)

Erforderlich. Der Ausstellungsmonat, in dem Rechnungen abgerufen werden sollen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für InvoiceService.ListInvoices.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "invoices": [
    {
      object (Invoice)
    }
  ]
}
Felder
invoices[]

object (Invoice)

Die Liste der Rechnungen, die der Abrechnungseinrichtung und dem Zeitraum entsprechen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/adwords

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

Rechnung

Eine Rechnung. Alle Rechnungsinformationen werden mit der PDF-Rechnung in einer Momentaufnahme angezeigt. Bei Rechnungen, die älter als die Einführung von InvoiceService sind, stimmen die Snapshot-Informationen möglicherweise nicht mit der PDF-Rechnung überein.

JSON-Darstellung 
{
  "resourceName": string,
  "type": enum (InvoiceType),
  "serviceDateRange": {
    object (DateRange)
  },
  "adjustmentsSubtotalAmountMicros": string,
  "adjustmentsTaxAmountMicros": string,
  "adjustmentsTotalAmountMicros": string,
  "regulatoryCostsSubtotalAmountMicros": string,
  "regulatoryCostsTaxAmountMicros": string,
  "regulatoryCostsTotalAmountMicros": string,
  "replacedInvoices": [
    string
  ],
  "accountBudgetSummaries": [
    {
      object (AccountBudgetSummary)
    }
  ],
  "accountSummaries": [
    {
      object (AccountSummary)
    }
  ],
  "id": string,
  "billingSetup": string,
  "paymentsAccountId": string,
  "paymentsProfileId": string,
  "issueDate": string,
  "dueDate": string,
  "currencyCode": string,
  "exportChargeSubtotalAmountMicros": string,
  "exportChargeTaxAmountMicros": string,
  "exportChargeTotalAmountMicros": string,
  "subtotalAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string,
  "correctedInvoice": string,
  "pdfUrl": string
}
Felder
resourceName

string

Nur Ausgabe Der Ressourcenname der Rechnung. Eine Rechnung kann von mehreren Kunden verwendet werden. Daher können mehrere Ressourcennamen auf dieselbe Rechnung verweisen. Namen von Rechnungsressourcen haben das folgende Format:

customers/{customerId}/invoices/{invoice_id}
type

enum (InvoiceType)

Nur Ausgabe Die Art der Rechnung.
serviceDateRange

object (DateRange)

Nur Ausgabe Der Zeitraum des Servicezeitraums dieser Rechnung. Das Enddatum ist eingeschlossen.
adjustmentsSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Die Zwischensumme der Zwischensumme der Vorsteuer für Korrekturen auf Rechnungsebene in Mikroeinheiten.
adjustmentsTaxAmountMicros

string (int64 format)

Nur Ausgabe Die Summe der Steuern auf Rechnungsebene in Mikros.
adjustmentsTotalAmountMicros

string (int64 format)

Nur Ausgabe Der Gesamtbetrag der Korrekturen auf Rechnungsebene in Mikroeinheiten.
regulatoryCostsSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Die Zwischensumme der Zwischensumme vor Steuern der regulatorischen Kosten auf Rechnungsebene in Mikros.
regulatoryCostsTaxAmountMicros

string (int64 format)

Nur Ausgabe Die Summe der Steuern für die regulatorischen Kosten auf Rechnungsebene in Mikroeinheiten.
regulatoryCostsTotalAmountMicros

string (int64 format)

Nur Ausgabe Der Gesamtbetrag der regulatorischen Kosten auf Rechnungsebene in Mikros.
replacedInvoices[]

string

Nur Ausgabe Der Ressourcenname der ursprünglichen Rechnung(en), die neu in Rechnung gestellt oder durch diese Rechnung ersetzt wird (falls zutreffend). Aufgrund der Konsolidierung von Rechnungen wurden möglicherweise mehrere Rechnungen ersetzt. Die ersetzten Rechnungen gehören möglicherweise nicht zum selben Zahlungskonto. Wenn replacedInvoices festgelegt ist, wird correctedInvoice nicht festgelegt. Namen von Rechnungsressourcen haben das folgende Format:

customers/{customerId}/invoices/{invoice_id}
accountBudgetSummaries[]

object (AccountBudgetSummary)

Nur Ausgabe Die Liste der zusammengefassten Informationen zum Kontobudget, die mit dieser Rechnung verknüpft sind.
accountSummaries[]

object (AccountSummary)

Nur Ausgabe Die Liste der zusammengefassten Kontoinformationen für diese Rechnung.
id

string

Nur Ausgabe Die ID der Rechnung. Sie wird auf der PDF-Rechnung als „Rechnungsnummer“ aufgeführt.
billingSetup

string

Nur Ausgabe Der Ressourcenname der Abrechnungseinrichtung dieser Rechnung.

customers/{customerId}/billingSetups/{billing_setup_id}
paymentsAccountId

string

Nur Ausgabe Eine 16-stellige ID zur Identifizierung des mit der Abrechnungseinrichtung verknüpften Zahlungskontos, z. B. „1234-5678-9012-3456“. Sie wird auf der PDF-Rechnung als „Rechnungskontonummer“ aufgeführt.
paymentsProfileId

string

Nur Ausgabe Eine 12-stellige ID zur Identifizierung des Zahlungsprofils, das mit der Abrechnungseinrichtung verknüpft ist, z. B. „1234-5678-9012“. Sie wird auf der PDF-Rechnung als „Abrechnungs-ID“ angegeben.
issueDate

string

Nur Ausgabe Ausstellungsdatum im Format JJJJ-MM-TT. Es wird auf der PDF-Rechnung als „Ausstellungsdatum“ oder „Rechnungsdatum“ angezeigt.
dueDate

string

Nur Ausgabe Das Fälligkeitsdatum im Format JJJJ-MM-TT.
currencyCode

string

Nur Ausgabe Der Währungscode. Alle Kosten werden in dieser Währung zurückgegeben. Ein Teil der Währungscodes, der von der Norm ISO 4217 abgeleitet wurde, wird unterstützt.
exportChargeSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Die Zwischensumme der Zwischensumme vor Steuern der Exportgebühren auf Rechnungsebene in Mikros.
exportChargeTaxAmountMicros

string (int64 format)

Nur Ausgabe Die Summe der Steuern auf Rechnungsebene für Exportgebühren, in Mikroeinheiten.
exportChargeTotalAmountMicros

string (int64 format)

Nur Ausgabe Der Gesamtbetrag der Exportgebühren auf Rechnungsebene in Mikros.
subtotalAmountMicros

string (int64 format)

Nur Ausgabe Die Zwischensumme vor Steuern in Mikroeinheiten. Dies entspricht der Summe der Zwischensummen der AccountBudgetSummary und der Invoice.adjustments_subtotal_amount_micros.
taxAmountMicros

string (int64 format)

Nur Ausgabe Die Summe aller Steuern auf der Rechnung in Mikros. Dies entspricht der Summe der Steuerbeträge von AccountBudgetSummary zuzüglich Steuern, die nicht mit einem bestimmten Kontobudget verknüpft sind.
totalAmountMicros

string (int64 format)

Nur Ausgabe Der Gesamtbetrag in Mikroeinheiten. Dies entspricht der Summe aus „Invoice.subtotal_amount_micros“, „Invoice.tax_amount_micros“, „Invoice.regulatory_costs_subtotal_amount_micros“ und „Invoice.export_charge_subtotal_amount_micros“. Diese sind in eine separate Position ab Version 14.1 aufgeteilt.
correctedInvoice

string

Nur Ausgabe Der Ressourcenname der ursprünglichen Rechnung, der gegebenenfalls durch diese Rechnung korrigiert, ausgebucht oder storniert wurde. Wenn correctedInvoice festgelegt ist, wird replacedInvoices nicht festgelegt. Namen von Rechnungsressourcen haben das folgende Format:

customers/{customerId}/invoices/{invoice_id}
pdfUrl

string

Nur Ausgabe Die URL zu einer PDF-Kopie der Rechnung. Nutzer müssen ihr OAuth-Token übergeben, um die PDF-Datei mit dieser URL anzufordern.

InvoiceType

Die mögliche Art der Rechnung.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
CREDIT_MEMO Eine Rechnung mit einem negativen Betrag. Das Konto erhält eine Gutschrift.
INVOICE Eine Rechnung mit einem positiven Betrag. Das Konto ist noch nicht beglichen.

AccountBudgetSummary

Zusammengefasste abrechenbare Kosten für das Kontobudget.

JSON-Darstellung 
{
  "billableActivityDateRange": {
    object (DateRange)
  },
  "invalidActivitySummaries": [
    {
      object (InvalidActivitySummary)
    }
  ],
  "customer": string,
  "customerDescriptiveName": string,
  "accountBudget": string,
  "accountBudgetName": string,
  "purchaseOrderNumber": string,
  "subtotalAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string,
  "servedAmountMicros": string,
  "billedAmountMicros": string,
  "overdeliveryAmountMicros": string,
  "invalidActivityAmountMicros": string
}
Felder
billableActivityDateRange

object (DateRange)

Nur Ausgabe Der Zeitraum für die abrechenbare Aktivität des Kontobudgets innerhalb des Zeitraums für die Bereitstellung dieser Rechnung. Das Enddatum ist eingeschlossen. Dieser Wert kann vom Beginn und Ende des Kontobudgets abweichen.
invalidActivitySummaries[]

object (InvalidActivitySummary)

Nur Ausgabe Liste der zusammengefassten Gutschriften für ungültige Aktivitäten mit ursprünglichen Verknüpfungen.
customer

string

Nur Ausgabe Der Ressourcenname des Kunden, der mit diesem Kontobudget verknüpft ist. Sie enthält die Kundennummer, die auf der PDF-Rechnung als „Account ID“ angezeigt wird. Namen von Kundenressourcen haben das folgende Format:

customers/{customerId}
customerDescriptiveName

string

Nur Ausgabe Der beschreibende Name des Kunden des Kontobudgets. Auf der PDF-Rechnung wird sie als „Konto“ angezeigt.
accountBudget

string

Nur Ausgabe Der Ressourcenname des Kontobudgets, das mit diesen zusammengefassten abrechenbaren Kosten verknüpft ist. Ressourcennamen vom Typ AccountBudget haben das folgende Format:

customers/{customerId}/accountBudgets/{account_budget_id}
accountBudgetName

string

Nur Ausgabe Der Name des Kontobudgets. In der PDF-Rechnung wird sie als „Kontobudget“ aufgeführt.
purchaseOrderNumber

string

Nur Ausgabe Die Auftragsnummer des Kontobudgets. Auf der PDF-Rechnung erscheint sie als „Auftrag“.
subtotalAmountMicros

string (int64 format)

Nur Ausgabe Die Zwischensumme vor Steuern, die diesem Budget während des Servicezeitraums zuzuordnen ist, in Mikroeinheiten.
taxAmountMicros

string (int64 format)

Nur Ausgabe Der Steuerbetrag, der während des Servicezeitraums auf dieses Budget zurückzuführen ist, in Mikroeinheiten.
totalAmountMicros

string (int64 format)

Nur Ausgabe Der Gesamtbetrag, der diesem Budget während des Servicezeitraums zuzuordnen ist, in Mikroeinheiten. Dies entspricht der Summe der Zwischensumme des Kontobudgets und der Steuerbeträge für das Kontobudget.
servedAmountMicros

string (int64 format)

Nur Ausgabe Der Betrag vor Steuern, der diesem Budget während des Servicezeitraums zugeordnet werden kann, in Mikrosekunden. Dies ist nur zum Abgleichen von Rechnungs- und Lieferdaten nützlich.
billedAmountMicros

string (int64 format)

Nur Ausgabe Der in Rechnung gestellte Betrag vor Steuern, der auf dieses Budget während des Servicezeitraums zurückzuführen ist, in Mikros. Hier werden keine Korrekturen berücksichtigt.
overdeliveryAmountMicros

string (int64 format)

Nur Ausgabe Der Betrag der Mehrauslieferung vor Steuern, der während des Servicezeitraums auf dieses Budget zurückzuführen ist, in Mikroeinheiten (negativer Wert).
invalidActivityAmountMicros

string (int64 format)

Nur Ausgabe Der Betrag der ungültigen Aktivitäten vor Steuern, der in den vergangenen Monaten auf dieses Budget zurückzuführen ist, in Mikroeinheiten (negativer Wert).

InvalidActivitySummary

Details zu ungültigen Aktivitäten für die Rechnung, die zusätzliche Informationen zur Rechnung enthalten, für die Korrekturen vorgenommen werden.

JSON-Darstellung 
{
  "originalMonthOfService": enum (MonthOfYear),
  "originalYearOfService": string,
  "originalInvoiceId": string,
  "originalAccountBudgetName": string,
  "originalPurchaseOrderNumber": string,
  "amountMicros": string
}
Felder
originalMonthOfService

enum (MonthOfYear)

Nur Ausgabe Ursprünglicher Dienst, in dem diese Gutschrift für ungültige Aktivitäten in Rechnung gestellt wurde.
originalYearOfService

string

Nur Ausgabe Das ursprüngliche Jahr, in dem der Dienst im Zusammenhang mit dieser Gutschrift für ungültige Aktivitäten genutzt wurde.
originalInvoiceId

string

Nur Ausgabe Ursprüngliche Rechnungsnummer für diese Gutschrift für ungültige Aktivitäten.
originalAccountBudgetName

string

Nur Ausgabe Der ursprüngliche Name des Kontobudgets, der mit dieser Gutschrift für ungültige Aktivitäten in Zusammenhang steht.
originalPurchaseOrderNumber

string

Nur Ausgabe Ursprüngliche Auftragsnummer, die mit dieser Gutschrift für ungültige Aktivitäten in Zusammenhang steht.
amountMicros

string (int64 format)

Nur Ausgabe Ungültige Aktivitätsmenge in Mikrosekunden.

AccountSummary

Eine Übersicht auf Kontoebene

JSON-Darstellung 
{
  "customer": string,
  "billingCorrectionSubtotalAmountMicros": string,
  "billingCorrectionTaxAmountMicros": string,
  "billingCorrectionTotalAmountMicros": string,
  "couponAdjustmentSubtotalAmountMicros": string,
  "couponAdjustmentTaxAmountMicros": string,
  "couponAdjustmentTotalAmountMicros": string,
  "excessCreditAdjustmentSubtotalAmountMicros": string,
  "excessCreditAdjustmentTaxAmountMicros": string,
  "excessCreditAdjustmentTotalAmountMicros": string,
  "regulatoryCostsSubtotalAmountMicros": string,
  "regulatoryCostsTaxAmountMicros": string,
  "regulatoryCostsTotalAmountMicros": string,
  "exportChargeSubtotalAmountMicros": string,
  "exportChargeTaxAmountMicros": string,
  "exportChargeTotalAmountMicros": string,
  "subtotalAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string
}
Felder
customer

string

Nur Ausgabe Das mit der Kontoübersicht verknüpfte Konto.
billingCorrectionSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Zwischensumme der Abrechnungskorrektur vor Steuern in Mikros.
billingCorrectionTaxAmountMicros

string (int64 format)

Nur Ausgabe Steuer auf Rechnungskorrektur in Mikroeinheiten.
billingCorrectionTotalAmountMicros

string (int64 format)

Nur Ausgabe Gesamtrechnungskorrekturbetrag in Mikros.
couponAdjustmentSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Zwischensumme des Gutschein-Korrekturbetrags vor Steuern in Mikros.
couponAdjustmentTaxAmountMicros

string (int64 format)

Nur Ausgabe Steuer auf Gutscheinkorrekturen in Mikroeinheiten.
couponAdjustmentTotalAmountMicros

string (int64 format)

Nur Ausgabe Gesamtbetrag der Gutscheinanpassung in Mikros.
excessCreditAdjustmentSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Zwischensumme der Überschreitung der Gutschriftkorrektur vor Steuern in Mikros.
excessCreditAdjustmentTaxAmountMicros

string (int64 format)

Nur Ausgabe Steuer auf übermäßige Gutschriftkorrektur in Mikroeinheiten.
excessCreditAdjustmentTotalAmountMicros

string (int64 format)

Nur Ausgabe Überschüssiger Gutschriftkorrekturbetrag in Mikros.
regulatoryCostsSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Zwischensumme der Zwischensumme der gesetzlichen Kosten vor Steuern in Mikros.
regulatoryCostsTaxAmountMicros

string (int64 format)

Nur Ausgabe Steuer auf behördliche Kosten, in Mikroeinheiten.
regulatoryCostsTotalAmountMicros

string (int64 format)

Nur Ausgabe Gesamtbetrag der regulatorischen Kosten in Mikros.
exportChargeSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Zwischensumme der Zwischensumme der Exportgebühr vor Steuern in Mikros.
exportChargeTaxAmountMicros

string (int64 format)

Nur Ausgabe Steuer auf die Ausfuhrabgabe in Mikroeinheiten.
exportChargeTotalAmountMicros

string (int64 format)

Nur Ausgabe Gesamtbetrag der Exportgebühr in Mikroeinheiten.
subtotalAmountMicros

string (int64 format)

Nur Ausgabe Gesamtzwischensumme vor Steuern, die dem Konto während des Servicezeitraums zuzuordnen ist, in Mikroeinheiten.
taxAmountMicros

string (int64 format)

Nur Ausgabe Der gesamte Steuerbetrag, der dem Konto während des Servicezeitraums zuzuordnen ist, in Mikroeinheiten.
totalAmountMicros

string (int64 format)

Nur Ausgabe Der dem Konto während des Nutzungszeitraums zuzuordnende Gesamtbetrag in Mikrosekunden. Dies entspricht der Summe der subtotalAmountMicros und taxAmountMicros.