> ## Documentation Index
> Fetch the complete documentation index at: https://help.firby.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter Evoliz

> Relier votre compte Evoliz à Firby avec une clé publique et une clé secrète.

Evoliz reçoit les brouillons validés et les transforme en factures conformes. La
connexion se fait avec une **clé publique** et une **clé secrète**, générées
depuis votre compte Evoliz.

## Obtenir vos clés API

1. Connectez-vous à Evoliz avec le compte de l’entreprise qui facture vos
   propriétaires.
2. Ouvrez la section **Applications**.
3. Dans **Connecteurs disponibles**, activez le connecteur **Evoliz API**.
4. Cliquez sur **Créer une clé API** : Evoliz affiche votre clé publique et
   votre clé secrète.
5. Copiez les deux clés. La **clé secrète n’est affichée qu’une seule fois** —
   si vous la perdez, il faut la régénérer.

## Connecter dans Firby

1. Ouvrez **Connexions → Outil de facturation** et choisissez **Evoliz**.
2. Collez la **clé publique** et la **clé secrète**.
3. Validez : Firby vérifie l’accès à votre dossier.

## Bon à savoir

* Les factures arrivent en **brouillon** dans Evoliz. Le numéro définitif n’est
  attribué qu’au moment où vous **enregistrez** la facture dans Evoliz : tant
  qu’elle est en brouillon, elle reste modifiable et supprimable.
* **Vérifiez vos taux de TVA avant le premier envoi.** Evoliz n’accepte que les
  taux configurés dans votre dossier (**Paramètres → TVA**). Si une de vos
  règles utilise un taux absent — par exemple 8,5 % en outre-mer — l’envoi
  échoue et Firby vous indique les taux disponibles. Ajoutez le taux manquant
  dans Evoliz, puis relancez l’envoi.
* Les lignes exonérées ou en débours (0 %) sont envoyées **sans TVA**, sans
  réglage de votre part.
* Un avoir ou un geste commercial apparaît dans Evoliz en **quantité négative**
  (par exemple −1 × 40 €) : c’est la façon dont Evoliz représente une déduction,
  le total de la facture est identique.
* Un propriétaire **particulier** ne demande que son nom et son adresse. Un
  propriétaire **professionnel** doit avoir un numéro de TVA intracommunautaire :
  Firby le calcule à partir du SIREN renseigné sur sa fiche.
* L’adresse e-mail d’un propriétaire est enregistrée dans Evoliz comme
  **contact** du client, la fiche client elle-même n’en portant pas.
* Le jeton d’accès Evoliz est valable 20 minutes ; Firby le renouvelle tout
  seul, vous n’avez rien à faire.
* Une clé régénérée ou révoquée fait échouer l’envoi (statut **Erreur**) :
  reconnectez avec les nouvelles clés.