Guide d’utilisation des interfaces SAP

1 Mode d’emploi

Le programme kcusap.exe fournit des fonctionnalités qui permettent de lire des données à partir d'un système SAP-R/3 à partir des modules FI, CO et FI-AA (AM}. Ces données sont les suivantes :

• Groupe de comptes (Modul FI)
• Racine des postes (Modul FI)
• Mise en correspondance des postes et des comptes (Modul FI)
• Soldes de compte (Modul FI)
• SOLDES DE COMPTE IC (Modul FI)
• Valeurs de solde du registre du TCNA (Modul FI)
• Racine du centre de coûts (Modul CO)
• Soldes centre de coûts (Modul CO)
• Variations de l'actif immobilisé (Modul FI-AA (AM))

En principe, le processus de lecture se déroule de telle sorte que les données sont obtenues soit par connexion au système distant, soit à partir d'un fichier généré par le système distant. Répertoire Le résultat est toujours un fichier texte correspondant dans le chemin d'accès IDL du lot ✓ du client. Par défaut, la connexion au système distant se fait à l'aide de l'entrée spécifiée dans le fichier kcusap.ini sous Client. Vous pouvez sélectionner un autre client en saisissant un autre client dans la cellule « Client SAP » de l'application IMPORT dans IDL Konsis.

1.1 Fonction Lire Compte

Pour extraire le plan de comptes du système SAP, l'application IMPORT doit spécifier les paramètres suivants :

• Plan comptable
• Langue

Si la désignation du plan de comptes plan comptable dans IDL Konsis et SAP est différente, il est nécessaire de définir un groupe d'implémentation qui veille à ce qu'IDL Konsis associe la désignation IDL Konsis du plan de comptes à la désignation SAP du plan de comptes, qui est ensuite utilisée par l'interface de lecture.

La langue doit être l'une des abréviations ECRIT, CZE, DEU, ENG, FLA, FRA, HOL, HUN, ITA, POL, SLO, RAPPCOL, SWE ou USA. Si un autre abréviation est spécifiée, le plan comptable allemand est lu.

Les paramètres facultatifs suivants peuvent être définis dans le fichier kcusap.ini de la plage

[Settings]

sont définies :

LoeschKnzKto=yes

Si cet indicateur est défini, les comptes marqués comme devant être effacés dans SAP-R/3 ne sont pas écrits dans le fichier KPKONTEN.TXT.

Vous pouvez également utiliser ce paramètre comme paramètre supplémentaire /D dans l'entrée d'appel externe pour UNLKTO de l'application KON/MEN. Cette entrée a priorité sur l'entrée dans le fichier kcusap.ini.

1.2 Fonction de lecture des agrégations

Pour extraire les agrégations du système SAP, spécifiez les paramètres suivants :

• Plan d'agrégations
• Plan comptable
• Langue

La spécification du plan de ligne correspond à la structure bilan/résultat dans le système SAP

Si la désignation du plan de comptes plan comptable dans IDL Konsis et SAP est différente, il est nécessaire de définir un groupe d'implémentation qui veille à ce qu'IDL Konsis associe la désignation IDL Konsis du plan de comptes à la désignation SAP du plan de comptes, qui est ensuite utilisée par l'interface de lecture.

La langue doit être l'une des abréviations FRA, HOL, ITA ou RAPPCOL. Si un autre abréviation est spécifiée, le plan d'agrégations allemand est lu.

1.3 Fonction Lecture Mappage des comptes de position

Pour extraire le mappage agrégation-compte du système SAP, vous devez spécifier les paramètres suivants :

• Plan d'agrégations
• Plan comptable
• Langue

Le plan de ligne est le numéro de version. (structure bilan/GuV) dans SAP

Si la désignation du plan de comptes plan comptable dans IDL Konsis et SAP est différente, il est nécessaire de définir un groupe d'implémentation qui veille à ce qu'IDL Konsis associe la désignation IDL Konsis du plan de comptes à la désignation SAP du plan de comptes, qui est ensuite utilisée par l'interface de lecture.

La langue doit être l'une des abréviations FRA, HOL, ITA ou RAPPCOL. Si un autre abréviation est spécifiée, le plan d'agrégations allemand est lu.

1.4 Fonction Lire les soldes de compte

