Aktive Softwareverbindungen und Kopplungen
Verbindungsschlüssel in eConnect erstellen

Verbindungsschlüssel (App Key und Secret) erstellen, Schnell Verbinden nutzen und eine Verbindung widerrufen.

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.

Was sind Verbindungsschlüssel?

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.

Schlüssel erstellen
  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.

Schlüssel in Ihre Software eingeben

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.

Schnell Verbinden

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.
Unterstützte Software für Schnell Verbinden
SoftwareRichtungBaseconeEmpfangen (Einkauf + Verkauf)Exact MultiversSenden + EmpfangenWhiteVisionEmpfangen (Einkauf + Verkauf)YukiEmpfangen (Einkauf + Verkauf)RadarSenden

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.

Mehrere Organisationen verbinden

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.

Schlüssel verloren?

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.

Sicherheit

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.
Verbindung widerrufen

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.

Erneut verbinden

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.

Was passiert mit Ihren Rechnungen?

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.

Häufig gestellte Fragen
Was soll ich tun, wenn ich mein Secret verloren habe?

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

Kann ich dieselben Verbindungsschlüssel für mehrere Organisationen verwenden?

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. Für die beste Sicherheit wird empfohlen, pro Organisation einen separaten Satz Schlüssel zu verwenden.

Was passiert mit meinen Rechnungen, wenn ich eine Verbindung widerrufe?

Der Widerruf hat keinen Einfluss auf Rechnungen, die bereits versendet oder empfangen wurden. Neue Rechnungen werden nicht mehr über die alte Verbindung ausgetauscht. Rechnungen, die bereitstanden, aber nicht abgerufen wurden, können Sie später durch erneutes Verbinden abrufen.


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

Verbindungsschlüssel erstellen