API RF GERE_DLC

  Version ACE : 5.0-00

Package : Spécifique

Sous-programme Basic : Gere_DLC

Fonctionnalité :Réception
Schémas d’entrée et de sortie : voir en fin de document.

Cette API permet non seulement de calculer plusieurs date : date de fabrication, date limite de vente (DLV) et date limite d’utilisation optimum (DLUO), mais aussi d’effectuer certains contrôles entre ces dates.

«

Calculs effectués

Date de fabrication = Date limite de consommation (DLC) - Durée de vie du produit

DLV fournisseur = DLC - (QF x Durée de vie du produit),

QF = pourcentage d'acceptation par rapport à la réception fournisseur (blocage de la réception en option).

DLUO = DLC - (QS x Durée de vie du produit),

QS = pourcentage d'acceptation pour la livraison magasin (blocage en sortie vers les magasins).

Contrôles effectués

API imbriquées : aucune.

Contraintes et limites de fonctionnement (hors périmètre)

Cette API est utilisée dans le cadre spécifique d’un client en particulier.

Paramétrage (PPE)

RAS.

Prototype de la fonction Basic

Gere_DLC (numero_module, typdep, sigdep, codpro, datdlc, datfab, durvie, datlv, datdluo, natstk)

Messages en entrée

GERE_DLC~typdep~sigdep~codpro~datdlc~

Messages en sortie

Retour~datfab~durvie~datlv~datdluo

Valeurs restituées par l’API

VALEUR REMARQUE
1 Les calculs et les contrôles ont été effectués.
2 DLC trop courte <=> Date de réception > DLV fournisseur
3 Date de fabrication > Date de réception
4 Problème de lecture du dépôt
5 Problème de lecture du produit
6 Problème de format de la DLC
7 Zones paramétrées du produit non renseignées : QS, QF et durée de vie

Processus, contrôles et règles de gestion

ETAPE DESCRIPTION DU PROCESSUS
1 Contrôle du format de la DLC : JJMMSSAA
2 identification des zones paramétrées du produit : QS, QF et durée de vie.
3 Calcul de la date de fabrication = DLC - Durée de vie du produit
4 Calcul de la DLV fournisseur = DLC - (QF x Durée de vie du produit)
5 Calcul de la DLV (DLUO) = DLC - (QS x Durée de vie du produit)
Détail :

Read the third-party (TIE table) data with the input parameters (typdep, sigdep) .

If the third-party does not exist, the API returns an error code 4.

Read the product (PRO table) data with the input product code (codpro).

If the product does not exist, the API returns an error code 5.

Initialize the reception date with the current date.

Call the function ut_verifdate, as so to verify the correctness of the input use-by date (in DDMMYYYY format).

If the function does not succeed the API returns an error code 6.

Read the percentage of acceptance for the product in relation to the supplier reception.(Read the product (PRO table) parameterized field with number 105.)

Read the percentage of acceptance for the product for the store delivery.(Read the product (PRO table) parameterized field with number 106.)

Read the product lifetime.(Read the product (PRO table) parameterized field with number 16.)

If one of the read values is empty, the API returns an error code 7.

Calculate the fabrication date for the product.

Calculate the supplier sale deadline date for the product.

Calculate the client sale deadline date for the product (optimal use deadline).

If the reception date is greater than the supplier sale deadline, the API returns an error code 2.

If the fabrication date is greater than the reception date, the API returns an error code 3.

Erreurs possibles

CAUSE EFFET
Date de réception > DLV fournisseur Code retour 2, message « DLC trop courte »
Date de fabrication > Date de réception Code retour 3, message « Date de Fab. > date d'entree »
Problème de lecture du dépôt Code retour 4, message « Probleme lecture depot »
Problème de lecture du produit Code retour 5, message « Probleme lecture produit »
Problème de format de la DLC Code retour 6, message « Erreur »
QS, QF ou durée de vie non renseigné. Code retour 7, message « Probleme lecture zone parametree »

Exemple(s) d’utilisation

W_retout = Gere_DLC (numero_module, "DEP", p_sigdep, p_codpro, p_datdlc, p_datfab, p_durvie, p_datlv, p_datdluo, natstk).

Paramètres en entrée

NOM DU PARAMÈTRE TYPE FORMAT TAILLE OBL O/N REMARQUE
typdep CHAR   3 O Type du dépôt
sigdep CHAR   12 O Sigle du dépôt
codpro CHAR   16 O Code produit
datdlc CHAR   8 O Date limite de consommation au format JJMMSSAA

Paramètres en sortie

NOM DU PARAMÈTRE TYPE TAILLE REMARQUE
ParamOut1 CHAR 8 Date de fabrication (datfab)
ParamOut2 CHAR 8 Durée de vie du produit (durvie)
ParamOut3 CHAR 8 Date limite de vente (datlv)
ParamOut4 CHAR 8 Date limite d’utilisation optimum (datdluo)