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

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

Mis à jour le : 30/05/2026