/ docs
ProduktWissenEntwickler
Plattform Control
SOAP API: Rechnungen versenden mit SendDocument

Rechnungen und Dokumente über den SendDocument SOAP-Endpoint versenden: Parameter, Routing und Statusverfolgung.

Mit dem SendDocument-Endpoint der Legacy SOAP API versenden Sie Rechnungen und andere Dokumente über die eConnect-Plattform. Die Plattform bestimmt automatisch die beste Route: über die eConnect-Plattform selbst, über Peppol oder als Fallback per E-Mail.

Wichtig: Dies ist die Legacy SOAP API. Für neue Integrationen empfehlen wir die REST API.

Wie SendDocument funktioniert

Beim Aufruf von SendDocument geben Sie das Quelldokument zusammen mit den Absender- und Empfängerdaten mit. Die Plattform sucht den Empfänger dann in drei Schritten:

  1. eConnect-Plattform: Ist der Empfänger auch ein Plattformbenutzer? Dann wird das Dokument direkt in seinen Posteingang zugestellt.
  2. Peppol: Ist der Empfänger im Peppol-Netzwerk auffindbar? Dann wird das Dokument über Peppol geroutet.
  3. E-Mail (Fallback): Wenn beides nicht möglich ist und eine E-Mail-Adresse angegeben wurde, wird das Dokument per E-Mail versendet.
Pflichtparameter
ParameterBeschreibungVia/ReferenceIdIdentifikation des Absenders (Ihre eigene EConnectPartyId, XCNL-Nummer)To/ReferenceIdIdentifikation des Empfängers (EConnectPartyId oder Peppol-Identifier wie 0106:KVK-Nummer)To/EmailAddressE-Mail-Adresse des Empfängers (wird als Fallback verwendet, wenn Plattform- und Peppol-Routing nicht möglich sind)SubjectBetreff des DokumentsPayloadDas Dokument selbst, als UBL-XML. Beachten Sie: Senden Sie das XML ohne XML-Prolog (<?xml ...?>)TemplateIdDie Template-ID, die den Dokumenttyp angibt
Beispielaufruf
<SendDocument>
  <Document>
    <Via>
      <ReferenceId>XCNL-123456</ReferenceId>
    </Via>
    <To>
      <ReferenceId>0106:12345678</ReferenceId>
      <EmailAddress>facturatie@voorbeeld.nl</EmailAddress>
    </To>
    <Subject>Factuur 2026-001</Subject>
    <Payload><!-- UBL-XML zonder prolog --></Payload>
    <TemplateId>GLDT9223370666504283001RA000000006DTP2000001</TemplateId>
  </Document>
</SendDocument>

Die TemplateId GLDT9223370666504283001RA000000006DTP2000001 ist die MasterTemplateId für eine Standardrechnung. Verwenden Sie immer die MasterTemplateId (nicht einen Versionscode), da diese über Template-Versionen hinweg stabil bleibt.

Response und ExternalId

Nach einem erfolgreichen Aufruf gibt die API eine ExternalId zurück. Dies ist die eindeutige ID des versendeten Dokuments in der eConnect-Plattform. Wenn die Antwort keine ExternalId enthält, wurde das Dokument nicht versendet. Überprüfen Sie in diesem Fall die Fehlermeldung in der Antwort.

Speichern Sie die ExternalId immer: Sie benötigen sie, um später den Dokumentstatus abzufragen.

DeliveryMethod

Die API gibt in der Antwort auch die DeliveryMethod zurück, sodass Sie wissen, über welchen Kanal das Dokument zugestellt wurde:

WertBedeutungToInboxIn den Posteingang des Empfängers auf der eConnect-Plattform zugestelltToPeppolÜber das Peppol-Netzwerk versendetToEmailPer E-Mail versendetOutboxOnlyNur in Ihrem eigenen Postausgang gespeichert (nicht zugestellt)NoneKeine Zustellung möglich
Statusverfolgung

Nach dem Versenden können Sie den Status Ihres Dokuments über zwei Endpoints verfolgen:

EndpointFunktionGetOutboxDocumentsListe versendeter Dokumente abrufen. Filtern Sie nach ModifiedOn, um nur kürzlich geänderte Dokumente zu sehen.GetOutboxDocumentEin bestimmtes Dokument anhand der ExternalId abrufen.GetOutboxDocumentStatusNur den Status abfragen, ohne das vollständige Dokument.
Tipps

UBL-XML ohne Prolog: Die Payload muss UBL-XML ohne die <?xml version="1.0" encoding="UTF-8"?> Deklaration enthalten. Wenn Sie den Prolog mitsenden, wird das Dokument möglicherweise nicht korrekt verarbeitet.

MasterTemplateId verwenden: Filtern Sie immer nach Template/MasterId statt nach einer spezifischen Template-ID. Die MasterTemplateId ändert sich nicht bei Versions-Updates des Templates.

Fehlerbehandlung: Überprüfen Sie die Antwort auf Fehlercodes. Die Fehlercode-Serien 400 (Validierung) und 200 (funktional) kommen bei Versandfehlern am häufigsten vor. Auf der Authentifizierungsseite finden Sie die vollständige Übersicht der Fehlercode-Serien.

Die REST API bietet beim Versenden zusätzliche Möglichkeiten wie Webhooks für Statusbenachrichtigungen und automatische Wiederholung bei Fehlern. Sehen Sie sich psb.econnect.eu für den modernen Ansatz an.

Zur REST API migrieren

Verwandt
PreviousSOAP-Authentifizierung
NextSOAP Empfangen