Paramétrage - Mode API / Iframe
Choisissez le mode API/IFRAME pour pouvoir utiliser l'assistant chiffrage
1) Fonctionnement
Le mode API/IFRAME permet une intégration fluide de l'assistant de chiffrage dans une Iframe, grâce à une API qui est compatible avec divers logiciels, notamment Odoo, Devisbox, Extrabat, Digit’AM, et Prisme / Iris.
Lorsqu'un logiciel tiers invoque l'Iframe, celle-ci s'ouvre dans une fenêtre de navigation temporaire, affichant ainsi l'assistant de chiffrage. À la validation, l'utilisateur a le choix entre deux options :
1) L'IFRAME peut rester ouverte pour permettre une saisie continue ou se fermer si un seul produit a été chiffré. Dans ce dernier cas, un fichier JSON est généré et transmis au logiciel tiers. Ce fichier est conservé dans son intégralité et son contenu est intégré au document produit par le logiciel tiers. Si cette intégration se déroule avec succès, un code de statut 200 est renvoyé à l'Iframe, ce qui permet de fermer la fenêtre. Le Payload, qui représente le fichier JSON, est alors enregistré du côté du logiciel tiers. Si une réouverture d'une ligne est nécessaire, ce fichier peut être renvoyé pour préremplir à nouveau les données dans l'Iframe.
L'Iframe procède ensuite à une vérification de la cohérence des données reçues par rapport à la version actuelle du catalogue et aux conditions établies. Si une mise à jour s'avère nécessaire, une boîte de dialogue d'actualisation s'affiche. Le processus qui suit est similaire à celui de la création de ligne.
2) En mode API, l'assistant de chiffrage ne s'affiche pas dans une fenêtre dédiée. À la place, seules des routes API sont mises à disposition pour interroger le moteur, confiant ainsi la présentation visuelle des données à l'interface frontale.
Le back-end est responsable de la gestion des droits d'accès, des utilisateurs, ainsi que des conditions d'achat et de vente. De plus, il contrôle l'ensemble des actions autorisées en fonction des rôles et des permissions définis dans le cadre de l'Iframe/API.
Documentation développeur IFRAME/REST
2) Paramètres système
Voici le paramétrage nécessaire pour le fonctionnement de l’assistant de chiffrage Link en mode API / IFRAME.
2.1 - Générales
Paramétrage de la société par défaut. Important quand il y en a plusieurs.

2.2 - Assistant de chiffrage
Paramétrage pour les conditions tarifaires (achat et vente).
OUI : Force l’utilisation des conditions d’achat ou de vente locale au lieu de celles de l’outil externe (API)

Attention : Il est important de noter que ce paramétrage des conditions tarifaires ne doit pas systématiquement être imposé, car le logiciel tiers peut également transmettre les conditions tarifaires à l'assistant de chiffrage, celles-ci étant configurées sur cette interface externe.
