Diese Anleitung beschreibt die Installation des ITscope Connector Moduls in Odoo. Das Modul verbindet Ihr Odoo-System über unsere SaaS-Plattform mit dem ITscope-Katalog und den KI-Funktionen.

Voraussetzungen

Was Sie brauchen Details
Odoo-Version Odoo 17, 18 oder 19 (Community oder Enterprise)
ITscope-Konto Aktive Subscription im Kundenportal
Internetzugang Odoo-Server muss api.connector.mateit.de erreichen können

Schritt 1: Modul herunterladen

  1. Öffnen Sie portal.connector.mateit.de im Browser
  2. Melden Sie sich mit Ihrem Konto an
  3. Klicken Sie links auf “Modul-Download”
  4. Klicken Sie auf den Button “ZIP herunterladen”
  5. Die Datei wird auf Ihrem Computer gespeichert (z.B. im Downloads-Ordner)

Wichtig: Der Download erfordert eine aktive Lizenz.

Schritt 2: Modul in Odoo installieren

Wählen Sie den Weg, der zu Ihrer Odoo-Umgebung passt:

Option A: Odoo.sh (Cloud) — per Git

Dies ist der empfohlene Weg für Odoo.sh-Kunden. Sie benötigen Git auf Ihrem Computer.

Eine ausführlichere Schritt-für-Schritt-Erklärung (auch für Git-Einsteiger) finden Sie unter Installation via Git (odoo.sh).

Git installieren (falls noch nicht vorhanden):

  • Mac: Bereits vorinstalliert (Terminal öffnen → git --version)
  • Windows: git-scm.com herunterladen und installieren

Schritt-für-Schritt:

# 1. Repository klonen (einmalig)
git clone -b IHR-BRANCH https://github.com/IHR-GITHUB-USER/IHR-ODOO-REPO.git
cd IHR-ODOO-REPO

# 2. Alten Modulordner löschen (falls vorhanden)
rm -rf itscope_connector
rm -f itscope_connector-*.zip

# 3. Neue Version entpacken
#    Mac:
unzip ~/Downloads/itscope_connector-*.zip -d .
#    Windows (Git Bash):
unzip /c/Users/BENUTZERNAME/Downloads/itscope_connector-*.zip -d .

# 4. Prüfen ob der Ordner korrekt ist
ls itscope_connector/__manifest__.py

# 5. Änderungen hochladen
git add -A
git commit -m "Update ITscope Connector"
git push origin IHR-BRANCH
Wichtig: Manuelle Entpackung (Doppelklick)

Wenn Sie die ZIP-Datei nicht im Terminal, sondern per Doppelklick entpackt haben (z.B. im Finder auf Mac oder Explorer auf Windows), liegt der Ordner itscope_connector/ noch in Ihrem Downloads-Ordner — nicht im Git-Repository!

Sie müssen den Ordner dann manuell verschieben:

  • Mac (Finder): Ziehen Sie den Ordner itscope_connector aus dem Downloads-Ordner in den Ordner Ihres geklonten Repositories (z.B. IHR-ODOO-REPO/)
  • Windows (Explorer): Schneiden Sie den Ordner itscope_connector aus (Strg+X) und fügen Sie ihn im Repository-Ordner ein (Strg+V)
  • Oder im Terminal:
    mv ~/Downloads/itscope_connector IHR-ODOO-REPO/

Danach weiter mit Schritt 4 (“Prüfen ob der Ordner korrekt ist”) und Schritt 5 (“Änderungen hochladen”).

Nach dem Push baut odoo.sh Ihre Instanz automatisch neu. Das Modul steht danach unter Apps zur Installation bereit.

Zusammenfassung als Copy-Paste-Block (für erfahrene Nutzer):

git clone -b IHR-BRANCH https://github.com/USER/REPO.git && cd REPO
rm -rf itscope_connector && rm -f itscope_connector-*.zip
unzip ~/Downloads/itscope_connector-*.zip -d .
git add -A && git commit -m "Update ITscope Connector" && git push origin IHR-BRANCH

