Type de dataset | Import-export de données XMLAvis d’expédition fournisseur pour création de pré-saisie réception fournisseur. |
---|---|
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, notamment le résultat de l’intégration de pièce |
Détails du fichier pivot
Le tableau suivant indique le format de balisage XML attendu
...
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> | Niveau1 - Oui | Balise ouvrante de pièce expédition | ||||
<Mouv> | Niveau 2 - 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 | ||||
|
| mouvement pièce (1 seul autorisé) | ||||
Champs de description du mouvement en commande | ||||||
<PREFCDNO>ValeurChaine/PREFCDNO> | Niveau 3 - Oui | |||||
<CDNO>ValeurNum</CDNO> | Niveau 3 - Oui | |||||
<REF>ValeurNum</REF> <SREF1/> <SREF2/> | Niveau 3 - Oui | Référence article obligatoire. Sous-référence en option | ||||
<TICOD>ValeurChaine/TICOD> | Niveau 3 - Oui | Type de Tiers : F pour fournisseur | ||||
<TIERS>ValeurChaine/TIERS> | Niveau 3 - Oui | Code du tiers | ||||
<ENRNO>ValeurNum</ENRNO> | Niveau 3 - Oui | Numéro de mouvement en commande | ||||
<EMBUN>ValeurChaine/EMBUN> | Niveau 3 - Oui | Unité d'emballage | ||||
<EMBQTE>ValeurNum/EMBQTE> | Niveau 3 - Oui | Quantité emballage | ||||
Champs de description du mouvement en bon de livraison | ||||||
<BLNO>ValeurNum</BLNO> | Niveau 3 - Oui | BLNO : numéro de BL si connu Mettre 0 pour générer un nouveau bl | ||||
<PINOTIERS>ValeurChaine/PINOTIERS> | Niveau 3 - Oui | N°BL fournisseur | ||||
<PIREF>ValeurChaine/PIREF> | Niveau 3 - Oui | REF fournisseur | ||||
<BLDT>ValeurDate</BLDT> | Niveau 3 - Non | Date d'expédition | ||||
<BLTIERS>ValeurChaine</BLTIERS> | Niveau 3 - Non | Tiers pour livraison | ||||
<BLADRCOD>ValeurChaine</BLADRCOD> | Niveau 3 - Non | Code adresse de livraison | ||||
<BLTRANSJRNB>ValeurNum</BLTRANSJRNB> | Niveau 3 - Non | Durée de transport | ||||
<BLMOD>ValeurChaine</BLMOD> | Niveau 3 - Non | Mode de transport | ||||
Champs de description du pied de bon de livraison | ||||||
<COLINB>ValeurNum</COLINB> | Niveau 3 - Non | Nombre de colis | ||||
<POITOT>ValeurNum</POITOT> | Niveau 3 - Non | Poids brut | ||||
<VOLTOT>ValeurNum</VOLTOT> | Niveau 3 - Non | Volume | ||||
<POINTO>ValeurNum</POINTO> | Niveau 3 - Non | Poids net | ||||
<SOLDEFLG>ValeurNum</SOLDEFLG> | Niveau 3 - Non | Solde du poste | ||||
<FRAISMT>ValeurNum</FRAISMT> | Niveau 3 - Non | frais de port : champ existe si champ porcod de l'entete = 0 ou 1 | ||||
Ventilations* | Lignes de ventilation du mouvement (niveau 4) | |||||
</Mouv> | Niveau 2 - Oui | Balise fermante de mouvement pièce (1 seul autorisé) | ||||
</Piece> | Niveau1 - Oui | Balise fermante de pièce expédition | ||||
Ventilations: |
|
| ||||
<VTLNO>ValeurNum</VTLNO> | Niveau 4 - Oui | Numéro de ventilation | ||||
<COLINB>ValeurNum</COLINB> | Niveau 4 - Non | Nombre de colis | ||||
<BLQTE>ValeurNum</BLQTE> | Niveau 4 - Non | Quantité livrée → balise existe si article sécable (obligatoire si COLINB de ventilation = '' et EMBQTE de mouv= '') | ||||
<SERIEFOU>ValeurNum</SERIEFOU> | Niveau 4 - Non | Uniquement balise si article sécable | ||||
<LIEU>ValeurChaine</LIEU> | Niveau 4 - Non | Uniquement si gestion des emplacements sur la fiche dossier et dépôt | ||||
<COLISLST> Liste de colis* </COLISLST> | Lignes de colis (niveau 5). Uniquement pour les articles non sécables ou une méthode de stock FEFO pour l’article | |||||
Liste de colis: | ||||||
<COLINB>ValeurNum</COLINB> | Niveau 6 - Non | Nombre de colis : doit être à 1 pour un article géré par numéro de série | ||||
<EMBQTE>ValeurNum</EMBQTE> | Niveau 6 - Non | Quantité emballage doit être à 1 pour un article géré par numéro de série | ||||
<BLQTE>ValeurNum</BLQTE> | Niveau 6 - Non | Quantité livré doit être à 1 pour un article géré par numéro de série | ||||
<SERIE>ValeurChaine</SERIE> | Niveau 6 - Non | Numéro de lot/ serie | ||||
<COLNO>ValeurNum</COLNO> | Niveau 6 - Non | Numéro de colis | ||||
<LIEU>ValeurChaine</LIEU> | Niveau 6 - Non | Emplacement |
Exemples de fichiers
Exemple de fichier pivot pour import de données réception fournisseur (pivot_impxmlrecepfou.dhub)
Bloc de code |
---|
<?xml version="1.0" encoding="UTF-8"?> <DataHub DataSetType="IMPEXPXMLRECEPFOU"> <Source>EXTERNE<<Source>CLIENTSWDHUB</Source> <Dossier>998</Dossier> <Etablissement></Etablissement> <Dossier>998 <FichierPrincipal>import.xml</FichierPrincipal> </DataHub> |
Exemple de fichier pivot pour export de données (pivot_expxml.dhub)
Bloc de code |
---|
<?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
Bloc de code | ||
---|---|---|
| ||
<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
Bloc de code | ||
---|---|---|
| ||
<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
Bloc de code | ||
---|---|---|
| ||
<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
Bloc de code | ||
---|---|---|
| ||
<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
...
</Dossier>
<Etablissement></Etablissement>
<SwTicketNo></SwTicketNo>
<PIECE>
<MOUV>
<PREFCDNO />
<CDNO>12090211</CDNO>
<REF>COC0001</REF>
<!-- pas de sous reference -->
<SREF1 /> <SREF2 />
<TICOD>F</TICOD>
<TIERS>F0000004</TIERS>
<ENRNO>16000</ENRNO>
<EMBUN>CAI</EMBUN>
<BLNO />
<PINOTIERS>BL-F4</PINOTIERS>
<PIREF>BL-F4</PIREF>
<BLDT>20210505</BLDT>
<BLTIERS>F0000004</BLTIERS>
<BLADRCOD />
<BLTRANSJRNB>2</BLTRANSJRNB>
<BLMOD>CHRO</BLMOD>
<COLINB />
<POITOT />
<VOLTOT />
<POINTOT />
<SOLDEFLG>1</SOLDEFLG>
<MVTLS>
<MVTL>
<VTLNO>17196</VTLNO>
<COLISLST>
<COLIS>
<COLINB>1</COLINB>
<EMBQTE>1</EMBQTE>
<BLQTE>1</BLQTE>
<SERIE>NS-1</SERIE>
<COLNO>COL-1</COLNO>
<LIEU>A1G C1 N1</LIEU>
</COLIS>
<COLIS>
<COLINB>1</COLINB>
<EMBQTE>1</EMBQTE>
<BLQTE>1</BLQTE>
<SERIE>NS-2</SERIE>
<COLNO>COL-1</COLNO>
<LIEU>A1G C1 N1</LIEU>
</COLIS>
</COLISLST>
</MVTL>
</MVTLS>
</MOUV>
</PIECE>
<FichierPrincipal>Recepfoucreation1.pdf</FichierPrincipal>
</DataHub>
|
Exemple de fichier compagnon (Recepfoucreation.pdf)
View file | ||
---|---|---|
|