Ce document est destiné aux commerçants qui souhaitent comprendre la procédure d'envoi des journaux générés par l'offre Sogenactif ainsi que la structure et les données contenues dans ces journaux.

Pour avoir une vue d’ensemble de la solution Sogenactif, nous vous conseillons de consulter les documents suivants :

• Présentation fonctionnelle ;
• Guide de configuration des fonctionnalités.

Pour toute question technique ou demande d'assistance, nos services sont disponibles du lundi au vendredi, hors jours fériés, de 9 h à 19 h :

• par téléphone au : +33 (0) 825 090 095  (0,15 € TTC/min + prix d’un appel local – Tarif au 12/09/2022)
• par e-mail : supportsogenactif@worldline.com

Pour faciliter le traitement de vos demandes, veuillez communiquer votre identifiant de commerçant : merchantId (numéro à 15 chiffres).

Chaque fichier se compose de quatre parties successives :

1. Type de journal : cette partie précise le type de journal et apporte d’autres renseignements d'ordre général comme le nom du journal, la date de génération ou la version TAB20 utilisée. C'est la première ligne du fichier, elle débute par le mot clé « TITLE ».
2. Entête du journal : c'est la deuxième ligne du fichier, elle liste les intitulés des colonnes. L’entête est spécifique à chaque type de journal et commence par le mot clé « HEADER ».
3. Corps du journal : ce sont les lignes qui suivent, elles commencent par un mot clé différent selon le type de journal (« TRANSACTION », « OPERATION », etc.). C’est cette partie qui contient les enregistrements (transactions, opérations de caisse) à proprement parler.
4. Fin du journal : c'est la dernière partie, elle marque la fin du fichier et ne comprend qu’un champ renseigné avec le mot clé « END » (journaux des transactions ou des opérations et des cartes arrivant à échéance) ou « FOOTER » (journaux de rapprochement bancaire ou de rapprochement des impayés).

Les journaux « surchargent » (modifient) le format de date de certains champs, c'est-à-dire qu'ils écrasent les formats initialement définis dans le dictionnaire des données Sogenactif.

Voici un récapitulatif des champs concernés pour chaque journal, avec les formats surchargés :

La convention suivante est utilisée dans ce guide :

• la colonne « Position » indique la position du champ (la colonne) dans le journal ;
• la colonne « Nom du champ » indique l’intitulé utilisé dans l’entête.

Ce journal contient toutes les transactions de paiement (acceptées ou refusées) réalisées à partir de votre boutique Web depuis l’envoi du journal précédent, à l’exception des transactions en doublon (code 94) et de celles en attente (code 60).

Il peut servir à pallier les situations où votre système d’information n’est pas notifié de l’aboutissement d’une transaction : par exemple, si vous intégrez les pages de paiement de Sogenactif, le client est susceptible de ne pas cliquer sur le bouton « Retour à la boutique » (absence de réponse manuelle) ; ou bien un problème réseau peut survenir (absence de réponse automatique).

En utilisant un outil de traitement automatique ou manuel, vous pouvez analyser ce journal, mettre à jour vos bases de données et assurer de cette manière la livraison de toutes les commandes dont le paiement a été accepté.

Les guides d’implémentation de chaque moyen de paiement peuvent contenir des précisions ou exceptions, nous vous invitons à les consulter pour davantage de précisions.

Télécharger un exemple

Le journal des opérations vous informe de l’évolution du statut des transactions dans leur cycle de vie. Il contient les changements apportés aux transactions de paiement, c'est-à-dire les événements susceptibles de modifier l’état de la transaction (par exemple, l'opération "validate" change le statut "TO_VALIDATE" d'une transaction en "TO_CAPTURE"). Ainsi, vous pouvez également analyser ces fichiers et mettre à jour vos bases de données. Le journal reprend également les opérations envoyées en banque. Par conséquent, vous pouvez vous en servir pour vérifier les mouvements comptables.

Télécharger un exemple

Ce journal est le résultat du rapprochement (on parle aussi de réconciliation) entre les transactions et les flux de retour concernant les paiements traités par vos banques ou établissements financiers. Le journal de rapprochement bancaire contient les transactions effectuées à partir de votre boutique Web et qui ont été créditées sur (ou débitées de) votre compte.

Après avoir reçu les fichiers des paiements provenant de vos banques ou de vos établissements financiers, Sogenactif effectue le rapprochement de ces transactions « payées » avec sa propre base d’informations, permettant ainsi d’ajouter le contexte fourni par Sogenactif pour la transaction (numéro de la transaction, références du commerçant etc.) aux informations des banques. Cela signifie que vous êtes informé en détail des transactions rapprochées. De plus, vous êtes mis en garde dans le cas de non rapprochement.

La disponibilité ou l'exhaustivité du journal de rapprochement bancaire dépend de la disponibilité des flux de retour après paiements fournis par vos banques ou établissements financiers.

Télécharger un exemple

Ce journal est le résultat du rapprochement (on parle aussi de réconciliation) entre les transactions et les flux de retour concernant les impayés traités par vos banques ou établissements financiers. Le journal de rapprochement des impayés contient, parmi les transactions effectuées à partir de votre boutique Web et déjà créditées ou débitées, celles qui font l'objet d'un impayé (par exemple, à cause d'un litige avec le client). Par conséquent elles font ou vont faire l'objet d'une régularisation.

Après avoir reçu les fichiers des impayés de la part de vos banques ou établissements financiers, Sogenactif effectue le rapprochement de ces transactions impayées avec sa propre base d’informations, permettant ainsi d’ajouter le contexte de la transaction fourni par Sogenactif (numéro de la transaction, références du commerçant etc.) aux informations de vos banques ou établissements financiers. Cela signifie que vous êtes informé en détail des transactions rapprochées.

La disponibilité ou l'exhaustivité du journal de rapprochement des impayés dépend de la disponibilité des flux de retour des impayés fournis par vos banques ou établissements financiers.

Depuis la version TAB20_V8, le journal de rapprochement des impayés supprime le séparateur redondant à la fin de l'entête, du corps et de la fin afin d'être cohérent avec les autres journaux.

Télécharger un exemple

Le journal des cartes arrivant à échéance vous informe sur les cartes stockées arrivant à expiration. Ainsi, vous pouvez prévenir les utilisateurs que leur carte arrive à échéance et leur demander de saisir leur nouvelle carte.

Télécharger un exemple