Schnittstelle (API und Webhooks)

Technische Beschreibung der REST-API und der Webhooks für Entwickler, die ERP, Leitstelle, Dokumentenablage oder Auswertungen an Revisio anbinden.

Artikel

  • API und Webhooks im Überblick

    Was die Schnittstelle kann, wie ein Fremdsystem angebunden wird und wo die technischen Einzelheiten stehen.

  • Grundlagen: Anmeldung, Formate, Blättern, Fehler

    Anmeldung mit Token, Berechtigungen, Datenformate, Blättern mit Cursor, Abgleich mit updated_since, Rate-Limit und Fehlercodes der API.

  • API: Stammdaten

    Kunden, Objekte, Anlagen mit SW-Nummer und Auftragstypen über die API lesen, mit Filtern und allen Feldern.

  • API: Aufträge

    Aufträge über die API abfragen, anlegen und ihren Status ändern, mit Filtern, Feldern, erlaubten Statuswechseln und Beispielen.

  • API: Berichte

    Prüfberichte über die API abfragen und das PDF über einen zeitlich begrenzten, signierten Link laden, zum Beispiel für ERP oder Dokumentenablage.

  • API: Störungen

    Störungen über die API abfragen und melden, mit Statuswerten, Prioritäten, Störungskategorien und Reaktionszeit.

  • Webhooks empfangen und prüfen

    Aufbau einer Webhook-Nachricht, Header, Prüfung der Signatur mit Beispielen für PHP, Node.js und Python, Wiederholungen, Duplikate und Reihenfolge.

  • Webhook-Ereignisse

    Alle Ereignisse, die Revisio per Webhook meldet, wann sie ausgelöst werden und welche Daten sie enthalten.

  • Anwendungsbeispiele

    Typische Anbindungen Schritt für Schritt – ERP-Abrechnung, Berichtsablage im DMS, Störungsmeldung aus einer Leitstelle, Stammdatenabgleich und Wartungsplanung im ERP.

Weitere Bereiche

  • Erste Schritte

    Revisio kennenlernen – Anmeldung, Oberfläche, Startseite, Suche, Benachrichtigungen, eigenes Konto und die Ersteinrichtung für neue Betriebe.

  • Kunden, Objekte und Anlagen

    Stammdaten anlegen und pflegen – Kunden, Objekte mit Zugangsinfos, Kontakte, Anlagen mit Komponenten, Datenimport, Karte und QR-Etiketten.

  • Wartung und Planung

    Wartungsverträge und Intervalle, Fälligkeiten, Touren, Aufträge, Planungskalender, Terminankündigung und Störungen.

  • Prüfung, Störungen und Berichte

    Prüfvorlagen, Prüfprotokoll im Büro, Prüfung je Komponente, Störungen, Prüfberichte mit Freigabe, Versand, Korrektur und Echtheitsprüfung.

  • Techniker-App

    Die App für unterwegs installieren, Aufträge offline abarbeiten, prüfen, erfassen, unterschreiben lassen und abschließen.

  • Brandmeldeanlagen und Melder

    Melder-Service mit Tauschbewertung, Verschmutzung, Ereignisspeicher, Betriebsbuch, Abschaltungen, Akkuberechnung und Fehlercodes.

  • Angebote und Abrechnung

    Angebote aus Störungen, Artikelstamm und Preislisten, Zeiten und Material am Auftrag, Abrechnung, Export für die Buchhaltung und Auswertungen.

  • Verwaltung

    Benutzer, Rollen und Rechte, Briefköpfe, Einstellungen, Module, Vorgaben für Anlagen und Aufträge, Protokolle, Sicherheit, Datenschutz und Schnittstellen.

  • Kundenportal

    Was Ihre Kunden im Portal sehen, wie Sie Zugänge einrichten, wie Kunden Störungen melden, Angebote entscheiden und Rechnungen abrufen.

  • Hilfe und Support

    Fragen, Fehler und Wünsche an den Revisio-Support – mit Konto als Support-Ticket, ohne Konto über das Kontaktformular.