FAQ

Comment créer mon application API KIMSUFI ?

Rendez-vous sur https://eu.api.kimsufi.com/createApp/ et connectez-vous avec vos identifiants KIMSUFI. Remplissez le nom et la description de votre application, puis notez l'Application Key et l'Application Secret générés. Reportez ces informations dans la configuration du module.

Le test de connexion échoue, que faire ?

Vérifiez les points suivants :

1. L'Application Key et l'Application Secret sont correctement saisis (sans espace en début ou fin).
2. La Consumer Key a bien été obtenue via le processus d'autorisation OAuth.
3. Lors de l'autorisation, vous avez bien choisi une validité Illimitée.
4. Le point d'accès API (endpoint) correspond à votre type de compte (kimsufi-eu pour KIMSUFI Europe, ovh-eu pour OVH Europe, etc.).

Si le problème persiste, relancez la procédure d'obtention de la Consumer Key en cliquant sur le lien correspondant dans l'onglet Authentification.

Puis-je utiliser ce module avec un compte OVH ou So You Start ?

Oui. Le module supporte plusieurs points d'accès API :

• kimsufi-eu et kimsufi-ca pour les comptes KIMSUFI
• ovh-eu et ovh-ca pour les comptes OVH
• soyoustart-eu et soyoustart-ca pour les comptes So You Start

Modifiez le point d'accès dans la configuration du module et adaptez l'URL de création d'application en conséquence (par exemple https://eu.api.ovh.com/createApp/ pour OVH Europe).

Pourquoi certaines factures sont marquées « Facture trouvée dans Dolibarr » ?

Le module détecte automatiquement les factures KIMSUFI déjà importées en se basant sur la référence. Ces factures ne peuvent pas être importées une seconde fois. Le lien affiché vous permet d'accéder directement à la facture existante dans Dolibarr.

Le PDF de la facture n'a pas été téléchargé, est-ce normal ?

Dans de rares cas, le PDF peut ne pas être disponible immédiatement sur l'API KIMSUFI. Réessayez l'import ultérieurement. Si le problème persiste, vérifiez que la facture est bien accessible depuis votre espace client KIMSUFI.

Comment fonctionne l'enregistrement automatique des paiements ?

Lors de l'import, si une facture est marquée comme payée chez KIMSUFI (statut « PAID »), le module :

1. Crée la facture fournisseur dans Dolibarr.
2. Récupère le mode de paiement utilisé chez KIMSUFI (carte bancaire, virement, etc.).
3. Le convertit en mode de paiement Dolibarr équivalent.
4. Enregistre le paiement sur le compte bancaire par défaut configuré dans les paramètres d'import.

Si aucun compte bancaire par défaut n'est configuré, la facture est importée mais le paiement n'est pas enregistré automatiquement.

Les taux de TVA des factures importées sont incorrects, que faire ?

Vous pouvez restreindre les taux de TVA acceptés lors de l'import en configurant la liste des taux de TVA valides dans l'onglet de configuration de l'import. Seuls les taux cochés seront utilisés. Si un taux présent sur la facture KIMSUFI ne fait pas partie de la liste, il sera ajusté automatiquement.

La création de snapshot augmente-t-elle ma facture KIMSUFI ?

Oui. La création de snapshots sur les instances Public Cloud entraîne une facturation supplémentaire sur votre compte KIMSUFI/OVH. Le coût dépend de la taille du snapshot et de la durée de conservation. Consultez les tarifs sur votre espace client KIMSUFI avant de créer un snapshot.

Quelles permissions dois-je attribuer à mes utilisateurs ?

Le module propose deux permissions :

• Import Invoice : pour les utilisateurs qui doivent importer les factures (typiquement la comptabilité).
• Administration of KIMSUFI servers : pour les utilisateurs qui supervisent l'infrastructure (typiquement les administrateurs système).

Configurez ces permissions dans Accueil > Configuration > Utilisateurs > Permissions.