Objet de l'interface
L’interface permet d’importer les données stockées d'activité et de productivité d'un entrepôt drive et ses points de livraison pour une journée donnée depuis l’outil Middle Office Drive vers la solution Timesquare.
Le principe est de mettre à disposition les informations attendues dans un fichier de type XML qui sera lu et interprété par l’interface de façon à mettre à jour la base de données.
En savoir plus sur le paramétrage de cet import.
Récupération des activités et des points de livraison
Les activités et les points de livraison sont contenus dans le fichier XML. Pour indiquer les activités et les points de vente concernés par l'import, j'utilise le contenu du fichier XML à importer ou d'un ancien fichier, à partir d'un emplacement local ou bien de l'emplacement paramétré du fichier importé.
Un seul fichier est récupéré. En fonction du filtrage des dates, c'est le fichier le plus récent de la période concernée qui est récupéré. Exemple : Si la période sélectionnée est J-10 à J-1, c'est le fichier de J-1, sinon J-2, etc.
Nom du fichier
Le nom de fichier est fixe : ficWPPD001_AAMMJJ_NNNNNN.xml, avec :
- ficWPPD001 =préfixe
- AAMMJJ = journée de travail où "JJ" correspond au jour, "MM" correspond au mois et "AA" correspond à l'année sur 2 caractères
- NNNNNN = code de l'entrepôt drive
Format
Fichier XML avec encodage UTF-8.
Description des lignes du fichier
Le fichier est structuré comme suit :
- Elément <DAP> : élément à la racine du fichier.
- Elément <TACHES> : composé d'éléments <TACHE>, il décrit la liste des différentes activités (tâches) qui peuvent être effectuées.
- Elément <AFFS> : composé d'éléments <AFF>, il décrit la liste des sous-tâches (affectations) paramétrées dans l'entrepôt.
- Elément <PERS> : composé d'éléments <PER>, il décrit la liste des personnes travaillant dans l'entrepôt.
- Elément <DACTS> : composé d'éléments <DACT>, il détaille l'activité de l'entrepôt ou de ses points de livraison.
- Elément <DPRODS> : composé d'éléments <DPROD>, il détaille la productivité de l'entrepôt ou de ses points de livraison.
Elément <DAP>
Cet élément est à la racine du fichier. Il contient les informations suivantes :
Elément |
Type | Remarques |
---|---|---|
CENTREPOT | Numérique | Code de l'entrepôt. |
NENTREPOT | Aphanumérique | Nom de l'entrepôt. |
JOUR | Date | Journée à laquelle se rapportent les données au format AAAA-MM-JJ. Cette date est la même que le nom du fichier. |
PAS | Numérique | Granularité des tranches saisies en minutes. Les valeurs possibles sont "15" ou "60". |
Exemple de contenu de l'élément <DAP>
<DAP xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" CENTREPOT="085901" NENTREPOT="Fretin" JOUR="2022-09-26" PAS="60">
Elément <TACHES>
La liste des activités (tâches) est contenue dans l'élément <TACHES>. Cet élément se compose d'éléments <TACHE>. L'élément <TACHE> contient les informations suivantes :
Elément |
Type | Remarques |
---|---|---|
CTACHE | Numérique | Code de l'activité (la tâche). |
LTACHE | Aphanumérique | Nom de l'activité (la tâche). |
TQTE | Aphanumérique |
Type des quantités renseignées pour la tâche. Les valeurs possibles sont :
|
DAFF | Aphanumérique | Indique si les données sont détaillées à l'affectation. Les valeurs possibles sont "O" pour Oui ou "N" pour Non. |
- Si DAFF="0", le système fait la combinaison entre la ligne TACHE et toutes les lignes AFF.
- Si DAFF="N", le système ne récupère que la ligne TACHE.
Exemple de contenu de l'élément <TACHES>
<TACHES>
<TACHE CTACHE="02" LTACHE="Préparation" TQTE="UV" DAFF="O" />
<TACHE CTACHE="03" LTACHE="Restockage des conteneurs" TQTE="NA" DAFF="N" />
<TACHE CTACHE="04" LTACHE="Livraison" TQTE="CDE" DAFF="N" />
<TACHE CTACHE="06" LTACHE="Gestion Produit" TQTE="NA" DAFF="N" />
<TACHE CTACHE="07" LTACHE="Transfert réserve vers picking" TQTE="NA" DAFF="N" />
</TACHES>
Elément <AFFS>
La liste des sous-tâches (affectations) est contenue dans l'élément <AFF>. Cet élément se compose d'éléments <AFF>. L'élément <AFF> contient les informations suivantes :
Elément |
Type | Remarques |
---|---|---|
CAFF | Numérique | Code de la sous-tâche (l'affectation). |
LAFF | Aphanumérique | Nom de la sous-tâche (l'affectation). |
TEMP | Aphanumérique |
Température de fonctionnement de la sous-tâche. Les valeurs possibles sont :
|
Exemple de contenu de l'élément <AFFS>
<AFFS>
<AFF CAFF="01" LAFF="AMBIANT STATIQUE" TEMP="01" />
<AFF CAFF="02" LAFF="FRAIS" TEMP="02" />
<AFF CAFF="03" LAFF="SURGELES" TEMP="04" />
<AFF CAFF="04" LAFF="FRUITS ET LEGUMES" TEMP="03" />
<AFF CAFF="05" LAFF="AUTOMATES" TEMP="01" />
<AFF CAFF="06" LAFF="ENTREPÔT" TEMP="99" />
</AFFS>
Elément <PERS>
La liste des personnes est contenue dans l'élément <PERS>. Cet élément se compose d'éléments <PER>. L'élément <PER> contient les informations suivantes :
Elément |
Type | Remarques |
---|---|---|
CPER | Aphanumérique | Matricule de la personne |
IPER | Aphanumérique | Initiales de la personne |
NPER | Aphanumérique | Nom de la personne |
PPER | Aphanumérique | Prénom de la personne |
Exemple de contenu de l'élément <PERS>
<PERS>
<PER CPER="12006" IPER="pgr" NPER="granada" PPER="pauline" />
<PER CPER="12009" IPER="sba" NPER="barcelona" PPER="sylvie" />
<PER CPER="12012" IPER="ama" NPER="madrid" PPER="amelie" />
<PER CPER="12015" IPER="ege" NPER="gerona" PPER="eric" />
<PER CPER="12020" IPER="pja" NPER="jaen" PPER="perrine" />
<PER CPER="12063" IPER="lal" NPER="almeria" PPER="lucas" />
</PERS>
Elément <DACTS>
La liste des données d'activité pour les points de livraison est contenue dans l'élément <DACTS>. Le code du point de livraison correspond au contenu de la balise CPL. Le libellé du point de livraison correspond au contenu de la balise NPL. L'élément <DACTS> se compose d'éléments <DACT>. L'élément <DACT> contient les informations suivantes :
Elément | Type | Remarques |
---|---|---|
CTACHE | Numérique | Code de l'activité |
TRANCHE | Heure | Début de la tranche horaire au format HH:MM |
CAFF | Numérique | Code de la sous-tâche |
DUREE | Numérique | Durée de travail en secondes |
QTE | Numérique | Quantité |
Exemple de contenu de l'élément <DACTS>
<DACTS CPL="085905" NPL="Lille">
<DACT CTACHE="03" TRANCHE="09:00" DUREE="44" />
<DACT CTACHE="03" TRANCHE="10:00" DUREE="563" />
<DACT CTACHE="03" TRANCHE="11:00" DUREE="347" />
<DACT CTACHE="03" TRANCHE="12:00" DUREE="361" />
<DACT CTACHE="04" TRANCHE="10:00" QTE="6" DUREE="472" />
<DACT CTACHE="04" TRANCHE="11:00" QTE="7" DUREE="444" />
<DACT CTACHE="04" TRANCHE="12:00" QTE="14" DUREE="975" />
<DACT CTACHE="10" TRANCHE="10:00" DUREE="54" />
<DACT CTACHE="10" TRANCHE="12:00" DUREE="32" />
</DACTS>
<DACTS CPL="085906" NPL="Toulouse">
<DACT CTACHE="03" TRANCHE="10:00" DUREE="709" />
<DACT CTACHE="03" TRANCHE="12:00" DUREE="195" />
<DACT CTACHE="03" TRANCHE="13:00" DUREE="639" />
<DACT CTACHE="03" TRANCHE="15:00" DUREE="592" />
<DACT CTACHE="04" TRANCHE="10:00" QTE="1" DUREE="132" />
<DACT CTACHE="04" TRANCHE="11:00" QTE="7" DUREE="1171" />
<DACT CTACHE="04" TRANCHE="12:00" QTE="10" DUREE="755" />
<DACT CTACHE="04" TRANCHE="13:00" QTE="5" DUREE="364" />
<DACT CTACHE="04" TRANCHE="14:00" QTE="4" DUREE="344" />
<DACT CTACHE="10" TRANCHE="10:00" DUREE="32" />
</DACTS>
Elément <DPRODS>
La liste des données de productivité pour les points de livraison est contenue dans l'élément <DPRODS>. Le code du point de livraison correspond au contenu de la balise CPL. Le libellé du point de livraison correspond au contenu de la balise NPL. L'élément <DPRODS> se compose d'éléments <DPROD>. L'élément <DPROD> contient les informations suivantes :
Elément |
Type | Remarques |
---|---|---|
CTACHE | Numérique | Code de l'activité |
CPER | Alphanumérique | Matricule de la personne |
CAFF | Numérique | Code de la sous-tâche |
DUREE | Numérique | Durée de travail en secondes |
QTE | Numérique | Quantité |
Exemple de contenu de l'élément <DPRODS>
<DPRODS CPL="085905" NPL="Lille">
<DPROD CTACHE="02" CPER="369076" QTE="18" DUREE="108" />
<DPROD CTACHE="02" CPER="370491" QTE="15" DUREE="78" />
<DPROD CTACHE="03" CPER="369076" DUREE="7540" />
<DPROD CTACHE="03" CPER="370491" DUREE="6500" />
<DPROD CTACHE="04" CPER="369076" QTE="46" DUREE="3445" />
<DPROD CTACHE="04" CPER="370491" QTE="51" DUREE="3243" />
<DPROD CTACHE="10" CPER="369076" DUREE="59" />
<DPROD CTACHE="10" CPER="370491" DUREE="191" />
</DPRODS>
<DPRODS />
<DPRODS CPL="085906" NPL="Toulouse">
<DPROD CTACHE="02" CPER="333009" QTE="8" DUREE="94" />
<DPROD CTACHE="02" CPER="347400" QTE="4" DUREE="52" />
<DPROD CTACHE="02" CPER="364652" QTE="12" DUREE="105" />
<DPROD CTACHE="03" CPER="333009" DUREE="6015" />
<DPROD CTACHE="03" CPER="347400" DUREE="494" />
<DPROD CTACHE="03" CPER="364652" DUREE="1513" />
<DPROD CTACHE="04" CPER="333009" QTE="21" DUREE="1723" />
<DPROD CTACHE="04" CPER="347400" QTE="19" DUREE="2176" />
<DPROD CTACHE="04" CPER="364652" QTE="31" DUREE="3206" />
<DPROD CTACHE="10" CPER="364652" DUREE="32" />
</DPRODS>
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.