Zurück zur Hauptseite
Startseite › Alles was du brauchst › Digitale Schnittstellen
Digitale Schnittstellen

Deine Software, direkt mit bausync verbunden.

Über die REST-API legt deine Software Projekte und Ausschreibungen in bausync an und liest Angebote und Neuigkeiten zurück. Deine Benutzer geben den Zugriff selbst frei.

Was sich anbinden lässt Projekte · Ausschreibungen · Unternehmer · Dokumente · Angebote
API-Einbindungen
Phase 01

Den Zugang einrichten

Die Anbindung startet mit einem Token für deine Software.

Token vom Support

Deine Software weist sich bei jedem Aufruf mit einem Token aus. Du erhältst ihn über den Support, und bausync zeigt ihn nur beim Erstellen an.

Dokumentation

Die Dokumentation im OpenAPI-Format beschreibt Felder, Beispiele und Antwortcodes der Endpunkte.

Den Zugang einrichten
Phase 02

Benutzer verknüpfen

Ohne Zustimmung des Benutzers fliessen keine Daten.

Freigabe durch den Benutzer

Kennt bausync den Benutzer noch nicht, enthält die Antwort einen Link, über den er den Zugriff einmalig freigibt.

Rechte des Benutzers

Beim Anlegen und Ändern von Projekten und Ausschreibungen sowie beim Laden von Angeboten prüft bausync die Rechte des Benutzers.

Benutzer verknüpfen
Phase 03

Daten übertragen

Einmal erfasst, in beiden Systemen verwendbar.

Projekte und Ausschreibungen

Lege Projekte mit Teilprojekten und Ausschreibungen mit Terminen und Konditionen an. Bestehende Datensätze verknüpfst du mit deinen eigenen Ids.

Unternehmer und Dokumente

Übertrage Unternehmer in die Adressliste und lade Dokumente zur Ausschreibung hoch. Nach der Veröffentlichung lassen sich nur noch die Anbieter aktualisieren.

Daten übertragen
Phase 04

Ergebnisse zurücklesen

Was in bausync entsteht, kommt zurück in deine Software.

Angebote laden

Lies je Ausschreibung die Anbieter mit Einladungsstatus, Konditionen, Totalen und Dateien aus. Die Download-Links gelten 24 Stunden.

Neuigkeiten und Fehlerberichte

Das Dashboard liefert bis zu 50 Einträge pro Abfrage. Bei Übertragungsfehlern enthält die Antwort einen Link zu einem Bericht für deine Benutzer.

Ergebnisse zurücklesen
Aus der Praxis

Bisher — und mit bausync.

Bisher

  • Projektdaten werden in zwei Systemen von Hand erfasst.
  • Nummern und Adressen laufen mit der Zeit auseinander.
  • Angebotssummen werden ins eigene System abgetippt.
  • Den Stand der Einladungen sieht man nur in bausync.

Mit bausync

  • Deine Software legt Projekt und Ausschreibung in bausync an.
  • Übertragene Felder bleiben in bausync gesperrt.
  • Angebotssummen und Konditionen kommen per Abfrage zurück.
  • Einladungsstatus und Neuigkeiten lassen sich abfragen.
Häufige Fragen

Was du wissen willst.

01Wie komme ich zu einem Zugang?

Über den Support. Eine Seite, auf der du Tokens selbst erstellst oder verwaltest, gibt es derzeit nicht.

02Kann ich LV-Positionen übertragen?

Nein. Die API überträgt Projekte, Ausschreibungen, Unternehmer, Dokumente sowie Angebotssummen und Konditionen, aber keine einzelnen LV-Positionen.

03Kann die API eine Ausschreibung veröffentlichen?

Nein. Die Antwort enthält einen Link, über den du die Ausschreibung in bausync prüfst und weiterbearbeitest.

04Meldet bausync Änderungen von selbst an meine Software?

Nein, Webhooks gibt es derzeit nicht. Deine Software fragt Angebote und Neuigkeiten selbst ab.

05Gelten auch die Projektrollen?

Bei den meisten Endpunkten noch nicht. Geprüft wird das Recht aus der Firmenrolle, eine davon abweichende Projektrolle berücksichtigt die API derzeit nicht.

06Sind auch Sitzungskalender, Rundgang oder Rapporte erreichbar?

Nein, diese Bereiche bietet die API derzeit nicht an.

07Können Einladungen über unseren eigenen Mailserver gehen?

Ja, das ist unabhängig von der API. Der Support richtet deinen Server ein, unter «Einstellungen › E-Mail und Signatur» wählst du ihn aus. Ist die Verbindung gestört, gehen die nächsten Einladungen über bausync.

Prüfe, wie bausync zu deiner Software passt.

30 Tage kostenlos, ohne Kreditkarte.