Reonic-Anbindung einrichten

Mit der Reonic-Anbindung verbindest du Photovate mit Reonic. Ist sie aktiv, überträgst du die Projektdaten einer Chance an Reonic und schreibst dein Angebot dort weiter.

Dieser Artikel richtet sich an alle, die die Einstellungen betreuen. Er zeigt, wo die Einrichtung liegt, welche drei Felder dort stehen und welches davon du einträgst und welche du herauskopierst. Genau diese Unterscheidung ist die häufigste Rückfrage: Im Einrichtungsfenster steht ein Feld, das „Reonic API-Key" heißt, und weiter unten ein zweites, das nur „API-Key" heißt. Die beiden meinen nicht dasselbe.

Voraussetzungen

Drei Berechtigungen spielen zusammen:

1. Leserecht auf „Integrationen". Ohne das zeigt die Seite nur „Du hast keine Berechtigung, diese Seite anzusehen."
2. Schreibrecht auf „Integrationen". Ohne das siehst du die Seite, aber die Schaltflächen „Integration aktivieren" und „Integration deaktivieren" sind ausgegraut.
3. Leserecht auf Mitarbeiter. Davon hängt ab, ob dir der Abschnitt „Deine Zugangsdaten für Reonic" mit „Client-Id" und „API-Key" überhaupt angezeigt wird.

In der Berechtigungsverwaltung heißt das Untermodul „Integrationen" und liegt im Modul „Settings". Bei seiner Einführung wurde es allen Rollen zugeteilt, die bereits Zugriff auf „admin" hatten.

Außerdem brauchst du deinen Reonic API-Key.

Wo die Einrichtung liegt

Du findest sie in der Seitenleiste unter „Einstellungen" → Gruppe „Organisation" → „Integrationen", der Eintrag mit dem Puzzleteil-Symbol.

Auf der Seite steht die Zeile „Reonic" mit dem Text „Verbinde Photovate mit Reonic, um Chancen in Reonic Angebote umzuwandeln.". Rechts daneben steht „Integration aktivieren", solange die Anbindung nicht aktiv ist — sonst „Integration deaktivieren". Beide Schaltflächen öffnen dasselbe Fenster. Ist die Anbindung aktiv, trägt die Zeile neben „Reonic" zusätzlich das Abzeichen „Aktiv".

Das Fenster heißt „Reonic Integration". Darunter steht: „Mit der Reonic Integration kannst du deine Projektdaten in der Chance an Reonic übertragen und dein Angebot in Reonic schreiben."

Die drei Felder auseinanderhalten

Im Fenster stehen drei Felder. Eines füllst du, zwei liest du ab.

„Reonic API-Key" ist das einzige Eingabefeld. Es ist Pflichtfeld und trägt deshalb einen roten Stern hinter der Beschriftung. Im leeren Zustand steht der Platzhalter „Dein Reonic API-Key" darin. Der Inhalt wird verdeckt dargestellt; über den Augen-Umschalter machst du ihn sichtbar.

„Client-Id" und „API-Key" stehen darunter in einem eigenen Abschnitt mit der Überschrift „Deine Zugangsdaten für Reonic". Beide sind grau hinterlegt und schreibgeschützt. „Client-Id" ist sofort lesbar. „API-Key" ist verdeckt und wird erst über den Augen-Umschalter sichtbar — der Hinweis am Umschalter wechselt zwischen „Anzeigen" und „Verbergen". Rechts in beiden Feldern sitzt ein Kopier-Knopf mit dem Hinweis „In die Zwischenablage kopieren"; nach dem Kopieren wird sein Symbol für zwei Sekunden zu einem Haken.

Gut zu wissen: „Client-Id" und „API-Key" musst du nirgends beantragen. Sie entstehen automatisch, sobald dein Betrieb eingerichtet wird. Sie dienen dem Zugriff auf die Photovate-Schnittstelle: Die Client-Id steht dort am Anfang der Adresse, der API-Key wird als Zugangsschlüssel mitgeschickt. Passen beide nicht zusammen oder ist der Zugang inaktiv, antwortet die Schnittstelle mit „Client mismatch or inactive".

Die Anbindung aktivieren

