Falcon und Lucanet verbinden

Mit der Lucanet-Integration können Daten aus Falcon nach Lucanet übertragen werden. Falcon bleibt dabei das System für Maßnahmen, Verantwortlichkeiten, Status, Zeitpläne und Effekte. Lucanet nutzt die übertragenen Daten anschließend für Planung, Analyse, Konsolidierung und Reporting.

Damit die Integration funktioniert, müssen auf Falcon-Seite die Rechnungswesen-Zuordnungen vorbereitet sein. Auf Lucanet-Seite muss das passende Falcon-Skript eingerichtet werden.

Was muss vorbereitet sein?

Für die Einrichtung werden vier Dinge benötigt:

Die Integration (das sog. Skript #3711-BUD.REST-JSON.FOS) muss bei Lucanet angefragt werden.
In Falcon müssen Sachkonten und Legal Entities gepflegt sein.
Auf Maßnahmenebene muss je relevantem Effekt die Zuordnung zu Sachkonto und Legal Entity hinterlegt sein.
In Lucanet muss das Skript eingerichtet und konfiguriert werden.

Wichtig: Es muss keine feste Anzahl an Effekten vorbereitet werden. Die Zuordnung kann für beliebig viele Effekte erfolgen.

Schritt 1: Integration bei Lucanet anfragen

Bitte wenden Sie sich zunächst an Ihren Lucanet Customer Success Manager und fragen Sie die Falcon-Integration an. Nennen Sie dabei ausdrücklich das folgende Skript:

Falcon #3711-BUD.REST-JSON.FOS

Lucanet stellt das Skript bereit beziehungsweise unterstützt bei der Aktivierung und Einrichtung in Ihrer Lucanet-Umgebung.

Für die Anfrage an Lucanet sollten Sie folgende Informationen bereithalten:

Benötigt	Beschreibung
Name der Integration	Falcon-Integration
Skriptname	Falcon #3711-BUD.REST-JSON.FOS
Ziel	Import von Falcon-Daten nach Lucanet
Falcon-API-URL	In der Regel `https://api.nordan.tech/v1/`
Falcon-Ansprechpartner	Ihr Customer Success Manager
Lucanet-Ansprechpartner	Ihr Lucanet Customer Success Manager

Schritt 2: Voraussetzungen in Falcon prüfen

Bevor Lucanet Daten aus Falcon sinnvoll verarbeiten kann, müssen in Falcon die Rechnungswesen-Zuordnungen gepflegt sein.

Dafür werden insbesondere benötigt:

Falcon-Information	Zweck
Sachkonten	Ordnet einen Effekt der passenden Kontenlogik zu
Legal Entities / Firmen	Ordnet einen Effekt der passenden Gesellschaft zu

Entscheidend ist die Zuordnung auf Maßnahmenebene:

Für jeden relevanten Effekt muss auf Maßnahmenebene die passende Kombination aus Sachkonto und Legal Entity hinterlegt sein.

Diese Zuordnung kann für beliebig viele Effekte erfolgen. Wenn eine Maßnahme mehrere relevante Effekte hat, können entsprechend mehrere Effekte jeweils mit Sachkonto und Legal Entity verknüpft werden.

Ohne diese Zuordnung kann Lucanet die Werte nicht sauber der gewünschten Finanzstruktur zuordnen.

Schritt 3: Persönlichen Zugangstoken in Falcon erstellen

Lucanet greift über die Falcon-API auf die Daten zu. Dafür wird ein persönlicher Zugangstoken in Falcon benötigt.

Den Token erstellen Sie in Falcon unter:

Entwicklung → Persönliche Zugangstokens

Für die Erstellung benötigen Sie:

Feld	Empfehlung
Name	Zum Beispiel „Lucanet Integration“
Gültigkeit	Passende Laufzeit für den produktiven Betrieb wählen

Wichtig: Der Token wird nach der Erstellung nur einmal vollständig angezeigt. Kopieren und speichern Sie ihn daher direkt sicher ab.

Der Token wird später in Lucanet in der Verbindung zu Falcon hinterlegt.

Schritt 4: Skript in Lucanet importieren

Sobald Lucanet das Skript bereitgestellt hat, wird es in Lucanet importiert.

Dazu wird in Lucanet im Bereich Skripte ein neues Skript auf Basis der Skriptdatei angelegt.

Benötigt wird:

Benötigt	Beschreibung
Lucanet-Skript	Falcon #3711-BUD.REST-JSON.FOS
Lucanet-Zugriff	Berechtigung zum Anlegen und Konfigurieren von Skripten
Lucanet-Version	Version 25 oder höher
Unterstützung	Ihr Lucanet Customer Success Manager oder Lucanet-Administrator

Schritt 5: Verbindung zu Falcon in Lucanet einrichten

Nach dem Import wird im Skript die Verbindung zu Falcon konfiguriert.

In der Source connection werden folgende Angaben hinterlegt:

Feld in Lucanet	Inhalt
URL path	`https://api.nordan.tech/v1/`
Username	E-Mail-Adresse des Falcon-Nutzers
Access token	Persönlicher Zugangstoken aus Falcon

Damit kann Lucanet über die Falcon-API auf die relevanten Daten zugreifen.

Schritt 6: Importlogik in Lucanet konfigurieren

Anschließend wird festgelegt, wie die Falcon-Daten in Lucanet abgebildet werden.

Dieser Schritt ist wichtig, weil hier die fachliche Zuordnung erfolgt.

Typische Konfigurationsbereiche sind:

Data level

Hier wird definiert, welche Falcon-Datenebene welcher Lucanet-Datenebene entspricht.

Beispiel:

Falcon	Lucanet
Current	BUD

Adjustment level

Hier wird festgelegt, welche Falcon-Quellgröße welcher Lucanet-Bewertungsebene entspricht.

Beispiel:

Falcon-Quelle	Lucanet Adjustment Level
Abverkäufe Ladenhüter	Lager
Lagerbestandsreichweite	Lager2

Reporting entity

Hier werden Falcon Legal Entities den Lucanet Reporting Entities zugeordnet.

Beispiel:

Falcon Legal Entity	Lucanet Reporting Entity
Nordantech Solutions GmbH	Nordantech Solutions GmbH
Beispiel GmbH	Beispiel GmbH

Optional kann zusätzlich eingeschränkt werden, ob nur bestimmte Sachkonten importiert werden sollen.

Schritt 7: Datenquelle und Datenimport in Lucanet anlegen

Nach der Skriptkonfiguration wird in Lucanet eine Datenquelle angelegt.

Dafür wird eine Datenquelle vom Typ Bereitstellung via Skript verwendet. Diese Datenquelle nutzt das zuvor eingerichtete Falcon-Skript.

Danach wird ein Datenimport angelegt.

Benötigt wird:

Benötigt	Beschreibung
Datenquelle	Die Falcon-Datenquelle via Skript
Zuordnungstabelle	Mapping der importierten Werte auf Lucanet-Strukturen
Importkonfiguration	Festlegung von Datenebene, Entity und weiteren Parametern
Testlauf	Prüfung, ob Werte korrekt ankommen