gsBase mit ImaCash einrichten
gsBase ist eine Plattform zur Entwicklung von Geschäftsanwendungen. Diese Anleitung beschreibt das ImaCash-Profil für den Dateiaustausch; der Anbieter muss bestätigen, dass die installierte Anwendung dieses Format erzeugt und empfängt. Sie belegt keine Kompatibilität mit allen ERP-Systemen, Versionen oder der gsBase-API.
1. Einen eigenen Ordner vorbereiten
Vereinbare mit dem Anbieter einen Austauschordner für einen Arbeitsplatz und einen einzigen Dateiabnehmer. Das tatsächliche Windows-Konto von ImaCash muss Dateien auflisten, Eingaben exklusiv zum Lesen und Schreiben öffnen, sie löschen und den Unterordner RESPUESTA samt Dateien anlegen können. Wähle weder ein Laufwerksstammverzeichnis noch Dokumente, Sicherungen oder Ordner anderer Programme.
2. Das aktuelle Profil auswählen
Öffne Konfiguration > Integration und wähle POS > GsBase. Wähle unter Verkäufe über das Ordnersymbol das vereinbarte Verzeichnis. Dieses Profil fragt weder Server, Port, SQL-Konto, Passwort noch DSN ab. Private Installationsdaten stellt der Administrator bereit.
3. Datensätze und Referenzen abstimmen
Der Leser verwendet .txt-Dateien der obersten Ebene. Bereite einen kompakten Datensatz je Datei vor: UTF-8 ohne BOM, kleiner als 1 KiB, mit vier durch Semikolon getrennten Feldern: Filiale; Verkaufsreferenz; Verkäufer; Betrag. Ein fünftes Feld wird akzeptiert, aber nicht verwendet. Die Referenz stammt aus dem zweiten Feld, nicht dem Dateinamen; sie muss eindeutig und als Name der Antwortdatei gültig sein. Verwende weder Pfade noch Verzeichnistrennzeichen.
4. Die Betragseinheit bestätigen
Das vierte Feld wird auf zwei Arten gelesen: Wird es als Ganzzahl erkannt, wird es durch hundert geteilt; andernfalls wird es gemäß den Windows-Regionseinstellungen als Dezimalzahl umgewandelt. Der Anbieter muss Einheit, Dezimaltrennzeichen, Vorzeichen, Währung und resultierenden Betrag vor dem Einsatz prüfen. Gehe weder davon aus, dass eine Ganzzahl ganze Währungseinheiten darstellt, noch dass derselbe Dezimaltext auf jedem Rechner funktioniert.
5. Speichern und Zugriff prüfen
Speichere und schließe unter dem Windows-Konto von ImaCash mit vollständigem, nicht leerem Pfad. Beim Start versucht das Profil, RESPUESTA vorzubereiten; die Anzeige verbunden belegt weder das Lesen der Kasse, korrektes Format noch Bargeld. Prüfe Ordner, Berechtigungen, Betrag und Empfang der Antworten vor dem gewerblichen Einsatz mit dem Anbieter.
6. Lesen und Kennungen verstehen
Eingaben werden nach dem Lesen und vor der Ergebnisbestätigung gelöscht, auch wenn kein gültiger Verkauf entsteht. Es gibt weder ein Archiv verarbeiteter Dateien noch historische Wiederherstellung nach Datum. Filiale und Verkäufer stammen aus dem Datensatz; das Terminal wird intern zugewiesen und das Datum ist die Lesezeit, kein importiertes Verkaufsdatum. Filial-, Kassen- oder Verkäuferkataloge werden nicht abgefragt und Filter belegen keine Trennung nach Arbeitsplatz. Bewahre die Nachvollziehbarkeit an der Quelle und stelle Dateien nicht zum Wiederholen erneut ein.
7. RESPUESTA prüfen
Die Bestätigung versucht, in RESPUESTA mit der Verkaufsreferenz und Endung .OK zu schreiben: Betrag, übergebener Betrag und Wechselgeld, getrennt durch |. Prüfe das Vorzeichen des Wechselgelds mit dem Anbieter. Ein als storniert markierter Vorgang versucht .KO mit dem Betrag und zwei Nullen. Ablehnen allein schreibt keine Antwort. Eine vorhandene Datei belegt weder deren Einlesen durch die Kasse, den Verkaufsabschluss noch die abgeschlossene Stornierung.
8. Ablauf und Grenzen validieren
Dieses Profil erfasst Eingaben als Bargeld und bietet weder die Auswahl Karten akzeptieren, eine unabhängige Bankkartenaufschlüsselung, Produkte, Bestände noch Schichten. Das fünfte Feld belegt keine Zahlungsart. Prüfe unter Aufsicht Referenzen, Beträge und Vorzeichen, Antworten in beiden Programmen und tatsächliches Bargeld. Bei unklarem Ergebnis prüfe dies vor Wiederholung, erneutem Einstellen von Dateien, Synchronisieren oder Neustart. Eine Anleitung oder Verbindung belegt keine physische Validierung.
Wir behalten das gsBase-Logo des Katalogs bei; die Anleitung erklärt die aktuelle POS-Auswahl und ersetzt alte Konfigurationsaufnahmen.