Obtenir vos clés API
- Connectez-vous à Evoliz avec le compte de l’entreprise qui facture vos propriétaires.
- Ouvrez la section Applications.
- Dans Connecteurs disponibles, activez le connecteur Evoliz API.
- Cliquez sur Créer une clé API : Evoliz affiche votre clé publique et votre clé secrète.
- 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
- Ouvrez Connexions → Outil de facturation et choisissez Evoliz.
- Collez la clé publique et la clé secrète.
- 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.