---
title: "Configuration"
weight: 20
description: "Paramétrage de l'authentification API et des options d'import des factures."
---

# 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

1. 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).
2. Remplissez le nom et la description de l'application.
3. 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](screenshots/configuration-authentification.webp)

### Obtenir la Consumer Key

1. Après avoir saisi l'Application Key et l'Application Secret, cliquez sur le lien affiché pour vous authentifier chez OVH.
2. Connectez-vous avec vos identifiants OVH/SoYouStart.
3. Choisissez une validité **illimitée**.
4. 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
5. 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](screenshots/configuration-import-factures.webp)

### 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