Configuration

La configuration du module se fait depuis Accueil > Configuration > Modules/Applications, en cliquant sur l'icône d'engrenage du module SoYouStart. Elle comporte trois onglets : Authentification, Import factures et À propos.

Authentification

Cet onglet permet de configurer la connexion à l'API OVH/SoYouStart. Vous devez créer une application API sur le portail OVH puis saisir les identifiants dans Dolibarr.

Créer une application API

Rendez-vous sur la page de création d'application indiquée dans l'écran de configuration (le lien est affiché automatiquement selon votre endpoint).
Remplissez le nom et la description de l'application.
Notez l'Application Key et l'Application Secret générés.

Saisir les identifiants

Remplissez les champs suivants :

Champ	Description
Application name	Nom de votre application API (pour référence)
Application key	Clé d'application fournie par OVH
Application secret	Secret d'application fourni par OVH
Consumer key	Clé consommateur (générée à l'étape suivante)

Écran de configuration de l'authentification API avec les champs application key, secret et consumer key

Obtenir la Consumer Key

Après avoir saisi l'Application Key et l'Application Secret, cliquez sur le lien affiché pour vous authentifier chez OVH.
Connectez-vous avec vos identifiants OVH/SoYouStart.
Choisissez une validité illimitée.
Validez les permissions demandées par le module :
- GET /me* -- Accès aux informations de facturation
- GET /dedicated/server* -- Informations sur les serveurs
- POST /dedicated/server*/features/ipmi/access -- Accès IPMI/KVM
- GET /ip* -- Informations IP
- GET /support* -- Tickets de support
Vous êtes redirigé vers Dolibarr et la Consumer Key est automatiquement enregistrée.

Tester la connexion

Cliquez sur Tester connexion aux API pour vérifier que les identifiants sont valides.

Import des factures

Cet onglet configure le comportement de l'import des factures SoYouStart dans Dolibarr.

Écran de configuration de l'import des factures avec les champs fournisseur, produit, banque et TVA

Fournisseur pour l'import

Sélectionnez le tiers fournisseur sur lequel les factures importées seront créées. Ce tiers doit exister au préalable dans votre base Dolibarr (par exemple, créez un fournisseur "SoYouStart" ou "OVH").

Produit/Service générique

Optionnel. Si vous souhaitez que les lignes de facture soient rattachées à un produit/service prédéfini, sélectionnez-le ici. Sinon, les lignes seront créées comme des lignes libres avec le libellé de la facture SoYouStart.

Compte bancaire par défaut

Sélectionnez le compte bancaire à utiliser pour les factures importées. Ce paramètre est indispensable pour le paiement automatique : lorsqu'une facture est marquée comme payée chez OVH, le module crée automatiquement le paiement et l'écriture bancaire sur ce compte.

Attention : Si aucun compte bancaire n'est configuré, les factures seront importées en brouillon sans paiement automatique.

Liste des taux de TVA valides

Sélectionnez les taux de TVA acceptés lors de l'import. Le module calcule le taux de TVA à partir des montants de la facture OVH et le rapproche du taux valide le plus proche dans cette liste.

Laissez ce champ vide pour accepter tous les taux de TVA (calcul automatique).

Permissions

N'oubliez pas d'attribuer les permissions du module aux utilisateurs concernés depuis Accueil > Utilisateurs & Groupes :

Import des factures -- Autorise l'accès à l'écran d'import
Administration des serveurs -- Autorise l'accès à la supervision des serveurs et aux tickets de support