Schnittstelle > Magicplan

magicplan ist eine App für Handy und Tablet, mit der man einen Raum aufmisst und aufzeichnet, indem man ihn mit der Kamera abgeht. Heraus kommt ein Grundriss mit Raumnamen, Flächen und Höhen – und eine Skizze, die man weitergeben kann.
Die Schnittstelle verbindet das mit Pluvius. Der Nutzen ist handfest: Sie messen vor Ort einmal, und die Räume stehen anschließend in Pluvius, ohne dass jemand Maßband, Zettel und Tastatur bemüht.
Und weil die Skizze automatisch als Skizze gekennzeichnet ankommt, geht sie denselben Weg wie jede andere Skizze weiter – in den Bericht und, wenn Sie es so eingestellt haben, zur Versicherung.

Zu finden unter Mein Konto ▸ Benutzer ▸ Magicplan.

Hinweis:
Diese Schnittstelle wird je Mitarbeiter eingerichtet, nicht einmal für die Firma. Jeder, der mit magicplan messen soll, verbindet sein eigenes Konto. Deshalb steht sie unter Mein Konto und nicht unter den Admin-Schnittstellen.

Was Sie damit machen können

Von Pluvius nach magicplan:
  • Ein Projekt aus Pluvius nach magicplan übertragen – mit Projektnummer, Adresse und Beschreibung. Sie müssen die Baustelle in der App also nicht neu anlegen und nicht abtippen.
Von magicplan nach Pluvius:
  • Räume importieren – die aufgemessenen Räume werden in Pluvius als Räume angelegt, mit Fläche, Höhe und der Etage als Wohnung. Genau die Angaben, die Messprotokoll und Instandsetzungsbericht brauchen.
  • Skizze importieren – der Grundriss wird als Dokument in den Auftrag geladen und dabei als Skizze gekennzeichnet.
  • Kostenschätzungen übernehmen – hat jemand in magicplan eine Schätzung (Estimate) erstellt, lassen sich ihre Positionen in ein Pluvius-Angebot übernehmen.
Tipp aus der Praxis:
Der größte Gewinn liegt beim Raumimport. Diese Zahlen stehen später im Bericht, den die Versicherung liest.

Was Sie dafür brauchen

  • ein magicplan-Konto Ihres Betriebs mit einem Abo, das den Zugriff über die Schnittstelle enthält – magicplan stellt den Schlüssel nur in den größeren Plänen bereit
  • einen Administrator des magicplan-Arbeitsbereichs; nur er darf den Schlüssel erzeugen
  • die App auf den Geräten, mit denen gemessen wird
Die Begriffe – kurz erklärt

  • API-Schlüssel (API Key) – der Ausweis, mit dem Pluvius bei magicplan anklopft. Eine lange Zeichenfolge; behandeln Sie sie wie ein Passwort.
  • Kunden-ID (Customer ID) – die Nummer Ihres magicplan-Arbeitsbereichs. Sie gehört zum Schlüssel und wird immer zusammen mit ihm gebraucht.
  • Arbeitsbereich (Workspace) – Ihr Firmenkonto bei magicplan, in dem alle Nutzer und Projekte liegen.
  • Team – eine Gruppe innerhalb des Arbeitsbereichs. Nur wer im selben Team ist, kann gemeinsam an einem Plan arbeiten.
Schritt 1: Schlüssel und Kunden-ID bei magicplan holen

Dieser Schritt passiert bei magicplan, nicht in Pluvius:
1. Auf cloud.magicplan.app anmelden – mit dem Konto, das Administrator des Arbeitsbereichs ist.
2. In der linken Navigation API & Integrations öffnen.
3. Im Bereich API Key den Schlüssel erzeugen lassen.
4. API Key und Customer ID kopieren – beide werden gebraucht.
Achtung:
Der Zugriff auf den Schlüssel setzt ein entsprechendes magicplan-Abo voraus, und nur ein Administrator des Arbeitsbereichs darf ihn erzeugen. Wenn Sie den Bereich API & Integrations nicht sehen, fehlt eines von beidem – das klären Sie mit magicplan beziehungsweise dem Kollegen, der Ihr Konto verwaltet.