Pour extraire les soldes de compte du système SAP, spécifiez les paramètres suivants :

• Période
• Type de données

La période indique la date à laquelle les soldes cumulés doivent être extraits.

La version type de données est requise par l'application par lot d'IDL Konsis et doit donc être écrite dans le fichier .TXT généré.

D'autres paramètres peuvent être spécifiés :

• Société
• Variante d'exercice
• Mois > 12
• Secteur d'activités

Société La quantité de la clé correspond au code d'entreprise dans le système SAP

Cette indication permet d'indiquer les valeurs pour toutes les sociétés, respectivement. de lire les segments d'équilibrage qui ont la même variante d'exercice,

Dans le système SAP, si le nombre de périodes comptables est supérieur à douze. M.a.W. : Extrait avec périodes de réservation spéciales (13, 14, 15 ou 16).

Un * dans cette cellule contrôle que les soldes ne sont pas identifiés en détail au niveau de la division, mais agrégés par compte.

Pour l'extraction, trois cas peuvent se produire en combinaison :

1. Société Si une seule entité comptable est spécifiée et que la variante d'exercice comptable est vide, seuls les soldes du segment d'équilibrage associé sont extraits.
2. Société Si une variante d'exercice est indiquée mais pas de ⌧, les soldes sont extraits pour tous les segments d'équilibrage qui ont la variante d'exercice indiquée.
3. Société Si aucune information n'est fournie, une tentative de lecture des soldes de toutes les sources d'information est effectuée. Cela n'est toutefois possible que si les cercles comptables n'ont pas de variantes d'exercice différentes.

Les paramètres facultatifs suivants peuvent être définis pour UNLSALD dans la cellule {appel externe} de l'application KON/MEN/ :

• /V=xxx

où xxx représente l'identification à trois chiffres de la version General Ledger

La commande de la lecture relative à. Par exemple, IFRS/Local GAAP est défini dans la section Settings du fichier kcusap.ini comme suit :

IFRSFact=C1
LocalGAAPFact=L1
IFRSPrefix=1
LocalGAAPPrefix=9
PrefixPos=2

• L'IFRSFact définit la norme type de données pour les IFRS.
• LocalGAAPFact définit la valeur type de données pour Local GAAP.
• IFRSPrefix indique la caractéristique de différenciation dans le numéro de compte des comptes GAAP communs/locaux
• LocalGAAPPrefix indique la caractéristique de différenciation dans le numéro de compte des comptes common/IFRS
• PrefixPos indique l’endroit du numéro de compte où le signe distinctif doit être trouvé.

1.5 Fonction Lire soldes de compte IC

Pour extraire les soldes de compte IC du système SAP, spécifiez les paramètres suivants :

• Période
• Type de données

