Hier finden Sie Antworten auf die häufigsten Fragen zum ITscope SaaS Connector. Falls Ihre Frage nicht beantwortet wird, kontaktieren Sie uns unter support@mateit.de.

Authentifizierung & API-Keys

„Meine API-Anfragen werden mit 401 abgelehnt"

Mögliche Ursachen und Lösungen:

  1. API-Key fehlt im Request:
    Stellen Sie sicher, dass der Header X-API-Key in jeder Anfrage enthalten ist:

    curl -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://api.connector.mateit.de/api/v1/itscope/search?q=Dell"

  2. API-Key ungültig oder deaktiviert:
    Prüfen Sie im Kundenportal unter Einstellungen → API-Keys, ob der Key aktiv ist.

  3. API-Key falsch kopiert:
    Der Key muss vollständig kopiert werden (inkl. Prefix sk_live_). Achten Sie auf versehentliche Leerzeichen am Anfang oder Ende.

  4. Key in Odoo falsch eingetragen:
    Navigieren Sie zu Einstellungen → ITscope Connector → SaaS-Verbindung und prüfen Sie den eingetragenen Key. Nutzen Sie den „Verbindung testen"-Button.

Tipp: Erstellen Sie im Zweifelsfall einen neuen API-Key im Portal und tragen Sie diesen in Odoo ein. Deaktivieren Sie anschließend den alten Key.

Weiterführend: Authentifizierung & API-Keys

„Meine Anfragen werden mit 403 abgelehnt"

Ein 403 Forbidden-Fehler bedeutet, dass Ihr Konto gesperrt, gelöscht oder die Subscription abgelaufen ist.

Prüfen Sie:

  1. Konto-Status: Melden Sie sich im Portal an und prüfen Sie, ob Ihr Konto aktiv ist.
  2. Subscription-Status: Unter Dashboard sehen Sie Ihren Subscription-Status. Bei blocked oder cancelled müssen Sie die Subscription erneuern.
  3. Löschung beantragt? Falls Sie eine Kontolöschung beantragt haben, können Sie diese innerhalb von 14 Tagen widerrufen.

Credits & Abrechnung

„Credits werden nicht abgezogen"

Das ist korrekt! Nicht alle Aktionen verbrauchen Credits:

Aktion Credits
Produktsuche (/itscope/search) 0 — immer kostenfrei
Produktdetails (/itscope/product/{id}) 0 — immer kostenfrei
Batch-Preisabfrage (/itscope/batch-prices) 0 — immer kostenfrei
KI-Kategorisierung (/ai/enrich, mode=category) 3–5 Credits
KI-Artikelbeschreibung (/ai/enrich, mode=article) 4–8 Credits

Credits werden ausschließlich für KI-Anreicherungen (Kategorisierung und Artikelbeschreibung) verbraucht. Die Produktsuche und alle Katalog-Funktionen sind kostenfrei.

„Mein Credit-Saldo stimmt nicht"

  1. Prüfen Sie die Transaktionshistorie im Portal unter Credits.
  2. Jede Transaktion zeigt den genauen Verbrauch (delta_credits), den Grund (reason) und einen Zeitstempel.
  3. Bei LLM-Fehlern werden reservierte Credits automatisch zurückgebucht (Refund-Transaktionen mit reason: refund).
  4. Falls Sie eine Diskrepanz vermuten, kontaktieren Sie support@mateit.de — das System führt täglich einen automatischen Reconciliation-Job durch.

„Wie kann ich mehr Credits kaufen?"

  1. Melden Sie sich im Kundenportal an.
  2. Gehen Sie zu Credits.
  3. Wählen Sie ein Paket (XS: 5.000 Credits für 29 € bis XL: 1.000.000 Credits für 2.499 €).
  4. Schließen Sie die Zahlung über die sichere Zahlungsseite ab.
  5. Credits werden sofort gutgeschrieben.

Produktsuche

„Produktsuche liefert keine Ergebnisse"

