Le traitement d'intégration GTPP150

Owned by Bertrand Littel
Last updated: 23/09/2024 by Bertrand Littel
8 min read

SOMMAIRE

Principe de l’intégration de pièce

Le traitement d'intégration de pièces dans Divalto Achat-Vente intègre le contenu d'un fichier DHFI de type GTFI.dhfd.

IMPORTANT

  • Le format DHFI est un format propriétaire Divalto, qui n’est reconnu que par le Runtime Harmony et les outils de développement autour d’XWIN.

  • Le traitement d’intégration de pièce GTPP150 est une tâche de fond, sans interaction utilisateur

  • Tous les traitements qui proposent une intégration de pièce (import tableur, import par service web, import par CSV, fonction de validation de pièce, etc…) font appel à ce traitement d’intégration

  • Par “intégration” on entends plusieurs actions possibles : création, modification, suppression, validation (=passage d’un type de pièce a un autre)

  • Un fichier GTFI peut traiter plusieurs actions différentes sur plusieurs pièces différentes, mais attention aux anomalies partielles qui deviennent difficile à traiter en retour

 

En pratique, un traitement métier va faire l’intermédiaire entre le format d’import et le fichier d’intégration GTFI.

Prenons un exemple avec une création de commande client par tableur excel

  1. Lancement du traitement en interaction avec un utilisateur (Exemple : lancer l’import tableur et lui donner une feuille excel qui décrit une création de commande)

  2. Conversion par traitement des données d’entrée vers les données temporaires (Exemple : l’import tableur convertit la feuille excel en données GTFI, en faisant des pré-contrôles)

  3. Ecriture dans un fichier GTFI des données temporaires (Ecriture dans des fichiers temporaires, par exemple gtfi_tableur.dhfi et gtfi_tableur.dhfd)

  4. Appel de l’intégration de pièce avec indication des fichiers (Appel en programmation Diva au GTPP150 avec pour paramètre gtfi_tableur.dhfi )

  5. L’intégration de pièce traite ce qui est demandé dans les fichiers GTFI (Dans cet exemple une création d’une commande client)

  6. Création d’un fichier retour en cas d’erreur ou d’informations retour, et écriture dans le livre de bord par l’intégration de pièce (Par exemple une erreur de paramétrage a empêché la création)

  7. Renvoi au demandeur d’un status et d’un fichier retour ; le fichier GTFI est effacé (Par exemple pièce rejetée, avec un fichier gtfierr.dhfi)

  8. Le traitement demandeur traite la réponse et le fichier erreur (Par exemple, afficher dans une colonne excel les messages d’erreur)

 

Les actions possible - algorithmes disponibles

Il est possible de :

  • Créer de nouvelles pièces dans l’ERP : devis, commandes, BL, factures qui peuvent concerner : client, fournisseur, tiers interne

  • Modifier une pièce

  • Supprimer une pièce

  • Valider une pièce partiellement (exemple : validation de commandes partiellement en BL ). Une partie de la pièce change de type; on précise les lignes à valider, ces lignes peuvent être validées totalement ou partiellement.

  • Totale validation de pièce. Toute la pièce change de type.


La première lettre en gras ci-dessus indique le type d’algorithme

Algorithme de validation de type 'C'

La séquence d'enregistrements minimale est :
IPAR
MOUV

Algorithme de validation de type 'M'

La séquence d'enregistrements minimale est :
IPAR
MOUV


Pour modifier les tables liées à l'en-tête (EEC – EAD- ou texte) il faut que l'enregistrement ENT figure dans GTFI.

Le mouvement à modifier est recherché par le numéro d'enregistrement ENRNO. L'égalité GRREF – OP – DEPO est contrôlée.

Informations complémentaires

  • Seules les données renseignées ( <> de espace ou 0) sont modifiées.

  • Si on modifie les quantités, les enregistrement MVTL deviennent obligatoires. On doit respecter somme des ventilations = à quantité du MOUV.

  • Les chapitres, les postes et les MOUV avec un ENRNO = 0 ou non trouvé sont créés en fin de pièce.

  • Lorsqu'un texte est intégré il remplace le texte existant (pas de fusion possible).

  • La fonction ENT_Client_Modification_Affecter traite la modification

  • Les données modifiées sont traitées dans la séquence G1T1_Client_Modification_affecter..

 

Suppression de mouvement lors de la validation

Un champ, le MOUV.CEF positionne à la valeur ‘S' est un artifice qui permet d’indiquer la suppression du mouvement indiqué

Algorithme de validation de type ‘V' (=passage d’un type de pièce à un autre sur une partie des lignes)

La séquence d'enregistrements minimale est :
IPAR
MOUV


Pour chaque enregistrement MOUV à valider, on recherchera par le numéro d'enregistrement le MOUV de la pièce initiale qui doit être validé.
Lorsque l'enregistrement à valider existe, il est repris entièrement pour la validation. Si vous souhaitez modifier certaines données, surchargez la procédure « G1T1_Validation_Affectation_Ap ».

