Interface Catalogues Atelio AfterMarket

Description fonctionnelle

Les transferts entre les applications Partenaires et les applications Catalogues Atelio AfterMarket (communément appelées applications « IO ») sont de différents types et peuvent correspondre à :

  1. une interface distante,
  2. ou une interface locale,
  3. ou une double interface.

Cas d’un utilisateur qui ouvre un Catalogue « IO », pour y rechercher des pièces qu’il commandera ensuite à son Distributeur (application Partenaire).

  • Chaque fois qu’une liste de pièces est affichée, une demande des prix et stocks de ces pièces est lancée vers la plateforme du Distributeur : la réponse est affichée en retour dans le Catalogue « IO ».
  • Lorsque l’utilisateur a finalisé sa sélection de pièces, il envoie à son Distributeur le panier de pièces à commander.

Interface IO distante : description fonctionnelle
L’application Partenaire (la plateforme du distributeur) est serveur et elle est dans un réseau ouvert sur internet : le mode d’échange est le mode direct, sans création de session.

Dans ce cas, les services utilisés sont :

Interface IO distante : les services

C’est l’application Partenaire qui est à l’origine des dialogues. Son utilisateur :

  • crée un dossier / un Ordre de Réparation dans son application,
  • puis le transfère dans le Catalogue « IO » où un devis est créé (voire complété, s’il existait déjà).
  • Après l’ajout de pièces, ingrédients, temps, forfaits à ce devis, l’utilisateur récupère toutes les données dans le dossier de son application.

Interface IO locale : description fonctionnelle

 

Si l’application Partenaire n’est pas accessible directement au serveur XAT2, elle doit émettre une requête contenant son URL et spécifiant le contexte de sa demande. En retour, elle obtient l’identifiant unique de la session et l’URL du Catalogue « IO », à ouvrir dans une nouvelle fenêtre de navigation.

 

Les services utilisés peuvent être :

  • pour une ouverture de la page d’accueil du Catalogue « IO » : service redirectHome
    Interface IO locale : service redirectHome
  • pour le transfert d’un dossier vers le Catalogue « IO », avec client et véhicule identifiés : service redirectEstimate
    Interface IO locale : service redirectEstimate
  • Lorsque l’utilisateur a terminé son travail, il clique sur un bouton « TRANSFERT » présent en page du devis.
    Une redirection HTTP est envoyée à l’application Partenaire, qui reprend la main et invoque le serveur XAT2 (service getData) pour récupérer le devis (réponse postEstimate).Pour terminer, l’application Partenaire peut invalider la session en appelant le service deleteSession.
    Interface IO locale : services getData & deleteSession

Il est possible de combiner les deux types d’interface.

  • Comme dans le cas de l’interface locale, l’utilisateur de l’application Partenaire crée un dossier / un Ordre de Réparation dans son application, puis le transfère dans le Catalogue IO où un devis est créé (voire complété, s’il existait déjà).
  • Au moment où il recherche des pièces, une demande des prix et stocks de ces pièces est lancée vers la plateforme de son Distributeur (interface distante) : ceux-ci sont affichés en retour dans le Catalogue « IO ».
  • Lorsque le devis est finalisé, l’utilisateur envoie le panier de pièces à son Distributeur (interface distante) et transfère toutes les données dans le dossier de son application (interface locale).

Interface IO double : description fonctionnelle (1)

Cas particulier de la double interface : l’utilisateur de l’application Partenaire interroge ses propres prix et stocks depuis le Catalogue « IO ».
Pour les obtenir, le Catalogue « IO » envoie une notification à l’application Partenaire qui invoque le serveur XAT2 avec le service getData. L’application Partenaire reçoit en réponse la demande de prix et stocks (getPriceAndStock), puis elle envoie ses prix et stocks par le service postPriceAndStock.

Interface IO double : description fonctionnelle (2)