Passer au contenu principal

Comment fonctionne l'intégration entre Yooz et Okimia ?

Connectez Yooz à Okimia via l’API pour récupérer automatiquement vos factures fournisseurs et clients. Ce guide détaille la génération des identifiants API, la création du rapport Yooz et la finalisation de la connexion dans Okimia.

S
Écrit par Support Okimia

Pré-requis : pour connecter Okimia et Yooz, vous devez au préalable disposer d’un compte administrateur sur chacune des deux applications. Côté Yooz, vous devez pouvoir accéder au menu Integrations > Public API.

Si vous ne disposez pas encore de compte sur Okimia, vous pouvez en créer un à partir de cette page 👉 https://app.okimia.com/signup

💡

La connexion se fait en trois temps : vous générez d’abord vos identifiants API dans Yooz, vous créez ensuite un rapport dédié dans Yooz, puis vous renseignez l’ensemble de ces informations dans Okimia. Gardez précieusement chaque identifiant généré : certains ne sont affichés qu’une seule fois.

1. Générer vos identifiants API dans Yooz

  • Depuis Yooz, rendez-vous dans Settings > Integrations > Public API.

  • Dans la section OAuth 2.0 Authorization code, cliquez sur le + en haut à droite.

  • Créez ensuite votre client OAuth en renseignant les deux champs suivants :

    1. Name : donnez un nom explicite à la connexion (par exemple Okimia_Prod).

    2. Redirect URIs : saisissez impérativement l’URL suivante, sans quoi la connexion échouera 👉 https://app.okimia.com/partner/callback

  • Cliquez sur Create. Yooz affiche alors votre Client ID et votre Client secret.

  • C'est le premier couple de Client ID et votre Client secret que vous générez.

⚠️

Ces deux identifiants ne sont affichés qu’une seule fois et ne pourront pas être récupérés par la suite. Copiez-les et conservez-les précieusement avant de fermer la fenêtre.

  • Revenez sur le menu Public API.

  • Dans la section OAuth 2.0 Authorization Code Grant > Generate Token for API Connexion

  • Nous allons générons un deuxième couple de client_id et de client_secret

  • Préservez le client_id et le client_secret, nous en auront besoin utltérieurement.

⚠️ A ce stade, nous avons deux client_id et deux client_secret, ce sont deux couples différents et à ne pas mélanger.

2. Créer le rapport Yooz

Okimia récupère vos factures via un rapport dédié que vous créez dans Yooz. Le paramétrage de ce rapport est déterminant pour la bonne synchronisation des données.

  • Dans Yooz, cliquez sur Créer un rapport.

  • Donnez-lui un nom explicite (par exemple Okimia_V2) et sélectionnez le modèle Documents (en-tête).

  • Dans les Filtres, ajoutez impérativement le filtre Date de création (Donnée système) : Depuis dernière exécution. Ce filtre garantit qu’Okimia ne récupère que les nouveaux documents à chaque synchronisation, sans doublon.

💡

Pourquoi le filtre « Depuis dernière exécution » est-il essentiel ?
Sans ce filtre, chaque synchronisation réimporterait l’intégralité de vos documents et générerait des doublons dans Okimia. Le filtre limite l’export aux documents créés depuis la dernière récupération.

Colonnes à intégrer au rapport

Ajoutez l’ensemble des colonnes ci-dessous au rapport. Elles permettent à Okimia d’exploiter correctement vos factures fournisseurs et clients :

  • Numéro Yooz

  • Numéro de document

  • Date de création document

  • Organisation (Code)

  • Type de document

  • Tiers (Fournisseur, Client, …) (Nom)

  • En retard ?

  • Devise

  • Statut

  • Montant déjà payé/remboursé (Données de la facture)

  • Reste à payer (Données de la facture)

  • Facture à recevoir ? (Autres données d’achat)

  • Écart détecté (Données de la facture)

  • Date de paiement prévue (Données de la facture)

  • Date de facture (Données de la facture)

  • Date d’échéance (Propriétés)

  • Statut de la commande dans l’ERP (Autres données d’achat)

  • À encaisser (Données de la facture)

  • Montant net (Données de la facture)

  • Montant brut (Données de la facture)

  • Reste à encaisser (Données de la facture)

  • Document encaissé ? (Données de la facture)

  • Numéro de facture (Données de la facture)

  • Document payé ? (Données de la facture)

  • Montant total

  • Montant de taxe

  • Processus

  • Traité ?

  • Yoozing

3. Récupérer votre Application ID et Report ID

  • Retournez dans le menu Integrations > Public API.

  • Cette fois, cliquez sur Access en face de Yooz API documentation.

  • Dans l’URL de la page qui s’ouvre, repérez le paramètre applicationId. La valeur qui suit le signe = correspond à votre Application ID. Copiez-la et conservez-la avec vos autres identifiants.

  • Scrollez vers le bas et cliquez sur Authorize

  • Remontez la mollette vers le haut afin d'atteindre le premier encadré, et entrez le client_id et le client_secret (ceux générés en deuxième)

  • Descendez vers le bas et cherchez l'onglet "Rapport"

  • Ne changez pas ce que vous voyez dans application_id, et cliquez sur Executer.

  • Maintenant, nous allons récupérer l'ID du Rapport que nous avons créé.

4. Finaliser la connexion dans Okimia

  • Rendez-vous sur votre compte Okimia, sur la page 👉 https://app.okimia.com/partner/selection

  • Dans la liste des outils, sélectionnez la vignette Yooz puis cliquez sur Valider.

  • Renseignez enfin les quatre identifiants générés précédemment dans les champs correspondants :

    1. Client ID (celui généré en premier)

    2. Client Secret (celui généré en premier)

    3. Application ID

    4. Report ID

  • Cliquez sur Connecter Yooz pour finaliser la connexion.

👉

Une fois la connexion établie, Okimia récupère quotidiennement les documents de votre rapport Yooz afin d’alimenter le suivi de vos factures fournisseurs et clients. Vous pouvez modifier ce paramétrage à tout moment.

Votre outil n’apparaît pas dans la liste ? 👉 Consultez Comment connecter un autre outil ?

Articles connexes
Avez-vous trouvé la réponse à votre question ?