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

> Relier votre compte Sinao à Firby avec une clé API et le numéro d’application.

Sinao reçoit les brouillons validés et les transforme en factures conformes. La
connexion se fait avec une **clé API** Sinao et le **numéro d’application** (le
dossier d’entreprise auquel la clé est liée).

## Obtenir votre clé API

1. Dans Sinao, ouvrez le dossier de l’entreprise qui facture vos propriétaires.
2. Ouvrez **Paramètres → Connexions API**, puis cliquez sur **Créer une clé
   API** (action réservée à l’administrateur du dossier).
3. Copiez la clé.
4. Notez aussi le **numéro d’application** : c’est le numéro du dossier,
   visible dans l’adresse de l’application Sinao une fois connecté.

## Connecter dans Firby

1. Ouvrez **Connexions → Outil de facturation** et choisissez **Sinao**.
2. Collez la **clé API** et renseignez le **numéro d’application**.
3. Validez : Firby vérifie l’accès au dossier.

## Bon à savoir

* La clé API Sinao est liée à un seul dossier d’entreprise et n’expire pas :
  créez-la bien depuis le dossier qui émet les factures. Si Firby indique que
  la clé est liée à une autre application, vérifiez le numéro saisi.
* Firby retrouve vos clients Sinao — entreprises comme particuliers — pour les
  rapprocher de vos propriétaires ; les fiches entreprises créées par Firby sont
  complétées automatiquement par Sinao à partir du SIREN (données INSEE).
* Les factures restent en **brouillon** dans Sinao : la numérotation n’est
  attribuée qu’à la finalisation, que vous déclenchez dans Sinao.
* Une clé révoquée fait échouer l’envoi (statut **Erreur**) : reconnectez avec
  une nouvelle clé.