Um Ihre Buchhaltungssoftware mit eConnect zu verbinden, benötigen Sie Verbindungsschlüssel. Diese bestehen aus einem App Key und einem Secret, mit denen Ihre Software sicher mit der eConnect-Plattform kommuniziert. In wenigen Schritten erstellen Sie diese.

Verbindungsschlüssel bestehen aus zwei Teilen:

• App Key (auch Consumer Key genannt): der Identifikationscode Ihrer Verbindung
• Secret (auch Consumer Secret genannt): das Passwort, das die Verbindung absichert

Zusammen bilden sie die Zugangsdaten, mit denen Ihre Software Rechnungen über eConnect versenden und empfangen kann. Behandeln Sie das Secret wie ein Passwort und teilen Sie es nicht öffentlich.

1. Melden Sie sich bei platform.econnect.eu an.
2. Gehen Sie zu Mijn omgeving und wählen Sie die Organisation, für die Sie die Verbindung einrichten möchten.
3. Navigieren Sie zu Verbindingen oder Software koppelen (abhängig von Ihrer Abonnementversion).
4. Klicken Sie auf Nieuwe verbinding aanmaken.
5. Wählen Sie Ihr Softwarepaket aus der Liste.
6. Die Plattform generiert Ihren App Key und Ihr Secret. Kopieren Sie diese sofort: das Secret wird nur einmal angezeigt.

Nach dem Erstellen geben Sie die Schlüssel in Ihrem Softwarepaket ein. Der genaue Ort variiert je nach Paket, folgt aber in der Regel diesem Muster:

• Öffnen Sie die Einstellungen oder Konfiguration Ihres Softwarepakets.
• Suchen Sie nach dem Abschnitt für E-Rechnung, eConnect oder Peppol.
• Fügen Sie den App Key und das Secret in die vorgesehenen Felder ein.
• Speichern Sie die Einstellungen und testen Sie die Verbindung.

Bei einigen Paketen (wie über Schnell Verbinden) können Sie die Schlüssel mit CTRL+V auf einmal in das Verbindungsfenster einfügen.

Mit Schnell Verbinden geben Sie die Schlüssel beschleunigt ein. Anstatt den App Key und das Secret einzeln zu kopieren, öffnet sich ein Verbindungsfenster, in dem Sie mit CTRL+V beide Schlüssel gleichzeitig einfügen.

1. Erstellen Sie Verbindungsschlüssel (siehe oben).
2. Klicken Sie bei der erstellten Verbindung auf Schnell Verbinden.
3. Es öffnet sich ein neues Fenster. Drücken Sie CTRL+V: die Schlüssel werden automatisch eingelesen.
4. Wählen Sie die Verwaltung, für die Sie Rechnungen abrufen möchten.
5. Geben Sie die E-Mail-Adresse ein, die mit der Verwaltung in Ihrem Softwarepaket verknüpft ist (nicht Ihre eConnect-E-Mail-Adresse).
6. Stellen Sie optional ein Startdatum ein.
7. Wählen Sie, ob Sie auch Ausgangsrechnungen verarbeiten möchten.
8. Bestätigen Sie und klicken Sie auf Toepassen.

Tipp: Die E-Mail-Adresse, die Sie bei Schnell Verbinden eingeben, muss die Adresse sein, die mit der Verwaltung in Ihrem Softwarepaket verknüpft ist. Verwenden Sie nicht die E-Mail-Adresse Ihres eConnect-Kontos.

Eine der Verbindungen, die Sie über Schnell Verbinden erstellen, heißt in der Plattform Email-Connector. Achtung: Trotz des Namens funktioniert dies über Verbindungsschlüssel, und die Verbindung gehört zu Verbindingen -- es wird keine E-Mail eingereicht. Verwechseln Sie dies nicht mit dem Email Receiver: das ist eine App, mit der Sie selbst Rechnungen per E-Mail auf der Plattform empfangen. Der Email-Connector macht das Gegenteil: er leitet über eConnect empfangene Rechnungen automatisch an eine E-Mail-Adresse Ihrer Wahl weiter.

Neben dem Standard-Email-Connector gibt es Varianten, die das empfangene Dokument in ein bestimmtes Format transformieren (immer SI 2.0, immer BIS v3, immer SI 1.2 oder immer SALES005 Rechnung). Die Einrichtung ist dieselbe wie beim Standard-Email-Connector; eConnect sorgt für die Zustellung im gewählten Format.