Hinweis:
Sollte der Schlüssel einmal in falsche Hände geraten, lässt er sich im magicplan-Konto austauschen. Danach ist der alte Schlüssel wertlos und muss in Pluvius neu eingetragen werden.

Schritt 2: In Pluvius verbinden

Unter Mein Konto ▸ Benutzer ▸ Magicplan, Karte Mit Magicplan Verbinden:
1. Api-Key einfügen.
2. Kunden-ID einfügen.
3. Speichern.
Pluvius prüft die Angaben sofort bei magicplan. Passen sie, erscheint „Magicplan-User erfolgreich angelegt oder aktualisiert" und darunter die Karte Magicplan Verbindung mit Ihrer E-Mail-Adresse aus dem magicplan-Konto. Passen sie nicht, meldet Pluvius „Fehlerhafte Daten".
Hinweis:
Führende oder abschließende Leerzeichen entfernt Pluvius selbst und weist mit einer Meldung darauf hin. Das ist praktisch, weil beim Kopieren gern ein Leerzeichen mitkommt – die häufigste Ursache für „Fehlerhafte Daten" bei anderen Programmen.

Schritt 3: Team auswählen

In der Karte Magicplan Verbindung steht das Feld Team. Steht dort „Sie haben kein Team ausgewählt", klicken Sie auf ändern und wählen Ihr Team.
Die Seite weist selbst auf die drei wichtigen Punkte hin:
  • Sie sollten dem gleichen Team wie Ihre Arbeitskollegen zugewiesen sein, um gemeinsam an Projekten zu arbeiten
  • Ein Projekt kann nur eine Magicplan-Team-ID besitzen
  • Wer nicht im selben Team ist, kann in der App nicht an diesem Projekt teilnehmen
Achtung:
Das Team ist die Stelle, an der es in der Praxis klemmt: Legt Kollege A ein Projekt an und Kollege B ist in einem anderen Team, sieht B den Plan in der App nicht – und misst dann versehentlich in ein neues, unverbundenes Projekt. Klären Sie deshalb vor dem ersten Einsatz, dass alle Messenden im selben Team sind.

Hinweis:
Unter dem Team zeigt die Seite die Team Mitglieder und die Workspace Mitglieder direkt aus magicplan an. Damit lässt sich ohne Umweg über die App prüfen, wer wo drin ist. Über Aktualisieren werden die Listen neu geholt.

Schritt 4: Projektnamen festlegen

Unter Wie soll das Projekt beim Projektexport benannt werden? wählen Sie, wie das Projekt in magicplan heißt:
  • Projektnummer – nur die Nummer, zum Beispiel 2026-0417
  • Projektnummer und Ansprechpartner – zum Beispiel 2026-0417 Meier
Die Änderung wird sofort übernommen.
Tipp aus der Praxis:
Ich würde Projektnummer und Ansprechpartner nehmen. In der App sucht man unterwegs eher nach dem Namen als nach der Nummer – und die Nummer bleibt trotzdem vorn, sodass die Liste sortiert bleibt.

So läuft es im Alltag

1. Projekt übertragen. Aus dem Projekt beziehungsweise dem Termin in Pluvius das Projekt nach magicplan exportieren. Übertragen werden Projektnummer, Straße, Hausnummer, PLZ und Ort sowie die Beschreibung; falls im Objekt vorhanden, auch die Koordinaten. Das Projekt wird in Ihrem Team angelegt.
2. Vor Ort messen. In der magicplan-App das Projekt öffnen und die Räume aufnehmen.
3. Räume zurückholen. Im Termin in Pluvius den Raumimport aufrufen. Für jeden Raum aus magicplan entsteht ein Raum in Pluvius – mit Name, Etage als Wohnung, Fläche und Höhe.
4. Skizze zurückholen. Im selben Bereich die Skizze auswählen und importieren. Sie landet als Dokument am Auftrag und ist als Skizze gekennzeichnet.
Achtung:
Ein Projekt lässt sich nur einmal nach magicplan übertragen. Beim zweiten Versuch meldet Pluvius „Dieses Projekt hat bereits eine Magicplan ID". Das verhindert doppelte Baustellen in der App – heißt aber auch: Wurde beim ersten Mal das falsche Team gewählt, muss das in magicplan korrigiert werden.

