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