Die Endpunkte unter /itscope/* stellen den Lese-Zugriff auf den ITscope-Katalog bereit: Volltextsuche, Produktdetails, Batch-Preisabfragen, Datenblätter sowie Stammdaten zu Distributoren, Herstellern und Kategorien.

---

1. Katalogsuche

Volltextsuche im ITscope-Katalog über Produktname, Hersteller, MPN und EAN. Liefert eine kompakte Trefferliste mit den wichtigsten Eckdaten zu jedem Produkt.

Anwendungsfall: Produkte im ITscope-Katalog finden — etwa um sie anschließend in das ERP zu importieren oder Preisabfragen anzustoßen.

Endpoint:

GET /itscope/search?q={suchbegriff}&limit=25

Parameter:

curl-Beispiel:

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

Antwort (Auszug):

{
  "data": [
    {
      "itscope_id": "12345678",
      "title": "Dell Latitude 5540 - 15.6\" Full HD - Core i5-1345U",
      "manufacturer": "Dell",
      "mpn": "N006L554015EMEA_VP",
      "ean": "5397184820025",
      "category_path": "IT/Notebook/Business-Notebook",
      "available_stock": 142,
      "lowest_price_eur": null
    }
  ],
  "pagination": {
    "limit": 25,
    "has_more": true,
    "next_cursor": "eyJvZmZzZXQiOjI1fQ=="
  }
}

---

2. Produktdetails

Liefert das vollständige Produktobjekt zu einer ITscope-PUID inklusive Beschreibung, Bilder, Spezifikationen, Lieferanten und Projektpreisen.

Anwendungsfall: Anzeige der Produktdetailseite, Datenanreicherung im ERP oder Vorbereitung einer Bestellung.

Endpoint:

GET /itscope/product/{puid}

Parameter:

curl-Beispiel:

curl -X GET "https://api.connector.mateit.de/api/v1/itscope/product/12345678" \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Antwort (Auszug):

{
  "itscope_id": "12345678",
  "title": "Dell Latitude 5540 - 15.6\" Full HD - Core i5-1345U",
  "manufacturer": "Dell",
  "mpn": "N006L554015EMEA_VP",
  "ean": "5397184820025",
  "long_description": "Das Dell Latitude 5540 ist ein Business-Notebook ...",
  "short_description": "15,6\" Business-Notebook mit Intel Core i5",
  "images": [
    "https://cdn.itscope.com/12345678/main.jpg"
  ],
  "suppliers": [
    {
      "distributor_id": "1001",
      "distributor_name": "Distributor A",
      "stock": 42,
      "delivery_days": 2
    }
  ],
  "project_prices": [],
  "attributes": [
    { "name": "Display", "value": "15.6\" Full HD" },
    { "name": "CPU",     "value": "Intel Core i5-1345U" }
  ],
  "raw": { }
}

---

3. Batch-Preisabfrage

Aktuelle Preise und Bestände für mehrere Produkte gleichzeitig abfragen. Intern werden die übergebenen PUIDs in 50er-Chunks an ITscope gesendet, sodass Anfragen mit bis zu 500 PUIDs in einem einzigen Request möglich sind.

Anwendungsfall: Periodische Preis- und Bestandsaktualisierung im ERP, Warenkorb-Validierung vor Bestellabsendung.

Endpoint:

POST /itscope/batch-prices

Request-Body:

curl-Beispiel:

curl -X POST "https://api.connector.mateit.de/api/v1/itscope/batch-prices" \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
        "puids": ["12345678", "12345679", "12345680"],
        "distributor_id": "1001"
      }'

Antwort (Auszug):

{
  "products": [
    {
      "puid": "12345678",
      "price": null,
      "stock": 42,
      "currency": "EUR"
    },
    {
      "puid": "12345679",
      "price": null,
      "stock": 0,
      "currency": "EUR"
    }
  ],
  "success_count": 2,
  "failed_count": 1,
  "failed_puids": ["12345680"]
}

---

4. Datenblatt herunterladen

Liefert das offizielle Produktdatenblatt im Originalformat. Je nach Datenlage bei ITscope wird entweder ein PDF oder eine HTML-Repräsentation zurückgegeben.

Anwendungsfall: Datenblatt im Kundenportal anbieten, in Angebote einbinden oder lokal archivieren.

Endpoint:

GET /itscope/datasheet/{puid}

Antwort: Binärinhalt mit Content-Type: application/pdf oder Content-Type: text/html.

curl-Beispiel:

curl -X GET "https://api.connector.mateit.de/api/v1/itscope/datasheet/12345678" \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --output datenblatt.pdf

---

5. Datenblatt strukturiert

Liefert die im Datenblatt enthaltenen technischen Spezifikationen als strukturiertes JSON, gruppiert nach Themenblöcken (z. B. „Display", „Prozessor", „Anschlüsse").

Anwendungsfall: Spezifikationen tabellarisch in der eigenen Oberfläche anzeigen, Produktvergleiche aufbauen oder Spezifikationen feldgenau in das ERP übernehmen.

Endpoint:

GET /itscope/datasheet/{puid}/parsed

curl-Beispiel:

curl -X GET "https://api.connector.mateit.de/api/v1/itscope/datasheet/12345678/parsed" \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Antwort (Auszug):

{
  "spec_groups": [
    {
      "name": "Display",
      "specs": [
        { "name": "Diagonale",  "value": "15.6\"" },
        { "name": "Auflösung",  "value": "1920 x 1080" }
      ]
    },
    {
      "name": "Prozessor",
      "specs": [
        { "name": "Modell", "value": "Intel Core i5-1345U" },
        { "name": "Kerne", "value": "10" }
      ]
    }
  ]
}

---

6. Distributoren auflisten

Liefert das Verzeichnis aller im aktuellen ITscope-Account verfügbaren Distributoren.

Anwendungsfall: Auswahllisten für Bestellabsendung, Filter auf einen bevorzugten Distributor.

Endpoint:

GET /itscope/distributors

curl-Beispiel:

curl -X GET "https://api.connector.mateit.de/api/v1/itscope/distributors" \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

---

7. Hersteller auflisten

Liefert die Liste aller bei ITscope geführten Hersteller.

Anwendungsfall: Hersteller-Filter im Suchformular, Mapping auf eigene Markenstammdaten im ERP.

Endpoint:

GET /itscope/manufacturers

curl-Beispiel:

curl -X GET "https://api.connector.mateit.de/api/v1/itscope/manufacturers" \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

---

8. Kategorien auflisten

Liefert die hierarchischen ITscope-Produktkategorien.

Anwendungsfall: Kategorie-Mapping zwischen ITscope und der eigenen ERP-Warengruppen­struktur, Aufbau eines Kategoriebaums in der Oberfläche.

Endpoint:

GET /itscope/categories

curl-Beispiel:

curl -X GET "https://api.connector.mateit.de/api/v1/itscope/categories" \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

---

9. Versandbedingungen

Liefert die je Distributor hinterlegten Versand- und Lieferbedingungen.

Anwendungsfall: Anzeige der Lieferbedingungen im Bestellprozess, Auswahl des passenden Distributors anhand von Versandkonditionen.

Endpoint:

GET /itscope/shipping-conditions

curl-Beispiel:

curl -X GET "https://api.connector.mateit.de/api/v1/itscope/shipping-conditions" \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

---

Hinweise zur Verfügbarkeit

---

Weiterführende Seiten

• Authentifizierung — API-Keys, Header und Rate-Limits
• Bestellungen — Bestellungen anlegen, senden und nachverfolgen
• KI-Anreicherung — Per-Field Optimierung und Kategoriezuordnung
• Webhooks — Asynchrone Events zu Status- und Lieferänderungen