Configuration

La configuration du module se fait depuis Accueil > Configuration > Modules/Applications > Kimsufi (icône d'engrenage). Elle est répartie sur deux onglets : Authentification et Import des factures.

Authentification

Cet onglet configure la connexion à l'API KIMSUFI/OVH. Vous devez créer une application API chez KIMSUFI puis renseigner les identifiants dans Dolibarr.

Créer une application API

Rendez-vous sur la page de création d'application KIMSUFI : https://eu.api.kimsufi.com/createApp/.
Connectez-vous avec vos identifiants KIMSUFI.
Remplissez le nom et la description de l'application (par exemple : « Dolibarr Kimsufi »).
Notez l'Application Key et l'Application Secret générés.

Attention : si vous utilisez un compte OVH ou So You Start plutôt que KIMSUFI, l'URL de création sera différente (par exemple https://eu.api.ovh.com/createApp/ pour OVH).

Renseigner les identifiants

De retour dans Dolibarr, remplissez les champs suivants :

Champ	Description
Application name	Nom de votre application API (informatif)
Application key	Clé d'application obtenue à l'étape précédente
Application secret	Secret d'application obtenu à l'étape précédente

Cliquez sur Enregistrer.

Écran de configuration de l'authentification API KIMSUFI avec les champs Application key et Application secret

Obtenir la Consumer Key

Après avoir enregistré l'Application Key et le Secret :

Cliquez sur le lien « Cliquez ici pour vous connecter et obtenir une consumer key ».
Vous êtes redirigé vers le site KIMSUFI pour autoriser l'accès.
Choisissez une validité Illimitée.
Validez l'autorisation.
Vous êtes automatiquement redirigé vers Dolibarr et la Consumer Key est enregistrée.

Le module demande les droits d'accès suivants sur l'API :

GET /me* : informations du compte et factures
GET /dedicated/server* : informations des serveurs dédiés
GET /ip* : informations réseau
GET /support/tickets* : tickets de support

Tester la connexion

Une fois la Consumer Key obtenue, cliquez sur Tester connexion aux API pour vérifier que tout fonctionne. Un message « Connexion ok! » confirme que l'authentification est opérationnelle.

Point d'accès API (endpoint)

Par défaut, le module utilise le point d'accès kimsufi-eu. Si vos services sont hébergés dans une autre région, vous pouvez modifier le point d'accès. Les valeurs possibles sont :

kimsufi-eu (Europe - par défaut)
kimsufi-ca (Canada)
ovh-eu (OVH Europe)
ovh-ca (OVH Canada)
soyoustart-eu (So You Start Europe)
soyoustart-ca (So You Start Canada)

Import des factures

Cet onglet configure les paramètres utilisés lors de l'import des factures KIMSUFI dans Dolibarr.

Écran de configuration de l'import des factures avec le choix du fournisseur et du compte bancaire

Fournisseur pour l'import

Paramètre obligatoire. Sélectionnez le tiers fournisseur sur lequel les factures KIMSUFI seront importées. Ce tiers doit avoir été créé au préalable dans Dolibarr (par exemple : « OVH » ou « KIMSUFI »).

Produit générique pour les lignes

Sélectionnez un produit ou service générique à utiliser pour les lignes des factures importées. Si vous laissez ce champ vide, les lignes seront créées en tant que lignes libres (texte libre) avec le libellé original de la facture KIMSUFI.

Compte bancaire par défaut

Si le module Banque est activé dans votre Dolibarr, vous pouvez sélectionner un compte bancaire par défaut. Ce compte sera utilisé pour enregistrer automatiquement les paiements des factures KIMSUFI déjà réglées.

Taux de TVA valides

Par défaut, le module accepte tous les taux de TVA présents sur les factures KIMSUFI. Si vous souhaitez restreindre les taux acceptés (par exemple pour ne garder que 20% et 0%), cochez les taux souhaités dans la liste.

Les taux disponibles sont ceux configurés dans Dolibarr pour le pays de votre société et celui du fournisseur sélectionné.