> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.superhote.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# SuperConcierge — Intégration Pennylane — Guide utilisateur

L'intégration Pennylane de SuperConcierge vous permet d'envoyer vos factures de conciergerie directement dans votre compte Pennylane, en brouillon, prêtes à être finalisées. Ce guide explique comment la connecter et l'utiliser au quotidien.



## Ce que fait l'intégration

Une fois connectée, vous pouvez pousser n'importe quelle facture propriétaire de SuperConcierge vers Pennylane en un clic. La facture y arrive **en brouillon** : c'est ensuite Pennylane qui prend le relais pour la numérotation, la conformité (Factur-X) et la transmission officielle.

SuperConcierge ne fait qu'**envoyer** le brouillon. Il ne finalise jamais la facture à votre place, et ne modifie rien dans Pennylane au-delà de la création du brouillon.

> **Important : l'envoi est 100 % manuel.** Il n'y a aucune synchronisation automatique. Chaque facture que vous voulez retrouver dans Pennylane doit être envoyée manuellement, une par une.



## 1. Connecter votre compte Pennylane

La connexion se fait une seule fois, depuis la page **Intégrations**.

1. Récupérez votre **token API** dans Pennylane (clé d'accès avec le périmètre `customer_invoices`).
2. Dans SuperConcierge, ouvrez la page **Intégrations**.
3. Collez le token dans le champ Pennylane et validez.

SuperConcierge teste immédiatement le token auprès de Pennylane :

* **Token valide** → la connexion est enregistrée, l'intégration passe en « connecté ».
* **Token invalide** → un message « Token invalide » s'affiche et rien n'est enregistré.

### Sécurité de votre token

Votre token est traité avec soin :

* il est **chiffré** avant d'être stocké (chiffrement au repos) ;
* il est conservé dans un espace **verrouillé**, inaccessible depuis l'application publique — seules les fonctions serveur de SuperConcierge peuvent l'utiliser ;
* vous pouvez le **retirer à tout moment** depuis la page Intégrations (bouton de déconnexion), ce qui efface le token enregistré.



## 2. Envoyer une facture vers Pennylane

L'envoi se fait facture par facture, depuis le détail d'une facture propriétaire.

1. Ouvrez le **détail de la facture** du propriétaire concerné.
2. Cliquez sur **« Envoyer vers Pennylane »**.
   *(Ce bouton n'apparaît que si l'intégration Pennylane est connectée.)*
3. Un message de confirmation s'affiche avec l'identifiant du brouillon créé (ex. « Draft envoyé (ID : 12345) »).

La facture est maintenant visible **en brouillon** dans votre compte Pennylane.

### Ce qui est transmis automatiquement

Lors de l'envoi, SuperConcierge construit le brouillon pour vous :

* **Le propriétaire est créé comme client** dans Pennylane s'il n'existe pas encore (nom, email, adresse, pays).
* **Les produits / prestations sont créés** automatiquement si besoin.
* **Une ligne par poste et par hébergement** est générée — Commission, Ménage, Linge, Check-in, forfaits divers — nommée par hébergement (ex. « Commission – \<nom du logement\> »). Seuls les postes dont le montant est supérieur à 0 apparaissent.
* **Les ajustements et avoirs** sont repris en lignes négatives.
* Si aucun montant n'est à facturer sur les postes, une seule ligne récapitulative est créée : « Prestation conciergerie – MM/AAAA ».
* **La TVA** est mappée vers le bon code Pennylane selon le taux (20 %, 10 %, 5,5 %, 2,1 % ou 0 %).
* **Les dates** : date de facture au 1er du mois de la période, échéance à +30 jours.
* Une mention « Facture générée par SuperConcierge » est ajoutée.



## 3. Après l'envoi

Une fois le brouillon dans Pennylane, tout le reste se passe **dans Pennylane** :

* numérotation officielle de la facture,
* mise en conformité (Factur-X),
* transmission via la plateforme de dématérialisation.

Vous restez maître de la finalisation : tant que vous ne validez pas le brouillon dans Pennylane, rien n'est officiel.



## ⚠️ Point de vigilance important

**Évitez de cliquer deux fois sur « Envoyer vers Pennylane » pour la même facture.**

SuperConcierge ne garde pas en mémoire qu'une facture a déjà été envoyée : le bouton reste affiché même après un envoi réussi, et chaque clic crée un **nouveau brouillon**. Cliquer deux fois = **deux brouillons en doublon** pour la même facture dans Pennylane.

En pratique :

* envoyez chaque facture **une seule fois** ;
* si vous avez un doute, vérifiez d'abord dans Pennylane avant de recliquer ;
* en cas de doublon, supprimez le brouillon en trop directement dans Pennylane.



## Récapitulatif

| Étape | Où | Action |
| ---- |
| Connexion | Page Intégrations | Coller le token Pennylane (une fois) |
| Envoi | Détail d'une facture | Cliquer « Envoyer vers Pennylane » |
| Finalisation | Dans Pennylane | Valider le brouillon |
| Déconnexion | Page Intégrations | Retirer le token |

En cas de question sur un token refusé, une facture qui n'apparaît pas, ou un doublon, contactez le support SuperConcierge.