API / APIs Radiofréquence
Sujet parent: APIs Radiofréquence

API RF DONNE_MIS

Version ACE : 5.0-00  

Package : Standard

Sous-programme Basic : Donne_Mission

 Fonctionnalité :Général
Schémas d’entrée et de sortie : voir en fin de document.

Cette API permet de rechercher une mission RF à affecter à un opérateur selon l’activité souhaitée.

Le dépôt, dans lequel sont effectuées la recherche et la mise à jour de la mission, est le dépôt par défaut de l’opérateur.

API imbriquées : aucune.

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

RAS.

Paramétrage (PPE)

GESMIS (paramètre facultatif) -

Prototype de la fonction Basic

Retour = Donne_Mission (numero_module, profil_choisi, p_age, typact_choisi, idmission, idreception, codallcir, lcodmag, adremp, cnttyp_sup, cntcod_sup, codpro, idobj, l_nbrcnt, cnttyp, cntcod, l_nbrcnt1, cnttyp1, cntcod1, l_nbrcnt2, cnttyp2, cntcod2, idmvt, typmvt, qteunt, flgchgobj, idtrn, recsimple, camion, lirtrn , idact, libact)

Messages en entrée

DONNE_MIS~profil_choisi~age~typact_choisi~

Messages en sortie

Réception :

Retour~idreception~lcodmag~adremp~idmission~cnttyp_sup~cntcod_sup~recsimple~ NB_CHG~NB_EA~CODEOP~DATE~idact~libact~FLAG_AVIEXP

Déplacement :

Retour~codallcir~lcodmag~adremp~codpro~idobj~l_nbrcnt~cnttyp~cntcod~ l_nbrcnt1~cnttyp1~cntcod1~l_nbrcnt2~cnttyp2~cntcod2~idmvt~typmvt~qteunt~flgchgobj~ idmission~idact~libact~nompro~sigliv~idtrn~lirtrn~idop~reflot~

Chargement :

Retour~idtrn~lcodmag~idmission~camion~lirtrn~idact~libact

Valeurs restituées par l’API

VALEUR REMARQUE
1 Une mission a été trouvée pour l’opérateur.
0 L’opérateur défini en entrée n’existe pas.
99 Aucune mission ne peut être affectée à l’opérateur.

Erreurs possibles

CAUSE EFFET
Aucune mission n’a pu être affectée à l’opérateur Code retour 99, message « Plus de missions pour cette activité »

Exemple(s) d’utilisation

Retour_Donne_Mission = Donne_Mission (numero_module, profil_choisi, age, typact_choisi, idmission, idreception,codallcir, lcodmag, adremp, cnttyp_sup, cntcod_sup,codpro, idobj, l_nbrcnt, cnttyp, cntcod,l_nbrcnt1, cnttyp1, cntcod1, l_nbrcnt2, cnttyp2,cntcod2, idmvt, typmvt, qteunt, flgchgobj, idtrn,recsimple, camion, lirtrn, idact, libact)

Processus, contrôles et règles de gestion

ETAPE DESCRIPTION DU PROCESSUS
1

Recherche d’une mission en statut « 5 » affectée à l’opérateur.

C’est le cas par exemple des missions arrêtées brutalement par une remise à zéro du terminal RF.

Cette recherche sélectionne toutes les missions affectées à l’opérateur et élimine ensuite celles qui ne sont plus valides :
  • Si la mission porte sur un mouvement qui n’existe plus ou est déjà validé,
  • Si la mission porte sur un objet qui n’existe plus,
  • Si la mission est de type Réception, celle-ci doit exister et être dans un statut différent de « 8 ».
  • S’il s’agit d’une mission de type Evacuation du quai de réception, il doit rester au moins une charge à évacuer.
  • Si la mission est de type Chargement, la tournée doit exister et être en statut « 6 », et les colis restant à charger doivent être sur le quai.
2

Si aucune mission n’est trouvée :

On vérifie s’il existe des missions de déplacement gelées (statut « 2 ») vers un magasin tampon. Si tel est le cas, on recherche des missions de sortie de ces tampons pour passer leur urgence à la valeur indiquée dans la zone N5 du paramètre GESMIS.
3
Si aucune mission n’est trouvée :
  • Si un type d’activité est défini en entrée, recherche d’une mission par activité (étape 4)
  • Sinon, recherche d’une mission par profil.

