Vous êtes sur la page 1sur 10

TABLE DES MATIERES

PRÉFACE............................................................................................................................................. 3
1 OBJET............................................................................................................................................. 3
2 DESCRIPTION GÉNÉRALE............................................................................................................ 3
2.1 Généralités........................................................................................................................... 3
2.2 Algorithme général.............................................................................................................. 3
2.3 Externalisation des paramètres......................................................................................... 3
3 PARAMÈTRAGE ALE..................................................................................................................... 4
4 ETAT................................................................................................................................................ 4
5 CONVERSION DE DONNÉES ET INTERFACES...........................................................................4
5.1 Structure du fichier en entrée............................................................................................ 4
5.1.1Enregistrement de contrôle : structure EDI_DC....................................................................4
5.1.2Enregistrement de données : structure EDI_DD...................................................................5
5.1.2.1 Segment E1KNA1M...................................................................................................... 5
5.1.2.2 Segment E1KNVVM...................................................................................................... 6
5.1.2.3 Segment E1KNVIM....................................................................................................... 6
5.1.2.4 Segment E1KNB1M...................................................................................................... 6
5.1.2.5 Segment E1KNB5M...................................................................................................... 7
5.2 Règles de gestion................................................................................................................ 7
5.2.1Règles de gestion pour les données entrantes.....................................................................7
5.2.2Règles de gestion pour les données transférées au Call Transaction...................................7
6 TRANSACTION............................................................................................................................... 8
7 ALGORITHME DETAILLE............................................................................................................... 8
7.1 Programme principal.......................................................................................................... 9
7.1.1Fonction z_idoc_input_zcl03s............................................................................................... 9
7.1.2Sous-programme fill_appl_structures....................................................................................9
7.1.3Sous-programme d’alimentation de structure, FILL_BDCDATA................................................9
7.1.4Sous-programmes d’alimentation de structure, CALL_TRANSACTION....................................10
7.1.5Sous-programme check_data............................................................................................. 10
7.1.6REMARQUE....................................................................................................................... 10
7.2 Ecrans impactés par BDCDATA.......................................................................................10
8 TABLES......................................................................................................................................... 13
9 QUESTIONS / REMARQUES....................................................................................................... 13
PRÉFACE
Programme : Z_IDOC_INPUT_Z****S
Type : Interface entrante
Classe de développement Z**1
Type d'IDOC: DEBMAS02
Type de message Z****S
Nom de l'IDOC: Code opération : ZC01

Spécification fonctionnelle :

1 OBJET

Le but de cette interface est de reporter dans AAAA les créations / modifications de client effectuées
dans BBBB

2 DESCRIPTION GÉNÉRALE

2.1 Généralités
Cette interface permet de créer, modifier et supprimer des clients dans quelque soit le
type de traitement demandé, l'intégration dans est quasiment identique. Pour les
créations de clients on utilise la transaction XD01 et pour les modifications /
suppressions la transaction XD02. Pour transférer les données de vers on utilise l'Idoc
standard DEBMAS02 et le module fonction spécifique Z_IDOC_INPUT_ZCL03S. Aucune
méthode particulière n'est mise en place pour le traitement des Idocs en erreur,
l'utilisateur devra donc lui même vérifier le statut des Idocs après le traitement et
relancer celui-ci si nécessaire.

2.2 Algorithme général


Le traitement est effectué par le module fonction Z_IDOC_INPUT_ZCL03S, lui même lié au
code opération ZC03
 Réception de l'Idoc en provenance du système externe par l'intermédiaire des
tables en paramètre.
 Boucle sur la table des données, pour charger les différentes table interne.
 Vérification des données
 Détermination du type de traitement ( création / modification)
 Création du dossier BDCDATA
 Exécution du call transaction

2.3 Externalisation des paramètres

Sans objet

3 PARAMÈTRAGE ALE

Utilisation d’un message logique : ( ne pas utiliser le message standard car on lance
une fonction qui n’est standard) ZCL03S
Liaison de celui ci avec l’Idoc DEBMAS02
Liaison du message logique avec le module fonction Z_IDOC_INPUT_Z****S.
Déclaration du code opération ZC03 Lié avec la fonction Z_IDOC_INPUT_Z****S.
Gestion des accords d'inter change: Liaison du message Z****S et du partenaire FR****L

4 ETAT

