🔐 Mettre en place une conexión EBICS T (récupération des cuentas bancarias)
📖 EBICS (Electronic Banking Internet Communication Standard) est un protocole de communication bancaire de niveau professionnel, conçu pour les échanges de masse entre une entreprise et sa banco. Comparé à la DSP2, il offre une fiabilité supérieure, des volumes plus importants, l'accès aux relevés MT940 / CAMT.053, et ne nécessite aucun renouvellement de consentement tous les 180 jours.
Cet article décrit la mise en place d'une conexión EBICS T (Transport), qui permet la récupération automatique des soldes et transacciones de sus cuentas bancarias dans Okimia. La signature des virements (EBICS TS) fait l'objet d'un article séparé.
📋 Requisitos previos : souscrire un contrat EBICS auprès de su banco
⏳ La souscription d'un contrat EBICS est une démarche bancaire qui prend en général 2 à 6 semaines selon les établissements. Anticipez cette étape : aucune integración n'est possible côté Okimia tant que le contrat n'est pas actif côté banco.
Demande à formuler à su banco
Contactez su chargé d'affaires entreprise ou le service back-office de su banco et demandez la mise en place d'un contrat EBICS T (souvent appelé "abonnement EBICS T", "convention EBICS Transport", ou simplemente "EBICS T") en précisant les informations suivantes :
Information | Valeur à indiquer | Commentaire |
Type de contrat | EBICS T (Transport) | Pour la récupération de soldes et transacciones. EBICS TS est nécessaire en plus únicamente pour signer les virements. |
Version du protocole | H005 (recommandée) | Okimia supporte les trois versions. H005 est la plus récente et la plus sécurisée — privilégiez-la si su banco la propose. |
Comptes à inclure | Liste des IBAN à connecter | Indiquez explicitement chaque IBAN. Tout compte non listé au contrat ne sera pas synchronisable. |
Ordres autorisés | STA (relevés MT940) | A minima STA ou C53 pour les relevés quotidiens. Les autres ordres améliorent la fraîcheur des données. |
Certificat de signature | 3SKey (recommandé) | Voir section suivante. Le 3SKey est un standard SWIFT reconnu par la quasi-totalité des bancos. |
📖 Pourquoi EBICS T plutôt que TS ? EBICS T ne porte que la collecte de données (lecture). EBICS TS ajoute une couche de signature qualifiée pour émettre des virements. Si su cas d'usage Okimia est únicamente le suivi de tesorería, EBICS T est suffisant et plus rapide à mettre en place.
🔑 Obtenir et exporter su certificat 3SKey
📖 3SKey est une clé cryptographique sur support USB (token) émise par SWIFT et distribuée par les bancos. C'est le standard de signature personnelle (Personal Signature) reconnu par l'ensemble des bancos européennes. Chaque clé est nominative et liée à une personne physique.
1. Récupérer su clé auprès de su banco
Votre banco usted remet la clé USB 3SKey ainsi qu'un code PIN d'activation. À la première utilisation, usted devrez activer la clé sur le portail www.3skey.com et personnaliser su PIN.
2. Exporter le certificat public deluego la clé 3SKey
Una vez la clé activée, exportez le certificat public (fichier .cer ou .pem) para pouvoir le transmettre à Okimia et à su banco. SWIFT met à disposition un tutoriel vidéo officiel détaillant la procédure :
🎥 Tutoriel vidéo SWIFT : Comment exporter su certificat 3SKey (FR)
⚠️ Ne transmettez jamais su clé USB physique ni su PIN. Seul le certificat public doit être communiqué à Okimia et à su banco. La clé privée reste exclusivement sur su support 3SKey.
📤 Transmettre les informations à Okimia
Una vez le contrat EBICS souscrit auprès de su banco et le certificat 3SKey exporté, transmettez à su interlocuteur Okimia (ou à [email protected]) les éléments suivants :
Information | Exemple | Où la trouver ? |
Host ID |
| Sur le contrat EBICS remis par la banco. Identifie le serveur EBICS de la banco. |
Partner ID |
| Sur le contrat. Identifie su entreprise auprès de la banco. |
User ID |
| Sur le contrat. Identifie l'utilisateur (= la personne physique) titulaire de la clé 3SKey. |
URL du serveur EBICS | Sur le contrat. Point de terminaison HTTPS à contacter. | |
Version EBICS |
| Sur le contrat ou auprès de su chargé d'affaires. |
Certificat 3SKey (public) | Fichier | Exporté deluego su clé 3SKey (voir section précédente). |
Liste des IBAN à connecter |
| Tels que listés dans su contrat EBICS. |
📖 Le Host ID, le Partner ID et le User ID sont systématiquement présents sur le document contractuel que la banco usted remet à la signature de la convention EBICS. Si usted ne les trouvez pas, demandez le "récapitulatif technique" ou la "fiche d'identification EBICS" à su banco.
🚀 Initialisation de la conexión et lettre INI
Una vez les informations transmises, Okimia enregistre su profil EBICS et procède à l'initialisation de la conexión. Cette étape échange les clés publiques entre Okimia et le serveur EBICS de su banco (ordres INI, HIA, luego HPB).
À l'issue de cette initialisation, Okimia usted remet une lettre d'initialisation EBICS (parfois appelée "lettre INI" ou "lettre de clés") qui contient les empreintes (hashes) de sus clés publiques au format hexadécimal. Cette lettre doit être :
Imprimée et signée par le titulaire du User ID (la personne physique associée à la clé 3SKey) ;
Transmise à su banco par le canal qu'elle usted a indiqué (courrier postal, dépôt en agence, ou portail bancaire selon les établissements) ;
Validée par la banco, qui activera alors su accès EBICS sur ses serveurs.
📖 Pourquoi une lettre signée ? Ce processus papier est imposé par la norme EBICS. Il permet à la banco de vérifier en personne que la clé reçue électroniquement correspond bien à celle détenue par le titulaire. C'est l'équivalent du "scellement" d'un contrat bancaire à distance.
⚠️ Cas particulier CIC et BRED. Ces deux bancos utilisent un mode de calcul d'empreinte spécifique (hash SHA-256 du certificat complet, et non des composantes exposant/modulus de la clé). Okimia applique automáticamente le bon format dans la lettre INI — assurez-usted simplemente que la banco indiquée à su interlocuteur Okimia est correcte.
✅ Activation et premier rapatriement
Una vez la lettre validée par su banco (délai indicatif : 3 à 10 jours ouvrés), Okimia déclenche le premier rapatriement de l'historique bancaire (généralement les 90 derniers jours, selon les politiques de su banco). Les comptes connectés apparaissent luego dans su Dashboard Okimia aux côtés de sus autres comptes.
Le rafraîchissement automatique s'effectue luego une à plusieurs fois par jour, sin aucune action de su part.
💳 Validation des virements (cas EBICS TS)
📖 Cette section ne concerne que les clients ayant souscrit un contrat EBICS TS en plus du contrat EBICS T, et qui utilisent Okimia pour émettre des virements deluego la plateforme.
Cas 1 — Clé 3SKey absente ou non initialisée
Si usted tentez de valider un virement sin avoir de clé 3SKey active sur su compte utilisateur, ou sin que su conexión utilisateur ait été initialisée, verá la pantalla suivant :
⚠️ Cas des utilisateurs multi-entités. Une clé 3SKey est associée à chaque e-mail. Lorsque usted ajoutez une nouvelle entité à su périmètre, debe explicitement demander à nuestro soporte l'activation de la clé pour cette nouvelle entité, même si la clé physique reste la même.
Cas 2 — Clé 3SKey fonctionnelle
Lorsque su clé est correctement enregistrée et initialisée, verá au moment de valider un virement un écran de confirmation rappelant le montant, le bénéficiaire, l'IBAN et une empreinte de l'ordre. Saisissez su code PIN 3SKey dans el campo prévu à cet effet, luego haga clic en Confirmer :
📖 Un journal d'audit est conservé pour chaque virement signé, comme preuve de su ordre de virement. L'empreinte affichée à la pantalla (por ejemplo 9zkzklep2meM) est une signature courte des configuración du virement : elle garantit qu'aucun champ n'a été modifié entre le moment où usted avez préparé le virement et le moment où usted le signez.
❓ FAQ rapide
Combien coûte un contrat EBICS T ?
Les frais sont fixés par chaque banco. Comptez en général entre quelques dizaines et quelques centaines d'euros à la souscription, plus un abonnement mensuel modeste. Demandez la grille tarifaire à su chargé d'affaires.
Puis-je connecter plusieurs bancos en EBICS sur Okimia ?
Oui. Chaque banco fait l'objet d'un contrat EBICS distinct (Host ID, Partner ID et User ID propres à chacune), et chaque conexión est paramétrée séparément dans Okimia.
EBICS remplace-t-il la conexión DSP2 ?
EBICS et DSP2 peuvent coexister. Pour les comptes professionnels à fort volume ou nécessitant des relevés MT940 / CAMT.053, EBICS est préférable. Pour des comptes occasionnels ou de petits volumes, la DSP2 reste pertinente et plus rapide à mettre en place.
Que se passe-t-il si je perds ma clé 3SKey ?
Contactez immédiatement su banco pour révoquer la clé compromise et en obtenir une nouvelle. La nouvelle clé devra être enregistrée auprès de Okimia en suivant à nouveau la procédure d'initialisation (lettre INI à re-signer).
📖 Maintenant que su conexión EBICS est en place, consultez l'article Comment connecter une banco à Okimia ? pour décabrir les autres modes de conexión bancaire disponibles.