La période indique la date à laquelle les soldes cumulés doivent être extraits. Dans le système SAP, les paramètres requis dans les tables SAP correspondantes (par exemple, GLT3 ou l'affilié), le composant fonctionnel ne peut pas accéder aux valeurs antérieures à cette date et il faudrait se contenter d'un remède manuel pour ces périodes.

La version type de données est requise par l'application par lot d'IDL Konsis et doit donc être écrite dans le fichier .TXT généré.

D'autres paramètres peuvent être spécifiés :

• Société
• Variante d'exercice
• Mois supérieur à douze (> 12)

Pour l'extraction, trois cas peuvent se produire en combinaison :

1. Société Si une seule entité comptable est spécifiée et que la variante d'exercice comptable est vide, seuls les soldes du segment d'équilibrage associé sont extraits.
2. Société Si une variante d'exercice est indiquée mais pas de ⌧, les soldes sont extraits pour tous les segments d'équilibrage qui ont la variante d'exercice indiquée.
3. Société Si aucune information n'est fournie, une tentative de lecture des soldes de toutes les sources d'information est effectuée. Cela n'est toutefois possible que si les cercles comptables n'ont pas de variantes d'exercice différentes.

Si vous travaillez avec des secteurs d'activités de manière cohérente, c'est-à-dire si aucun astérisque (*) n'est spécifié dans la cellule répertoire « plage G », seul un fichier KPICKONV.TXT est créé dans le chemin d'accès IDL du BATCH-₆.

Si vous travaillez sans secteurs d'activités, un fichier KPICSALD.TXT est également créé. Dans le fichier KPICSALD.TXT, les soldes IC représentent les comptes de bilan, et dans le fichier KPICKONV.TXT, les soldes IC représentent les comptes de compte de résultat.

Les paramètres facultatifs suivants peuvent être définis pour UNLICSAL dans la cellule Appel externe de l'application KON/MEN :

• Le paramètre /Z crée un seul fichier KPICSALD.TXT à la fois, y compris les soldes IC (GuV).
• Le paramètre /T permet également de lire les soldes en monnaie de transaction avec. Un seul fichier KPICSALD.TXT est créé à la fois.
• Le paramètre /A garantit que les soldes IC sont accompagnés de diverses informations justificatives (numéro, date, numéro de référence et type) en plus de la monnaie de transaction. Un seul fichier KPICSALD.TXT est créé à la fois.

Les opérations de comptabilité spéciale, qui sont des soldes IC des tables KNC3 et LFC3 de SAP, peuvent être exécutées par l'entrée

[Settings]

SonderHBV=yes

sont activés. Il est important de noter que les valeurs des deux tables SAP ne sont pas stockées pendant l'année, mais toujours cumulées pour l'exercice.

1.6 Fonction de lecture du registre UKV

Pour extraire des soldes du registre UKV du système SAP, les paramètres suivants doivent être spécifiés :

• Période
• Type de données

D'autres paramètres peuvent être spécifiés :

• Société
• Variante d'exercice
• Mois supérieur à 12
• Secteur d'activités

Pour l'extraction, trois cas peuvent se produire en combinaison :

1. Société Si une seule entité comptable est spécifiée et que la variante d'exercice comptable est vide, seuls les soldes du segment d'équilibrage associé sont extraits.
2. Société Si une variante d'exercice est indiquée mais pas de ⌧, les soldes sont extraits pour tous les segments d'équilibrage qui ont la variante d'exercice indiquée.
3. Société Si aucune information n'est fournie, une tentative de lecture des soldes de toutes les sources d'information est effectuée. Cela n'est toutefois possible que si les cercles comptables n'ont pas de variantes d'exercice différentes.

Les paramètres facultatifs suivants peuvent être définis pour UNLICKONV dans la cellule Appel externe de l'application KON/MEN :

• • Le paramètre /T permet de lire les soldes en monnaie de transaction avec les soldes de compte IC liés au centre de coûts.

Pour le contrôle de chaque fonction, le paramètre UkvMitIC dans le fichier kcusap.ini} est dans la plage

[Settings]

UkvMitIC=x

Ajuster comme suit :

Pour x=0 :

Lire tous les soldes sans société partenaire et créer un fichier KPKSTSAL.TXT

Pour x=1 :

Lecture de tous les soldes associés et création d'un fichier KPICSALD.TXT

Pour x=2 :

Lire tous les soldes et créer les deux fichiers KPKSTSAL.TXT et KPICSALD.TXT

1.7 Fonction Lire Racine des centres de coûts

Pour extraire la racine du centre des comptes du système SAP, l'application IMPORT doit spécifier les paramètres suivants :

• Secteur d'activités
• Plan de centre de coûts
• Langue

Le paramètre secteur d'activités détermine si le secteur d'activités défini dans SAP est appliqué ou non lors de l'extraction du fichier racine du centre de coûts. Aucune valeur n'est appliquée si le paramètre secteur d'activités contient un astérisque (*).

Si la désignation du plan de centre de coûts dans IDL Konsis et dans SAP est différente, il convient de définir un groupe de mise en œuvre pour qu'IDL Konsis associe la désignation IDL Konsis du plan de centre de coûts à la désignation SAP du plan de centre de coûts, qui est ensuite utilisée par l'interface de lecture.

La langue doit être l'un des sigles suivants : FRA, FRA, HOL, ITA, RAPPCOL, USA, HUN, ECRIT, CZE, FLA, POL, SLO ou SWE. Si un autre abréviation est spécifiée, le plan des centres de coûts en allemand est lu.

1.8 Fonction lecture Soldes centre de coûts

Pour extraire les soldes de centre de coûts du système SAP, les paramètres suivants doivent être spécifiés :

• Période
• Type de données