5 CONVERSION DE DONNÉES ET INTERFACES


5.1 Structure du fichier en entrée

Il faut que ce fichier ait une structure identique à celle que pourrait avoir l’IDOC ou, soit
un IDOC :
 Un premier enregistrement de base pour dialoguer avec le connecteur,
 Un enregistrement de contrôle de structure EDI_DC
 Un enregistrements de données de structure EDI_DD

Attention, pas de retour chariot du début à la fin !

5.1.1 Enregistrement de contrôle : structure EDI_DC

La structure EDI_DC est relativement complexe et contient des informations qui ne sont
pas toutes essentielles. Nous n’allons donc retenir pour l’interface que les informations
indispensables, en laissant les autres à blanc.

Zone du Nom de zone Positio Forma Valeur et/ou règle de


fichier n t traitement

TABNAM Nom de la structure de table 1 C(10) Constante ‘EDI_DC’


FILLER FILLER 11 C(33) A blanc
DIRECT Sens 44 C(1) Constante ‘2’ (pour Entrante)
RCVPOR Port destinataire 45 C(10) Déterminé par le système
RCVPRT Type de partenaire 55 C(2) Constante ‘LS’
destinataire
RCVPRN N° partenaire destinataire 57 C(10) Valeur fixe ‘FR’. Non contrôlé.
FILLER FILLER 67 C(112) A blanc
SNDPOR Port expéditeur 179 C(10) A blanc
SNDPRT Type du partenaire expéditeur 189 C(2) Constante ‘LS’
SNDPRN N° du partenaire expéditeur 191 C(10) Calculé par le système
FILLER FILLER 201 C(217) A blanc
MESTYP Type de message logique 418 C(6) Constante ‘Z****S'
IDOCTYP Nom du type Idoc de base 424 C(8) Constante ‘DEBMAS02’
FILLER FILLER 432 C(33) A blanc

5.1.2 Enregistrement de données : structure EDI_DD

La structure EDI_DD contient également des informations propres à l’Idoc et les données
servant à construire la table de structure BDCDATA utilisée pour le Call Transaction. Ces
données sont interprétées par SAP comme un champ unique pouvant faire jusqu’à 1000
caractères et seront découpées ultérieurement selon la structure du segment indiqué
dans la première zone.

Cette idoc comprends 25 segments différents nous allons donc décrire que les segments
et les zones utilisés pour cette interface.

Zone du Nom de zone Positio Format Valeur et/ou règle de


fichier n traitement

TABNAM Nom de la structure de table 1 C(10) Cf. RS01


FILLER FILLER 11 C(25) A blanc
SEGNAM Nom du segment SAP 36 C(10) Cf. RS01
FILLER FILLER 46 C(10) A blanc
SDATA Données d'application 56 C(1000)
5.1.2.1 Segment E1KNA1M
Le champ SDATA aura la structure suivante pour les données de base:

Zone du Nom de zone Positio Format Valeur et/ou règle de


fichier n traitement

MSGFN Fonction 55 C(3)


KUNNR Numéro de client 58 C(10) RG01
KTOKD Groupe de comptes client 202 C(4) RG01
LAND1 Code pays 208 C(3) RG01
LOEVM Témoin de suppression 233 C(1)
client
NAME1 Nom 1 234 C(35) RG01
NAME2 Nom 2 269 C(35)
NAME3 Nom 3 304 C(35)
NAME4 Nom 4 339 C(35)
ORT01 Localité 376 C(35)
ORT02 Quartier 411 C(35)
PFACH Boîte postale 446 C(10)
PSTL2 Code de la boîte postale 456 C(10)

5.1.2.2 Segment E1KNVVM


Le champ SDATA aura la structure suivante pour les données commerciales:

Zone du Nom de zone Positio Format Valeur et/ou règle de


fichier n traitement

MSGFN Fonction 55 C(3) Constante = V001


VKORG Organisation commerciale 58 C(3) Constante = ZC
VTWEG Canal de distribution 62 C(2) Constante = ZS
SPART Secteur d'activité 64 C(2)
LOEVM Témoin de suppression pour 70 C(1)
client (niveau ADV)
KALKS Schéma client 74 C(1) RG01
WAERS Devise 152 C(5) RG01
KTGRD Groupe d'imputation client 157 C(2)
VWERK Division livraison 163 C(4) RG01 Constante = E012
KURST Type de cours 200 C(4) RG01 Constante = V

