Willkommen beim ITscope SaaS Connector von Mate iT! Diese Anleitung führt Sie in wenigen Schritten von der Registrierung bis zu Ihrem ersten importierten Produkt in Odoo.

---

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

Hinweis: Sie benötigen keine eigenen KI-Schlüssel — die KI-Funktionen laufen über unseren Cloud-Dienst. Ihren ITscope-Token hinterlegen Sie im Kundenportal unter Einstellungen → ITscope Token. In Odoo konfigurieren Sie lediglich den SaaS-API-Key.

---

Schritt 1: Registrierung im Kundenportal

1. Öffnen Sie das Kundenportal unter portal.connector.mateit.de.
2. Klicken Sie auf „Konto erstellen".
3. Geben Sie Ihre geschäftliche E-Mail-Adresse ein.
4. Sie erhalten einen Magic Link per E-Mail — klicken Sie darauf, um Ihr Konto zu aktivieren.
5. Vervollständigen Sie Ihr Firmenprofil (Firmenname, Anschrift, USt-IdNr.).

Hinweis: Der Login erfolgt passwortlos per E-Mail-Link. Sie erhalten einen sicheren Anmeldelink direkt in Ihr Postfach.

---

Schritt 2: Subscription buchen

1. Nach der Registrierung werden Sie zum Subscription-Bereich weitergeleitet.
2. Wählen Sie Ihre gewünschte Subscription.
3. Sie werden zur sicheren Zahlungsseite weitergeleitet.
4. Wählen Sie Ihre bevorzugte Zahlungsmethode (Kreditkarte, SEPA-Lastschrift oder PayPal).
5. Nach erfolgreicher Zahlung werden Ihrem Konto automatisch 25.000 Credits gutgeschrieben.

Tipp: Credits werden nur für KI-Anreicherungen (Kategorisierung, Artikelbeschreibungen) verbraucht. Die Produktsuche im ITscope-Katalog ist kostenfrei.

---

Schritt 3: API-Key erstellen

1. Navigieren Sie im Portal zu Einstellungen → API-Keys.
2. Klicken Sie auf „Neuen API-Key erstellen".
3. Vergeben Sie eine Bezeichnung (z. B. „Odoo Produktion").
4. Der API-Key wird einmalig angezeigt — kopieren und sicher speichern.

Der Key hat das Format:

sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Wichtig: Der API-Key wird nach der Erstellung nur einmal vollständig angezeigt. Speichern Sie ihn sofort in einem Passwortmanager. Bei Verlust können Sie jederzeit einen neuen Key erstellen und den alten deaktivieren.

---

Schritt 4: ITscope-Token hinterlegen

1. Navigieren Sie im Portal zu Einstellungen → ITscope Token.
2. Geben Sie Ihren ITscope-API-Token ein (aus Ihrem ITscope-Händlerkonto).
3. Klicken Sie auf Speichern.

Wo finde ich meinen ITscope-Token? Melden Sie sich bei itscope.com an und navigieren Sie zu Ihrem API-Bereich.

---

Schritt 5: Odoo-Modul installieren

1. Laden Sie das Modul im Portal unter Modul-Download herunter.
2. Entpacken Sie das ZIP-Archiv in Ihr Odoo Custom-Addons-Verzeichnis:

unzip itscope_connector_v5.zip -d /opt/odoo/custom_addons/

3. Starten Sie Odoo mit Modul-Update neu:

/opt/odoo/odoo-bin -c /etc/odoo/odoo.conf -u itscope_connector -d <database_name> --stop-after-init

4. Alternativ: Gehen Sie in Odoo zu Apps → App-Liste aktualisieren und installieren Sie „ITscope Connector V4 (Enterprise)".

Hinweis: Eine ausführliche Installationsanleitung finden Sie unter Odoo-Modul Installation.

---

Schritt 6: SaaS-API-Key in Odoo konfigurieren

1. Öffnen Sie in Odoo: Einstellungen → ITscope Connector.
2. Im Bereich „SaaS-Verbindung":
   • SaaS Base-URL: https://api.connector.mateit.de/api/v1
   • SaaS API-Key: Fügen Sie den in Schritt 3 erstellten Key ein.
3. Klicken Sie auf „Verbindung testen".
4. Bei erfolgreicher Verbindung erscheint ein grünes Status-Banner mit Ihrem Credit-Saldo.

✓ SaaS-Verbindung aktiv — Credit-Saldo: 25.000 Credits

Hinweis: Die API-Key-Felder sind nur für System-Administratoren (base.group_system) sichtbar. Normale Benutzer sehen diese Felder nicht.

---

Schritt 7: Erstes Produkt suchen und importieren

1. Öffnen Sie einen Verkaufsauftrag in Odoo.
2. Klicken Sie auf „ITscope Katalog" in der Toolbar.
3. Geben Sie einen Suchbegriff ein (z. B. „Dell Latitude 5540").
4. Die Suchergebnisse zeigen Produkte mit Preis, Verfügbarkeit und Lieferanten.
5. Wählen Sie ein Produkt aus und klicken Sie auf „Importieren".
6. Optional: Aktivieren Sie die KI-Anreicherung für:
   • Automatische Kategorie-Zuordnung
   • Optimierte Artikelbeschreibung auf Deutsch

Tipp: Die Produktsuche verbraucht keine Credits. Nur KI-Aktionen (Kategorisierung, Artikelbeschreibung) werden mit Credits abgerechnet.

---

Nächste Schritte

Nachdem Sie Ihr erstes Produkt erfolgreich importiert haben, empfehlen wir Ihnen folgende Artikel:

---

Hilfe & Support

Bei Fragen oder Problemen:

• Dokumentation: docs.connector.mateit.de
• E-Mail: support@mateit.de
• Portal: Status und Logs unter portal.connector.mateit.de