Get-PeppolParticipantFromId

EulandaXtools — Funktionsreferenz

Get-PeppolParticipantFromId

ÜBERSICHT

Ermittelt den registrierten Firmennamen zu einer Peppol Participant ID.

SYNTAX

Get-PeppolParticipantFromId [-ParticipantId] <string> [[-DirectoryBaseUri] <string>]
    [-IncludeCountryCode] [[-RetryCount] <int>] [[-RetryDelayMs] <int>] [-FailIfNotFound]
    [<CommonParameters>]

BESCHREIBUNG

Fragt das öffentliche Peppol Directory über den /search/1.0/json Endpoint ab und gibt den registrierten Participant-Namen zurück.

Beispiel für eine Participant ID: 'iso6523-actorid-upis::9930:de113835378'

Optional kann zusätzlich der Ländercode ausgegeben werden, z.B.: "EULANDA Software GmbH (DE)"

PARAMETER

-ParticipantId

Type: string

Vollständige Peppol Participant ID inklusive Scheme. Beispiel: 'iso6523-actorid-upis::9930:de113835378'

-DirectoryBaseUri

Type: string
Default: 'https://directory.peppol.eu'

Basis-URL des Peppol Directory. Standard: https://directory.peppol.eu

-IncludeCountryCode

Type: switch

Wenn gesetzt, wird der CountryCode in Klammern an den Namen angehängt.

-RetryCount

Type: int
Default: 3

Anzahl Wiederholungen bei HTTP 429 (Rate Limit). Standard: 3

-RetryDelayMs

Type: int
Default: 650

Wartezeit zwischen Wiederholungen in Millisekunden. Standard: 650

-FailIfNotFound

Type: switch

Wenn gesetzt, wird bei nicht existierender oder ungültiger Participant ID ein Fehler ausgelöst.

AUSGABEN

System.String

BEISPIELE

# Namen zu einer Peppol Participant ID ermitteln
Get-PeppolParticipantFromId -ParticipantId 'iso6523-actorid-upis::9930:de113835378'
# Namen inklusive Ländercode ausgeben
Get-PeppolParticipantFromId `
  -ParticipantId 'iso6523-actorid-upis::9930:de113835378' `
  -IncludeCountryCode
# Exception auslösen, wenn die ID nicht existiert
Get-PeppolParticipantFromId `
  -ParticipantId 'iso6523-actorid-upis::9999:doesnotexist' `
  -FailIfNotFound