·

4
Recherche d’une mission par activité (pilotage par urgence).
  • constitution d’un tableau des activités concernées par le type d’activité indiqué en entrée.
  • constitution de la liste des missions relatives aux activités concernées.
5

Tri des missions :

En priorité sont prises les missions affectées à l’opérateur.

Règle 1 : si l’urgence de la mission est supérieure à l’urgence maximum de l’opérateur, le tri est le suivant :

Urgence Mission – Urgence Profil – Priorite1 – Priorite 2 Croissante – Distance Croissante

Dans ce cas, les priorités 1 et 2 sont portées par la mission et la distance est égale au nombre d’allées entre l’allée en cours et l’allée de départ de la mission.

Règle 2 : si l’urgence de la mission est comprise entre l’urgence minimum et l’urgence maximum de l’opérateur, le tri est le suivant :

Urgence Profil – Urgence Mission - Priorite1 – Priorite 2 Croissante – Distance Croissante

Règle 3 : si l’urgence de la mission est inférieure à l’urgence minimum de l’opérateur, le tri est le même que pour la règle 1.
6
Recherche de la première mission « dégelable », valide et réalisable dans la liste.
  • Une mission gelée est une mission refusée par un opérateur, elle peut être « dégelée » au bout d’une minute.
  • La notion de mission valide est la même qu’en étape 1.
  • La notion de faisabilité est expliquée dans l’étape suivante.
.
7
Une mission de déplacement est réalisable si :
  • elle ne porte pas sur des emplacements en cours d’inventaire.
  • dans le cas d’un réapprovisionnement picking, la mission doit couvrir la demande et ne pas dépasser la capacité de l’emplacement (sauf si le dépassement est autorisé).
  • dans le cas d’un déstockage pour expédition, le colis correspondant doit être dans une tournée.
  • si la mission va vers le quai d'une tournée, on vérifie que cette tournée n'est pas fermée. Si la tournée est fermée, la mission n'est pas faisable, sauf si le magasin d'origine est un quai de réception, alors le magasin de destination devient le magasin chaîné de la tournée.

Une mission de chargement est faisable si la tournée correspondante comporte un numéro de camion.
8
Si une mission a été trouvée :
  • Historisation de l’activité de l’opérateur,
  • Mise à jour du contexte de l’opérateur,
  • Mise à jour du statut de la mission (statut « 5 »).

Paramètres en entrée

NOM DU PARAMÈTRE TYPE FORMAT TAILLE OBL O/N REMARQUE
Idprfact LONG     O Identifiant profil d'activité, obligatoire si le champ « ltypact » n’est pas renseigné.
Idopr CHAR   8 O Identifiant opérateur
Ltypact LONG     O Type d'activité, obligatoire si le champ « idprfact » n’est pas renseigné.
Idtrn LONG     N Identifiant de la tournée.
Lcodmag CHAR   3 N Code magasin.
Identite LONG     N Identifiant entité

Paramètres en sortie