La période indique la date à laquelle les soldes cumulés doivent être extraits.

Le type de données est requis par l'application par lot et doit donc être écrit dans le fichier .TXT généré.

D'autres paramètres peuvent être spécifiés :

• Société
• Variante d'exercice
• Mois > 12
• Secteur d'activités

Société La taille de la clé correspond au code d'entreprise dans le système SAP.

Cette indication permet d'indiquer les valeurs pour toutes les sociétés, respectivement. Lire les segments d'équilibrage qui ont la même variante d'exercice.

Dans Mois > 12, les valeurs 13, 14, 15 ou 16 peuvent être spécifiées en fonction de la période de réservation spéciale jusqu'à laquelle les soldes doivent être extraits.

Un * dans la cellule « Zone Gs » contrôle que les soldes ne sont pas identifiés en détail au niveau de la zone métier, mais qu'ils sont agrégés par compte.

Pour l'extraction, trois cas peuvent se produire en combinaison :

1. Société Si une seule entité comptable est spécifiée et que la variante d'exercice comptable est vide, seuls les soldes du segment d'équilibrage associé sont extraits.
2. Société Si une variante d'exercice est indiquée mais pas de ⌧, les soldes sont extraits pour tous les segments d'équilibrage qui ont la variante d'exercice indiquée.
3. Société Si aucune information n'est fournie, une tentative de lecture des soldes de toutes les sources d'information est effectuée. Cela n'est toutefois possible que si les cercles comptables n'ont pas de variantes d'exercice différentes.

Particularité

Pour un segment d'équilibrage spécifié, le segment de coût associé est déterminé à partir de la table SAP CSKS. Ce segment de coût est associé à un plan comptable dans la table SAP TKA01.

1.9 Fonction Lire variations de l'actif immobilisé

Pour extraire les variations de l'actif immobilisé du système SAP, spécifiez les paramètres suivants :

• Période
• Type de données

La période indique la date à laquelle les variations de l'actif immobilisé cumulées doivent être lues.

Le type de données est requis par l'application par lot et doit donc être écrit dans le fichier .TXT généré.

D'autres paramètres peuvent être spécifiés :

• Société
• Variante d'exercice
• Mois supérieur à 12
• Secteur d'activités

Société La taille de la clé correspond au code d'entreprise dans le système SAP.

Cette indication permet d'indiquer les valeurs pour toutes les sociétés, respectivement. Lire les segments d'équilibrage qui ont la même variante d'exercice.

La cellule Mois supérieur à 12 peut spécifier les valeurs 13, 14, 15 ou 16 pour inclure les périodes de réservation spéciales.

Pour l'extraction, trois cas peuvent se produire en combinaison :

1. Société Si une seule entité comptable est spécifiée et que la variante d'exercice comptable est vide, seuls les soldes du segment d'équilibrage associé sont extraits.
2. Société Si une variante d'exercice est indiquée mais pas de ⌧, les soldes sont extraits pour tous les segments d'équilibrage qui ont la variante d'exercice indiquée.
3. Société Si aucune information n'est fournie, une tentative de lecture des soldes de toutes les sources d'information est effectuée. Cela n'est toutefois possible que si les cercles comptables n'ont pas de variantes d'exercice différentes.

Si les comptes de correction de valeur sont gérés séparément dans SAP (T095B), l'appel externe dans le jeu MEN pour UNLANLBEW doit être complété par le paramètre /W.

Vous pouvez également utiliser les paramètres de la section Settings du fichier kcusap.ini côté client

UseT095B=yes

complété.

Pour extraire des valeurs pour différentes plages d'évaluation, l'appel externe peut spécifier la plage d'évaluation (à deux chiffres) dans le jeu MEN pour UNLANLBEW avec le premier paramètre /K. Si le paramètre est laissé vide, la valeur par défaut est HGB (= 01 comme AFABE).

Vous pouvez également utiliser les paramètres de la section Settings du fichier kcusap.ini côté client

Bewertungsbereich=nn

où nn est un espace réservé pour la zone d'évaluation réelle.

La liasse fournie dans le système SAP peut être utile pour analyser les écarts éventuels :

Appel via SA38

Le programme kcusap.exe mappe les groupes de types de mouvement (SAP R/3) aux clés de saisie de la manière suivante :

