| # Installation d'un programme de comptabilité fiscale Pour installer un programme de comptabilité fiscale et créer un lien avec ERP LN, procédez comme suit : 1. Gestion et configuration du système UNIX 2. Installation du programme de comptabilité fiscale et création des bases de données associées 3. Réglage des profils des utilisateurs ERP LN 4. Préparation du répertoire temporaire 5. Personnalisation du makefile 6. Création du fichier exécutable 7. Configuration de la mémoire partagée de ERP LN Erreurs d'interface 1. Gestion et configuration du système UNIX Assurez-vous que le système hôte UNIX est équipé d'un compilateur C ANSI. L'interface du programme de comptabilité fiscale utilise les files d'attente des messages d'UNIX pour communiquer avec ERP LN. Le noyau UNIX doit être configuré pour fournir une file d'attente des messages suffisamment longue et un tampon assez grand pour la transmission des messages. Vous devez examiner et éventuellement modifier les paramètres du noyau dont la liste suit :
Paramètre | Description | Valeur recommandée :
MSGMAX | Taille maximum des messages | 2048 ou plus
MSGMNB | Nombre maximum d'octets dans les files d'attente des messages pour tout le système | Maximum système
MSGTQL | Nombre maximum de messages ouverts dans tout le système | Maximum système ou 2 * nombre d'utilisateurs ERP LN
MSGMNI | Nombre maximum de files d'attente des messages utilisables dans tout le système | Maximum système ou 5 * nombre d'utilisateurs ERP LN
Remarque Les noms des paramètres spécifiques peuvent être différents selon les systèmes UNIX. Si un paramètre de la liste suivante n'existe pas, recherchez le paramètre ayant la même fonction sur votre système UNIX. L'interface attribue et retire des files d'attente de messages à l'ouverture et à la fermeture de l'API. En cas de panne du système ERP LN, il est possible que les files d'attente des messages ne soient pas correctement lancées. Il est conseillé au gestionnaire du système UNIX de contrôler régulièrement les files d'attente définies dans l'environnement UNIX. Dans la majorité des systèmes UNIX, vous pouvez utiliser la commande ipcs pour afficher les files d'attente de messages actuellement attribuées. Remarque Il ne faut jamais supprimer les files d'attente de messages appartenant à l'utilisateur de base. En revanche, les files d'attente de messages des utilisateurs non actifs peuvent être libérées en exécutant la commande suivante (pour la majorité des systèmes UNIX) : ipcrm -q <numéro file d'attente des messages>. 2. Installation du programme de comptabilité fiscale et création des bases de données associées Pour plus de détails, reportez-vous à la documentation du programme de comptabilité fiscale. Vous trouverez certains détails ci-dessous. Taxware L'API relative au système fiscal de ERP LN nécessite l'installation et la configuration des produits Taxware suivants pendant l'installation de Taxware : Verazip, système de TVA sur les ventes et l'utilisation, système STEP. Vertex L'API relative au système fiscal de ERP LN nécessite l'installation de tout le système Vertex Quantum, y compris le codeur GEO et le système de TVA sur les ventes. 3. Réglage des profils des utilisateurs ERP LN Placez les variables de l'environnement du programme de comptabilité fiscale dans l'un des emplacements suivants : /etc/profil de chaque utilisateur ERP LN profil de chaque utilisateur ERP LN
Variables Taxware
Variable | Description | Requise/Facultative
--- | --- | ---
AVPIN | Définit le répertoire d'entrée des fichiers de TVA | Requise
AVPOUT | Définit le répertoire de sortie des fichiers de TVA | Requise
AVPAUDIT | Définit le répertoire des fichiers d'audit de la TVA | Requise
AVTEMP | Définit le répertoire à usage temporaire par le système fiscal | Requise
STEPIN | Définit le répertoire d'entrée des fichiers de données STEP | Requise
STEPOUT | Définit le répertoire de sortie des fichiers de données STEP | Requise
STEPAUDIT | Définit le répertoire des fichiers d'audit STEP | Requise
STEPTEMP | Définit le répertoire à usage temporaire par STEP | Requise
ZIPIN | Définit le répertoire d'entrée des fichiers de données Verazip | Requise
ZIPOUT | Définit le répertoire de sortie des fichiers de données Verazip | Requise
ZIPTEMP | Définit le répertoire à usage temporaire par Verazip | Requise
Variables Vertex Quantum
Variable | Description | Requise/Facultative
--- | --- | ---
VERTEXGEO | Définit le répertoire de la base de données des codes GEO | Requise
VERTEXRATE | Définit le répertoire de la base de données des taux | Requise
VERTEXREG | Définit le répertoire de la base de données des registres fiscaux | Requise
VERTEXTDM | Définit le répertoire de la base de données TDM | Facultative*
VERTEXPWD | Définit le répertoire de travail utilisé par le TDM | Facultative
VERTEXUSER | Définit les informations utilisateur si vous employez un système de gestion de base de données relationnelle | Facultative
VERTEXSERVER | Définit les informations de la base de données si vous utilisez un système de gestion de base de données relationnelle | Facultative
Remarque VERTEXTDM doit être défini lors de l'utilisation de TDM. 4. Préparation du répertoire temporaire Créez un répertoire temporaire. Copiez la bibliothèque appropriée depuis $BSE/api/lib vers le répertoire temporaire : libtavp.a si vous utilisez Taxware, libtvtx.a si vous utilisez Vertex, libtaxb.a si vous utilisez Taxware et Vertex sur le même système. Copiez le makefile approprié depuis $BSE/api/lib vers le répertoire temporaire : makefile.avp si vous utilisez Taxware, makefile.vertex si vous utilisez Vertex, makefile.both si vous utilisez Taxware et Vertex sur le même système. 5. Personnalisation du makefile Copiez le makefile approprié (makefile.vertex, makefile.avp ou makefile.both) depuis le répertoire temporaire vers le makefile. Si vous utilisez Taxware, éditez le makefile et apportez les modifications suivantes : CC revient à faire appel à l'exécutable du compilateur C ANSI, CCOPTIONS revient à faire appel à toutes les options nécessaires à une compilation ANSI, AVPDIR revient à faire appel au répertoire père de la bibliothèque Btree, AVPTAXDIR revient à faire appel au répertoire où se trouvent les objets de TVA et les en-têtes, AVPZIPDIR revient à faire appel au répertoire où se trouvent les objets ZIP et les en-têtes, AVPSTEPDIR revient à faire appel au répertoire où se trouvent les objets STEP et les en-têtes. Si vous utilisez Vertex, éditez le makefile et apportez les modifications suivantes : CC revient à faire appel à l'exécutable du compilateur C ANSI, CCOPTIONS revient à faire appel à toutes les options nécessaires à une compilation ANSI, VERTEXDIR revient à faire appel au répertoire père des répertoires du produit Vertex. Si vous utilisez Taxware et Vertex ensemble : Effectuez les modifications décrites auparavant. 6. Création du fichier exécutable Placez-vous sur le répertoire temporaire. Entrez la commande `make`. Copiez api6.1 du répertoire temporaire vers $BSE/bin. Changez le groupe de $BSE/bin/api6.1 en groupe bsp. Changez le propriétaire de $BSE/bin/api6.1 en utilisateur bsp. Changez les autorisations en 550 pour $BSE/bin/api6.1. 7. Configuration de la mémoire partagée de ERP LN L'interface du programme de comptabilité fiscale utilise généralement trois utilitaires pour extraire les taux de TVA et les codes GEO du programme. En plaçant ces objets de programme dans la mémoire partagée, vous augmentez la rapidité de l'API du programme de comptabilité fiscale. Pour placer ces objets de programme dans la mémoire partagée : Connectez-vous à ERP LN en tant qu'utilisateur bsp. Démarrez la session Shared Memory Data (deprecated) (ttaad4150m000). Dans l'application tc, insérez les enregistrements pour les objets de programme suivants : tcapil000m000 tcapidlll001 tcapidlll002 tccomdll0020 Convertissez en dictionnaire de données runtime. Erreurs d'interface Des problèmes avec le logiciel tiers ou des données incorrectes dans l'interface peuvent provoquer plusieurs types d'erreurs. Il est cependant très rare que ces erreurs surviennent.
Plage d'erreurs | Informations sur les erreurs | Description
0-99 | Erreurs de communication | Echec de communication
1100-1199 | Erreur de produit Taxware Verazip | Problème de produit ou de données Taxware
1200-1299 | Problème lié à l'application Taxware Sales and Use Tax ou erreur de calcul de la TVA | Problème de données produit Taxware
1300-1399 | Problème lié à l'application Taxware Sales and Use Tax ou erreur de juridiction | Problème de données produit Taxware
1400-1499 | Problème de données ou erreur de produit du géocodeur Vertex | Problème de produit Vertex
1500-1599 | Erreur de calcul de la TVA du système Vertex Quantum | Erreur de calcul ou problème de produit Vertex
1600-1699 | Erreur de détermination de juridiction du système Vertex Quantum | Erreur de données ou problème de produit Vertex
Paramètres du temps d'attente de l'API Vous pouvez accroître le temps d'attente des demandes d'informations de l'API en augmentant la valeur des paramètres d'attente de l'API suivants : APIWAIT APISTART La valeur par défaut de ces paramètres est de 20, ce qui est relativement élevé. Vous n'avez généralement pas à modifier ces paramètres. Vous devez les définir uniquement dans les cas suivants : le système est extrêmement chargé, une protection supplémentaire est nécessaire contre les pointes de charge. APIWAIT Nombre maximum de secondes pendant lesquelles ERP LN attend une réponse de l'API. L'API répond normalement à la session de ERP LN en moins d'une seconde. En cas d'erreur n°11, attribuez à APIWAIT une valeur supérieure à 20 dans l'environnement UNIX pour chaque utilisateur. APISTART Nombre maximum de secondes pendant lesquelles la session ERP LN attend le démarrage du processus de l'API. Cela prend généralement moins d'une seconde. En cas d'erreur n°12, attribuez à APISTART une valeur supérieure à 20 dans l'environnement UNIX pour chaque utilisateur. Rubriques liées Utilisation d'un programme de comptabilité fiscale Configuration de l'interface du programme de comptabilité fiscale |