Exportation de données de factures d’immobilisation vers un logiciel externe

Généralités

Introduction

Ce dossier présente le mode d’implémentation et d’utilisation de la fonctionnalité d’exportation de données issues de factures d’immobilisation d’ACE FINANCE vers un logiciel externe via une interface au format particulier.

Attention dans le cadre de l’utilisation du logiciel TOSCANE immo

On utilise l’option « Exporter Factures » de la fonction P_IGES pour l’exportation des factures d’immobilisation.

Pour l’importation des dotations aux amortissements, on utilise l’option « Transformer » de la fonction P_2INT.

Pour en savoir plus sur l’importation des dotations aux amortissements dans le cadre de l’utilisation de TOSCANE Immobilisations, consultez la documentation de référence « Intégration des dotations aux amortissements ».

Principes de l’interface ACE / Logiciel externe

Cette fonctionnalité permet d'exporter une sélection d’informations issues de factures d’immobilisations vers un logiciel externe de manière automatique par un traitement différé. Ce traitement génère un fichier nommé FACTURE.CRG (ou un autre nom de fichier défini par le paramètre P_IGES).

En cas d'erreur,ce fichier sera renommé sous le nom de <nom d’origine du fichier>_ERREUR.CRG. Il sera possible de relancer le traitement différé autant de fois jusqu'à ce que l'exportation soit correcte.

Paramétrage

Il est nécessaire de paramétrer les différentes fonctions pour lancer le traitement de constitution du fichier.

Création d’un code édition

Dans UPLED, il faut créer le code édition EXPIMM de la fonction P_IGESE1: (via l’option « Créer ») ou s'il existe, le modifier, notamment au niveau de la vue utilisée (Clause Where).

Dans la clause Where : Mettre <p_mvcvalcp='I' and (p_mvcetia='i' or p_mvcetia='I') and p_mvcnumin=' ' >

Trucs et astuces

Ces critères permettent d'aller chercher des enregistrements qui sont validés (p_mvcvalcp) et qui possèdent l'état "i" ou "I"(saisie immobilisation : p_mvcetia). Le champ p_mvcnumin (numéro de la fiche inventaire) doit être à blanc. Ce champ est renseigné une fois l’exportation effectuée (contenu : « EXPORTE »). Ainsi, le traitement d’exportation est effectué une seule fois pour chaque facture d’immobilisation.

Configurateur fonctionnel

Dans GPEV, il faut d’abord créer la fonction P_IGESE1) (Fonction ® Créer).

Après avoir créé cette fiche, positionnez le paramètre P_IGES sur cette fonction.

Renseignez les champs numériques en respectant les consignes présentées ci-dessous.

Détail du paramètre : voir documentation P_IGES :

Paramétrage du code édition EXPIMM

Utilisez l’agent EXPLOI pour paramétrer ce code édition associée à la fonction P_IGESE1.

Pour en savoir plus, consultez la documentation de référence « Paramétrage des écrans lanceurs ».

Remarque importante : pour la nature standard, renseignez les deux valeurs autorisées "FAF et AVF". (table TP_NST).

Paramétrage des comptes comptables

Les comptes d'immobilisations doivent avoir la valeur 'I' dans le champ « Immo / Abonnt. » et le type de ces comptes doit porter la valeur ‘7’ (écran P_1ENV_13).

Personnalisation des modes de règlement (table GTMRG)

La fonction GTMRG permet de mettre à jour les modes de règlements.

Il suffit de renseigner les valeurs souhaitées dans la colonne "GECO" sur deux caractères.

Le traitement préfixe par « 2 » ces valeurs pour renseigner le champ souhaité par le logiciel externe.

Exemple : si le mode de règlement BO a le code 11, la valeur récupérée dans le champ mode de règlement du fichier est « 211 ».

Personnalistation du message d'erreur

Par la fonction « UMES », créez le message d'erreur « P_CPTIMMO » (le compte n'est pas de type immobilisations).

Ce message est systématiquement affiché en cas de mauvaise saisie du champ « compte » dans l’écran lanceur.

Gestion des d'erreur lors du traitement d'exportation

En cas d'échec du traitement d'exportation de factures vers le logiciel externe, les messages d'erreur sont visualisés dans le fichier « log » de l'édition :

  • « Le type de règlement n'est pas attribué. » : Pas de présence du type de règlement dans la table GTMRG.

Et les autres messages d'erreurs sont issus des données des factures.

Fonctionnalités

Lancement du traitement

Ce traitement différé est lancé à partir d’une option de la fonction P_IGES (écran P_IGES_ED1)

Les critères standards

Ces critères standards permettent de sélectionner :

  • le numéro de l’écriture (p_ecrnum),
  • la nature Standard (p_mvcnscod),
  • la couche (p_ecrtjl),
  • la date Comptable (p_ecrdat),
  • le numéro de compte (p_1ppcpt).

Note : Pour le numéro du compte, on traite les comptes d'immobilisations uniquement.

Enregistrements générés

Les enregistrements générés (dans le fichier "FACTURE.CRG" ou dans le fichier dont le nom est défini par le paramètre P_IGES) regroupent tous les mouvements comptables par numéro d’écriture, numéro de mouvement HT et / ou mouvement analytique (s’il existe), trié par compte.

Un numéro de ligne–facture est unique par facture (éclatement d’une facture sur autant d'enregistrements qu'il y a de mouvements analytiques pour cette facture).

Les différentes données d’un même enregistrement sont séparées par un point virgule (;).

Le traitement crée un fichier "FACTURE.CRG" (ou le fichier dont le nom est défini par le paramètre P_IGES). C’est ce fichier (et non le fichier d’extension « .SPL ») qui pourra être visualisé par Excel et qui sera interprété par le logiciel externe.

Le nom du fichier peut être personnalisé grâce à la zone L1 du paramètre P_IGES.

Si cette zone n’est pas renseignée, le fichier exporté porte le nom « FACTURE.CRG ». Dans le cas contraire, le nom du fichier de sortie sera celui défini dans la zone L1 (répertoire, nom, extension).

En cas d'erreur de traitement (exemple : absence du mode de règlement) , ce fichier sera renommé <nom d’origine du fichier>_ERREUR.CRG. On peut visualiser dans le « log » le problème en cas d'échec du traitement.

Si les enregistrements sont bien générés, le champ <p_mvcnumin> seront mis à jour sous le nom "EXPORTE" ce qui nous permet de ne pas re-générer deux fois le ou les mêmes enregistrements.

Note : Si le code société destination n'est pas retrouvé dans le paramétrage de l’option «Transfert/Gérer » de la fonction P_IENV, on reprend le code société courant pour le traitement d’exportation.

Aspects techniques

Fonction Entités mises à jour
P_IGES -
P_IGESE1 VB1_ECR_MVC