5.1.2.3 Segment E1KNVIM


Le champ SDATA aura la structure suivante pour les données indicateur de taxe:

Zone du Nom de zone Positio Format Valeur et/ou règle de


fichier n traitement

MSGFN Fonction 55 C(3)


TAXKD Classification fiscale - Client 65 C(1) RG01 / RG02

5.1.2.4 Segment E1KNB1M


Le champ SDATA aura la structure suivante pour les données société:
Zone du Nom de zone Positi Format Valeur et/ou règle de
fichier on traitement

MSGFN Fonction 55 C(3)


BUKRS Société déterminée globale 58 C(6) Constante = S001
LOEVM Témoin de suppression pour 65 C(1)
la fiche (niveau société)
ZUAWA Clé de tri selon les numéros 66 C(3) RG01
d'affectation
BUSAB Gestionnaire comptable 69 C(2)
AKONT Compte collectif en 71 C(10) RG01 Constante = 13120000
comptabilité générale
XAUSZ Code pour extraits de 253 C(1) RG01
compte périodiques
XZVER Code : Mémorisation des 286 C(1) RG01
habitudes de paiement ?
TOGRU Classe de tolérance pour le 287 C(4)
partenaire

5.1.2.5 Segment E1KNB5M


Le champ SDATA aura la structure suivante pour les données de relance:

Zone du Nom de zone Positi Format Valeur et/ou règle de


fichier on traitement

MSGFN Fonction 55 C(3)


MAHNA Procédure de relance 60 C(4) RG01
BUSAB Responsable relances 92 C(2) RG01

5.2 Règles de gestion

5.2.1 Règles de gestion pour les données entrantes

N° de la règle Description de la règle


RS01 'E1KNA1M' -> Pour les données de base client.
'E1KNVVM' -> Pour les données ventes
'E1KNVIM' -> Pour les indicateurs de taxes
'E1KNB1M' -> Pour les données société
'E1KNB5M' -> Pour les données relance

5.2.2 Règles de gestion pour les données transférées au Call Transaction

N° de la règle Description de la règle


RG01 Vérification que la zone est renseignée sinon édition d'un message
d'erreur.
RG03 Détermination du type de traitement, Création ou modification de
client.
Sélection sur la table des clients KNA1 avec comme clé :
 KUNNR = E1KNA1M-KUNNR
Si SY-SUBRC = 0
W_Transaction = XD02
N° de la règle Description de la règle
Sinon
W_Transaction = XD01
Fin de si.

6 TRANSACTION

La transaction utilisée pour la créations des documents.

7 ALGORITHME DETAILLE

7.1 Programme principal

7.1.1 Fonction z_idoc_input_zcl03s


Lecture du 1er enregistrement de la table IDOC_CONTROL (Données de contrôle).
Vérification du type d’idoc de base IDOC_CONTROL-IDOCTP = ‘DEBMAS02’. S’il est différent,
stop.
Transfert des données Idoc dans une table interne T_IDOC_DATA.
Si T_IDOC_DATA est non vide,
| Mise à jour de EDIDS et EDIDC avec un statut à ‘66’ par défaut.
| Par la suite, si le traitement se passe bien, on modifiera à nouveau le statut.

| Appel de la fonction fill_appl_structures, qui va appliquer les règles de gestion aux


données entrantes, puis, si aucune erreur n’est décelée, faire l’appel au call transaction sur
la XD01 ou XD02, création ou modification d'un client..
Fin Si.
Boucle sur T_IDOC_STATUS pour mise à jour des statuts.

7.1.2 Sous-programme fill_appl_structures


Boucle sur la table des données T_IDOC_DATA (de structure EDI_DD)
! Alimentation des tables internes T_Nom de la structure correspondantes au segment
d'Idoc.
! Chargemnt des paramètre de la table Z905.
! Détermination du type de traitement RG03
! Contrôle et conversion des données (perform check_data)
! Si aucune erreur
! ! Alimentation de la structure BDCSDATA (perform fill-bdcdata)
! ! Appel direct de la transaction XD01 ouXD02: Création ou modification d’un client
( perform call_transaction)
! ! Si problème
! ! ! Mise en erreur de l’IDOC
! ! Fin si
! Sinon
! ! Mise en erreur de l’IDOC
! Fin si
Fin de boucle

