Vai al contenuto

Punktuelle Suche nach OE-/AM-Codes im eigenen ERP

Allgemeiner Überblick

Durch die Integration des eigenen ERP in Quoting24 ist es möglich, in Echtzeit personalisierte Preise und Verfügbarkeiten für den jeweiligen Kunden zurückzugeben, mit dem du gerade schreibst, wenn Codes gesucht werden.

So lassen sich schnell die kundenspezifischen Geschäftsbedingungen des Kunden ermitteln, mit dem du gerade sprichst.

Ziel ist es, Quoting24 zu ermöglichen, nach der Identifizierung eines Produktcodes automatisch Folgendes abzurufen:

  • Verfügbarkeit und Nettopreis des jeweiligen Kunden
  • Produktmetadaten: beschreibende Informationen, Marke, gegebenenfalls aktive Aktionen und weitere zugehörige Attribute.
  • Der Ablauf ist so konzipiert, dass er transparent mit den ERP-APIs des Verwaltungssystems des Lieferanten kommuniziert.

Suchparameter

Von Quoting24 an den Lieferanten

Pflichtparameter

  • Authentifizierungstoken
    Ein eindeutiges Token, das die Server von Quoting24 eindeutig identifiziert.

  • Suchcode
    Vorzugsweise ein AM- oder OE-Code.
    Die Suche sollte nicht nur auf exakte Produktcodes beschränkt sein, sondern auch:

  • alternative Codes suchen
  • in externen Datenbanken suchen

⚠️ Wenn dieses Verhalten nicht unterstützt wird, muss dies klar kommuniziert werden.
Mindestens muss die Suche die Stammdaten des Produkts umfassen und nicht nur die exakten internen Codes.

Identifizierung des Kunden

Mindestens einer der folgenden Werte muss bereitgestellt werden

  • ID (wie im ERP erfasst) des Standorts eures Kunden
  • ID (wie im ERP erfasst) des Unternehmens eures Kunden
  • USt-IdNr. des Kunden
  • ID der Rabattkategorie
    Verwendet für:
  • nicht registrierte Kunden
  • damit der Mitarbeiter die Rabattregeln dynamisch ändern kann

Optionale Parameter

  • Mitarbeiter-ID (optional, aber empfohlen)
    Wird verwendet, um nachzuverfolgen, wer das Angebot erstellt hat.

  • Menge
    Kann in die Anfrage aufgenommen werden, wenn dies unbedingt erforderlich ist.
    Bevorzugter Ansatz: Verwaltung der Menge in der Antwort, nicht in der Anfrage.

  • Marke / Hersteller
    Um präzisere Suchen zu ermöglichen.

  • Suchmodus
    Parameter für punktuelle exakte Suche oder Suche mit Cross-Referenzen (die auch Ergebnisse alternativer Produkte liefert).

Antwortparameter

Vom Lieferanten an Quoting24

Die Antwort muss eine Liste von Produkten enthalten, jeweils mit den folgenden Feldern.

Pflichtfelder (pro Produkt)

  • Produktcode des Lieferanten
    Interner Bestellcode einschließlich Präfixe, genau wie in den Systemen des Lieferanten verwendet.

  • Hersteller
    Name des Herstellers (z. B. LUK, Magneti Marelli, Brembo).
    Kann in 2 Felder strukturiert sein:

  • Kurzversion/Vorcode (z. B. MAR)

  • vollständiger Name (z. B. Magneti Marelli)

  • Nettoverkaufspreis für den Kunden

  • Nettopreis (ohne MwSt.)
  • Versandkosten ausgeschlossen

  • Versandkosten können separat zurückgegeben werden, falls zutreffend

  • Verfügbarkeit
    Numerischer Wert, der die verfügbare Menge im Lager darstellt.

  • Lager
    Name des Lagers, Regals oder Verweis auf den internen Standort.

Optionale Felder

  • Produktbeschreibung
    Freitext (z. B. Bremsbeläge) und/oder Warenkategorie.

  • Identifikationscode des Herstellers
    Pflicht, wenn der ERP-Produktcode vom Herstellercode abweicht.

  • Listenpreis
    Nicht erforderlich, aber reproduzierbar, falls nötig.

  • Aktionen

  • Vorhandensein einer Aktion (binär)
  • Text der Aktion (optional)

  • Wenn der Text leer ist → Aktion nicht aktiv

  • Produktbild

  • URL des Bildes

  • oder Base64-Bild

  • URL des Produktdatenblatts
    Link zur Produktdetailseite im E-Commerce oder auf der externen Website.
    Wenn ein direkter Link nicht möglich ist:

  • URL-Syntaxregeln bereitstellen

  • oder eine generische URL der Login-Seite zurückgeben

  • Mengenbasierte Preise / Rabatte
    Wenn Mengenrabatte existieren, gib die Stufen in einem beliebigen analysierbaren Format zurück, zum Beispiel:

{
  "from": 2,
  "to": 10,
  "price": "50.00"
}