Documentation du service générique

Détail de l’activité d’un compte

Version Standard
 Sommaire

1. Objet 3
2. Traitement 4
2.1. Préambules 4
2.1.1. Composition des en-têtes des flux de requête et de réponse 4
2.1.2. Détail de la structure du flux 4
2.2. getAccountActivity – Détail de l’activité d’un compte 5
2.2.1. Composition du flux XML de requête 6
2.2.2. Composition du flux XML de réponse 10
 Version Standard Confidentiel Amplitude
Services génériques

1. Objet

Cette évolution a pour but de mettre en place des services génériques permettant à Amplitude d’échanger avec d’autres logiciels ; accessibles depuis
l’extérieur, ces services génériques constitueront un échange de flux XML avec le logiciel externe.

3/11
 Version Standard Confidentiel Amplitude
Services génériques

2. Traitement

2.1. Préambules

2.1.1. Composition des en-têtes des flux de requête et de réponse

Les flux XML de requête adopteront tous un en-tête commun de type "requestHeader" ; le détail de ces flux est décrit dans le document transverse
"Composition des en-têtes des flux de requête et de réponse".

Les flux XML de réponse adopteront tous un en-tête commun de type "responseHeader" et un élément de type "responseStatus" ; le détail de ces flux
est décrit dans le document transverse "Composition des en-têtes des flux de requête et de réponse".

2.1.2. Détail de la structure du flux

 Le niveau des champs du message, allant de + (1 plus) à ++++++++++ (10 plus) sont équivalents à des sous-titres hiérarchiques (de 1 à 10).
 Le format correspond à la caractéristique et à la longueur de l’élément traité. Une balise "Composite" correspond à une balise structurante, et l’attribut
"CHOICE" indique qu’un et un seul des éléments de la balise composite doit être renseigné.
 La colonne "Description" décrit le type ou l’élément de la balise.
 La colonne "Commentaires/Contrôles" contient des informations supplémentaires sur le type ou l’élément, ainsi que les contrôles et valeurs par défaut
appliqués à chacune des balises du flux de requête. Lorsque des valeurs par défaut sont précisées, elles doivent être paramétrées via le programme
dédié aux valeurs par défaut.
 La colonne "Multiple" indique qu’une balise peut apparaître plusieurs fois dans le flux.

4/11
 Version Standard Confidentiel Amplitude
Services génériques

2.2. getAccountActivity – Détail de l’activité d’un compte

Programme Amplitude : cbwcptcpta

Service générique : getAccountActivity

Liste des tables Amplitude accédées :

 Table principale :
 bkcom : Table des comptes clients
 Tables secondaires :
 bkhis : Table d'historique des comptes
 bkhisl : Table des libellés complémentaires des mouvements de l’historique des comptes
 bkeve : Table des mouvements générés durant la journée
 bkeve_eod : Table des mouvements générés durant la nuit

Liste des documentations des services associés :

 [SMG][DOC] Liste des mouvements de l’historique d’un compte

 [SMG][DOC] Liste des mouvements du jour d’un compte

Ce service a pour fonction de rechercher le détail de l’activité d’un compte correspondant à un ensemble de critères contenus dans le flux XML qu’il reçoit.

La recherche des mouvements d'un compte peut s'effectuer selon l'historique et/ou les mouvements du jour.

La description complète du flux de requête peut être trouvée dans la partie 2.2.1 du présent document.

La description complète du flux de réponse peut être trouvée dans la partie 0 du présent document.

5/11
Version Standard Confidentiel Amplitude
Services génériques

2.2.1. Composition du flux XML de requête

Nivea Nom de la balise Format Obligatoir Multipl Descriptio Commentaires/Contrôles

u e e n

requestHeader Type "requestHeader" Oui Non En-tête du L’en-tête est décrit dans le document
flux transverse "Composition des en-têtes
requête des flux de requête et de réponse".

getAccountActivityReque Composite Oui Non Requête

st Détail de
l’activité
d’un
compte

+ technicalCriteria Type "technicalCriteria" Non Non Critères Le type "technicalCriteria" est décrit
techniques dans la documentation transverse
"Documentation des types
transverses".

