Pré-requis : Pour pouvoir connecter votre compte Airwallex à votre compte Okimia, vous devez être administrateur du compte Airwallex.
L'intégration avec Airwallex vous permet d'enrichir votre interface Okimia grâce à la remontée de vos comptes Airwallex (un compte par devise), de leurs transactions et de vos factures clients émises depuis Airwallex.
Créer une clé API dans Airwallex
Okimia se connecte à Airwallex avec un Client ID et une clé API. Pour les obtenir :
Connectez-vous à Airwallex avec un utilisateur qui a les droits de gérer les clés API.
Ouvrez la rubrique
Développeur, puisClés API.
Copiez le Client ID, puis générez une clé API et copiez-la.
💡 Attention
Si vous souhaitez importer vos factures clients, la clé API doit avoir accès à la facturation Airwallex (Billing). Sans cet accès, la synchronisation des factures échoue. Si vous n'utilisez pas la facturation Airwallex, ne cochez pas les factures clients à l'étape suivante.
Connecter Airwallex à Okimia
Sur votre compte Okimia, allez dans le Menu
Intégrations.Cliquez sur
Ajouter une intégration>AirwallexRenseignez les champs
Client IDetClef APIavec les valeurs copiées dans Airwallex, puisValider.Choisissez les données à importer :
COMPTES 512: vos comptes et transactions Airwallex (coché par défaut) ;COMPTES 411: vos factures clients Airwallex.
Cliquez sur
Synchroniser les données.Une fois la synchronisation terminée, cliquez sur
Voir mon dashboard.
Vos comptes et transactions
Okimia crée un compte par devise détenue sur Airwallex, nommé d'après votre entreprise et la devise. Par exemple, si votre entreprise Acme détient des euros et des dollars américains, vous verrez apparaître deux comptes : Acme - EUR et Acme - USD.
Solde : le solde total du compte dans cette devise, tel qu'affiché par Airwallex.
IBAN : celui de votre compte de réception Airwallex actif dans cette devise, s'il en existe un.
Transactions : les transactions réglées des 180 derniers jours. Le montant importé est net des frais Airwallex : pour un encaissement de 1 000 € avec 5 € de frais, la transaction apparaît à 995 €.
Paiements par carte : le libellé reprend le nom du commerçant, le nom de la carte et ses 4 derniers chiffres.
Les nouvelles transactions arrivent sans catégorie : catégorisez-les comme vos autres transactions bancaires.
💡 Pourquoi je ne vois pas toutes mes devises ?
Une devise dont le solde est à zéro n'est pas ajoutée lors de la première synchronisation. Le compte apparaîtra automatiquement dès que vous détiendrez des fonds dans cette devise.
Vos factures clients
Si vous avez coché COMPTES 411, Okimia importe les factures émises depuis la facturation Airwallex au cours des 365 derniers jours, avec le nom du client associé. Retrouvez-les dans l'onglet Échéances.
Les factures en brouillon ne sont pas importées ;
Une facture annulée dans Airwallex apparaît comme annulée dans Okimia ;
Une facture payée apparaît comme payée, à sa date de paiement ;
Une facture partiellement réglée apparaît comme partiellement payée, avec son reste à encaisser.
Vos avoirs sont importés comme des factures à montant négatif, considérées comme réglées. Par exemple, un avoir de 200 € apparaît à -200 €.
Ce qui n'est pas synchronisé
Les factures fournisseurs : l'import des factures fournisseurs Airwallex n'est pas disponible pour le moment ;
Les transactions en attente : seules les transactions réglées sont importées. Une transaction en cours (par exemple un paiement par carte pas encore débité) apparaîtra une fois réglée.
👉 Que faire si la synchronisation est en erreur ?
Vérifiez dans Airwallex que votre clé API est toujours active et qu'elle n'a pas été révoquée. Si vous l'avez régénérée, reconnectez l'intégration avec la nouvelle clé. Si l'erreur ne concerne que les factures, vérifiez que la clé a bien accès à la facturation (Billing).