🔐 Mettre en place une Verbindung EBICS T (récupération des Bankkonten)
📖 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 Bank. 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 Verbindung EBICS T (Transport), qui permet la récupération automatique des soldes et Transaktionen de Ihre Bankkonten dans Okimia. La signature des virements (EBICS TS) fait l'objet d'un article séparé.
📋 Voraussetzungen : souscrire un contrat EBICS auprès de Ihrer Bank
⏳ 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 Integration n'est possible côté Okimia tant que le contrat n'est pas actif côté Bank.
Demande à formuler à Ihrer Bank
Contactez Ihr chargé d'affaires entreprise ou le service back-office de Ihrer Bank et demandez la mise en place d'un contrat EBICS T (souvent appelé "abonnement EBICS T", "convention EBICS Transport", ou einfach "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 Transaktionen. EBICS TS est nécessaire en plus nur 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 Ihrer Bank 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 Banks. |
📖 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 Ihr cas d'usage Okimia est nur le suivi de Liquidität, EBICS T est suffisant et plus rapide à mettre en place.
🔑 Obtenir et exporter Ihr certificat 3SKey
📖 3SKey est une clé cryptographique sur support USB (token) émise par SWIFT et distribuée par les Banks. C'est le standard de signature personnelle (Personal Signature) reconnu par l'ensemble des Banks européennes. Chaque clé est nominative et liée à une personne physique.
1. Récupérer Ihr clé auprès de Ihrer Bank
Votre Bank Sie remet la clé USB 3SKey ainsi qu'un code PIN d'activation. À la première utilisation, Sie devrez activer la clé sur le portail www.3skey.com et personnaliser Ihr PIN.
2. Exporter le certificat public dedann la clé 3SKey
Sobald la clé activée, exportez le certificat public (fichier .cer ou .pem) um zu pouvoir le transmettre à Okimia et à Ihrer Bank. SWIFT met à disposition un tutoriel vidéo officiel détaillant la procédure :
🎥 Tutoriel vidéo SWIFT : Comment exporter Ihr certificat 3SKey (FR)
⚠️ Ne transmettez jamais Ihr clé USB physique ni Ihr PIN. Seul le certificat public doit être communiqué à Okimia et à Ihrer Bank. La clé privée reste exclusivement sur Ihr support 3SKey.
📤 Transmettre les informations à Okimia
Sobald le contrat EBICS souscrit auprès de Ihrer Bank et le certificat 3SKey exporté, transmettez à Ihr interlocuteur Okimia (ou à [email protected]) les éléments suivants :
Information | Exemple | Où la trouver ? |
Host ID |
| Sur le contrat EBICS remis par la Bank. Identifie le serveur EBICS de la Bank. |
Partner ID |
| Sur le contrat. Identifie Ihr entreprise auprès de la Bank. |
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 Ihr chargé d'affaires. |
Certificat 3SKey (public) | Fichier | Exporté dedann Ihr clé 3SKey (voir section précédente). |
Liste des IBAN à connecter |
| Tels que listés dans Ihr contrat EBICS. |
📖 Le Host ID, le Partner ID et le User ID sont systématiquement présents sur le document contractuel que la Bank Sie remet à la signature de la convention EBICS. Si Sie ne les trouvez pas, demandez le "récapitulatif technique" ou la "fiche d'identification EBICS" à Ihrer Bank.
🚀 Initialisation de la Verbindung et lettre INI
Sobald les informations transmises, Okimia enregistre Ihr profil EBICS et procède à l'initialisation de la Verbindung. Cette étape échange les clés publiques entre Okimia et le serveur EBICS de Ihrer Bank (ordres INI, HIA, dann HPB).
À l'issue de cette initialisation, Okimia Sie remet une lettre d'initialisation EBICS (parfois appelée "lettre INI" ou "lettre de clés") qui contient les empreintes (hashes) de Ihre 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 à Ihrer Bank par le canal qu'elle Sie a indiqué (courrier postal, dépôt en agence, ou portail bancaire selon les établissements) ;
Validée par la Bank, qui activera alors Ihr accès EBICS sur ses serveurs.
📖 Pourquoi une lettre signée ? Ce processus papier est imposé par la norme EBICS. Il permet à la Bank 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 Banks 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 automatisch le bon format dans la lettre INI — assurez-Sie einfach que la Bank indiquée à Ihr interlocuteur Okimia est correcte.
✅ Activation et premier rapatriement
Sobald la lettre validée par Ihrer Bank (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 Ihrer Bank). Les comptes connectés apparaissent dann dans Ihr Dashboard Okimia aux côtés de Ihre autres comptes.
Le rafraîchissement automatique s'effectue dann une à plusieurs fois par jour, ohne aucune action de Ihr 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 dedann la plateforme.
Cas 1 — Clé 3SKey absente ou non initialisée
Si Sie tentez de valider un virement ohne avoir de clé 3SKey active sur Ihr compte utilisateur, ou ohne que Ihr Verbindung utilisateur ait été initialisée, Sie werden sehen dem Bildschirm suivant :
⚠️ Cas des utilisateurs multi-entités. Une clé 3SKey est associée à chaque e-mail. Lorsque Sie ajoutez une nouvelle entité à Ihr périmètre, Sie müssen explicitement demander à unseren Support 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 Ihr clé est correctement enregistrée et initialisée, Sie werden sehen 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 Ihr code PIN 3SKey dans das Feld prévu à cet effet, dann klicken Sie auf Confirmer :
📖 Un journal d'audit est conservé pour chaque virement signé, comme preuve de Ihr ordre de virement. L'empreinte affichée à dem Bildschirm (zum Beispiel 9zkzklep2meM) est une signature courte des Einstellungen du virement : elle garantit qu'aucun champ n'a été modifié entre le moment où Sie avez préparé le virement et le moment où Sie le signez.
❓ FAQ rapide
Combien coûte un contrat EBICS T ?
Les frais sont fixés par chaque Bank. Comptez en général entre quelques dizaines et quelques centaines d'euros à la souscription, plus un abonnement mensuel modeste. Demandez la grille tarifaire à Ihr chargé d'affaires.
Puis-je connecter plusieurs Banks en EBICS sur Okimia ?
Oui. Chaque Bank fait l'objet d'un contrat EBICS distinct (Host ID, Partner ID et User ID propres à chacune), et chaque Verbindung est paramétrée séparément dans Okimia.
EBICS remplace-t-il la Verbindung 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 Ihrer Bank 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 Ihr Verbindung EBICS est en place, consultez l'article Comment connecter une Bank à Okimia ? pour décöffnen les autres modes de Verbindung bancaire disponibles.