Get-B2bRouterInvoices

ÜBERSICHT

Ruft Rechnungen aus einem B2Brouter-Account ab.

SYNTAX

Get-B2bRouterInvoices [-ApiKey] <string> [-AccountId] <int> [[-Type] <string>] [[-DateFrom]
    <datetime>] [[-DateTo] <datetime>] [[-AckFilter] <string>] [[-Offset] <int>] [[-Limit] <int>]
    [-Sandbox] [[-ApiVersion] <string>] [<CommonParameters>]

BESCHREIBUNG

Diese Funktion liest Rechnungen eines B2Brouter-Accounts über die REST-API aus.

Die Filterung erfolgt über das Einreichungsdatum (Submission Date). Standardmäßig wird nur ein Enddatum (date_to) gesetzt, um aktuelle Rechnungen zuverlässig zu erfassen.

Das Rechnungsdatum selbst kann über die API nicht gefiltert werden. Ein Startdatum (date_from) sollte nur explizit angegeben werden, da dieser Filter je nach API-Zustand Ergebnisse ausschließen kann.

Die zurückgegebenen Objekte enthalten die interne Invoice-ID, die für alle weiteren Operationen (Status, Versand, Details) benötigt wird.

PARAMETER

-ApiKey

Type: string

API-Schlüssel für den Zugriff auf die B2Brouter-API.

-AccountId

Type: int

Technische Account-ID (Kontokennung) bei B2Brouter.

-Type

Type: string
Default: 'IssuedInvoice'

Typ der Rechnungen. Default ist IssuedInvoice.

-DateFrom

Type: datetime

Optionales Startdatum für die Abfrage (Submission Date).

-DateTo

Type: datetime

Enddatum für die Abfrage (Submission Date). Wenn nicht angegeben, wird automatisch das aktuelle Datum verwendet.

-AckFilter

Type: string
Default: 'All'

Steuert, welche Rechnungen bezueglich Quittierung (ACK) angezeigt werden.

All : Zeigt alle Rechnungen (quittierte und nicht-quittierte). Erfordert zwei API-Aufrufe, die intern zusammengeführt werden.
Ack : Zeigt nur quittierte Rechnungen (ack=true).
NoAck : Zeigt nur nicht-quittierte Rechnungen. Default ist All.

Hinweis: Rechnungen, die über Send-B2bRouterInvoice importiert werden, sind automatisch quittiert. Ohne AckFilter='All' oder 'Ack' würden diese in der Auflistung fehlen.

-Offset

Type: int
Default: 0

Startoffset für Paging. Default ist 0.

-Limit

Type: int
Default: 25

Anzahl der Datensätze pro Abfrage. Default ist 25, Maximum 500.

-Sandbox

Type: switch

Verwendet die Staging-Umgebung (api-staging.b2brouter.net).

-ApiVersion

Type: string
Default: '2025-10-13'

Version der B2Brouter-API. Default ist 2025-10-13.

AUSGABEN

PSCustomObject (Invoice)

BEISPIELE

# Alle aktuellen ausgestellten Rechnungen abrufen
$apikey = '564985413527445612879'
$accountId = '12345'
Get-B2bRouterInvoices -ApiKey $apiKey -AccountId 254524 -Sandbox

# Rechnungen bis zu einem bestimmten Datum abrufen
$apikey = '564985413527445612879'
$accountId = '12345'
Get-B2bRouterInvoices -ApiKey $apiKey -AccountId 254524 -Sandbox `
  -DateTo '2026-05-01'

# Nur quittierte (ACK) Rechnungen abrufen
$apikey = '564985413527445612879'
$accountId = '12345'
Get-B2bRouterInvoices -ApiKey $apiKey -AccountId 254524 -Sandbox -AckFilter Ack

# Nur nicht-quittierte Rechnungen abrufen (Posteingang)
$apikey = '564985413527445612879'
$accountId = '12345'
Get-B2bRouterInvoices -ApiKey $apiKey -AccountId 254524 -Sandbox -AckFilter NoAck

# Ermittelt die interne B2Brouter-ID zu einer Rechnungsnummer.
# Die Abfrage erfolgt über das Uploaddatum (Submission Date),
# standardmaessig bis zum aktuellen Datum.
# Die ermittelte ID kann z.B. verwendet werden, um ein PDF anzuhängen.
$apiKey    = '564985413527445612879'
$accountId = '12345'

Get-B2bRouterInvoices -ApiKey $apiKey -AccountId $accountId -Sandbox |
  Where-Object Number -eq '20214914' |
  Select-Object -ExpandProperty Id