7.1.3 Sous-programme d’alimentation de structure, FILL_BDCDATA

 La table de structure BDCDATA contient le nom du programme et le numéro de chacun des écrans
impactés, ainsi que les données censées être placées dans les cartouches adéquates.
 Le lien entre chacun des écrans est établi par un code transaction également
renseigné dans cette table.
 L’arborescence des écrans visités est indiquée ci-dessous ( § 7.2 ).
7.1.4 Sous-programmes d’alimentation de structure, CALL_TRANSACTION

Outre l’instruction CALL TRANSACTION ‘XD01’ (Création d’un Client) et CALL TRANSACTION ‘XD02’
(Modification d’un Client) , ce sous-programme effectue également la mise à jour du statut de l’idoc.

7.1.5 Sous-programme check_data


Contrôle de la présence des données obligatoires et de leur cohérence. RG01
Si un des contrôles n’est pas OK, l’idoc est mis en erreur (STATUT ‘51’) et un message
sera transmis.

7.1.6 REMARQUE

La désignation des messages d’erreur sont stockés dans la table T100 (domaine fonctionnel ‘Z1’)

7.2 Ecrans impactés par BDCDATA

La table de structure BDCDATA contient le nom du programme et le numéro de chacun des écrans
impactés, ainsi que les données censées être placées dans les cartouches adéquates.
Le lien entre chacun des écrans est établi par un code transaction également renseigné
dans cette table.
L’arborescence des écrans visités est indiquée ci-dessous.
En bleu les instructions spécifique à la création.
En rouge les instructions spécifique à la modification / suppression.

Zone SAP Nom de zone Zone du fichier et/ou règle de


traitement

Programme SAPMF02D - Ecran 0100– Ecran initial


Programme SAPMF02D - Ecran 0101– Ecran initial
RF02D-KUNNR Client T-E1KNA1M-KUNNR
RF02D-BUKRS Société T-E1KNB1M-BUKRS
RF02D-VKORG Organisation commerciale T-E1KNVVM-VKORG
RF02D-VTWEG Canal de distribution T-E1KNVVM-VTWEG
RF02D-SPART Secteur d'activité T-E1KNVVM-SPART
RF02D-KTOKD Groupe de compte T-E1KNA1M-KTOKD
Code fonction : /7 Marquer la totalité
Programme SAPMF02D - Ecran 0101– Ecran initial
Code fonction : /00 : Validation
Programme SAPMF02D - Ecran 0110– Adresse
KNA1-NAME1 Nom1 T-E1KNA1M-NAME1
KNA1- NAME2 Nom2 T-E1KNA1M-NAME2
KNA1- NAME3 Nom3 T-E1KNA1M-NAME3
KNA1- NAME4 Nom4 T-E1KNA1M-NAME4
KNA1-SORTl Zone de tri T-E1KNA1M-SORTL
KNA1-TELBX N° de télébox T-E1KNA1M-TELBX
KNA1-TELFX N° de télécopie T-E1KNA1M-TELFX
Zone SAP Nom de zone Zone du fichier et/ou règle de
traitement

KNA1-TELX1 N° de téléx T-E1KNA1M-TELX1


