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>