1. Öffne „Einstellungen" → „Organisation" → „Integrationen".
2. Klicke in der Zeile „Reonic" auf „Integration aktivieren". Das Fenster „Reonic Integration" öffnet sich.
3. Trage unter „Reonic API-Key" deinen Schlüssel ein. Solange das Feld leer ist, erscheint darunter „Erforderlich" und die Schaltfläche unten bleibt inaktiv.
4. Kopiere im Abschnitt „Deine Zugangsdaten für Reonic" die „Client-Id" und den „API-Key" heraus. Beide brauchst du auf der Reonic-Seite.
5. Klicke unten auf „Integration aktivieren".

Beim Speichern prüft Photovate den eingetragenen Schlüssel zuerst bei Reonic. Nimmt Reonic ihn an, erscheint die Meldung „Reonic Integration aktiviert" und die Zeile trägt von da an das Abzeichen „Aktiv". Lehnt Reonic ihn ab, erscheint „Ungültiger API-Key" und es wird nichts gespeichert.

Die beiden Zugangsdaten kannst du auch später jederzeit holen — die Schaltfläche in der Zeile „Reonic" öffnet immer dasselbe Fenster.

Mit „Abbrechen" links unten verlässt du das Fenster, ohne etwas zu speichern.

Schlüssel ändern oder Anbindung abschalten

Ist die Anbindung aktiv, heißt die Schaltfläche in der Zeile „Integration deaktivieren". Sie öffnet dasselbe Fenster wie vorher.

Im Fenster hängt die Schaltfläche unten rechts davon ab, was du getan hast:

• Du hast den Schlüssel geändert → „Änderungen speichern". Nach dem Speichern erscheint „Änderungen wurden gespeichert".
• Du hast nichts geändert → dort steht stattdessen der rote Knopf „Integration deaktivieren".

Beim Deaktivieren wird die Anbindung nur abgeschaltet. Der hinterlegte Schlüssel bleibt gespeichert, damit du ihn beim nächsten Aktivieren nicht erneut eintippen musst. Danach erscheint „Reonic Integration deaktiviert".

Was die Anbindung im Alltag bewirkt

Ist sie aktiv, findest du in einer Chance unter „Weitere Optionen" den Eintrag „In Reonic übertragen". Er erscheint nur, solange die Chance noch nicht übertragen wurde.

Während der Übertragung steht dort „Wird übertragen …". Danach erscheint „Erfolgreich zu Reonic übertragen" mit der Aktion „Anzeigen", über die du das Angebot im Reonic-Portal öffnest. Der Menüeintrag heißt von da an „In Reonic öffnen".

Häufige Fehler

„Erforderlich" steht unter dem Feld. Das Feld „Reonic API-Key" ist leer. Es muss gefüllt sein, sonst lässt sich nicht speichern.

„Ungültiger API-Key". Reonic hat den eingetragenen Schlüssel abgelehnt. Es wurde nichts gespeichert. Prüfe den Schlüssel und trage ihn erneut ein.

„Leider ist es etwas schiefgelaufen". Das Speichern oder das Deaktivieren ist technisch fehlgeschlagen. Versuche es erneut.

„Du hast keine Berechtigung, diese Seite anzusehen." Dir fehlt das Leserecht auf „Integrationen". Wende dich an die Person, die eure Berechtigungen betreut.

Die Schaltflächen in der Zeile „Reonic" sind ausgegraut. Dir fehlt das Schreibrecht auf „Integrationen". Ansehen darfst du die Seite, ändern nicht.

Der Abschnitt „Deine Zugangsdaten für Reonic" fehlt im Fenster. Dann konnten die Zugangsdaten nicht geladen werden. Dahinter steckt in aller Regel das fehlende Leserecht auf Mitarbeiter: Ohne dieses Recht werden „Client-Id" und „API-Key" nicht angezeigt. Einen Hinweistext dazu gibt es im Fenster nicht — der Abschnitt fehlt einfach. Lass dir das Recht geben oder bitte eine Kollegin oder einen Kollegen mit diesem Recht, dir die beiden Werte herauszukopieren.

„Client-Id" wird angezeigt, das Feld „API-Key" darunter fehlt. Dann ist für deinen Betrieb kein Schlüssel hinterlegt. Neu erzeugen lässt er sich auf dieser Seite nicht — wende dich an den Photovate-Support.

In der Chance steht „Die Reonic-Integration ist nicht aktiv. Bitte in den Einstellungen aktivieren." Die Anbindung ist abgeschaltet. Aktiviere sie wie oben beschrieben.

Wenn die Übertragung einer Chance scheitert

Diese Meldungen betreffen die Chance selbst, nicht die Einrichtung: