Spécification technique pour les éditeurs de logiciels de caisse et les développeurs qui souhaitent lire un QR code QR-Facture afin de pré-remplir une facture. Intégration gratuite et ouverte.
Le QR code QR-Facture encode, sous forme d'une chaîne JSON en UTF-8, les coordonnées légales de facturation d'une entreprise. Un lecteur (caisse, application) scanne le QR, récupère la chaîne, la parse en JSON et mappe les champs vers sa facture. Aucune donnée n'est stockée sur un serveur : tout est contenu dans le QR. Niveau de correction d'erreur : M.
| Clé | Description | Exemple | Présence |
|---|---|---|---|
entreprise | Raison sociale | MEDIA TECHNOLOGIES | requis |
siren | SIREN (9 chiffres) | 484804786 | requis |
siret | SIRET du siège (14 chiffres) | 48480478600024 | requis |
tva | N° TVA intracommunautaire | FR56484804786 | requis |
adresse | Voie (numéro + libellé) | 9 rue Georges Enesco | requis |
cp | Code postal | 94000 | requis |
ville | Commune | Créteil | requis |
pays | Pays | France | requis |
email | Email de facturation | info@exemple.fr | optionnel |
tel | Téléphone | 01 75 43 05 05 | optionnel |
service | Service / département | Comptabilité | optionnel |
""), pour rester compatible avec les versions futures.Contenu brut encodé dans le QR (chaîne JSON) :
{ "entreprise": "MEDIA TECHNOLOGIES", "siren": "484804786", "siret": "48480478600024", "tva": "FR56484804786", "adresse": "9 rue Georges Enesco", "cp": "94000", "ville": "Créteil", "pays": "France", "email": "info@exemple.fr", "tel": "", "service": "" }
Après décodage du QR par votre lecteur, le contenu texte se parse directement :
const data = JSON.parse(qrTextContent); const facture = { raisonSociale: data.entreprise, siren: data.siren, siret: data.siret, tvaIntra: data.tva, adresse: `${data.adresse}, ${data.cp} ${data.ville}`, email: data.email || "" };
try / catch autour du JSON.parse : un QR scanné qui n'est pas au format QR-Facture ne doit pas faire planter la caisse.La version 1 documente le format actuel. Sont à l'étude, sans rupture de compatibilité : un alignement des champs avec les standards de la facturation électronique (EN 16931 / Factur-X) ; un numéro de version explicite dans la charge utile ; des extensions liées au paiement B2B.
Vous éditez un logiciel de caisse et souhaitez intégrer la lecture du QR-Facture ? L'intégration est gratuite et ouverte. Écrivez-nous : contact@allo-carte.fr.