| API / API Web | |
|
Edition spéciale ES1 |
||
|
Package : fr.ACE.metier.bc4j.evenement.common GestionReglementcontrolerModeReglement |
||
| Schémas d’entrée et de sortie : | IN | OUT |
Cette API permet de contrôler les modes de règlement : validité du mode de règlement, adresse de livraison,…
API imbriquées : aucune.
Contraintes et limites de fonctionnement (hors périmètre)
| RAS. |
Paramétrage (PPE)
| VPC_B1 - |
Processus, contrôles et règles de gestion
| Etape | Description du Processus |
|
L’API contrôle la validité du mode de réglement ou de l’adresse de livraison de l’événement commercial. Le tiers et le produit à passer en entrée d’API sont facultatifs. En revanche, il faut indiquer l’événement ou le poste sur lequel les contrôles liés aux réglements doivent être effectués. |
|
| Contrôle 1 |
Sur le mode de réglement (à renseigner en entrée d’API). Le système récupère au niveau du mode de réglement (table MRG), le numéro de la zone paramétrée du tiers et/ou le numéro de la zone paramétrée d’adresse contenant le code des réglements non autorisés. La liste de ces codes est enregistrée dans une table utilisateur (voir fonction GTTTU) pour le tiers et une autre pour l’adresse. Les numéros de ces tables utilisateurs sont stockés également au niveau du champ lib2 de la table MRG. N° codzn du tiers : caractères 16 à 18 N° TTU du tiers : caractères 19 à 21 N° codzn de l’adresse : caractères 22 à 24 N° TTU de l’adresse : caractères 25 à 27 Si la donnée complémentaire n’est pas renseignée, on effectue alors une recherche par QUE/QUE à partir des données en entrée d’API, et avec
Si un code est renseigné en retour et que ce dernier se trouve dans la liste des codes de la table utilisateur (TTU) associée, alors le mode de réglement n’est pas autorisé. Ce contrôle est bloquant si le caractère « B » est enregistré dans le champ lib2 de la TTU. |
| Contrôle 2 |
Sur l’adresse de livraison (adresse à renseigner en entrée d’API). Même type de contrôle que ci-dessus. Le système parcours l’ensemble des modes de réglement de l’événement et pour chacun d’eux, contrôle si celui-ci est valide par rapport à l’adresse de livraison. Si le contrôle est négatif, l’API renvoie une erreur (code, libellé et indicateur bloquant (« O » ou « N »). |
Cas d’erreur
| Cause | Effet |
| TIE_INEX : le tiers de l’événement ou le tiers passé en entrée de l’API n’existe pas. | |
| ADR_INEXIS : l’adresse de livraison du tiers de l’événement ou l’adresse passé en entrée d’API n’existe pas. |