Informations complémentaires

  • On ne pourra en aucun cas modifier la référence article, le code opération…

  • On ne peut pas supprimer de ventilation

  • Les lignes sont toujours créées en fin de pièce

  • La validation d'une ligne est identifiée par son numéro d'enregistrement, et pas à partir de la référence article.

  • Pour identifier une ventilation on indiquera également le numéro VTLNO sinon les ventilations seront validées dans l'ordre de lecture des VTL .

  • Le reliquat est mis à jour automatiquement au prorata des quantités validées

  • Attention, pour le cas d’une validation commande ou BL en facture, il faut éviter de modifier les quantité livrées


Traitement des remises en pied
Validation sur une pièce existante on conserve le % de la pièce finale.
Validation en créant la pièce finale, on reprend le % de la pièce initiale.
Le % indiqué dans ENT de GTFI écrasant le % ainsi défini.

 

Suppression de mouvement lors de la validation

Un champ, le MOUV.CEF positionne à la valeur ‘S' est un artifice qui permet d’indiquer la suppression du mouvement indiqué

 

Algorithme de validation de type 'T' Validation de pièce (=passage total d’un type de pièce à un autre)

La séquence d'enregistrements minimale est :
IPAR

Pour chaque enregistrement MOUV à valider, on recherchera par le numéro d'enregistrement le MOUV de la pièce initiale qui doit être validé.
Lorsque l'enregistrement à valider existe, il est repris entièrement pour la validation. Si vous souhaitez modifier certaines données, surchargez la procédure « G1T1_Validation_Affectation_Ap ».

Informations complémentaires

  • On ne pourra en aucun cas modifier la référence article, le code opération…

  • On ne peut pas supprimer de ventilation

  • La validation d'une ligne est identifiée par son numéro d'enregistrement, et pas à partir de la référence article.

  • Pour identifier une ventilation on indiquera également le numéro VTLNO sinon les ventilations seront validées dans l'ordre de lecture des VTL .

  • Attention, pour le cas d’une validation commande ou BL en facture, il faut éviter de modifier les quantité livrées

 

Traitement des remises en pied
Validation sur une pièce existante on conserve le % de la pièce finale.
Validation en créant la pièce finale, on reprend le % de la pièce initiale.
Le % indiqué dans ENT de GTFI écrasant le % ainsi défini.

 

Suppression de mouvement lors de la validation

Un champ, le MOUV.CEF positionne à la valeur ‘S' est un artifice qui permet d’indiquer la suppression du mouvement indiqué

Algorithme de validation de type 'S'

La séquence d'enregistrements minimale est :
IPAR

 

Exemples simples d’action

Création de pièce avec texte (C)

Exemple Diva d’une ligne IPAR de création d’un pièce commande fournisseur avec mouvement

IPAR = ' ' IPAR.CE1 = 'I' IPAR.DOS = MZ.DOS IPAR.ETB = MZ.ETB IPAR.PICOD = '2' ; Commande IPAR.TICOD = 'F' ; Fournisseur IPAR.TRAIT = 'C' ; Création HWrite(GTFI, IPAR) ENT = ' ' ENT.CE1 = 'A' ENT.CE4 = Condition(CdeProvisoireCtmFl = OUI, '7', '1') ENT.TIERS = TiersFou ;fournisseur choisi ENT.TvaTie = Fournisseur.TvaTie ENT.DEPO = GtCtm100T1.DEPO ;depo de la ligne client ENT.Projet = GtCtm100T1.Projet ENT.PiDt = today ENT.DelDemDt = today ENT.OP = 'F' HWrite(GTFI, ENT) MOUV = ' ' MOUV.CE1 = 'C' MOUV.CE2 = '1' MOUV.GrRef = GrRef MOUV.CdQte = QteE MOUV.VenUn = AchUn MOUV.Depo = Depo MOUV.CdDt = DelDt MOUV.Projet = Projet HWrite(GTFI, MOUV) Note_Chargement_ (C_APPLIC_DAV,Note,RtfMot=RtfMot) if Note_Tag_Extraction(C_APPLIC_DAV ,Note,Tag, RtfMot=RtfMot) = true rtfnom = Note_Rechercher_Nom_Rtf (C_APPLIC_DAV,RtfMot=RtfMot) init itxt = ' ' itxt.ce1 = 'T' itxt.txtnat = 2 ; Rtf itxt.txttyp = TxtTyp ; Note ligne pièce itxt.txttrait= 1 if rtfnom <> ' ' richo.name = rtfnom st = fopen (richo,'P') if st = 0 do init itxt.texte = $00 while freadst (richo,texte) = 0 if mid (texte,1000,1) <> $00 itxt.texte = texte else itxt.texte = mid (texte,1,length (texte)) & $00 endif hwrite (Gtfi,itxt) wend hclose (richo) endif endif endif ;Soit ne pas donner de MVTL, soit faire une boucle pour par exemple changer les délais MVTL = ' ' MVTL.CE1 = 'V' MVTL.GrRef = GrRef MVTL.RefQte = RefQte MVTL.DelDemDt = Ventilation.DelDemDt Convertir_RefQte_Qte(Ventilation.Qte, Ventilation.ref, Ventilation.sref1, Ventilation.sref2, Ventilation.refQte, MOUV.VenUn, ART.RefUn) MVTL.DelAccDt = Ventilation.DelAccDt MVTL.DelRepDt = Ventilation.DelRepDt MVTL.DelDt = Ventilation.DelDt HWrite(GTFI, MVTL)

