Voraussetzungen und Berechtigungen
- Bitten Sie Provet, die OAuth-Integration mit Client ID und Client secret, dem Ablauf client_credentials und dem Geltungsbereich restapi zu aktivieren. Die Rechte des zugeordneten virtuellen Benutzers bestimmen die lesbaren Ressourcen.
- Der ImaCash-Rechner benötigt ausgehenden HTTPS-Zugriff auf Provet Cloud. Bestätigen Sie mit Provet die Domain Ihrer Instanz und deren Kompatibilität mit der installierten Version; ändern Sie weder Domain noch Zertifikate, um Fehler zu umgehen.
- Erlauben Sie Lesezugriff auf department, invoice, invoicepayment, unallocatedpayment und user für die betreffende Abteilung. Ein gültiges Token garantiert keinen Zugriff auf jede Ressource. Diese Abfragen benötigen keine Schreibrechte.
- Beantragen Sie auch Lesezugriff auf den Katalog paymentmethod, um benutzerdefinierte Methoden einschließlich benutzerdefinierter Kartenzahlungen zu erkennen. Provet muss passende Katalogrechte vergeben; gewähren Sie dafür keine allgemeinen Administratorrechte.
Einrichtung in ImaCash
- Öffnen Sie Konfiguration > Integration und wählen Sie Provet Cloud. Der frühere Name Provet Cloud V2 bleibt nur als Kompatibilitätsalias bestehen, nicht als zweite Integration.
- Provet ID (tenantId): die von Provet bereitgestellte numerische Instanz- oder Klinikkennung. Dies ist weder Benutzername noch E-Mail-Adresse oder Abteilungs-ID; geben Sie nur die Kennung ein, keine URL.
- Client ID: die OAuth-Kennung der für diese Instanz aktivierten Integration.
- Client secret: Private Angabe des Administrators. Ausschließlich in ImaCash eingeben.
- Speichern Sie die Konfiguration und wählen Sie bei Aufforderung die Abteilung dieser Kasse. Prüfen Sie vor dem Test auch die Benutzerfilter und die aktive Währung.
Erfassung und Zahlungsarten
- ImaCash liest abgeschlossene Rechnungen der Abteilung, deren Zahlungen und nicht zugeordnete Zahlungen. Vergleichen Sie stets Beträge, Währung und Zahlungsart in beiden Systemen; ein API-Lesezugriff bestätigt keine physische Bargeldbewegung.
- Die dokumentierten Standardtypen sind payment_type=1 für Bargeld und payment_type=0 für Karte. Ihre Erkennung hängt nicht von einer erfolgreichen zusätzlichen paymentmethod-Abfrage ab.