Type de dataset | Import-export de données XML |
---|---|
DatasetType | RECEPFOU |
Nature de fichier joint | DATAHUB_RECEPFOU |
Code chemin | DATAHUB_JOINT_RECEPFOU |
Fichier pivot | Complet, le pivot contient toutes les données de la réception fournisseur |
Fichier compagnon | Non |
Fichier trace | Oui pour les anomalies |
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: RECEPFOU pour indiquer qu’il s’agit d’une réception fournisseur |
Entête* | Oui | Entête de description des prévisions |
Détail des avis de réception* | Oui |
|
</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 |
<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. Par exemple le PDF ou JPG ou autre image de l’avis d’expédition fournisseur |
| ||
Détail de l’avis d’expédition : |
|
|
<Piece> | Oui | Balise ouvrante de pièce expedition |
Prevision* | Oui | Description d’une prévision |
</Piece> | Oui | Balise fermante de pièce expedition |
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 |
|
|
|
Exemples de fichiers
Exemple de fichier pivot pour import de données (pivot_impxml.dhub)
<?xml version="1.0" encoding="UTF-8"?> <DataHub DataSetType="IMPEXPXML"> <Source>EXTERNE</Source> <Dossier>998</Dossier> <Etablissement></Etablissement> <FichierPrincipal>import.xml</FichierPrincipal> </DataHub>
Exemple de fichier pivot pour export de données (pivot_expxml.dhub)
<?xml version="1.0" encoding="UTF-8"?> <DataHub DataSetType="IMPEXPXML"> <Source>EXTERNE</Source> <Dossier>998</Dossier> <Etablissement></Etablissement> <FichierPrincipal>export.xml</FichierPrincipal> </DataHub>
Exemple de fichier principal pour un import de données (import.xml)
Cas d’une modification du nom d’une client
<XML> <import table="CLI" action="update"> <field name="DOS" value="998"/> <field name="TIERS" value="C0001010"/> <field name="NOM" value="NOM MODIFIE PAR DATAHUB"/> </import> </XML>
Cas d’une modification de l’encours de deux clients
<XML> <import table = "CLI" action= "update"> <field name = "TIERS" value= "C0000001"/> <field name = "ENMAX(1)" value= "250000,00"/> </import> <import table = "CLI" action= "update"> <field name = "TIERS" value= "C0000003"/> <field name = "ENMAX(1)" value= "250000,00"/> </import> </XML>
Exemple de fichier principal pour un export de données (export.xml)
Cas d’un export de tous les code opérations avec tous les champs
<XML> <export table="T025"> <field name="ALL"/> </export> </XML>
Cas d’un export de tous les clients avec les champs DOS, TIERS et TEL, avec indication du typage dans la réponse
<XML> <export table="CLI" datatype=true> <field name="DOS"/> <field name="TIERS"/> <field name="TEL"/> </export> </XML>
Exemple de réponse à une demande d’export avec typage de données