Integration

Für alle, die RecommenderPro an Warenwirtschaft oder Onlineshop anbinden: das Dateiformat, die Anfragen, die Antwort und die Regeln, die zu beachten sind. Wenn Sie möchten, begleiten wir die Anbindung.

Drei Schritte, mit Beispielen

1
Sie exportieren die Kaufhistorie
Eine Textdatei ohne Kopfzeile. Jede Zeile ist ein Kauf: der Kunde, ein Semikolon, das Produkt.
```
C0042;kaffeebohnen-1kg
C0042;entkalker
C0117;kaffeebohnen-1kg
C0117;tassen-set-6
```
Sie laden sie hoch
Über das Faktenarchiv der Web-App oder über die API. Der Import läuft im Hintergrund, in Blöcken zu 5000 Zeilen, und Sie verfolgen ihn unter „Aktuelle Imports“. Laden Sie ein Archiv mit demselben Namen erneut hoch, ersetzt es das bestehende.
3
Ihr System fragt die Vorschläge ab
Für einen Kunden sendet es eine GET-Anfrage mit dessen Kennung. Für einen Warenkorb sendet es eine POST-Anfrage mit der Produktliste, wie im Beispiel weiter unten. Die Antwort hat immer diese Form.
```
GET /api/suggestions/noratings/users/C0042/verkaeufe?minscore=60&max=5

{
  "_count": 1,
  "items": [
    { "prod": "tassen-set-6", "score": 72.5 }
  ]
}
```

Für einen Warenkorb

Ihr System sendet die Produkte, die der Warenkorb enthält. Die Antwort hat dieselbe Form wie die für einen Kunden.

POST /api/suggestions/noratings/products/verkaeufe?minscore=60&max=5

{ "products": ["kaffeebohnen-1kg", "entkalker"] }

Parameter

Parameter	Bedeutung	Standardwert
`minscore`	Mindestscore, von 0 bis 100	60
`max`	Maximale Anzahl zurückgegebener Produkte, bis zu 100	10

Wie der Score berechnet wird, steht unter So funktioniert es.

Was Sie brauchen

Eine Datei mit zwei Spalten, getrennt durch ein Semikolon. Leere Zeilen und Zeilen, die mit # beginnen, werden ignoriert. Ein leeres Feld führt dazu, dass die Datei abgelehnt wird; sie wird vor dem Hochladen geprüft.
Der Name des Archivs besteht aus Buchstaben, Ziffern und Unterstrichen, beginnt mit einem Buchstaben und ist bis zu 30 Zeichen lang.
Die in den API-Anfragen verwendeten Kennungen bestehen aus Buchstaben, Ziffern, Bindestrichen und Unterstrichen, bis zu 100 Zeichen. Leerzeichen sind nicht erlaubt.
Anfragen nach Vorschlägen müssen mit einem Zugriffstoken gestellt werden.

Brauchen Sie Unterstützung?

Wir von bit Time Professionals begleiten die Anbindung: Schulung zur Integration in die Software, die Sie bereits nutzen, und Support. Darüber sprechen wir nach der Demo.

Möchten Sie sehen, was es Ihren Kunden vorschlagen würde?

Wir zeigen Ihnen die Web-App und wie sie sich mit Ihrem Onlineshop oder Ihrer Warenwirtschaft verbindet. Wenn Sie starten möchten, begleiten wir Sie bei der Integration.

Demo anfragen