Comprendre la structure du journal de rapprochement bancaire V3

L'enregistrement « Titre »

L'enregistrement Titre renseigne sur les caractéristiques du fichier pour permettre une meilleure identifcation. Il est valorisé comme suit :

Pos. Description Valeurs
01 Code d'enregistrement TITRE
02 Nom de la boutique
03 Date et heure de l'envoi au format W3C en UTC Ex: 2017-12-15T16:53Z
04 Version TABLE_V3

Les enregistrements « Entête » et « Détails »

Pos. Enregistrement « Entête » Enregistrement « Détails »
Libellé Description Valeur possible Signification
01 ENTETE Code d'enregistrement MATCHING  
02 MERCHANT_COUNTRY Pays du marchand   Exemple : FR pour la France
03 MERCHANT_ID Identifiant du marchand   Exemples :

0+SIRET (système d'identification du répertoire des établissements) en France.

0+CRN (Company Registration Number) au Royaume-Uni

0+NIF (Numero de Identificación Fiscal) en Espagne

04 CONTRACT Numéro de contrat du marchand    
05 PAYMENT_DATE Date et heure (UTC) du paiement   Format W3C dans le fuseau UTC

Ex: 2017-12-15T12:17Z

06 TRANSACTION_ID Identifiant de la transaction équivalent à vads_trans_id  
07 ORIGIN_AMOUNT Montant de la transaction en devise d’origine (exprimé dans la plus petite unité de la devise)    
08 CURRENCY_CODE Code de la devise de la transaction  

Voir tableau vads_currency pour plus d'exemples.

09 PAYMENT_METHOD Moyen de paiement    
10 ORDER_ID Référence de commande    
11 RETURN_CONTEXT Contexte de la commande d’un acheteur   Une ou plusieurs informations (order_info, order_info2, order_info3, ...) séparées par le caractère « | »
12 CUSTOMER_ID Identifiant client    
13 OPERATION_TYPE Type d’opération DT Débit
CT Crédit
14 OPERATION_NUMBER Numéro de séquence de l’opération    
15 REMITTANCE_DATE Date et heure (UTC) de la remise   Format W3C dans le fuseau UTC

Ex: 017-12-15T23:05Z

16 BRUT_AMOUNT Montant brut de la transaction remisée (exprimé dans la plus petite unité de la devise)    
17 MATCH_STATUS Statut de rapprochement MATCH_OK Rapprochement effectué
18 REMITTANCE_NB N° de remise    
19 NET_AMOUNT Montant net (exprimé dans la plus petite unité de la devise)   Renseigné uniquement lorsque le rapprochement est effectué automatiquement et s’il ne s’agit pas d’une carte privative
20 COMMISSION_AMOUNT Montant de la commission (exprimé dans la plus petite unité de la devise)  
21 COMMISSION_CURRENCY Devise de la commission  
22 INTERCHANGE Montant des frais d'interchange    
23 SCHEME_CHARGE_AMOUNT Montant de la commission Réseau    
24 BANK_CHARGE_AMOUNT Montant de la commision Banque    
25 CARD_NATURE Nature de la carte
  • P
  • E
  • vide si non fournie par l'acquéreur
  • P : Consumer Card
  • E : Commercial Card
26 TRANSACTION_REGIONALITY Zone géographique du paiement
  • FRA
  • UE
  • HUE
  • vide si non fournie par l'acquéreur
  • FRA : Domestique
  • UE : Zone Euro
  • HUE : Hors zone Euro
27 CARD_HOLDER_COUNTRY_CODE Code pays de la carte
  • code alpha-3 de la norme ISO 3166
  • vide si non fournie par l'acquéreur

Exemple : FRA pour France

28 CARD_SCHEME Réseau de la carte
  • 1
  • 2
  • 3
  • 4
  • 9
  • vide si non fournie par l'acquéreur
  • 1 : CB
  • 2 : VISA
  • 3 : MCI
  • 4 : ECI
  • 9 : Indeterminé (CB ou VISA)
29 CARD_PRODUCT_CATEGORY Catégory du produit de la carte
  • D
  • C
  • P
  • C : CREDIT
  • D : DEBIT
  • P : PREPAID
30 ACQ_INFOS Informations complémentaires envoyées par l'acquéreur CardCategory=XX XX peut prendre une des valeurs suivantes:
  • HE : Carte hors Union Européenne
  • CO : Carte commerciale Union Européenne
  • DT : Carte de débit Union Européenne
  • CT : Carte de crédit Union Européenne
  • UV : Carte universelle Union européenne (uniquement pour la marque commerciale CB)
  • NR : Carte non régulée Union Européenne
31 TRANSACTION_UUID Identifiant unique de la transaction    
32 DATA_COMP_1 Identifiant unique de la transaction d'origine   UUID de la transaction d'origine dans le cas d'un remboursement.
33 DATA_COMP_2 Date de valeur   Format W3C dans le fuseau UTC

Ex: 2018-08-10T10:14Z

34 DATA_COMP_3 Réservé pour une utilisation future    
35 DATA_COMP_4 Réservé pour une utilisation future    
36 DATA_COMP_5 Réservé pour une utilisation future    
37 DATA_COMP_6 Réservé pour une utilisation future    
38 DATA_COMP_7 Réservé pour une utilisation future    
39 DATA_COMP_8 Réservé pour une utilisation future    
40 DATA_COMP_9 Réservé pour une utilisation future    
41 DATA_COMP_10 Réservé pour une utilisation future    
42 DATA_COMP_11 Réservé pour une utilisation future    
43 DATA_COMP_12 Réservé pour une utilisation future    
44 DATA_COMP_13 Réservé pour une utilisation future    
45 DATA_COMP_14 Réservé pour une utilisation future    
46 DATA_COMP_15 Réservé pour une utilisation future    
47 DATA_COMP_16 Réservé pour une utilisation future    
48 DATA_COMP_17 Réservé pour une utilisation future    
49 DATA_COMP_18 Réservé pour une utilisation future    
50 DATA_COMP_19 Réservé pour une utilisation future    
51 DATA_COMP_20 Réservé pour une utilisation future    

L'enregistrement « Fin »

Pos. Description Valeurs
01 Code d'enregistrement FIN

Exemple de fichier

Cet extrait de journal de rapprochement bancaire (JRB) montre :

  • une ligne d'enregistrement Titre,
  • une ligne d'enregistrement Entête,
  • deux lignes d'enregistrement Détails commençant chacune par MATCHING,
  • une ligne d'enregistrement Fin marquant la fin du document.
TITRE;Lyra Collect;2017-12-15T16:53Z;TABLE_V3;								
ENTETE;MERCHANT_COUNTRY;MERCHANT_ID;CONTRACT;PAYMENT_DATE;TRANSACTION_ID;ORIGIN_AMOUNT;
CURRENCY_CODE;PAYMENT_METHOD;ORDER_ID;RETURN_CONTEXT;CUSTOMER_ID;OPERATION_TYPE;
OPERATION_NUMBER;REMITTANCE_DATE;BRUT_AMOUNT;MATCH_STATUS;REMITTANCE_NB;
NET_AMOUNT;COMMISSION_AMOUNT;COMMISSION_CURRENCY;INTERCHANGE;CARD_PRODUCT_CATEGORY;
SCHEME_CHARGE_AMOUNT;BANK_CHARGE_AMOUNT;CARD_NATURE;TRANSACTION_REGIONALITY;
CARD_HOLDER_COUNTRY_CODE;CARD_SCHEME;ACQ_INFOS;TRANSACTION_UUID;DATA_COMP_1;
DATA_COMP_2;DATA_COMP_3;DATA_COMP_4;DATA_COMP_5;DATA_COMP_6;DATA_COMP_7;DATA_COMP_8;
DATA_COMP_9;DATA_COMP_10;DATA_COMP_11;DATA_COMP_12;DATA_COMP_13;DATA_COMP_14;DATA_COMP_15;
DATA_COMP_16;DATA_COMP_17;DATA_COMP_18;DATA_COMP_19;DATA_COMP_20				
MATCHING;FR;045251785700028;3668754;2017-12-15T12:17Z;929644;5490;978;CB;C-100030479;;;DT;;
2017-12-15T23:05Z;5490;MATCH_OK;000132;5436;54;978;1.02;D;1.123;3.45;E;UE;250;1;CardCategory=UV;
cf7b10f898e94fd1aaaaa7a62f965817;;;;;;;;;;;;;;;;;;;;			
MATCHING;FR;045251785700028;4567654;2017-12-15T23:45Z;936518;20000;978;CB;C-100030502;;;DT;;
2017-12-15T23:05Z;20000;MATCH_OK;267501;19800;200;978;1.08;1.123;3.45;E;UE;;1;D;;
6fb0944bec7c4b76b9227e488ee317be;;;;;;;;;;;;;;;;;;;;				
FIN;