Suppression de pièce (S)

Exemple Diva d’une ligne minimale de fichier GTFI pour une suppression

IPAR = ' ' IPAR.CE1 = 'I' IPAR.DOS = MZ.DOS IPAR.ETB = MZ.ETB IPAR.TRAIT = 'S' ;Suppression IPAR.TICOD = 'F' ;Fournisseur IPAR.PICOD = 2 ;2=cde IPAR.FullPiNo = PieceIntegration.FullPiNo HWrite(GTFI, IPAR)

 

Validation partielle de devis en commande (V)

Exemple Diva d’une ligne IPAR de fichier GTFI pour une validation partielle, puis plusieurs mouvements MOUV basés pour l’exemple sur : les chapitres et postes

OU la référence article ALB0001 de la pièce d’origine

IPAR = " " IPAR.Trait = "V" IPAR.Ce1 = "I" IPAR.Dos = ENTdv.Dos IPAR.Etb = ENTdv.Etb IPAR.TiCod = 'C' IPAR.PiCod = 1 IPAR.PiCodf = 2 IPAR.FullPino = ENTDv.FullPiNo Hwrite (GTFI, IPAR) ;Exemple partiel (non fonctionnel) de lecture des mouvements de la pièce origine do while ReaderNext_Mouvement(Rs_Mouvement, IdrMouv) = 0 ;condition exemple : les ref ALB0001 ou chapitre/postes if ( left(MOUV.REF) = 'ALB0001' or MOUV.CE2 in (2,3) ) MOUV = Rs_Mouvement.MOUV ;reprise du MOUV à valider MOUV.CdQte = MOUV.DvQte ;en commande on reprend la quantité en devis Hwrite (GTFI, MOUV) endif wend

Validation totale de commande en BL (T)

Exemple Diva d’une ligne IPAR de fichier GTFI pour une validation totale de commande en BL

Appel de l’intégrateur GTPP150

L'appel à partir d’un fichier GTFI se fait nécessairement en programmation Diva, depuis le module GTPM000.dhop

 

Le retour peut se traiter à plusieurs niveaux

  • Retour de la fonction “Tunnel_integration_piece” :

    • 0 : l’intégrateur a été appelé

    • <>0 : erreur d’appel de l’intégrateur (problème de contexte d’appel)

  • Retour, dans le cas d’une pièce unique à traiter, dans G3XZ

    • Appel à Pongreceive("G3XZ", G3XZ)

    • G3XZ.Pino = 0 indique une erreur de traitement

    • G3XZ.FullPino est garni avec le numéro de pièce en réussite

  • Retour dans tous les cas d’une chaîne HMP

    • Appel à Pongreceive("Resultat", ResultatHMP)

    • ResultatHMP donne des détails dans une succession de balises <PIECE>

      • <PIREF> : Référence de la pièce

      • <TICOD> : type de tiers

      • <PICOD> : type de pièce

      • <FULLPINO> : numéro complet (numérique + alpha)

      • <PINO> : numéro de pièce hors préfixe

      • <PREFPINO> : préfixe numéro de pièce

      • <ACTION> : rappel du IPAR.Trait demandé

      • <PARAM> : rappel du IPAR.PAram demandé

      • <STATUS> 0= rejet demande, 1=demande acceptée

  • Retour du fichier GTFIERR.dhfi

 

Exemple de traitement du retour

 

Structure d’un fichier GTFI

Le fichier GTFI est de type DHFI ('N' en longueur variable).
Il contient des enregistrements, qui doivent respecter l’ordre suivant. L’intégrateur traite chaque IPAR avec les enregistrement qui le suivent pour traiter pièce par pièce. Il termine la pièce au prochain IPAR ou en fin de demande.

Consultez la page dédiée pour plus d’informations sur le contenu de chaque enregistrement Contenu d'un fichier GTFI

Nom enregistrement

 

Détails

Nom enregistrement

 

Détails

IPAR

OBLIGATOIRE et au début.

Paramètre de l'intégration demandée, notamment l’action attendue

ENT

OBLIGATOIRE sauf pour Suppression

Suit IPAR

En-tête de pièce pour l’action demandée.

Un seul entête par IPAR

ITXT

Suit ENT

Texte en-tête, pied, ligne ou note

EEC

Suit ENT

Echéance multiple

EAD

Suit ENT

Adresses

ENTCPLEXT

Suit ENT

Complément externe d’entête pièce

MOUV

Suit ENT

Mouvement

MOUVTCLIRE

Suit MOUV, pour TICOD C uniquement

Remise client mouvement

MOUVTAX

Suit MOUV

Taxe complémentaire mouvement (ecotaxe)

MVTL

Suit MOUV

Ventilation