QR-facture : les quatre erreurs qui font rejeter un paiement

Une QR-facture est lue par une machine, qui applique une spécification. Les Swiss Implementation Guidelines publiées par SIX décrivent, champ par champ, ce qui est admis. Quand une donnée sort de ce cadre, le fichier n'est pas « presque bon » : il est non conforme. Les règles ont changé en novembre 2025 avec la version 2.3, et la version 2.4 entre en vigueur le 14 novembre 2026.

Voici quatre non-conformités que le générateur d'AdminCH contrôle avant d'écrire quoi que ce soit. Chacune est traçable à une règle de la spécification, référencée dans le fichier des sources livré avec le pack.

1. L'adresse de type combiné, abandonnée

Le symptôme : la facture est produite par un modèle qui fonctionnait avant, et plus rien n'indique un problème à l'écran.

La cause : depuis la version 2.3 de la spécification, en vigueur depuis le 21 novembre 2025, seule l'adresse structurée est admise. Rue, numéro, numéro postal, localité et pays occupent des champs distincts. Le type combiné, qui laissait deux lignes d'adresse libres, est supprimé. Les modèles antérieurs le produisent encore.

Ce que fait AdminCH : le générateur n'offre pas d'autre choix. L'adresse est un objet à champs séparés et le payload émet toujours le marqueur d'adresse structurée ; les champs obligatoires et le code pays à deux lettres sont contrôlés avant l'écriture.

2. La référence qui ne va pas avec l'IBAN

Le symptôme : la facture est refusée à la lecture, ou le paiement reçu ne se rapproche d'aucune facture.

La cause : le type de référence dépend du compte. Un QR-IBAN — reconnaissable à son QR-IID, les chiffres 5 à 9 compris entre 30000 et 31999 — impose une référence QR. Un IBAN classique admet une Creditor Reference ISO 11649 ou aucune référence, jamais une référence QR. Toute autre combinaison est invalide selon la spécification.

Ce que fait AdminCH : la combinaison est vérifiée dans les deux sens, et le message nomme le conflit exact — par exemple qu'une référence QR exige un QR-IBAN. Rien n'est écrit tant que le conflit subsiste, et rien n'est arbitré à votre place : le pack ne devine pas quel compte vous vouliez utiliser.

3. La clé de contrôle de la référence

Le symptôme : une référence recopiée à la main, ou reprise d'un ancien numéro de bulletin, qui a la bonne allure mais n'est pas acceptée.

La cause : une référence QR fait 27 chiffres dont le dernier est une clé calculée par un modulo 10 récursif décrit en annexe de la spécification. Une Creditor Reference suit la norme ISO 11649 : préfixe RF et clé modulo 97-10. Un chiffre inversé change la clé.

Ce que fait AdminCH : les deux clés sont recalculées et comparées. Le pack construit aussi la référence à partir de votre numéro interne, et rejoue les vecteurs de test publiés dans la spécification.

4. Le jeu de caractères et les longueurs

Le symptôme : un tiret long copié depuis un traitement de texte, ou un message un peu long : à la relecture humaine, rien ne cloche.

La cause : le Swiss QR Code n'admet qu'un jeu de caractères défini. Chaque champ a sa longueur maximale, et surtout le message libre et les informations de facture structurées partagent une limite commune de 140 caractères — pas 140 chacun.

Ce que fait AdminCH : les caractères hors jeu admis sont listés un par un, avec le champ concerné ; les longueurs de champ, la limite commune de 140 caractères et la taille totale du payload sont vérifiées.

Ce qu'AdminCH ne fait pas

Il n'imprime pas la facture complète : il produit le QR code aux bonnes dimensions et le récapitulatif des valeurs mises en forme. L'insertion dans votre modèle, avec le récépissé et la section paiement, reste de votre côté.
Il ne remplace pas un conseil fiscal : c'est un outil de calcul et un référentiel documentaire, pas une fiduciaire ni une administration.
Il ne se met pas à jour : aucune connexion réseau, aucun abonnement, aucun support. L'édition 2026 est livrée telle quelle.
Il ne corrige rien en silence : quand une donnée est non conforme, elle est énumérée et rien n'est écrit.

Prix

290 CHF, un seul paiement, licence perpétuelle avec usage commercial autorisé. Le pack comprend les programmes, les référentiels de données, le guide écrit, les quatre skills pour Claude Code et le fichier des sources daté. Remboursement sous 14 jours.

AdminCH est développé par Olivier, à Neuchâtel, en Suisse, avec l'aide d'une intelligence artificielle pour l'écriture du code et de la documentation. Pour une question, écrivez-nous : nous répondons sous 2 jours ouvrables.