Documentation des services génériques

Création de virements

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. createTransfer – Création de virements 5
2.2.1. Composition du flux XML de requête 6
2.2.2. Composition du flux XML de réponse 7
 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/7
 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/7
 Version Standard Confidentiel Amplitude
Services génériques

2.2. createTransfer – Création de virements

Programme Amplitude : guwvrtc

Service générique : createTransfer

Liste des tables Amplitude accédées :

 Tables principales :
 bkeve : Table des événements
 bkvrt : Table des virements permanents et différés
 bksct : Table des virements permanents et différés SEPA

Ce service permet de créer, modifier ou annuler des virements à partir d’un flux PAIN 001. Un flux PAIN 002 est restitué afin de savoir si l’exécution de
l’ordre s’est bien passée ou non.

Seuls les virements locaux et SEPA sont gérés via ce service générique ; si une autre demande est reçue, alors une erreur est levée.

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 2.2.2 du présent document.

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

2.2.1. Composition du flux XML de requête

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

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

createTransferRequest Composite Oui Non Requête de

création de
virements

+ canal CHARMAX20 Oui Non Code canal

+ pain001 STRING Oui Non Flux PAIN 001 Voir la documentation technique
du SIOP "0262-1-10.1Service
d'initiation d'ordres de paiements"

6/7
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".

createTransferResponse Composite Oui Non Réponse de la

création de
virements

+ pain002 STRING Oui Non Flux de réponse Voir la documentation technique

PAIN 002 des PSR "0265-1-10.
1Spécifications techniques des
PSR"

7/7