Als Empfänger können Sie einen Email-Connector erstellen, um über eConnect empfangene Rechnungen automatisch an eine angegebene E-Mail-Adresse weiterleiten zu lassen. Standardmäßig wird dabei nur die XML mitgesendet -- keine PDF oder andere Anhänge. Dieses Verhalten wird durch den Parameter excludeAdditionalAttachments bestimmt:

• excludeAdditionalAttachments=true (Standard): zusätzliche Anhänge wie eine PDF werden nicht mitgesendet.
• excludeAdditionalAttachments=false: die PDF und eventuelle andere Anhänge werden ebenfalls mitgesendet.

Beim Standard-Email-Connector (dem Collabrr-Auto-Hook) steht dieser Parameter auf true. Möchten Sie auch die PDF erhalten, kann dies nur der Techsupport anpassen.

Achtung nach einer Techsupport-Anpassung: Passen Sie als Kunde den Email-Connector danach selbst an, überschreibt diese Änderung automatisch die Techsupport-Anpassung. Die PDF wird dann wieder unterdrückt und nicht mehr mitgesendet. Ändern Sie den Connector nach der Anpassung nicht selbst.

Nutzen Sie stattdessen den Mailhook in der PSB und stellen Sie den Connector selbst ein, können Sie diesen Parameter selbst festlegen -- das ist ein separater, eigenständiger Self-Service-Weg.

Diese Weiterleitung ist eine geeignete Alternative für einen Empfänger, der (noch) nicht bei Peppol angemeldet ist, aber die Rechnungsdaten oder das PDF-Dokument automatisch abrufen möchte.

Wenn Sie mehrere Organisationen in Ihrer Umgebung verwalten, erstellen Sie pro Organisation einen separaten Satz Verbindungsschlüssel. Der App Key ist einzigartig pro Organisations-Verbindung. Es ist möglich, denselben API-Schlüssel für mehrere Organisationen innerhalb desselben Softwarepakets zu verwenden, aber die organisationsspezifische Kennung (wie die eConnect ID) muss pro Organisation eingestellt werden.

Wenn Sie das Secret verloren haben, können Sie kein neues Secret anfordern. Sie müssen einen neuen Satz Verbindungsschlüssel erstellen. Die alten Schlüssel werden damit ungültig. Vergessen Sie nicht, die neuen Schlüssel auch in Ihrer Software zu aktualisieren.

Die Verbindungsschlüssel bieten gesicherten Zugang zu Ihrer eConnect-Organisation. Beachten Sie daher:

• Teilen Sie Schlüssel nur mit der Person, die die Verbindung einrichtet.
• Bewahren Sie das Secret an einem sicheren Ort auf (Passwort-Manager).
• Wenn Sie vermuten, dass Schlüssel kompromittiert wurden, erstellen Sie sofort neue.

Möchten Sie auf eine andere Verbindungsmethode umsteigen oder Ihr Softwarepaket nicht mehr nutzen? Dann können Sie die Verbindung widerrufen.

1. Melden Sie sich bei platform.econnect.eu an.
2. Gehen Sie zu Verbindingen in der betreffenden Organisation.
3. Klicken Sie auf die Verbindung, die Sie widerrufen möchten.
4. Klicken Sie auf Sleutel intrekken.
5. Die Verbindung ist jetzt inaktiv.

Nach dem Widerruf können Sie die Verbindung vollständig löschen: Gehen Sie zurück zur Übersicht, klicken Sie auf die drei Punkte neben der widerrufenen Verbindung und wählen Sie Verwijder verbinding.

Widerrufen Sie auch in Ihrem Softwarepaket die Verbindung. Andernfalls versucht die Software weiterhin, über die alten Schlüssel zu kommunizieren.

Möchten Sie sich erneut verbinden? Erstellen Sie einen neuen Satz Verbindungsschlüssel. Die alten Schlüssel funktionieren nach dem Widerruf nicht mehr.

Achtung: Wenn Sie auf den Autopilot umsteigen, müssen Sie die alte Verbindung zuerst widerrufen. Zwei aktive Verbindungen zur gleichen Verwaltung können zu Konflikten führen.

Der Widerruf hat keinen Einfluss auf bereits versendete oder empfangene Rechnungen. Neue Rechnungen werden nicht mehr über die alte Verbindung ausgetauscht. Rechnungen, die bereitstanden, aber nicht abgerufen wurden, können Sie später erneut abrufen, indem Sie sich neu verbinden und "API opnieuw aanbieden" verwenden.

Bereit, Ihre Software zu verbinden? Sehen Sie, welche Integrationsmethode zu Ihrem Paket passt.