Mit der Legacy SOAP API rufen Sie empfangene Dokumente über Polling ab. Sie prüfen periodisch, ob neue Dokumente in Ihrem Posteingang vorhanden sind, laden sie herunter und aktualisieren den Status. Dieser Artikel beschreibt den vollständigen Empfangsablauf.

Wichtig: Dies ist die Legacy SOAP API. Für neue Integrationen empfehlen wir die REST API. Die REST API bietet Webhooks, sodass Sie nicht pollen müssen.

Rufen Sie GetInboxDocuments mit dem Filter CreatedOn.From auf, um nur neue Dokumente abzurufen. Speichern Sie nach jedem Aufruf den höchsten CreatedOn-Wert und verwenden Sie diesen als Ausgangspunkt für die nächste Prüfung.

<GetInboxDocuments>
  <Filter>
    <CreatedOn>
      <From>2026-03-01T00:00:00</From>
    </CreatedOn>
  </Filter>
</GetInboxDocuments>

Die Antwort enthält Metadaten aller Dokumente im Posteingang. Filtern Sie nach Template/MasterId, um nur den richtigen Dokumenttyp auszuwählen. Für Standardrechnungen verwenden Sie die MasterTemplateId:

GLDT9223370666504283001RA000000006DTP2000001

Verwenden Sie immer die MasterTemplateId und nicht eine versionsspezifische ID, da diese sich bei Template-Updates nicht ändert.

Rufen Sie pro Dokument die vollständige Payload mit GetInboxDocument ab, anhand der ExternalId aus der Metadatenliste:

<GetInboxDocument>
  <ExternalId>het-external-id-uit-stap-1</ExternalId>
</GetInboxDocument>

Verwenden Sie GetDocumentPdf, um die PDF-Version des Dokuments abzurufen. Das PDF wird als base64-codierter String zurückgegeben.

Beachten Sie: Wenn das PDF noch generiert wird, gibt die API den Fehlercode ERRDMN8000003 zurück. Warten Sie in diesem Fall einige Sekunden und versuchen Sie es erneut.

Aktualisieren Sie den Dokumentstatus mit SetInboxDocumentStatus. Dies ist wichtig für den Verarbeitungsablauf und für die Sichtbarkeit des Status in der Plattform.

Der Posteingang verwendet folgende Statuscodes. Verwenden Sie beim Filtern und Aktualisieren immer den Code (nicht den Namen).

Beim Abrufen von Dokumenten können Sie verschiedene Filter verwenden, um die Ergebnisse einzugrenzen:

Neben Posteingangsdokumenten können Sie auch Ihre eigenen versendeten Dokumente abrufen. Verwenden Sie dafür GetOutboxDocuments und GetOutboxDocument. Die Funktionsweise ist vergleichbar mit den Posteingangs-Endpoints, aber für Dokumente, die Sie selbst versendet haben.

Für Dokumente, die noch nicht versendet wurden (Entwürfe), verwenden Sie GetDocuments und GetDocument. Diese Endpoints arbeiten mit einer DocumentId anstelle einer ExternalId. Entwürfe haben eigene Statuscodes:

Intervall: Pollen Sie nicht häufiger als einmal pro Minute. Für die meisten Integrationen reicht einmal alle 5 bis 15 Minuten aus.

Inkrementelles Abrufen: Speichern Sie immer den höchsten CreatedOn-Wert und verwenden Sie diesen als From-Filter beim nächsten Aufruf. So vermeiden Sie, dass Sie dieselben Dokumente wiederholt abrufen.

Statusänderungen erkennen: Verwenden Sie den ModifiedOn-Filter, wenn Sie erkennen möchten, wann sich der Status bestehender Dokumente geändert hat, beispielsweise nach Genehmigung oder Zahlung.

Mit der REST API müssen Sie nicht pollen: Webhooks senden automatisch eine Benachrichtigung, sobald ein neues Dokument eingeht. Sehen Sie sich psb.econnect.eu für den modernen Ansatz an.

• SOAP API: Übersicht und Endpoints
• SOAP-Authentifizierung und App Keys
• SOAP: Rechnungen versenden (SendDocument)
• PSB REST API: Übersicht