Le programme kcusap.exe met en correspondance les valeurs reportées (SAP R/3) avec les clés de saisie de la manière suivante :

Le programme kcusap.exe met en correspondance les champs de valeur d'immobilisation et les valeurs proportionnelles (SAP R/3) avec les clés de saisie de la manière suivante :

Les indicateurs de valeurs SAP R/3 suivants ne sont volontairement pas appliqués :

1.10 Opérations courantes

Afin d'éviter que les fondeurs n'interfèrent avec les temps de réponse du système en mode interactif, l'exécution de la liasse et des éléments fonctionnels est soumise à une durée maximale déterminée. Si une seule liasse ou un seul bloc fonctionnel dépasse le délai d'exécution maximum autorisé pour un processus de dialogue, le système SAP arrête automatiquement son exécution. La valeur maximale du runtime est définie dans le paramètre de profil rdisp/max_wprun_time.

Si un délai d'expiration (Time-Out) se produit lors de la lecture des soldes de compte IC côté SAP, les étapes suivantes doivent être exécutées côté SAP.

• Connectez-vous au système SAP via SAPGUI
• Merci d'appeler la transaction SA38
• Sélectionnez et exécutez la liasse YFB_ACCOUNTS
• Veuillez fournir les paramètres requis
• Sélectionnez la fonction souhaitée via Radio Button
• Enfin, exécutez la liasse en arrière-plan

Liasse YFB_ACCOUNTS:

En conséquence, la liasse crée un fichier associé au fichier portant le nom logique Z_KONSIS_TEMP_STAMM_FILE.

Répertoire Ce fichier doit ensuite être copié sur un lecteur accessible à partir du client IDL Konsis (par exemple, le fichier WORK-₆ dans le chemin IDL).

Les améliorations suivantes sont également apportées au fichier KCUSAP.INI côté client :

[FileLocation]

FileIcktosal=Chemin et nom de fichier du fichier Z_KONSIS_TEMP_STAMM_DATEI

FileIckonv=chemin d'accès et nom du fichier Z_KONSIS_TEMP_STAMM_DATEI

Par exemple, si K est le lecteur du serveur de programmes :

[FileLocation]

FileIcktosal=K:\IDL\WORK\ICSALD.txt

FileIckonv=K:\IDL\WORK\ICKONV.txt

Il est à noter que les clés spécifiées pour l'extraction dans le système SAP (code d'entreprise, année, etc.) correspondent également aux clés spécifiées dans IDL Konsis pour l'extraction via fichier.

2 Messages d'erreur

2.1 Fonction Lire plan comptable

2.2 Fonction Lire plan d'agrégations

2.3 Fonction de lecture Mappage de comptes de position

2.4 Fonctions Lire (IC—) soldes de compte

2.5 Messages supplémentaires Lire les soldes de compte IC

2.6 Messages supplémentaires de lecture du registre du TCNA

2.7 Fonction Lire Racine des centres de coûts

2.8 Fonction lecture Soldes centre de coûts

Les exceptions lancées par le bloc fonctionnel ici sont désagréables, car NO_RECORD_T001 est utilisé pour quatre situations différentes :

1. La combinaison de la variante d'exercice et du segment d'équilibrage n'existe pas.
2. Société Il n'y a pas d'association entre le segment d'équilibrage et le groupe d'équilibrage si ni la variante d'exercice ni le segment d'équilibrage n'ont été spécifiés.
3. Société Aucun code d'entreprise n'a été affecté au code d'entreprise ou le code d'entreprise n'existe pas.
4. Société Si la variante d'exercice est prédéfinie, le segment d'équilibrage associé n'a pas été affecté ou le segment d'équilibrage n'existe pas.

Cette différenciation est mieux résolue dans le prologue aux soldes fonctionnels du module FI.

L'exception NO_RECORD_CSKS est actuellement utilisée dans deux situations d'erreur différentes :

1. Le code entreprise spécifié est introuvable dans la table CSKS (table des enregistrements racines de centre de coûts).
2. Le contrôle d'admissibilité a déterminé que l'utilisateur connecté n'est pas autorisé à afficher les valeurs du groupe de coûts spécifié.

2.9 Fonction Lire variations de l'actif immobilisé