Für die Integration von AhoraTPV mit ImaCash ist ein aktives Modul von Ahora TPV erforderlich, das die Kommunikation zwischen den Systemen ermöglicht. Sobald es aktiv ist, muss der Techniker die Verbindungsdaten ausfüllen.
Auszuführende Schritte
1- Öffnen Sie die Integrationskonfiguration:
- Öffnen Sie in ImaCash Konfiguration > Integration > AhoraTPV.
2- Wählen Sie das POS-System aus:
- Wählen Sie die POS-Kategorie aus, in diesem Fall Retail.
- Wählen Sie anschließend AhoraTPV im Dropdown-Menü aus
3- Vervollständigen Sie die Verbindungsdaten:
- Web-URL: Geben Sie die Basis-URL mit dem genauen Protokoll des Dienstes, http:// oder https://, und dem überprüften Host ein. Geben Sie weder Port, abschließenden Schrägstrich, /api/Imacash-Pfade, Parameter, Benutzername noch Passwort an.
- Port: Geben Sie den tatsächlichen Port des Dienstes separat ein. Beispiel: Web-URL https://192.168.1.20 und Port 8443, nur wenn dies der autorisierte HTTPS-Endpunkt ist.
- Benutzer: ein von AhoraTPV für das ImaCash-Modul autorisiertes Konto mit Berechtigungen zum Abrufen und Bestätigen von Transaktionen.
- Passwort: das Passwort dieses Kontos, ausschließlich im dafür vorgesehenen Feld. Nehmen Sie Zugangsdaten niemals in die URL auf und teilen Sie sie nicht in Screenshots oder Protokollen.
- ImaCash-ID: die dieser Installation in AhoraTPV zugewiesene Kennung. Sie entspricht dem internen Feld Puestos und muss mit dem im AhoraTPV-Modul konfigurierten Wert übereinstimmen.
4- Speichern Sie die Konfiguration:
- Klicken Sie unten links auf die Schaltfläche Speichern (Diskettensymbol)
Voraussetzung: Das ImaCash-Modul von AhoraTPV muss aktiviert sein. Bestätigen Sie vor dem Speichern Protokoll, Host, Port, autorisiertes Konto und ImaCash-ID mit dem Verantwortlichen.
HTTPS, Zertifikate und Weiterleitungen
ImaCash 4.4.3.1263 akzeptiert private oder selbstsignierte Zertifikate ausschließlich für den lokalen oder privaten HTTPS-Endpunkt von AhoraTPV. Diese Ausnahme gilt nicht für öffentliche Server und deaktiviert die Zertifikatsprüfung nicht global. Bei einem TLS-Fehler erfolgt kein automatischer Wechsel von HTTPS zu HTTP.
ImaCash 4.4.3.1264: Build validiert; Veröffentlichung noch zu bestätigen. Die Version blockiert Weiterleitungen von HTTPS zu HTTP, zu einem anderen Host und zu einem anderen Port innerhalb desselben Protokolls. Der Wechsel von HTTP zu HTTPS auf demselben Host ist erlaubt; lokales HTTPS bleibt erhalten. Schreiben Sie diesen zusätzlichen Schutz nicht 4.4.3.1263 zu; prüfen Sie vor einem Update die installierte Version und die Verfügbarkeit.
Ein TLS-Fehler oder eine abgelehnte Weiterleitung beweist kein falsches Passwort und erfordert keine Änderung des AhoraTPV-Dienstes. Konfigurieren Sie für lokale Zertifikate die überprüfte endgültige HTTPS-URL und den Port direkt, ohne sich auf Weiterleitungen zu verlassen.
Wenn eine Weiterleitung auf einen anderen Host verweist, prüfen Sie zuerst dessen Identität und Autorisierung mit dem AhoraTPV-Verantwortlichen. Konfigurieren Sie die endgültige Basis-URL und den Port ausdrücklich in ImaCash; senden Sie keine Zugangsdaten an ein ungeprüftes Ziel und fügen Sie der URL weder Benutzername noch Passwort hinzu.
Deaktivieren Sie bei einem ImaCash-Fehler weder Windows-Sicherheit, Virenschutz, Firewall noch die globale TLS-Prüfung und ändern Sie den Server nicht, um einen Clientfehler zu umgehen. Prüfen Sie zuerst die Version und die Verbindungsdaten. HTTP darf nur ausdrücklich konfiguriert werden, wenn es das tatsächliche autorisierte Protokoll ist, niemals als automatischer Ersatz bei einem HTTPS-Fehler.
Prüfungen vor dem Produktiveinsatz
Prüfen Sie vom ImaCash-Rechner aus den Zugriff auf den autorisierten Host und Port; speichern Sie die Konfiguration und bestätigen Sie die Anmeldung sowie das Laden der Benutzer und Kassen. Prüfen Sie bei Fehlern das aktivierte Modul, die ID, die Zugangsdaten und die bereinigte Diagnose, ohne Passwörter oder Tokens offenzulegen.
Prüfen Sie in einem kontrollierten Test den Eingang eines Verkaufs und die Rückmeldung seines Status an AhoraTPV. Die Integration ruft Transaktionen ab und bestätigt Abschluss, Fehler oder Stornierung über PUT /api/Imacash/transaccion; nur eine HTTP-2xx-Antwort bestätigt diese Übermittlung. Ein Timeout oder HTTP-Fehler belegt keine Bestätigung: Prüfen Sie beide Systeme, bevor Sie einen Bargeldvorgang wiederholen. Diese Dokumentation ersetzt keine Prüfung an der tatsächlichen Installation.