Hinweis zum Branch: Ersetzen Sie IHR-BRANCH durch den Namen Ihres Produktions- oder Staging-Branches (z.B. main, production oder staging). Dieser Branch ist direkt mit Ihrer odoo.sh-Umgebung verbunden — Änderungen werden nach dem Push sofort deployed.

Option B: Eigener Server — per Kommandozeile

  1. Odoo-Server stoppen:
sudo systemctl stop odoo
  1. ZIP-Archiv auf den Server kopieren und entpacken:
unzip itscope_connector-*.zip -d /opt/odoo/custom-addons/
  1. Odoo neu starten:
sudo systemctl start odoo

Wichtig: Stellen Sie sicher, dass der Pfad /opt/odoo/custom-addons/ in Ihrer Odoo-Konfiguration unter addons_path eingetragen ist.

Option C: Odoo Web-Interface

  1. Entpacken Sie die ZIP-Datei und legen Sie den Ordner itscope_connector in Ihren Odoo-Addons-Ordner
  2. Starten Sie Odoo neu
  3. Melden Sie sich als Administrator an
  4. Gehen Sie zu Apps → klicken Sie auf “Addon-Liste aktualisieren”
  5. Suchen Sie nach “ITscope”
  6. Klicken Sie auf “Installieren”

Schritt 3: Modul in Odoo aktivieren

Nach der Installation (egal welcher Weg):

  1. Melden Sie sich in Odoo als Administrator an
  2. Gehen Sie zu Apps
  3. Klicken Sie auf “Addon-Liste aktualisieren”
  4. Suchen Sie nach “ITscope Connector”
  5. Klicken Sie auf “Installieren”

Schritt 4: Verbindung zum ITscope-Service herstellen

  1. Gehen Sie zu Einstellungen (Zahnrad-Symbol)
  2. Scrollen Sie zu “ITscope Connector”
  3. Tragen Sie folgende Daten ein:
Feld Wert
SaaS Base-URL https://api.connector.mateit.de/api/v1
SaaS API-Key Ihr persönlicher Schlüssel aus dem Portal
  1. Klicken Sie auf “Verbindung testen”

Bei Erfolg sehen Sie:

✓ SaaS-Verbindung aktiv — Credit-Saldo: XX.XXX Credits

Wo finde ich meinen API-Key? Im Kundenportal unter Einstellungen → API-Key.

Schritt 5: Erste Schritte nach der Installation

Nach erfolgreicher Verbindung können Sie sofort loslegen:

  • Produkte suchen: Öffnen Sie einen Verkaufsauftrag → Klicken Sie auf “ITscope Katalog”
  • Preise aktualisieren: Läuft automatisch täglich im Hintergrund
  • Bestellungen importieren: Läuft automatisch alle 15 Minuten

Modul aktualisieren (Update)

Bei neuen Versionen:

  1. Laden Sie die neue Version im Portal herunter
  2. Wiederholen Sie Schritt 2 (je nach Ihrer Installation)
  3. In Odoo: Apps → “ITscope Connector” suchen → “Upgrade” klicken

Tipp: Erstellen Sie vor Updates immer ein Backup Ihrer Datenbank.

Häufige Probleme

Problem Lösung
Modul wird in Odoo nicht angezeigt Die ZIP-Datei wurde nicht entpackt! Odoo erkennt nur Ordner, keine ZIP-Dateien.
“Verbindung fehlgeschlagen” Prüfen Sie ob der API-Key korrekt kopiert wurde (keine Leerzeichen am Anfang/Ende)
“Permission denied” beim Git-Push Ihr GitHub-Token braucht repo-Berechtigung
“Merge conflict” Führen Sie zuerst git pull origin IHR-BRANCH aus
Modul lässt sich nicht installieren Prüfen Sie den Addons-Pfad: grep addons_path /etc/odoo/odoo.conf
Preise werden nicht aktualisiert Prüfen Sie unter Einstellungen → Technisch → Geplante Aktionen ob der Cron-Job aktiv ist

Weiterführende Artikel