NOM DU PARAMÈTRE TYPE FORMAT TAILLE REMARQUE
DEPLACEMENT       Cas du déplacement
Codallcir CHAR   8 Allée de circulation de la prise
Lcodmag CHAR   3 Code magasin de prise
Adremp CHAR   8 Adresse de prise
Codpro CHAR   16 Code produit
Idobj CHAR   18 Identifiant de l’objet de stock à déplacer
L_nbrcnt LONG     Nombre de contenants de l’objet
Cnttyp CHAR   2 Type de contenant de l’objet
Cntcod CHAR   2 Code contenant de l’objet
L_nbrcnt1 LONG     Nombre de contenants de niveau 1
Cnttyp1 CHAR   2 Type de contenant de niveau 1
Cntcod1 CHAR   2 Code contenant de niveau 1
L_nbrcnt2 LONG     Nombre de contenants de niveau 2
Cnttyp2 CHAR   2 Type de contenant de niveau 2
Cntcod2 CHAR   2 Code contenant de niveau 2
Idmvt LONG   9 Identifiant du mouvement de déplacement associé à la mission
Typmvt CHAR   1 Type du mouvement de déplacement associé à la mission
Qteunt LONG   5 Quantité unitaire du mouvement de déplacement
Flgchgobj CHAR   1 Indicateur d’un changement d’objet possible, pour l’évacuation des quais de réception
Idmission LONG   7 Identifiant de la mission
Idact LONG   5 Identifiant de l’activité
Libact CHAR   30 Libellé de l’activité
Nompro CHAR   30 Nom de produit
Sigliv CHAR   12 Sigle du tiers livré si le mouvement de déplacement appartient à un OL : cas du déstockage d’un objet complet pour expédition.
Idtrn LONG     Identifiant de la tournée dans le cas d’un déstockage
Lirtrn CHAR   10 Libellé réduit de la tournée
Idop LONG     Identifiant de l’OP dans le cas du déstockage, porté par le mouvement (champ « idord »).
Reflot CHAR   30 Référence du lot porté par le mouvement
Fgldepose CHAR   1 Si = ‘R’, il s’agit d’une reprise de la mission de déstockage. Le mouvement SS est validé, il reste la dépose : mouvement de transfert en cours

NOM DU PARAMÈTRE TYPE FORMAT TAILLE REMARQUE
RECEPTION       Cas d’une réception
Numrec LONG   5 Numéro de réception porté par la mission (champ « identite »)
Lcodmag CHAR   3 Code magasin origine de la mission (champ « codmagori »). C’est le quai de réception.
Adremp CHAR   8 Adresse origine de la mission (champ « adrempori »). C’est le quai de réception.
Idmission LONG   7 Identifiant mission
Cnttyp CHAR   2 Type du conteneur de niveau 4 défini dans la fonction GTLNCN.
Cntcod CHAR   2 Code conteneur de niveau 4 défini dans GTLNCN
Plangere CHAR   1
Indicateur qui vaut « 1 » si les mouvements de réception existent :
  • Dans le cas d’une réception simple,
  • Dans le cas des avis d’expédition,
  • Dans le cas où les mouvements ont été générés à la demande.
Nb_chg LONG    

Nombre de charges à réceptionner, égal au nombre de mouvements restant à valider si l’indicateur précédent vaut « 1 ».

Sinon, c’est le mode déclaratif, égal au nombre de charges déclarées dans l’en-tête de réception moins le nombre de mouvements validés.
Nb_ea LONG     Nombre d’EA de la réception.
Codeop CHAR   12 Code opération des EA, récupéré sur la première EA lue.
Date CHAR   8 Date de réception = date du jour.
Idact LONG   5 Identifiant de l’activité.
Libact CHAR   30 Libellé de l’activité.
Flag_aviexp CHAR   1 Egal à « 1 » s’il s’agit d’une réception avec avis d’expédition.

NOM DU PARAMÈTRE TYPE FORMAT TAILLE REMARQUE
CHARGEMENT       Cas du chargement, expédition
Idtrn LONG   7 Identifiant de la tournée associée à la mission
Lcodmag CHAR   3 Quai d’expédition de la tournée
Idmission LONG   7 Identifiant de la mission
Camion CHAR   10 Numéro de camion de la tournée
Lirtrn CHAR   10 Libellé réduit de la tournée
Idact LONG   5 Identifiant de l’activité
Libact CHAR   30 Libellé de l’activité.
NOM DU PARAMÈTRE TYPE FORMAT TAILLE REMARQUE
Palettisation       Cas d’une consolidation, palettisation
Lcodmag CHAR   3 Code magasin origine de la mission (champ « codmagori »). C’est le quai de réception.
Cnttyp CHAR   2 Type du conteneur de niveau 4 défini dans la fonction GTLNCN.
Cntcod CHAR   2 Code conteneur de niveau 4 défini dans GTLNCN
Idmission LONG   7 Identifiant mission
Idact LONG   5 Identifiant de l’activité.
Libact CHAR   30 Libellé de l’activité.
Sujet parent: APIs Radiofréquence
Aurea Logo
Copyright © 2020. Aurea Software, Inc. ("Aurea")