Références QR automatiques des factures : SCOR et QRR
SCOR et QRR déterminent comment une facture QR code l'affectation du paiement. Une référence propre permet à votre logiciel bancaire et comptable d'attribuer un paiement entrant de manière unique à une facture. Il ne remplace pas l'import CAMT, mais rend son affectation plus fiable.
Choisir SCOR ou QRR
| Type | Comportement technique | Configuration |
|---|---|---|
| SCOR | edoobox génère à partir de l'affectation de la facture une référence de créancier ISO-11649 avec chiffre de contrôle RF. | La structure QRR de 27 chiffres est inactive. |
| QRR | edoobox génère une référence QR suisse avec un total de 27 chiffres. | La structure doit comprendre exactement 27 positions et contenir une section pour InvoiceNumber. |
Le choix du type est immédiatement enregistré dans la V2 actuelle. Si vous avez effectué des modifications de structure QRR non enregistrées et que vous changez ensuite de type, l'éditeur réinitialise cette structure à l'état enregistré le plus récent.
L'IBAN et la référence vont de pair : Pour QRR, vous avez besoin d'une IBAN QR ; pour SCOR, d'une IBAN normale. N'utilisez pas la même valeur de compte non vérifiée pour les deux variantes. Harmonisez le type de compte, la devise et la référence avec votre banque et scannez une facture émise. Les directives actuelles sont publiées par SIX pour la facture QR.
Comprendre la structure standard QRR
L'éditeur V2 démarre avec quatre zones consécutives :
| Position | Contenu standard | Modifiable |
|---|---|---|
| 1 à 6 | Bloc réservé Customer ID | Position et longueur sont verrouillées ; valeur selon spécification bancaire. |
| 7 à 18 | Variable de remplacement InvoiceNumber | Oui, tant que la structure globale reste valide. |
| 19 à 26 | Valeur fixe, remplie par défaut avec des zéros | Oui. |
| 27 | Chiffre de contrôle | Non ; edoobox le calcule avec la procédure suisse Modulo-10. |
Pour le premier bloc, la génération côté serveur utilise l'identification client que vous recevez de votre banque. Dans PostFinance, cette valeur peut rester vide selon l'implémentation technique. Clarifiez la spécification concrète avec votre banque avant l'envoi en production.
Modifier la structure QRR
Activez la facture QR dans les paramètres de facturation et choisissez QRR.
Ouvrez Configuration Structure QRR.
Laissez le premier bloc en position 1 à 6 et le chiffre de contrôle en position 27.
Insérez des valeurs fixes ou des variables de remplacement de Rechnung.pdf entre les deux.
Assurez-vous qu'au moins une section InvoiceNumber est utilisée.
Vérifiez l'aperçu et n'enregistrez que lorsque la longueur est exactement de 27 caractères.
L’éditeur place les sections à la suite, sans intervalle. Une valeur fixe ne doit pas dépasser la longueur de sa section. L’API normalise les valeurs fixes et les références dynamiques sous forme numérique et les complète avec des zéros à gauche.
Planifier correctement le numéro de facture et l'alias
Le paramètre de facture général permet un alias d'au plus cinq caractères et un prochain numéro de facture d'au plus dix chiffres. Pour QRR, la valeur dynamique est traitée côté serveur comme un nombre. Les lettres et les séparateurs d'un alias représentatif ne sont donc pas des composants fiables de la référence de 27 chiffres.
Tester d'abord la série de numéros : Planifiez la structure QRR avec le numéro de facture le plus élevé attendu. Vérifiez non seulement la facture visible, mais aussi la référence de 27 chiffres réellement générée et la réconciliation CAMT.
Quand l'enregistrement est bloqué
Pour QRR, l'interface V2 empêche l'enregistrement si la longueur totale n'est pas de 27 ou s'il n'y a pas de section InvoiceNumber. Le traitement côté serveur vérifie en outre les longueurs minimales, les zones continues, le premier bloc verrouillé, le chiffre de contrôle libre et les valeurs fixes trop longues.
Pour SCOR, la structure QRR n'est pas pertinente pour la référence active. Une configuration de brouillon QRR erronée ne bloque donc pas le passage à SCOR ou l'enregistrement de SCOR.
Tester complètement la référence
Générez une nouvelle facture après chaque modification ; les PDF existants n'affichent pas automatiquement la nouvelle référence.
Pour QRR, comptez les 27 chiffres et vérifiez si le numéro de facture est reconnaissable dans la zone prévue.
Scannez le code QR et comparez le montant, le compte et la référence avec la facture.
Importez un jeu de données de test CAMT approprié et vérifiez l'attribution à la facture ouverte.
Testez le passage à la longueur de chiffres suivante, par exemple de 99999 à 100000.
Exemple d'application : QRR avec la structure standard
La banque confirme l'identification du client pour les positions 1 à 6. L'organisation laisse InvoiceNumber sur 7 à 18 et le bloc de zéros sur 19 à 26. Après l'enregistrement, elle génère une facture, vérifie les 27 chiffres et importe l'entrée de test CAMT correspondante.
Exemple d'application : valeur fixe interne avant le numéro de facture
La comptabilité a besoin d’un identifiant numérique de série de facturation à deux chiffres. L’équipe raccourcit les autres blocs modifiables afin que Customer ID, la valeur fixe, InvoiceNumber et le chiffre de contrôle totalisent toujours exactement 27 positions. Une facture utilisant un numéro proche de la limite supérieure prévue permet de tester les limites.
Exemple d'application : passage de QRR à SCOR
Après consultation avec la banque, SCOR doit être utilisé à l'avenir. L'équipe enregistre d'abord l'état actuel de QRR, passe ensuite à SCOR et crée une nouvelle facture. Elle contrôle la référence RF et adapte le processus d'attribution CAMT, sans réinterpréter a posteriori les anciennes factures QRR.
Distinguer l'aperçu de la référence réellement émise
L'aperçu coloré dans l'éditeur QRR utilise des données d'exemple. Il confirme la structure, mais ne remplace pas une facture de test émise avec votre numéro de facture réel. Après l'enregistrement, vérifiez la référence dans le nouveau PDF et lors du scan. Un changement ultérieur du type de référence n'invalide pas les factures déjà envoyées ; laissez leurs entrées de paiement être attribuées selon la référence d'origine.
En cas de message d'erreur, corrigez la structure concernée avant de créer une nouvelle facture. Un import CAMT avec la même référence erronée ne répare pas la configuration de référence.