Hinweis:
Der Raumimport legt Räume an und überschreibt keine vorhandenen. Ein Raum, den es unter demselben Namen in derselben Etage schon gibt, bleibt wie er ist. Sie können den Import also gefahrlos wiederholen, wenn nachträglich ein Raum in magicplan dazukommt – die neuen kommen dazu, die alten bleiben unverändert.

Hinweis:
Weil die importierte Skizze als Skizze gekennzeichnet ist, wirkt sie wie jede andere Skizze weiter: Sie erscheint an den Stellen, an denen Skizzen angezeigt werden, kann das Signal Skizze hinzugefügt auslösen und – bei eingerichteter Versicherungsschnittstelle – an das Portal übermittelt werden.

Kostenschätzungen als Angebot übernehmen

Wer in magicplan mit Estimates arbeitet, kann deren Positionen in ein Pluvius-Angebot holen. Pluvius zeigt dazu die vorhandenen Schätzungen des Projekts an; eine davon lässt sich laden und in das Angebot übernehmen.
Tipp aus der Praxis:
Das lohnt sich vor allem, wenn Sie in magicplan mit eigenen Preislisten arbeiten. Wer seine Preise in Pluvius im Leistungsverzeichnis pflegt, ist mit der Angebotserstellung in Pluvius meist schneller – dann nutzen Sie magicplan für Maße und Skizze und lassen die Kalkulation dort, wo Ihre Preise stehen.

Häufige Fragen

Muss jeder Mitarbeiter das einrichten?
Jeder, der messen und importieren soll, ja – die Verbindung hängt am Benutzer. Für Kollegen, die nur die Ergebnisse in Pluvius sehen, ist nichts einzurichten.

Ich habe gemessen, aber in Pluvius kommen keine Räume an.
Prüfen Sie: Wurde das Projekt aus Pluvius nach magicplan übertragen? Nur dann kennt Pluvius den Plan. Und: Sind Sie im richtigen Team? Haben Sie in der App womöglich ein eigenes, neues Projekt angelegt statt das übertragene zu öffnen?

Kann ich ein Projekt nachträglich verbinden, das ich in der App angelegt habe?
Über diese Oberfläche nicht. Der Weg führt immer von Pluvius nach magicplan.

Sieht magicplan meine Pluvius-Daten?
Übertragen werden Projektnummer beziehungsweise Ansprechpartner, die Adresse des Objekts, die Projektbeschreibung und eine interne Kennung. Kundendaten, Berichte oder Preise gehen nicht mit.

Was passiert, wenn ich den Schlüssel wieder entferne?
Dann ruht die Verbindung: Es lassen sich keine Projekte übertragen und keine Räume importieren. Was bereits in Pluvius angekommen ist – Räume, Skizzen, Angebotspositionen – bleibt erhalten.

Kostet die Schnittstelle etwas?
Pluvius stellt die Schnittstelle bereit. Das magicplan-Konto und der Plan, der den API-Schlüssel enthält, laufen über Sie – welcher Plan das ist und was er kostet, erfahren Sie bei magicplan. Etwaige Kosten dort sind nicht im Preis für Pluvius enthalten; zu Preisen und Vertragsinhalten können wir keine Auskunft geben. Was auf Pluvius-Seite dazugehört, klären Sie mit uns. Eine Übersicht dazu steht in Schnittstellen: Überblick und Voraussetzungen.
Was damit zusammenhängt

Was damit zusammenhängt

  • Mieter und Ansprechpartner hinzufügen – dort entstehen die Räume und Wohnungen, in die der Import schreibt.
  • Messprotokoll erstellen und Messungen mit Messpunkten – dort werden die importierten Räume mit Flächen und Höhen gebraucht.
  • Dokumentenupload im Auftrag – dort landet die importierte Skizze, gekennzeichnet als Skizze.
  • Einstellungen ▸ Tätigkeiten – der Haken Skizze macht die Skizze zum Pflichtschritt im Termin.
  • Einstellungen ▸ Signale und Automatisierungen – dort kann Skizze hinzugefügt einen Status setzen.
  • Angebotserstellung – Ziel der übernommenen Kostenschätzungen.
  • Schnittstelle ▸ LVM und PropertyExpert – dort kann die Skizze an das Versicherungsportal gehen.