Factures QR passage à des adresses structurées

Dans cet article

À partir du 21 novembre 2025, les informations d'adresse pour les factures QR devront être fournies sous forme structurée. En l'absence d'une adresse structurée, le paiement ne pourra pas être effectué.

En prévision de ces changements :

  • Une nouvelle version de Banana Comptabilité+ a été publiée avec des mises à jour spécifiques pour gérer les adresses structurées.
  • Les extensions d'impression des factures avec bulletin QR ont été publiées en version Bêta.
    Les versions stables seront également mises à jour ultérieurement.
  • Les modifications requises de la part de l'utilisateur sont minimes : il suffit de mettre à jour vers Banana Comptabilité+ (version 10.2.2) et d'installer les extensions correspondantes pour l'impression des factures avec bulletins QR.

Modifications et mises à jour dans Banana Comptabilité Plus

La version Banana Comptabilité+ (version 10.2.2) comprend les changements suivants :

L'utilisation du champ Numéro de Rue est facultative. Il est toujours possible d'insérer la rue et le numéro dans la même ligne de l'adresse, en laissant le nouveau champ numéro de rue vide.

Ceux qui utilisent la colonne Extra (nom XML : AddressExtra) pour insérer le numéro devront déplacer celui-ci dans la nouvelle colonne. La colonne Extra ne pourra plus être utilisée pour insérer le numéro de rue.

Il est recommandé de vérifier attentivement les premières impressions pour s'assurer de l'affichage correct de l'adresse, aussi bien dans l'en-tête que dans le code QR.

Modifications et mises à jour dans les extensions

Pour prendre en charge les adresses structurées, de nouvelles versions bêta des extensions ont été publiées. Elles doivent être installées et utilisées à la place des versions actuelles.

Les extensions sont les suivantes :

Pour installer la version Bêta d'une extension :

  • Menu Extensions > Gérer extensions.
  • Sélectionner dans le menu de gauche Installé.
  • Rechercher l'extension (parmi celles indiquées ci-dessus) et la sélectionner.
  • Choisir Version Bêta comme canal préféré (au lieu de Version Stable)
    Vous pouvez changer de canal à tout moment, de la version Bêta à la version Stable et vice versa.
  • Cliquer sur le bouton Fermer.

Les modifications apportées concernent uniquement l'impression et la composition de l'adresse structurée. Les lignes de l'adresse structurée dans le QR sont composées comme suit :

  • Ligne 1 : nom de l'entreprise ou nom et prénom du client
    • obligatoire, maximum 70 caractères
  • Ligne 2 : rue / case postale
    • facultatif, maximum 70 caractères
    • peut inclure le numéro si non indiqué à la ligne 3
  • Ligne 3 : numéro de rue
    • facultatif, maximum 16 caractères
    • si non indiqué à la ligne 2
  • Ligne 4 : code postal
    • facultatif, maximum 16 caractères
  • Ligne 5 : ville
    • obligatoire, maximum 35 caractères
  • Ligne 6 : code pays
    • obligatoire, maximum deux caractères
    • conforme à la norme ISO 3166-1

Comment insérer les adresses dans les tableaux Comptes et Contacts

Le numéro de rue peut être inséré soit dans la colonne Rue, soit dans la colonne Numéro de Rue. Les deux options sont correctes.

La colonne Rue accepte tout caractère jusqu'à un maximum de 70 caractères :

 

La colonne Numéro de Rue accepte tout caractère jusqu'à un maximum de 16 caractères :

 

 

Mise à jour des extensions personnalisées de mise en page de facture CH10

Si vous utilisez une extension personnalisée, comme par exemple l'extension de mise en page de facture CH10 que vous avez modifiée pour l'impression des factures, vous devez vérifier si l'impression des adresses dans le QR est de type structuré (S).

Étant donné qu’il s’agit d’une extension personnalisée, Banana ne peut pas accéder au code ni le modifier automatiquement ; par conséquent, il ne peut pas garantir le bon fonctionnement pour l’impression des adresses structurées.

Pour vérifier si l'impression des adresses dans le QR est de type structuré (S) :

  • Affichez la fenêtre d'impression des factures.
  • Sélectionnez votre mise en page personnalisée et cliquez sur Paramètres.
  • Cochez l'option Afficher JSON facture (en bas) et confirmez avec OK.
  • Cliquez sur OK pour imprimer la facture.
  • Avant l’impression de la facture, une fenêtre s’affiche avec les données JSON de la facture. Faites défiler vers le bas jusqu’à la section QR Code text et vérifiez que deux "S" apparaissent avant les deux adresses.
  • Si deux "S" apparaissent, cela signifie que les adresses sont déjà de type structuré et qu'aucune modification n’est nécessaire.
  • Si une ou deux "K" apparaissent, cela signifie qu'une ou les deux adresses sont de type combiné et doivent être modifiées. Dans ce cas, vous avez deux possibilités :
    1. Modifier les paramètres de votre mise en page personnalisée comme suit :
      • Dans la section Code QR > Payable à : cochez le champ et saisissez les informations de l’adresse dans les champs suivants (Nom, Rue, Numéro, Code postal, Localité, Code pays).
      • Dans la section Code QR > Type d’adresse client : sélectionnez le type "S" (Structuré).
      • Dans le tableau Comptes/Contacts, entrez le numéro dans la colonne Rue (rue et numéro dans la même colonne) ou séparément dans la colonne Adresse Extra.
      • Important : la colonne Extra doit être utilisée uniquement pour le numéro, et non pour d'autres informations.
    2. Recompiler l’extension personnalisée :
      • Ouvrez le lien du nouveau code swissqrcode.js
      • Enregistrez la page affichée avec le nom exact swissqrcode.js.
      • Remplacez le fichier swissqrcode.js de l'ancienne extension par celui que vous venez de télécharger.
      • Recompilez le paquet .sbaa de l'extension personnalisée.
      • Désinstallez l’ancienne extension et réinstallez la nouvelle.

