Pièce commerciale (V10.5)
- Bertrand Littel
Type de dataset | Création de pièce commerciale |
|---|---|
DatasetType (6) | IMPPCE |
Nature de fichier joint | DATAHUB_PCE |
Code chemin | DATAHUB_JOINT_PCE |
Fichier pivot | Simple : le détail des pièces est dans le fichier XML compagnon |
Fichier compagnon | XML : décrit les pièces à intégrer (par le traitement d’intégration GTPP150) |
Fichier trace | Oui, erreur d’intégration |
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: IMPPCE pour indiquer qu'il s'agit de pièce commerciale |
<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 |
<Dossier>valeurChaine</Dossier> | Oui | 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 |
<FichierPrincipal>valeurChaine</FichierPrincipal> | Oui | Nom du fichier principal. Ce fichier au format XML indique les détails de la ou les pièces commerciales à importer |
NOTE : à partir de la version 10.6, le champ IPAR <PcePiRefCtrFl> permet d’indiquer si le contrôle d’existence sur la référence externe est actif ou non. Par défaut le contrôle est appliqué selon le paramétrage
<PcePiRefCtrFl>2</PcePiRefCtrFl> : oui, le contrôle des champs Votre pièce et Votre référence est actif. En cas d’erreur de ce contrôle, un message est indiqué dans le fichier trace
<PcePiRefCtrFl>1</PcePiRefCtrFl> : non, pas de contrôle des champs Votre pièce et Votre référence
Détails du fichier principal
La structure du fichier XML compagnon est strictement identique à celle d’un fichier l’intégration de pièce (GTFI GTPP150) avec une mise à plat au format XML des balises.
Chaque pièce à créer est entourée des balises </PIECE> … </PIECE>, puis décrite à l'aide de la structure d'un fichier GTFI
<IPAR>...valeurs de champs...</IPAR>
<ENT>...valeurs de champs...</ENT>
<ITXT>...valeurs de champs...</ITXT>
<EEC>...valeurs de champs...</EEC>
<EAD>...valeurs de champs...</EAD>
<MOUV>...valeurs de champs...</MOUV>
<MVTL>...valeurs de champs...</MVTL>
Toutes les informations par ici Intégration de pièce par GTPP150
La structure du fichier pivot a été enrichie en V10.5 pour permettre d'importer des taxes complémentaires. Ces dernières doivent être spécifiées pour chaque ligne de pièce soumise à des taxes complémentaires dès lors que les lignes sont dans le fichier pivot (si le fichier ne référence que l'entête de pièce, les taxes complémentaires renseignées dans la commande ou le bon de livraison sont conservées et servent à initialiser le contrôle de facture)
Exemples de fichiers
Exemple de fichier pivot pour création pièce (pivot_pce.dhub)
<?xml version="1.0" encoding="UTF-8"?>
<DataHub DataSetType="IMPPCE">
<Source>CLIENTSWDHUB</Source>
<Dossier>998</Dossier>
<Etablissement>1</Etablissement>
<SwTicketNo>0</SwTicketNo>
<FichierPrincipal>ImportPiece.xml</FichierPrincipal>
</DataHub>
Exemple de fichier compagnon pour création pièce (ImportPiece.xml)
<PIECE>
<IPAR>
<Ce1>I</Ce1>
<Trait>C</Trait>
<Dos>998</Dos>
<Ticod>C</Ticod>
<Picod>2</Picod>
</IPAR>
<ENT>
<Dos>998</Dos>
<Ce1>A</Ce1>
<Ce4>1</Ce4>
<op>C</op>
<Tiers>C0000001</Tiers>
<Ticod>Client</Ticod>
<Picod>Commande</Picod>
<pidt>01/01/2021</pidt>
<deldemdt>01/01/2021</deldemdt>
<delaccdt>01/01/2021</delaccdt>
<depo>1</depo>
</ENT>
<MOUV>
<Ce1>C</Ce1>
<Ce2>1</Ce2>
<Ref>ALB0001</Ref>
<CdQte>6,0000</CdQte>
<pcod>4</pcod>
<pub>6,3600</pub>
<pubtyp>2</pubtyp>
<crtotmt>5,0400</crtotmt>
<stres>1</stres>
<mvcod>1</mvcod>
</MOUV>
</PIECE>