Type de dataset | Import-export de données XML | DatasetTypeAvis d’expédition fournisseur pour création de pré-saisie réception fournisseur. |
|---|---|---|
DatasetType (8) | 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<<SwTicketNo>0</Horizon>SwTicketNo> | Oui RecHorizon 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 | Numéro de ticket de demande. LA présence de la balise indique qu’on veut avoir un ticket en retou | |
<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 | ||
|---|---|---|
|