Tuto #2 : Le service Panier

Image tuto

 Ce tutoriel permet de développer le service Panier avec les catalogues électroniques E-T-A-I.

Tuto #2 : les prérequis

Avant de commencer, voici les prérequis :

  • Avoir un serveur joignable sur le web, sinon utiliser le simulateur E-T-A-I en mode serveur.
  • Avoir un compte actif sur la plateforme de développement E-T-A-I, sinon utiliser le simulateur E-T-A-I en mode client.
  • Connaître ses identifiants de connexion à l’Application Catalogue E-T-A-I.

Tuto #2 : Le schéma fonctionnel du service Panier

Schéma fonctionnel IO service commande pièces

Tuto #2 : Quel message reçoit l’Outil de Gestion ?

Lors de l’envoi d’une commande de pièces par l’utilisateur, voici le flux XML envoyé vers l’Outil de Gestion :

Flux postBasket

Dans ce message, il y a plusieurs catégories d’information :

  • <session-context> contient les identifiants de l’utilisateur.
  • <action-list> (dans l’élément <transport>) indique le type de flux : ici, postBasket.
  • <person-list> donne toutes les informations relatives au garage qui effectue la commande.
  • <vehicle-list> donne les informations utiles pour l’identification du véhicule, afin de permettre éventuellement au distributeur de proposer des pièces équivalentes.
  • <part-list> correspond à la liste des pièces commandées.
    Pour chaque pièce commandée, les informations suivantes sont transmises : la référence, le fournisseur et la quantité.

Tuto #2 : Réponse de l’Outil de Gestion à la réception de la commande du panier de pièces

Il convient de noter qu’il ne faut pas initialiser un nouveau post pour la réponse, mais bien répondre au post envoyé.

Voici le retour attendu par l’application E-T-A-I :

Flux postBasket reponse

Les éléments suivants sont présents dans le message de retour :

  • <message-list> avec l’accusé de réception de la commande (ack pour acknowledgement).
  • <transport> avec le numéro du bon de livraison et le statut du panier (complet / partiel / rejeté).
  • <settings> pour préciser le(s) taux de TVA et les remises éventuelles appliquées par le distributeur aux éléments du panier et/ou à la facture globale.
  • <part-list> débutant par le prix global du panier, dans l’élément <price-list>, suivi du détail de chaque pièce du panier <part>.
  • <comment-list> pour ajouter éventuellement un commentaire du distributeur au garage qui commande.