Exigences DSP
Exigences fonctionnelles
ID | Type | Exigence |
|---|---|---|
1 | Obligatoire | Le jeton d'accès doit être automatiquement rafraîchi toutes les 90 minutes |
2 | Obligatoire | Le API d'authentification du concessionnaire access_token et refresh_token doivent être sauvegardés et utilisés par tous les utilisateurs ayant la permission de gérer les commandes de pièces. |
3 | Obligatoire | Le API d'authentification du concessionnaire jeton_d'accès doit être actualisé toutes les 2 heures en utilisant le jeton_de_rafraîchissement. |
4 | Obligatoire | Le concessionnaire doit valider (Valider le service) avant de soumettre (Créer le service) la commande de pièces. |
5 | Obligatoire | Les messages d'avertissement et d'erreur renvoyés par le service de validation et de création doivent être affichés au concessionnaire. |
6 | Obligatoire | Une commande de pièces créée doit être mise à jour en appelant le service Get pour récupérer les dernières informations jusqu'à ce que la commande soit expédiée. Le service Get peut être appelé lorsque le concessionnaire affiche la commande de pièces ou périodiquement en arrière-plan. |
7 | Obligatoire | Le code d'état 504 de délai d'attente de passerelle doit être géré en appelant le service de vérification jusqu'à ce que la commande de pièces soit créée pour les services de création et de validation. |
8 | Obligatoire | Les méthodes d'expédition disponibles pour le revendeur doivent être obtenues à partir de la API des concessionnaires. La méthode d'expédition par défaut doit être la première renvoyée par la API des concessionnaires. |
9 | Obligatoire | Le concessionnaire doit être en mesure d'annuler un ou plusieurs articles dans une commande de pièces si la commande n'est pas complétée ou expédiée. |
10 | Obligatoire | Le DMS doit utiliser le service Get pour effectuer un chargement initial, récupérer toutes les commandes de pièces des 90 derniers jours et les enregistrer dans la base de données DMS. Si une commande de pièces a été créée dans votre DMS, la commande de pièces doit être mise à jour avec les nouvelles informations reçues via l'API de commande de pièces. Si la commande de pièces n'existe pas, elle doit être créée dans votre DMS. |
11 | Obligatoire | Le service Get doit être utilisé quotidiennement pour récupérer les commandes de pièces des 30 derniers jours et les enregistrer dans la base de données DMS. Si une commande de pièces a été créée dans votre DMS, la commande de pièces doit être mise à jour avec les nouvelles informations reçues via l'API de commande de pièces. Si la commande de pièces n'existe pas, elle doit être créée dans votre DMS. |
12 | Obligatoire | Le concessionnaire doit être en mesure de trouver une commande de pièces en utilisant un numéro de livraison. |
13 | Obligatoire | Le concessionnaire doit être en mesure de trouver une commande de pièces en utilisant un numéro de facture. |
14 | Optionnel | Le concessionnaire peut trouver une commande en utilisant le numéro de suivi du transporteur. |
15 | Optionnel | Le concessionnaire peut charger manuellement les commandes de pièces en fournissant une plage de dates. |
16 | Obligatoire | Pour chaque commande de pièce, les informations spécifiques au BRP suivantes doivent être disponibles pour le concessionnaire :
|
17 | Obligatoire | Lorsqu'une commande de pièces est affichée, le shipping_lines champ doit être montré à l'utilisateur. Le ordered_lines champ peut également être affiché, mais le DMS doit clairement montrer que le concessionnaire recevra les pièces énumérées dans le shipping_lines champ. |
18 | Optionnel | Le concessionnaire devrait être en mesure de récupérer une seule commande de pièces en utilisant le numéro de commande de vente. Votre DMS devrait appeler le Obtenir la commande point de terminaison. |
19 | Optionnel | Le concessionnaire devrait être en mesure de récupérer les résumés de commandes de pièces. Dans ce cas, votre DMS devrait appeler le Obtenir les commandes point de terminaison en utilisant le résumé paramètre. |
Activités de certification
Cette section présente toutes les activités de certification et validations qui doivent être complétées pour certifier l'API.
Assurance Qualité
Les tests énumérés dans le tableau ci-dessous doivent être complétés avec succès dans l'environnement de test avant de pouvoir commencer la phase pilote des concessionnaires.
👉 Pour exécuter les tests, vous avez besoin des identifiants de concessionnaire BOSSWeb dans l'environnement de test. Si vous ne les avez pas, ouvrez un ticket dans le Jira de DCP.
ID | Test | Résultat attendu |
|---|---|---|
1 | Vérifiez les méthodes d'expédition disponibles pour le concessionnaire dans le DMS. | Les méthodes d'expédition doivent être les mêmes que celle renvoyée par le API des concessionnaires et la méthode par défaut doit être la première renvoyée dans la réponse. |
2 | Valider une commande de pièces avec 20 pièces valides et afficher les messages d'avertissement et d'erreur. | La commande de pièces est valide, sans message d'avertissement ni d'erreur. |
3 | Valider une commande de pièces avec une pièce obsolète (1301200012). Afficher les messages d'avertissement et d'erreur. | La commande de pièces est invalide, et le message d'erreur est affiché. |
4 | Valider une commande de pièces avec 45 lignes d'articles. Appelez le service de vérification jusqu'à ce que la commande soit validée. | La commande de pièces est valide, sans message d'avertissement ni d'erreur. |
5 | Valider et créer une commande de pièces avec 20 pièces valides et afficher les messages d'avertissement et d'erreur. | La commande de pièces est créée et affichée. |
6 | Obtenez la commande de pièces créée et affichez le résultat. | La commande de pièces est affichée. |
7 | Créez une commande de pièces avec 45 pièces valides. Appelez le service de vérification jusqu'à ce que la commande soit créée. | La commande de pièces est créée et affichée. |
8 | Appelez le service Get Orders pour récupérer les commandes de pièces créées au cours des 7 derniers jours. | Les commandes de pièces ont été chargées dans votre DMS. L'équipe DCP compare les commandes de pièces à celles trouvées sur BOSSWeb. |
9 | Appelez le service Obtenir les commandes pour récupérer les commandes de pièces en cours. | Les commandes de pièces ont été chargées dans votre DMS. |
10 | Créez une commande de pièces avec 1 ligne d'article. Dès que la commande est créée, annulez l'article. | L'article et la commande sont annulés. |
11 | Valider et créer une commande de pièces avec les pièces suivantes :
| La commande est valide et créée avec des messages d'avertissement. |
12 | Valider une commande de pièces avec une pièce dans une gamme de produits non prise en charge par le concessionnaire. | Le message d'erreur est affiché. |
13 | Le service Get est appelé quotidiennement pour récupérer les commandes de pièces | Les commandes de pièces pour les 30 derniers jours sont chargées dans la base de données |
14 | Appelez le Get Order pour obtenir une commande spécifique en utilisant le numéro de commande de vente. (Optionnel) | La commande de pièces est chargée dans votre DMS. |
15 | Appelez le service Obtenir les commandes pour récupérer les résumés des commandes de pièces créées au cours des 7 derniers jours. (Optionnel) | Les commandes de pièces sont chargées dans votre DMS. |
Pilote de concessionnaire
Le tableau ci-dessous décrit les paramètres et validations du pilote de concessionnaire.
Paramètre | Valeur |
|---|---|
Environnement | Production |
Nombre de concessionnaires | 1 à 3 |
Durée | 1 à 3 semaines |
Validation 1 | Vérifiez que les commandes de pièces avec plus de 25 lignes sont créées. |
Validation 2 | Vérifiez que les commandes de pièces créées sont mises à jour pour afficher les informations de livraison. |
Validation 3 | Vous envoyez un rapport chaque semaine montrant les commandes de pièces créées pour chaque concessionnaire dans le projet pilote. Le rapport doit montrer le pac_order_id et le sales_order_id. |
Valider 4 | Réalisez une démonstration en direct de la fonction de commande de pièces dans votre DMS chez l'un des concessionnaires du projet pilote. |
Validation 5 | Vérifiez que les commandes de pièces des 90 derniers jours sont chargées. |
Validation 6 | Vérifiez que les commandes de pièces des 30 derniers jours sont mises à jour quotidiennement. |