Installation & Erster Start

Um den Gambio Bestellungs-Exporter nutzen zu können, sind nur wenige Schritte notwendig. Das Programm ist als eigenständige Anwendung konzipiert und erfordert keine komplexe Installation.

1. Installation

1. Download: Laden Sie das Programmpaket (.zip-Archiv) von der bereitgestellten Quelle herunter und entpacken Sie es in einen Ordner Ihrer Wahl.
2. Inhalt des Pakets: In diesem Ordner befinden sich nun mindestens zwei wichtige Dateien:
   • Gambio Bestellungs-Exporter.exe: Die ausführbare Programmdatei.
   • public_key.pem: Der öffentliche Schlüssel zur Überprüfung Ihrer Lizenz.
3. Wichtiger Hinweis: Die .exe-Datei und die public_key.pem müssen immer im selben Verzeichnis verbleiben, damit die Lizenzprüfung funktioniert.

2. Erster Start & Lizenzprüfung

Beim ersten Start der Anwendung per Doppelklick auf die .exe-Datei wird automatisch eine Lizenzprüfung durchgeführt:

• Lizenzdatei (license.key) nicht gefunden: Falls noch keine gültige Lizenzdatei (license.key) im selben Verzeichnis wie die .exe-Datei und die public_key.pem vorhanden ist, wird eine Fehlermeldung angezeigt. Diese Meldung enthält Ihre Hardware-ID.
  • Aktion: Kopieren Sie diese Hardware-ID und senden Sie sie an uns, um Ihre persönliche Lizenzdatei zu erhalten.
  • Lizenzdatei platzieren: Sobald Sie Ihre license.key-Datei erhalten haben, legen Sie diese bitte in dasselbe Verzeichnis, in dem sich auch die Gambio Bestellungs-Exporter.exe und die public_key.pem befinden. Starten Sie die Anwendung anschließend neu.
• Lizenzprüfung erfolgreich: Wenn eine gültige license.key-Datei gefunden und die Lizenz erfolgreich verifiziert wurde, startet die Anwendung wie gewohnt.

3. API-Zugangsdaten eingeben

Im Tab „Export“ finden Sie die Felder zur Eingabe Ihrer Gambio API-Zugangsdaten:

• Shop-Adresse (URL): Geben Sie hier die vollständige URL zu Ihrem Gambio-Shop ein, z.B. https://www.ihr-shop.de. Das Programm ergänzt automatisch den API-Endpunkt (/api.php/v2).
• Benutzer: Tragen Sie den Benutzernamen Ihres Gambio API-Accounts ein.
• Passwort: Geben Sie das Passwort Ihres Gambio API-Accounts ein.
• Passwort anzeigen: Aktivieren Sie die Checkbox „Passwort anzeigen“, um das eingegebene Passwort im Klartext zu sehen.

4. Masterpasswort festlegen (optional)

Wenn Sie die Option „Zugangsdaten speichern“ aktivieren und noch kein Masterpasswort festgelegt haben, erscheint ein Dialogfenster:

• Zweck: Das Masterpasswort dient dazu, Ihre API-Zugangsdaten verschlüsselt auf Ihrem Computer zu speichern, sodass Sie diese nicht bei jedem Start neu eingeben müssen.
• Festlegen: Geben Sie ein sicheres Masterpasswort ein und bestätigen Sie es. Merken Sie sich dieses Passwort gut, da es zum Entschlüsseln Ihrer Zugangsdaten benötigt wird.
• Speichern: Klicken Sie anschließend auf den Button „Speichern/Löschen“, um Ihre Zugangsdaten sicher zu hinterlegen.

5. Verbindung testen

Um zu überprüfen, ob die Verbindung zu Ihrem Gambio-Shop mit den eingegebenen Zugangsdaten funktioniert, klicken Sie einfach auf den Button „Export starten“.

• Erfolgreich: Im Statusfenster unten sehen Sie Meldungen wie „Verbinde mit API…“ und „Rufe Bestelldaten ab…“. Wenn keine Fehlermeldung erscheint, ist die Verbindung erfolgreich.
• Fehler: Bei Problemen (z.B. falsche Zugangsdaten, Shop nicht erreichbar) erhalten Sie eine entsprechende Fehlermeldung im Statusfenster und ggf. ein Popup-Fenster mit Details.