Si vous souhaitez utiliser la nouvelle colonne Numéro et/ou la colonne Extra pour saisir d'autres informations, vous devez mettre à jour l’extension personnalisée : téléchargez le nouveau code de l’extension CH10 disponible en ligne et adaptez-le à vos besoins.

Tester le code QR

Les PDF de factures avec codes QR peuvent être testés avec le site officiel de validation, comme décrit ci-dessous :

Si le code est correct, la page affiche le contenu du code QR. En revanche, en cas de problème, celui-ci s'affiche en rouge.
Si aucun message rouge ne s'affiche, le QR est considéré comme correct.

Schéma des adresses pour factures QR Suisse

Adresse structurée :

<Cdtr>
    <AdrTp>S</AdrTp>
    <Name>Banana.ch SA</Name>
    <StrtNmOrAdrLine1>Via la Santa</StrtNmOrAdrLine1>
    <BldgNbOrAdrLine2>7</BldgNbOrAdrLine2>
    <PstCd>6962</PstCd>
    <TwnNm>Viganello</TwnNm>
    <Ctry>CH</Ctry>
</Cdtr>

Adresse structurée avec « tolérance » :

<Cdtr>
    <AdrTp>S</AdrTp>
    <Name>Banana.ch SA</Name>
    <StrtNmOrAdrLine1>Via la Santa 7</StrtNmOrAdrLine1>
    <PstCd>6962</PstCd>
    <TwnNm>Viganello</TwnNm>
    <Ctry>CH</Ctry>
</Cdtr>

Remarques :

  • Adresse structurée
    • Aucune combinaison avec l'élément "AdrLine" n'est autorisée.
  • Adresse structurée avec « tolérance »
    • Le numéro de rue peut également apparaître dans l'élément "StrtNm" au lieu de l'élément "BldgNb".

 

Relevés de compte bancaire CAMT

L'extension Relevé bancaire Camt ISO 20022 Suisse (Banana+)  utilise déjà le nouveau format CAMT ISO 20022 V2019, qui prévoit déjà ces modifications.

Ordres de paiement pain.001

À partir du 21 novembre 2026, seules les adresses structurées seront prises en charge.

  • L'extension Extension Ordres de paiement [BETA] prend déjà en charge le nouveau format ISO 20022-version 2019 (pain.001.001.09.ch.03), qui cependant ne prévoit pas encore de données structurées d’adresse.
  • Pour répondre aux nouvelles exigences, la nouvelle version SPS 2025 sera intégrée dans les mois à venir, disponible à partir de novembre 2025, ce qui permettra la transmission des ordres de paiement avec des adresses structurées.

Schéma des adresses de paiement

Adresse structurée :

Suisse SIX

Europe EPC

<Cdtr>
   <Nm>Banana.ch SA</Nm>
   <PstlAdr>
       <StrtNm>Via la Santa</StrtNm>
       <BldgNb>7</BldgNb>
       <PstCd>6962</PstCd>
       <TwnNm>Viganello</TwnNm>
       <Ctry>CH</Ctry>
   </PstlAdr>
</Cdtr>
 
<Dbtr>
   <Nm>Banana.ch SA</Nm>
   <PstlAdr>
       <StrtNm>Via la Santa</StrtNm>
       <BldgNb>7</BldgNb>
       <BldgNm></BldgNm>
       <PstlCd>6962</PstlCd>
       <TwnNm>Viganello</TwnNm>
       <Ctry>CH</Ctry>
   </PstlAdr>
</Dbtr>

Adresse hybride :

Suisse SIX

Europe EPC

<Cdtr>
   <Nm>Banana.ch SA</Nm>
   <PstlAdr>
       <AdrLine>Via la Santa 7</AdrLine>
       <PstCd>6962</PstCd>
       <TwnNm>Viganello</TwnNm>
       <Ctry>CH</Ctry>
   </PstlAdr>
</Cdtr>
<Dbtr>
   <Nm>Banana.ch SA</Nm>
   <PstlAdr>
       <AdrLine>Via la Santa 7</StrtNm>
       <PstlCd>6962</PstlCd>
       <TwnNm>Viganello</TwnNm>
       <Ctry>CH</Ctry>
   </PstlAdr>
</Dbtr>

Ressources

Comment pouvons-nous mieux vous aider ?

Dites-nous quel sujet nous devrions développer ou ajouter pour rendre cette page plus utile.

Envoyez-nous vos commentaires

Partager cet article: Twitter | Facebook | LinkedIn | Email