Les plateforme de boutique en ligne peuvent provoquer la création 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.

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>