Tous les détails concernant le fonctionnement du Datahub et de ce Dataset sont ici

En voici un extrait

• Superviseur pièce commerciale
• Paramétrage dossier et Visa
• Intégration de pièce
  • Absence du fichier XML compagnon (V10.11)

Les plateforme de boutique en ligne peuvent provoquer la gestion d’une pièce commerciale (devis, commande client) dans l’ERP par ce type de dataset

Superviseur pièce commerciale

Le superviseur bénéficie des fonctionnalités communes.

Paramétrage dossier et Visa

Une option de la fiche dossier indique si un Visa est requis pour les demandes Datahub d’import de pièce.

Si la case est cochée, il sera nécessaire d’apposer un visa sur tout demande de traitement de dataset. Ce visa doit être donné par un profil Superviseur car il n’y a pas d’affectation nommée.

Si la cas n’est pas cochée, le flux se déroule sans action utilisateur.

Intégration de pièce

Le traitement par l'automate de ce type de fichier est sans particularité : les états de l'automate décrits dans le paramétrage sont enchainés jusqu'à création de la pièce (en passant par exemple par un visa).

L'appel à l'intégrateur de pièces commerciales donne une réponse qui est stockée dans un fichier de trace associé au dataset.

Après intégration, le fichier trace (trace_datahub*.log, où * correspond au numéro de séquence du fichier trace) recense le numéro des pièces traitées.

Si un fichier à intégrer contient plusieurs pièces, celles-ci sont traitées d’un bloc et le fichier trace contient un message unique, recensant toutes les pièces traitées.

Pour traiter les pièces une à une et obtenir un fichier trace par pièce traitée, il est nécessaire de cocher la case Activer le traitement vertical dans le dossier Commerce et logistique, onglet Datahub, groupe Import de pièces.

Il est possible de gérer de la création, modification, évolution et suppression de pièce.

Absence du fichier XML compagnon (V10.11)

Jusqu'à la version 10.10, lors de l’import de pièce par le datahub, l’absence du fichier XML compagnon référencé dans le fichier pivot ne bloquait pas le traitement d'intégration, provoquant une erreur en fin de flux.

A partir de la version 10.11, l’anomalie est détectée en début de flux et le traitement est interrompu avec le message d’erreur numéro 15030:

:

Précision technique : ce contrôle a été implémenté dans la fonction Controler_Coherence_DataSet_ImpPce_Local du programme gtpmdhb000.dhsp .

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

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>

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>