Prüfen Sie:

  1. Suchbegriff zu kurz: Der Suchbegriff muss mindestens 2 Zeichen lang sein.
  2. Suchbegriff zu spezifisch: Versuchen Sie einen allgemeineren Begriff (z. B. „Dell Latitude" statt einer vollständigen Artikelnummer).
  3. ITscope-Service vorübergehend nicht erreichbar: Bei 502- oder 503-Fehlern ist der ITscope-Katalog temporär nicht verfügbar. Versuchen Sie es in einigen Minuten erneut.
  4. Netzwerkproblem: Stellen Sie sicher, dass Ihr Odoo-Server api.connector.mateit.de über HTTPS erreichen kann.

Hinweis: Die Produktsuche durchsucht den gesamten ITscope-Katalog (über 1,5 Mio. IT-Produkte). Wenn ein Produkt bei ITscope gelistet ist, wird es auch über die SaaS-API gefunden.

Weiterführend: Produktsuche

„Preise im Odoo stimmen nicht mit ITscope überein"

Produktpreise werden für 5 Minuten gecacht. Wenn sich ein Preis bei ITscope ändert, dauert es bis zu 5 Minuten, bis der neue Preis über die API zurückgegeben wird.

Für aktuelle Preise:

  • Warten Sie den Cache-Ablauf ab (5 Minuten).
  • Nutzen Sie die Batch-Preisabfrage (POST /itscope/batch-prices), die bei Cron-Jobs für automatische Preis-Updates verwendet wird.

KI-Funktionen

„KI-Kategorisierung ist langsam"

KI-Vorgänge benötigen typischerweise 5–15 Sekunden pro Produkt. Dies ist normal und liegt an der Komplexität der Analyse.

Hinweis: Bei Timeouts (über 30 Sekunden) werden reservierte Credits automatisch zurückgebucht. Sie können den Vorgang dann erneut starten.

„KI-Ergebnisse sind nicht zufriedenstellend"

Verbessern Sie die Ergebnisse durch:

  1. Mehr Produktdaten bereitstellen: Je vollständiger Ihre Produktdaten in Odoo sind (Attribute, Beschreibung), desto bessere Ergebnisse liefern die Agenten.
  2. Custom Instructions anpassen: Öffnen Sie den jeweiligen Agent im Customer Portal und hinterlegen Sie individuelle Anweisungen (z.B. Tonalität, Fachbegriffe, Formatierung).
  3. Eigene Kategorie-Hierarchie definieren: Geben Sie dem Categorizer-Agent in seinen Custom Instructions Beispiele Ihrer Odoo-Kategorien an.

Weiterführend: KI-Anreicherung

Odoo-Modul

„Odoo-Modul zeigt ‚SaaS nicht erreichbar’"

Prüfen Sie der Reihe nach:

  1. Netzwerk: Kann der Odoo-Server api.connector.mateit.de erreichen?

    curl -I https://api.connector.mateit.de/api/v1/health

    Erwarteter Status: 200 OK

  2. API-Key: Ist der Key unter Einstellungen → ITscope Connector korrekt eingetragen?

  3. Firewall: Ist Port 443 (HTTPS) nach außen offen?

  4. Server-Status: In seltenen Fällen kann der SaaS-Server vorübergehend nicht erreichbar sein. Prüfen Sie den Status im Portal.

„Preis-Updates laufen nicht"

  1. Cron-Job aktiv?
    Prüfen Sie unter Einstellungen → Technisch → Geplante Aktionen, ob „ITscope: Preise aktualisieren" aktiv ist und das nächste Ausführungsdatum in der Zukunft liegt.

  2. Produkte haben PUID?
    Nur Produkte mit einer ITscope-PUID werden bei Preis-Updates berücksichtigt. Prüfen Sie die Produktdaten.

  3. Logs prüfen:

    tail -f /var/log/odoo/odoo.log | grep -i "itscope.*price\|cron_update"

  4. Manuell auslführen:
    Im Debug-Modus können Sie den Cron-Job manuell starten: Geplante Aktionen → „ITscope: Preise aktualisieren" → „Jetzt ausführen".

Weiterführend: Odoo-Modul Installation

„Modul-Installation schlägt fehl"

  1. Dependencies prüfen: Das Modul benötigt sale, sale_management, purchase, purchase_requisition, stock, web und product. Stellen Sie sicher, dass alle installiert sind.

  2. Addons-Pfad prüfen:

    grep addons_path /etc/odoo/odoo.conf

    Der Pfad muss das Verzeichnis enthalten, in dem das Modul liegt.

  3. Modul-Update erzwingen:

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

Konto & Datenschutz

„Wie kann ich mein Konto löschen?"

  1. Melden Sie sich im Kundenportal an.
  2. Navigieren Sie zu Einstellungen → Danger Zone.
  3. Klicken Sie auf „Konto löschen" und bestätigen Sie.
  4. Sie haben eine 14-tägige Widerrufsfrist.
  5. Nach 14 Tagen wird das Konto deaktiviert (Soft-Delete).
  6. Nach 30 Tagen werden alle personenbezogenen Daten endgültig gelöscht (Hard-Delete).

„Wie exportiere ich meine Daten? (DSGVO)"

Sie können folgende Daten exportieren:

Daten Wo
Credit-Transaktionen Portal → Credits → Export
Rechnungen Portal → Rechnungen → PDF-Download
API-Key-Liste Portal → Einstellungen → API-Keys

Für einen vollständigen Datenexport gemäß DSGVO Art. 20 (Recht auf Datenübertragbarkeit) kontaktieren Sie support@mateit.de.

„Wie kündige ich meine Subscription?"

  1. Melden Sie sich im Portal an.
  2. Gehen Sie zu Einstellungen → Danger Zone.
  3. Klicken Sie auf „Subscription kündigen".
  4. Die Subscription läuft bis zum Ende des bezahlten Zeitraums weiter.
  5. Verbleibende Credits können bis zum Periodenende genutzt werden.

Hinweis: Es erfolgt keine anteilige Rückerstattung. Planen Sie die Kündigung möglichst zum Periodenende.

Technische Fragen

„Welche IP-Adressen muss ich in der Firewall freigeben?"

Ihr Odoo-Server muss folgende Domain über HTTPS (Port 443) erreichen können:

  • api.connector.mateit.de

Die IP-Adressen können sich ändern (Cloud-Hosting). Konfigurieren Sie Ihre Firewall daher über den Domainnamen, nicht über feste IP-Adressen.

„Ist die Datenverarbeitung DSGVO-konform?"

Ja. Alle Daten werden ausschließlich auf Servern in Deutschland (Frankfurt, Nürnberg) verarbeitet und gespeichert. Die Daten verschiedener Kunden sind strikt voneinander getrennt. Es findet keine Datenverarbeitung außerhalb der EU statt.

  • Kontolöschung: Self-Service gemäß Art. 17 DSGVO (14-Tage-Frist + Hard-Delete).
  • AV-Vertrag: Ein Auftragsverarbeitungsvertrag wird bei Vertragsschluss bereitgestellt.

„Welche KI-Modelle werden verwendet?"

Die Plattform verwendet leistungsstarke, EU-gehostete KI-Modelle, die speziell für deutschsprachige IT-Produktdaten optimiert sind. Die Modellauswahl wird kontinuierlich verbessert und automatisch aktualisiert.

Agenten & Konfiguration

Was ist ein KI-Agent?

KI-Agenten sind spezialisierte Assistenten, die verschiedene Aufgaben bei der Produktoptimierung übernehmen. Jeder Agent ist auf eine bestimmte Aufgabe spezialisiert — z.B. Textoptimierung, Übersetzung oder Kategorisierung. Sie konfigurieren Ihre Agenten im Customer Portal.

Welche Agent-Typen gibt es?

Es gibt vier Agent-Typen:

  • Optimizer — Verbessert Produktnamen und Beschreibungen
  • Translator — Übersetzt Inhalte in Ihre Zielsprachen
  • Categorizer — Ordnet Produkte automatisch in Kategorien ein
  • E-Commerce Agent — Erstellt formatierte Shop-Beschreibungen

Kann ich mehrere Agenten desselben Typs erstellen?

Ja. Sie können z.B. mehrere Optimizer-Agenten mit unterschiedlichen Anweisungen erstellen — einen für Marketing-Texte und einen für technische Beschreibungen.

Wie deaktiviere ich einen Agent?

Öffnen Sie den Agent im Portal und klicken Sie auf den Status-Button, um zwischen „Aktiv" und „Pausiert" zu wechseln. Bereits verarbeitete Daten bleiben erhalten.

Wo konfiguriere ich meine Agenten?

Die Agenten-Konfiguration erfolgt vollständig im Customer Portal unter portal.connector.mateit.de/agents. In Odoo selbst aktivieren Sie nur die grundsätzliche KI-Funktion.

Was sind Custom Instructions?

Custom Instructions sind individuelle Anweisungen, die Sie pro Agent hinterlegen können. Damit steuern Sie, wie der Agent Ihre Produktdaten verarbeitet — z.B. Tonalität, Fachbegriffe oder Formatierung.

Wie hängen Agenten voneinander ab?

Manche Agenten bauen auf den Ergebnissen anderer auf. Beispiel: Der Translator übersetzt die Texte, die der Optimizer zuvor verbessert hat. Diese Abhängigkeiten können Sie im Portal selbst konfigurieren.

Wie teste ich einen Agent vor dem Live-Einsatz?

Öffnen Sie den Agent im Portal und wechseln Sie zum Tab „Konfigurieren". Dort finden Sie ein Test-Interface, in dem Sie den Agent mit Beispieldaten ausprobieren können.

Noch Fragen?

Falls Ihre Frage hier nicht beantwortet wird: