Intégration

Pour ceux qui connectent RecommenderPro au logiciel de gestion ou au site e-commerce : le format du fichier, les requêtes, la réponse et les règles à respecter. Si vous préférez, nous nous occupons de la connexion.

Trois étapes, avec des exemples

1
Vous exportez l'historique
Un fichier texte, sans en-tête. Chaque ligne est un achat : le client, un point-virgule, le produit.
```
C0042;cafe-grains-1kg
C0042;detartrant
C0117;cafe-grains-1kg
C0117;lot-tasses-6
```
Vous le chargez
Depuis « Archives de Faits » dans l'application web, ou par l'API. L'import se fait en arrière-plan, par blocs de 5 000 lignes, et vous le suivez dans « Imports récents ». Recharger une archive du même nom la remplace.
3
Votre système demande les suggestions
Pour un client, il fait une requête GET avec son code. Pour un panier, il fait une requête POST avec la liste des produits, comme dans l'exemple plus bas. La réponse a toujours cette forme.
```
GET /api/suggestions/noratings/users/C0042/ventes?minscore=60&max=5

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

Pour un panier

Votre système envoie les produits que contient le panier. La réponse a la même forme que celle pour un client.

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

{ "products": ["cafe-grains-1kg", "detartrant"] }

Paramètres

Paramètre	Signification	Valeur par défaut
`minscore`	Score minimum, de 0 à 100	60
`max`	Nombre maximum de produits renvoyés, jusqu’à 100	10

Comment se calcule le score, vous le trouvez dans Comment ça marche.

Ce qu’il faut

Un fichier avec deux colonnes séparées par un point-virgule. Les lignes vides et celles qui commencent par # sont ignorées. Un champ vide fait rejeter le fichier, qui est contrôlé avant le chargement.
Le nom de l’archive utilise des lettres, des chiffres et le tiret bas, commence par une lettre et peut aller jusqu’à 30 caractères.
Les identifiants utilisés dans les requêtes API contiennent des lettres, des chiffres, le tiret et le tiret bas, jusqu’à 100 caractères. Les espaces ne sont pas autorisés.
Les requêtes de suggestions doivent être faites avec un jeton d’accès.

Besoin d’un coup de main ?

Chez bit Time Professionals, nous nous occupons de la connexion : formation à l’intégration avec le logiciel que vous utilisez déjà, et assistance. Nous en parlons après la démo.

Voulez-vous voir ce qu'il suggérerait à vos clients ?

Nous vous montrons l'application web et comment elle se connecte à votre site e-commerce ou à votre logiciel de gestion. Si vous décidez de démarrer, nous vous accompagnons dans l'intégration.

Demander une démo