+ accountIdentifier Type Oui Non Identifiant Le compte doit exister en base.

"internalFormatSimpleAccountOurBran du compte
Le type
ch"
"internalFormatSimpleAccountOurBran
ch" est décrit dans la documentation
transverse "Documentation des types
transverses".

6/11
Version Standard Confidentiel Amplitude
Services génériques

Nivea Nom de la balise Format Obligatoir Multipl Descriptio Commentaires/Contrôles

u e e n

+ moduleCode Type "moduleCode" Non Non Code Le type "moduleCode" est décrit dans
module la documentation transverse
"Documentation des types
transverses".

+ fileReference CHARMAX50 Non Non Numéro de

dossier

+ movementPeriod Type "movementPeriod" Oui Non Définition Le type "movementPeriod" est décrit
de la dans la documentation des types
période transverses au domaine Maintenance
des comptes.

Selon les dates définies pour la

période, et le moment du jour ou de la
nuit, les mouvements sont
recherchés soit dans les mouvements
du jour, soit dans l’historique des
mouvements du compte, soit dans les
deux :

 Quelque soit le moment du jour ou

de la nuit :

 Si la date de début est

inférieure strictement à la date
comptable et que la date de
fin est inférieure strictement à

7/11
Version Standard Confidentiel Amplitude
Services génériques

Nivea Nom de la balise Format Obligatoir Multipl Descriptio Commentaires/Contrôles

u e e n

la date comptable,
alors sélection :

 De l’historique

 Si la date de début est

inférieure strictement à la date
comptable et que la date de
fin est vide, alors sélection :

 Des mouvements du
jour

Et

 De l’historique

 Si la date de début est

supérieure strictement à la
date comptable alors, quelque
soit la date de fin, sélection :

 Des mouvements du
jour

 Si la date de début est égale à la

date comptable, alors :

 En journée, ou bien en TFJ

avant la position comptable,
sélection :

8/11
Version Standard Confidentiel Amplitude
Services génériques

Nivea Nom de la balise Format Obligatoir Multipl Descriptio Commentaires/Contrôles

u e e n

 Des mouvements du
jour

 En TFJ après la position

comptable et avant la nouvelle
journée :

 Si la date de fin est

égale à la date
comptable, alors
sélection :

 Dans l’historique

 Sinon, sélection :

 Des mouvements du
jour
Et
 De l’historique

9/11
Version Standard Confidentiel Amplitude
Services génériques

2.2.2. Composition du flux XML de réponse

Niveau Nom de la balise Format Obligatoire Multiple Description Commentaires/Contrôles

responseHeader Type "responseHeader" Oui Non En-tête de réponse L’en-tête est décrit dans le
document transverse
"Composition des en-têtes des
flux de requête et de réponse".

responseStatus Type "responseStatus" Oui Non Statut de la Le statut est décrit dans le
réponse document transverse
"Composition des en-têtes des
flux de requête et de réponse".

getAccountActivityResp Composite Oui Non Réponse Détail de

onse l’activité d’un
compte

+ accountIdentifier Type Non Non Identifiant du Le type

"internalFormatAccountOurB compte "internalFormatAccountOurBranch
ranch" " est décrit dans la documentation
transverse "Documentation des
types transverses".

+ accountActivityBalances Type Non Non Soldes de l’activité Le type "accountActivityBalances"

"accountActivityBalances" du compte est décrit dans la documentation
des types transverses au domaine
Maintenance des comptes.

10/11
Version Standard Confidentiel Amplitude
Services génériques

Niveau Nom de la balise Format Obligatoire Multiple Description Commentaires/Contrôles

+ intraDayMovements Type Non Non Mouvements du Le type

"getIntraDayMovementListR jour du compte "getIntraDayMovementListRespon
esponse" se" est décrit dans la
documentation "[SMG][DOC]
Liste des mouvements du jour
d’un compte".

+ accountHistory Type Non Non Mouvements de Le type

"getAccountHistoryMovemen l’historique du "getAccountHistoryMovementListR
tListResponse" compte esponse" est décrit dans la
documentation "[SMG][DOC]
Liste des mouvements de
l’historique d’un compte".

11/11