Le service de facturation
Mis à jour le 2026-08-29
Ce chapitre ne s’adresse pas à un salon de coiffure. Il décrit l’écran Service de facturation du panneau plateforme : l’intégration avec le service qui émet les factures de HairConnect à ses salons.
Ce que fait le service et ce que nous faisons
HairConnect n’émet pas lui-même ses factures de plateforme. Cela se fait auprès d’un service externe, qui prend quatre choses en charge :
- le numéro de facture que le client voit sur son document ;
- le PDF et l’UBL de ce document ;
- le régime de TVA — taux belge, autoliquidation intracommunautaire ou exportation — sur la base du pays et du numéro de TVA du salon ;
- les montants de TVA qui en découlent.
Nous conservons localement : quel salon, quelle période, quelles lignes, quel montant hors TVA, et notre propre référence.
Notre référence n’est pas un numéro de facture
Dans la liste figure soit le vrai numéro de facture, soit ref. 2026-0001. Ce second est notre référence : un comptage continu et sans trou par exercice, que nous transmettons. Le service y reconnaît une demande qui arrive deux fois, et nous y rattachons un document émis à la bonne période.
Le préfixe ref. est là à dessein. Sans lui, 2026-0001 se lit comme un numéro de facture, et ce n’en est pas un.
Configurer la clé
La clé API ne se trouve pas dans un fichier de configuration sur le serveur mais sur cet écran. Cela évite un déploiement à chaque modification, et cela rend visible à l’écran s’il y a bien une clé.
Ce que vous remplissez :
| Champ | Ce qui doit y figurer |
|---|---|
| Intégration active | Active l’intégration. Sans clé, elle reste inactive, même si ceci est activé. |
| Adresse du service | L’URL de base avec le préfixe de l’API, se terminant donc par /api/v1. |
| Chemin pour une nouvelle facture | Où une facture est créée, relatif à l’adresse ci-dessus. Sous forme de réglage, afin de pouvoir être corrigé sans déploiement. |
| Nouvelle clé | Collez la clé ici. |
La clé est conservée chiffrée et ne réapparaît jamais à l’écran — pas même pour vous. Ce que vous revoyez, c’est qu’il y a une clé, ses quatre derniers caractères, et la date à laquelle elle a été posée.
Le champ est donc vide à l’ouverture de la page, même s’il y a bel et bien une clé. Ce n’est pas une erreur : laisser vide signifie « ne touchez pas à ce qui est là ». Qui a collé une mauvaise clé colle simplement la bonne par-dessus.
Les bonnes valeurs
Une installation neuve est correcte d’emblée. Pour vérifier à la main :
| Champ | Valeur |
|---|---|
| Adresse du service | https://invoice.fades-management.com/api/v1 |
| Chemin pour une nouvelle facture | /invoices |
Le piège. Si vous omettez /api/v1 dans l’adresse, Tester la connexion aboutit sur le site web au lieu de l’API, et le service répond 404 — The route me could not be found. Ce message désigne le chemin alors que c’est l’adresse qui cloche. Si vous mettez le préfixe deux fois — une fois dans l’adresse et une fois dans le chemin — cela donne /api/v1/api/invoices et vous obtenez la même 404 à l’envoi d’une facture.
Tester la connexion
Le bouton Tester la connexion en haut à droite appelle GET /me auprès du service et montre ce qui revient. C’est le moyen le plus rapide de voir si la clé est correcte avant qu’une facture ne passe.
Que se passe-t-il si le service est injoignable
Rien de votre propre administration n’est perdu. L’intégration fonctionne en meilleur effort :
- la facture est simplement enregistrée localement, avec ses lignes et sa référence ;
- rien n’est annulé et rien n’est bloqué ;
- la raison figure auprès de la facture dans la liste (« niet uitgegeven — … ») et dans le journal ;
- le bouton Renvoyer propose à nouveau la facture.
Ce bouton peut être utilisé deux fois sans risque : la facture garde sa référence, et dès qu’un numéro de facture existe, plus rien ne se passe. Il n’y a donc jamais un deuxième document pour la même période.
Tant que la TVA n’est pas connue, les colonnes TVA et TTC affichent un tiret. Ce n’est délibérément pas un zéro : zéro prétendrait qu’il n’y a pas de TVA, et nous n’en savons rien.
Ce qui bloque bel et bien
Les données de facturation du salon. Sans nom, adresse, pays et numéro de TVA, le service ne peut pas déterminer le régime de TVA applicable, et il devrait deviner. Une facture avec le mauvais régime est une erreur fiscale chez deux parties à la fois.
S’il manque quelque chose, Enregistrer refuse avec un message indiquant le champ. Complétez-le auprès du salon lui-même.
Ce qui reste à vérifier
Les adresses sont correctes : GET /me a été mesuré et renvoie une réponse valable. Deux choses ne sont pas encore vérifiées :
- la forme exacte de la réponse à une facture créée ;
- la forme de ce que nous envoyons — les noms de champs des données client et de la référence.
La réponse est donc lue avec tolérance : plusieurs noms de champs plausibles sont essayés, et une éventuelle enveloppe data est retirée. Si une réponse arrive sans numéro de facture, rien n’est inventé — la facture reste en place avec le message indiquant que le format de réponse doit être contrôlé.
Vérifiez cela sur le serveur avant la première vraie facture, puis ramenez ce code à la forme réellement utilisée par le service.