KNA1-REGIO N° de région T-E1KNA1M-REGIO
Code fonction :0520 : Autre fonction / Témoin de suppression.
Programme SAPMF02D - Ecran 0520 Témoins de suppression
KNA1-LOEVM Témoin de suppression T-E1KNA1M-LOEVM CVAR0004
client
KNB1-LOEVM Société sélectionnée T-E1KNB1M-LOEVM
KNVV-LOEVM Domaine commerciale T-E1KNVVM-LOEVM
sélectionné
Code fonction :/3
Programme SAPLV02Z - Ecran 0510–Données de blocage
KNA1-AUSFD Blocage de commande T-E1KNA1M-AUFSD
client ( blanc ou 01)
KNVV-AUSFD Blocage de commande T- E1KNVVM -AUFSD
client ( blanc ou 01)
Code fonction :PF03
Programme SAPMF02D - Ecran 0110– Adresse
Code fonction : ZUDA - Environnement / données supplémentaires
Programme SAPLV02Z - Ecran 0100– Données supplémentaire client central
KNA1-KATR3 Attribut 3 T-E1KNA1M-KATR3
KNA1-KATR6 Attribut 6 T-E1KNA1M-KATR6
KNA1-KATR7 Attribut 7 T-E1KNA1M-KATR7
Code fonction : /0 Validation
Programme SAPMF02D - Ecran 0110– Adresse
Code fonction : VW - écran suivant
Programme SAPMF02D - Ecran 0120– Paramétrage
KNA1-VBUND N° de société SL partenaire T-E1KNA1M-VBUND
Traitée uniquement lors
d’une creation et dans ce
cas à blanc si DOMEST ou
EXPORT dans
KNA1-STCD1 N° de SIREN T-E1KNA1M STCD1
KNA1-STCEG N° d'identifiant TVA T-E1KNA1M-STCEG
KNA1-BEGRU Groupe d'autorisation T_E1KNA1M-BEGRU
Code fonction : VW - écran suivant
Programme SAPMF02D - Ecran 0125
Code fonction : VW - écran suivant
Programme SAPMF02D - Ecran 0130 - Règlement
KNA1-XZEMP Payeur divergent autorisé T_E1KNA1M-XZEMP.
Zone SAP Nom de zone Zone du fichier et/ou règle de
traitement

Code fonction : VW - écran suivant


Programme SAPMF02D - Ecran 0210 - Gestion de compte comptabilité
KNB1-AKONT Compte collectif en T_E1KNB1M-AKONT
comptabilité générale
KNB1-ZUANA Clé de tri selon les numéro T_E1KNB1M-ZUAWA
d'affectation
Code fonction : VW - écran suivant
Programme SAPMF02D - Ecran 0215 - Règlement comptabilité
KNB1-TOGRU Groupe de tolérance T_E1KNB1M-TOGRU
KNB1-XZVER Code mémorisation des T_E1KNB1M-XZVER
habitude de paiement
KNB1-KNRZB N° de compte d'un autre T_E1KNB1M- KNRZB.
payeur
Code fonction : VW - écran suivant
Programme SAPMF02D - Ecran 0220 -Correspondance comptabilité
KNB5-MAHNA Procédure de relance T_E1KNB5M-MAHNA
KNB5-BUSAB Responsable de la relance T_E1KNB5M-BUSAB
KNB1-BUSAB Gestionnaire comptable T_E1KNB1M-BUSAB
Code fonction : VW - écran suivant
Programme SAPMF02D - Ecran 0230 : Assurance comptabilité
Code fonction : VW - écran suivant
Programme SAPMF02D - Ecran 0310 : Vente domaine commercial
KNVV-WAERS Devise T_E1KNVVM-WAERS
KNVV-KURST Type de cours T_E1KNVVM-KURST
KNVV-KALKS Schéma client T_E1KNVVM-KALKS
Code fonction : VW - écran suivant
Programme SAPMF02D - Ecran 0315 : Expédition domaine commercial
KNVV-VWERK Division de livraison T_E1KNVVM-VWERK
KNVV-AUTLF Livraison complète par T_E1KNVVM-AUTLF
commande impérative
KNVV-ANTLF Composante du n° de T_E1KNVVM- ANTLF
version (0 par défaut)
Code fonction : VW - écran suivant
Programme SAPMF02D - Ecran 0320 : Facturation domaine commercial
KNVV-INCO1 Incoterms 1ère partie T_E1KNVVM-INCO1
KNVV-INCO2 Incoterms 2nde partie T_E1KNVVM-INCO2
Code fonction : VW - écran suivant
Programme SAPMF02D - Ecran 1350 : Taxe domaine commercial
Zone SAP Nom de zone Zone du fichier et/ou règle de
traitement

KNVI-TAXKD Classification fiscale W_TAXKD_TRANSCO .CF RG02


Code fonction : VW - écran suivant
Programme SAPMF02D - Ecran 0324 : Fonction partenaire Domaine commercial
Code fonction : VW - écran suivant
Programme SAPLSPO1 - Ecran 0300 : Pop up de validation des données
Code fonction YES: Sauvegarde

8 TABLES

Nom Désignation Clé


EDIDC Enregistrement de contrôle (document /
intermédiaire)
EDIDD Enregistrement de données (document /
intermédiaire)
KNA1 Fiche client: Partie générale /

9 QUESTIONS / REMARQUES

FIN DE DOCUMENT