Prévisions de vente PDP et niveaux de stock
Type de dataset | Prévisions de vente PDP/Objectifs de vente CBN et niveaux de stock |
---|---|
DatasetType (3) | PDPPREV |
Nature de fichier joint | DATAHUB_PDPPREV |
Code chemin | DATAHUB_JOINT_PDPPREV |
Fichier pivot | Complet: le détail est dans le fichier pivot. Le pivot contient soit des prévisions, soit des niveaux de stock |
Fichier compagnon | Non |
Fichier trace | Non |
Règles de gestion
REGLES DE GESTION COMMUNE :
un fichier pivot contient les données d’un seul dossier à la fois.
REGLES DE GESTION PREVISIONS :
les données sont traitées en import ‘mode différentiel’ selon la clé REF-SREF1-SREF2-DEPO. Les données transmises sont donc crées ou mises à jour selon cette clé, puis les données non importées sont supprimées. Cela implique qu’un groupe concernant la clé est obligatoirement écrit, même si la quantité est à 0 pour que l’import sache qu’il doit traiter la clé.
hors exception précédente (quantité donnée à 0 pour indiquer le traitement de la clé) les dates qui n’ont pas de prévision ne sont pas transmises
la balise Horizon permet de gérer la suppression des données antérieures à cette date (pour tout le Dossier indiqué)
les données importées sont visibles dans le ‘Saisie des prévisions PDP’
seuls les articles ayant un mode de gestion des prévisions “PDP” ou “Objectifs de vente” sont acceptés
REGLES DE GESTION NIVEAU DE STOCK :
les données importées sont visibles dans la fiche réappro RSO de l’article
le fournisseur habituel et l'unité de vente sont pris par défaut de la fiche article
Détails du fichier pivot
Le tableau suivant indique le format de balisage XML attendu
Les types traités sont :
valeurChaine indique une valeur de type chaîne de caractères alphanumériques
valeurDate indique une valeur de type date au format YYYYMMDD
valeurNum indique une valeur numérique sans séparateur de milliers
La colonne indique si la balise et sa valeur sont obligatoires ou non. 'Rec' signifie 'Recommandé' pour un traitement total automatique
Balise XML | Obligatoire | Observation |
<?xml version="1.0" encoding="UTF-8"?> | Oui | Indique le format d’encodage des chaînes de caractères |
<DataHub DataSetType=valeurChaine> | Oui | L’attribut DATASETTYPE indique le type de pivot. Valeur: PDPPREV pour indiquer qu’il s’agit d’une prévision de vente PDP |
Entête* | Oui | Entête de description des prévisions |
Détail des prévisions* ou Détail des niveaux de stock* | Oui |
|
Fichiers* | Non | Fichiers complémentaires au fichier principal et au pivot |
Erreurs* | Non | Messages d’erreurs concernant les documents compagnons du pivot |
</DATAHUB> | Oui |
|
| ||
Entête : |
| Un seul entête par fichier |
<Source>valeurChaine</Source> | Rec | Permet d’identifier l’émetteur du pivot dans le dataset |
<Systeme>valeurChaine</Systeme> | Rec | Permet d’identifier le système émetteur dans le dataset |
<IdExterne>valeurChaine</IdExterne > | Rec | Permet d’indiquer l’identifiant unique d’un logiciel externe dans le but de donner un premier pivot pour complétion ultérieure par un second pivot. |
<Dossier>valeurChaine</Dossier> | Rec | Code de dossier Divalto |
<Etablissement>valeurChaine</Etablissement> | Rec | Code d’établissement Divalto, si gestion du dossier par établissement |
<SwTicketNo>0</SwTicketNo> | Rec | Numéro de ticket de demande. La présence de la balise indique qu’on veut avoir un ticket en retour |
<Horizon>valeurDate</Horizon> | Oui | Horizon de départ des prévisions ou niveaux de stock ; Utilisé pour les prévisions pour gérer la suppression des données antérieures à cette date |
<FichierPrincipal> valeurChaine</FichierPrincipal> | Non | Nom du fichier principal associé au pivot (feuille excel par exemple). Le fichier peut être dans un sous-répertoire du pivot, on indiquera donc le chemin relatif. |
| ||
Détail des prévisions : |
|
|
<Previsions> | Oui | Balise ouvrante de prévisions |
Prevision* | Oui | Description d’une prévision |
</Previsions> | Oui | Balise fermante de prévisions |
VOIR NOTE 1 | ||
Détail des niveaux de stock : |
|
|
< NiveauxStock > | Oui | Balise ouvrante de niveau de stock |
NiveauStock* | Oui | Description d’un niveau de stock |
</NiveauxStock> | Oui | Balise fermante de niveau de stock |
| ||
Prévision : |
|
|
<Prevision> | Oui | Balise ouvrante de prévision |
<Reference> valeurChaine </Reference> | Oui | Référence article |
<IndiceArticle> valeurChaine </IndiceArticle> | Non | Indice Article (si vide l’indice en cours sera pris) |
<SousReference1> valeurChaine </SousReference1> | Non | Sous-référence 1 article |
<SousReference2> valeurChaine </SousReference2> | Non | Sous-référence 2 article |
<Depot> valeurChaine </Depot> | Oui | Code dépôt |
<Quantite> valeurNum </Quantite> | Oui | Quantité de prévision. Peut être à 0 si valeur unique, mais |
<Unite> valeurChaine </ Unite > | Rec | Unité de prévision (vente) |
<DateDebutPeriode> valeurDate</DateDebutPeriode> | Oui | Date de début de la période (par exemple premier jour du mois) |
<Periode> valeurChaine</Periode> | Oui | J pour Jour, S pour Semaine, M pour Mois |
</Prevision> | Oui | Balise fermante de prévision |
| ||
| ||
Niveau de stock : |
|
|
<NiveauStock> | Oui | Balise ouvrante de prévision |
<Reference> valeurChaine </Reference> | Oui | Référence article |
<IndiceArticle> valeurChaine </IndiceArticle> | Non | Indice Article (si vide l’indice en cours sera pris) |
<SousReference1> valeurChaine </SousReference1> | Non | Sous-référence 1 article |
<SousReference2> valeurChaine </SousReference2> | Non | Sous-référence 2 article |
<Depot> valeurChaine </Depot> | Oui | Code dépôt |
<Tiers> valeurChaine </Tiers> | Non | Code tiers |
<Quantite> valeurNum </Quantite> | Oui | Quantité du niveau de stock |
<Unite> valeurChaine </ Unite > | Rec | Unité de niveau de stock |
</NiveauStock> | Oui | Balise fermante de prévision |
| ||
Fichiers : |
|
|
<Fichiers> | Oui | Balise ouvrante de fichiers |
<Fichier> valeurChaine </Fichier> | Oui | Nom du fichier compagnon complémentaire (hors fichier principal qui a une balise dédiée). Le fichier peut être dans un sous-répertoire du pivot, on indiquera donc le chemin relatif |
</Fichiers> | Oui | Balise fermante de fichiers |
|
|
|
Erreurs : |
|
|
<MsgErreurs> | Oui | Balise ouvrante d’erreurs |
<MsgErreur> | Oui | Balise ouvrante d’erreur |
<NumErreur> valeurNum </NumErreur> | Non | Numéro du message d’erreur |
<TexteErreur> valeurChaine </TexteErreur> | Non | Texte du message d’erreur |
</MsgErreur> | Oui | Balise fermante d’erreur |
</MsgErreurs> | Oui | Balise fermante de pièces |
NOTE 1 : un fichier pivot xml contient SOIT des prévisions SOIT des niveaux de stock. Les informations d'entête sont communes, mais les informations de détails des lignes ne peuvent concerner qu'une seule des deux entités à la fois.
Exemples de fichiers
Exemple de fichier pivot pour prévision PDP (pivot_pdpprev.dhub)
<?xml version="1.0" encoding="UTF-8"?>
<DataHub DataSetType="PDPPREV">
<Source>DYN</Source>
<Systeme>DSCP</Systeme>
<IdExterne></IdExterne>
<Dossier>998</Dossier>
<Etablissement></Etablissement>
<Horizon>20170205</Horizon>
<Previsions>
<Prevision>
<Reference>ALB0001x</Reference>
<SousReference1></SousReference1>
<SousReference2></SousReference2>
<Depot>1</Depot>
<DateDebutPeriode>20170701</DateDebutPeriode>
<Quantite>2,5</Quantite>
<Unite>P</Unite>
<Periode>S</Periode>
</Prevision>
<Prevision>
<Reference>ALB0001</Reference>
<SousReference1></SousReference1>
<SousReference2></SousReference2>
<Depot>1</Depot>
<DateDebutPeriode>20170801</DateDebutPeriode>
<Quantite>2,5</Quantite>
<Unite>P</Unite>
<Periode>S</Periode>
</Prevision>
</Previsions>
</DataHub>
Exemple de fichier compagnon pour niveau de stock (pivot_nivstoc.dhub)
<?xml version="1.0" encoding="UTF-8"?>
<DataHub DataSetType="PDPPREV">
<Source>DYN</Source>
<Systeme>DSCP</Systeme>
<IdExterne></IdExterne>
<Dossier>998</Dossier>
<Etablissement></Etablissement>
<Horizon>20170205</Horizon>
<NiveauxStock>
<NiveauStock>
<Reference>ALB0001</Reference>
<SousReference1></SousReference1>
<SousReference2></SousReference2>
<Depot>1</Depot>
<Quantite>2,5</Quantite>
<Unite>P</Unite>
</NiveauStock>
</NiveauxStock>
</DataHub>