eConnect bietet SDKs und Client-Bibliotheken an, mit denen Sie schneller in die PSB API integrieren können. Darüber hinaus können Sie die OpenAPI-Spezifikation (swagger.json) verwenden, um selbst einen Client in nahezu jeder Programmiersprache zu generieren.

Zwei offiziell unterstützte SDKs sind auf GitHub verfügbar, unter der Organisation theinvoicingcompany:

Beide SDKs kapseln die PSB REST API und bieten typisierte Methoden für die häufigsten Operationen: Authentifizierung, Rechnungen senden und empfangen, Hooks verwalten und Parteidaten abfragen.

Das .NET SDK ist als NuGet-Paket verfügbar. Nach der Installation können Sie sich mit wenigen Zeilen Code authentifizieren und Ihren ersten API-Aufruf durchführen.

// Authentifizierung und erster Aufruf mit dem .NET SDK
var client = new PsbClient(new PsbClientOptions
{
    ClientId = "Ihre-client-id",
    ClientSecret = "Ihr-client-secret",
    BaseUrl = "https://accp-psb.econnect.eu",
    IdentityUrl = "https://accp-identity.econnect.eu"
});

var me = await client.GetMeAsync();
Console.WriteLine($"Account: {me.Name}");

Tipp: Verwenden Sie während der Entwicklung die Akzeptanz-URLs (accp-psb und accp-identity). Wechseln Sie zu den Produktions-URLs, wenn Sie live gehen.

Das PHP SDK wird über Composer installiert. Das SDK übernimmt das OAuth-Tokenmanagement automatisch, sodass Sie sich auf die Geschäftslogik konzentrieren können.

// Authentifizierung und erster Aufruf mit dem PHP SDK
$client = new \EConnect\Psb\PsbClient([
    'client_id' => 'Ihre-client-id',
    'client_secret' => 'Ihr-client-secret',
    'base_url' => 'https://accp-psb.econnect.eu',
    'identity_url' => 'https://accp-identity.econnect.eu',
]);

$me = $client->getMe();
echo "Account: " . $me->getName();

Arbeiten Sie in einer anderen Sprache als .NET oder PHP? Die PSB API ist vollständig als OpenAPI 3.0-Spezifikation dokumentiert. Sie können die swagger.json von psb.econnect.eu herunterladen und damit einen Client mit OpenAPI Generator generieren.

OpenAPI Generator unterstützt mehr als 50 Sprachen und Frameworks, darunter Java, Python, TypeScript, Go und Ruby. Ein Beispiel mit dem Kommandozeilen-Tool:

openapi-generator-cli generate \
  -i https://psb.econnect.eu/swagger/v1/swagger.json \
  -g java \
  -o ./psb-client-java

Das Ergebnis ist eine vollständige Client-Bibliothek mit typisierten Modellen für alle Request- und Response-Objekte. Sie müssen nur noch die Authentifizierung einrichten (siehe den Authentifizierungsartikel) und können direkt loslegen.

Wichtig: Generierte Clients enthalten standardmäßig kein Token-Management. Implementieren Sie die Logik zum Anfordern und Erneuern von Tokens selbst, oder verwenden Sie eine OAuth2-Bibliothek für Ihre Plattform.

Der direkteste Weg, die API zu erkunden, führt über die Swagger UI unter psb.econnect.eu. Dort können Sie:

• Alle Endpoints einsehen, gruppiert nach Funktionsbereich (SalesInvoice, PurchaseInvoice, Hook, Peppol usw.)
• Request- und Response-Schemata mit allen Feldern und deren Datentypen inspizieren
• API-Aufrufe mit Ihrem eigenen Bearer Token direkt im Browser ausführen
• Die swagger.json für Code-Generierung herunterladen

Die Swagger UI dient auch als praktische Referenz während der Entwicklung. Wenn Sie sich über die Struktur einer Anfrage oder die Felder einer Antwort unsicher sind, finden Sie dort immer die aktuelle Spezifikation.

Sie verwenden lieber kein SDK? Die PSB API ist eine Standard-REST API, die Sie mit jedem HTTP-Client aufrufen können. Unten ein Beispiel mit curl, das zeigt, wie Sie ein Token anfordern und anschließend Ihre Kontodaten abrufen:

# Token anfordern
TOKEN=$(curl -s -X POST https://accp-identity.econnect.eu/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=Ihre-client-id" \
  -d "client_secret=Ihr-client-secret" \
  -d "scope=ap" | jq -r '.access_token')

# Kontodaten abrufen
curl -s \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  https://accp-psb.econnect.eu/api/v1/me | jq .

In Produktionsanwendungen empfiehlt es sich, das Token zu cachen und erst kurz vor Ablauf zu erneuern (nach etwa 3500 Sekunden). Fordern Sie nicht bei jeder Anfrage ein neues Token an.