Zum Inhalt springen
    tinana

    Doctolib-Synchronisation

    Wenn ihr Doctolib für die Online-Terminbuchung nutzt, könnt ihr es mit tinana verbinden. So erscheinen Doctolib-Buchungen automatisch in eurem tinana-Kalender.

    Doctolib verbinden

    Für die Verbindung nutzt ihr die API-Zugangsdaten von Doctolib – nicht euren persönlichen Doctolib-Login. Bei Fragen zur Einrichtung unterstützt euch unser Team.

    1. Fordert bei Doctolib die API-Zugangsdaten für die Schnittstelle an. Ihr erhaltet eine Client ID & ein Client Secret.
    2. Navigiert in tinana zu Einstellungen → Integration.
    3. Öffnet den Bereich Doctolib. Links seht ihr die fünf Bereiche Verbindung, Rechte, Kalender, Heilmittel & Konfiguration.
    4. Tragt im Bereich Verbindung Client ID & Client Secret ein.
    5. Klickt auf Verbinden. tinana prüft die Zugangsdaten direkt bei Doctolib & lädt anschließend eure Doctolib-Konfiguration mit Kalendern & Terminarten. Danach zeigt der Bereich Verbindung den Status Aktiv.
    Die Doctolib-Integration mit den Einrichtungsbereichen links sowie den Feldern Client ID und Client Secret.
    Für die Verbindung nutzt ihr die API-Zugangsdaten von Doctolib (Client ID & Client Secret).

    Einrichtung: Kalender & Terminarten zuordnen

    Nach dem Verbinden läuft die Schnittstelle noch nicht. Zuerst legt ihr einmalig fest, welcher Doctolib-Kalender zu welcher Mitarbeiter:in gehört & welches Heilmittel hinter einer Doctolib-Terminart steckt. Die Doctolib-Kachel zeigt dafür an, wie viele Terminarten, Mitarbeiter & Standorte erkannt wurden.

    1. Klickt in der Doctolib-Kachel auf Einrichtung starten. Es öffnet sich die Seite Doctolib einrichten mit den Schritten Kalender, Terminarten, An Doctolib übermitteln & Schnittstelle starten.
    2. Kalender: Wählt für jeden Doctolib-Kalender unter Zuordnen … die passende Mitarbeiter:in. Kalender, die ihr nicht braucht, setzt ihr auf Nicht relevant. Kalender, die tinana selbst angelegt hat, sind bereits zugeordnet.
    3. Terminarten: Sobald alle Kalender zugeordnet sind, wählt ihr für jede Doctolib-Terminart das passende Heilmittel – auf Wunsch auch mehrere. Eindeutige Treffer ordnet tinana schon vor, ihr könnt sie jederzeit ändern. Was ihr nicht abrechnet, etwa Erstgespräche oder Blocker, ignoriert ihr über das Dreipunkt-Menü.
    4. Klickt auf Weiter: An Doctolib übermitteln. Noch offene Terminarten ignoriert tinana nach einer Rückfrage. Die Zuordnung legt tinana als Datei für Doctolib bereit – ihr müsst nichts verschicken. Doctolib trägt daraufhin die tinana-Kennungen bei euren Terminarten & Kalendern ein.
    5. Im Schritt Schnittstelle starten seht ihr, wie viele Kennungen Doctolib schon eingetragen hat. Sind alle eingetragen, klickt ihr auf Jetzt starten. Ab dann werden Termine abgeglichen.

    Jede Zuordnung wird sofort gespeichert. Ihr könnt also jederzeit unterbrechen & später über Einrichtung fortsetzen weitermachen. Über Aktualisieren holt ihr Kalender & Terminarten neu von Doctolib. Ist alles bereit, erscheint ein grüner Punkt an Einstellungen, Integration & Doctolib – starten könnt ihr dann auch direkt in der Doctolib-Kachel über Jetzt starten.

    Die Bereiche der Doctolib-Integration

    • Rechte: Mit Verordnungen automatisch zuordnen ordnet tinana eingehenden Doctolib-Terminen automatisch eine passende Verordnung zu, wenn Heilmittel erkannt werden. Zugeordnet wird nur eine Verordnung, die für das Heilmittel noch freie Behandlungen hat – abgesagte & nicht wahrgenommene Termine zählen dabei nicht mit.
    • Kalender & Heilmittel: Hier pflegt ihr die Zuordnungen auch nach dem Start. Die Heilmittel-Liste filtert ihr nach Status, etwa Offen, Wartet auf Doctolib, Zugeordnet oder Ignoriert. Neue Zuordnungen gebt ihr über An Doctolib übermitteln bzw. Erneut an Doctolib übermitteln an Doctolib weiter.
    • Konfiguration: Über Jetzt synchronisieren übertragt ihr den aktuellen Stand – Fachrichtungen, Standorte, Kalender & Besuchsgründe – an Doctolib. Vor dem Start der Schnittstelle ist der Button gesperrt, denn der Start überträgt die Konfiguration selbst. Über Exportieren gebt ihr diese Konfiguration als Tabelle (CSV) oder als JSON aus; das geht auch ohne Verbindung. Unter Bestandsdaten abgleichen übernehmt ihr über Zeitraum wählen vergangene & künftige Termine nachträglich.

    Kombinierte Heilmittel

    Doctolib kennt nur einen Besuchsgrund je Termin. Buchungen über Doctolib können aber mehrere Behandlungen enthalten (z. B. Manuelle Therapie plus Wärmetherapie). Gibt es dafür in Doctolib schon eine Terminart, ordnet ihr dieser Terminart einfach mehrere Heilmittel zu. Eine neue Kombination legt ihr im Bereich Heilmittel an:

    1. Klickt im Bereich Heilmittel auf Neu.
    2. Vergebt einen Namen, wählt den Therapiebereich & über Heilmittel hinzufügen die Heilmittel, die gemeinsam als eine Doctolib-Leistung gebucht werden.
    3. Klickt auf Erstellen.

    Selbst angelegte Terminarten tragen in der Liste den Zusatz in tinana angelegt & werden beim Abgleich an Doctolib übertragen.

    Wie funktioniert die Synchronisation?

    • Nach dem Start der Schnittstelle erscheinen neue Buchungen über Doctolib automatisch im tinana-Kalender.
    • Über eure Zuordnung landet der Termin bei der richtigen Mitarbeiter:in & mit den passenden Heilmitteln. Solange Doctolib die Kennung einer Terminart noch nicht eingetragen hat, kommen Termine darauf ohne Heilmittel an – in der Liste steht dann Wartet auf Doctolib.
    • Termine aus Doctolib tragen beim Öffnen im Kalender das Doctolib-Logo mit dem Hinweis Gebucht über Doctolib.
    • Legt ihr in Doctolib neue Kalender oder Terminarten an, weist die Doctolib-Kachel darauf hin. Über Zuordnungen öffnen ordnet ihr sie zu, über Ignorieren legt ihr sie beiseite.
    • Solange Doctolib verbunden ist, läuft die Online-Buchung komplett über Doctolib. Unter Einstellungen → Online-Buchung seht ihr dann nur den Hinweis Online-Buchung läuft über Doctolib.

    Wichtige Hinweise

    • Die Verbindung erfordert ein aktives Doctolib-Konto mit API-Zugang.
    • Ordnet alle Kalender zu, die ihr nutzt: Termine aus einem Kalender ohne Zuordnung landen bei keiner Mitarbeiter:in.
    💡 Tipp: Ihr startet neu mit Doctolib? Mit dem [Doctolib-Bundle](/partner/doctolib) bekommt ihr tinana & Doctolib zusammen vergünstigt – die Anbindung richten wir dabei im Onboarding mit euch ein.