Facturation électronique

Snipcart peut générer des factures électroniques conformes à la norme EN 16931 au format hybride Factur-X / ZUGFeRD : un fichier PDF/A-3b qui est à la fois une facture lisible par l'humain et une facture lisible par la machine, grâce à une version XML structurée de la facture (CII) intégrée dans le PDF. Un seul fichier satisfait à la fois la norme française Factur-X et la norme allemande ZUGFeRD (EN 16931 / profil Comfort).

Une fois la fonctionnalité activée, la facture électronique de chaque commande payée est jointe au courriel de confirmation de commande et peut être récupérée via l'API REST — aucun changement à votre boutique n'est requis.

Activer la facturation électronique

Dans le tableau de bord du marchand, allez dans Store settings → Orders & invoices → E-invoicing et appuyez sur le bouton Configure.

Avant de pouvoir activer la facturation électronique, votre numéro de TVA et l'adresse complète de votre entreprise (adresse, ville, code postal et pays) doivent être remplis dans les informations d'entreprise de votre compte. Le commutateur Enable e-invoicing reste désactivé tant qu'ils ne le sont pas — une facture électronique sans vendeur pleinement identifié ne serait pas conforme.

La facturation électronique se configure par environnement (Test / Live). Nous recommandons de l'activer d'abord en Test pour valider votre configuration, puis en Live. Consultez Environnements Test/Live pour plus de détails sur les environnements.

Options de configuration

Zero-rate untaxed items

Désactivée par défaut. Lorsque des parties d'une commande — articles ou livraison — ne sont couvertes par aucun taux de taxe, cette option les émet sur la facture électronique sous la catégorie de TVA Z (taux zéro, 0 %).

Lorsque l'option est désactivée, aucune facture électronique n'est générée pour de telles commandes : sans traitement de TVA pour chaque ligne, une facture légalement complète ne peut pas être produite. Activez cette option, ou assurez-vous que chaque produit et frais de livraison est couvert par un taux de taxe.

Buyer VAT number custom field

Optionnel. Le nom d'un champ personnalisé de commande où vos clients d'affaires peuvent saisir leur numéro de TVA lors du paiement.

Lorsque le champ est présent sur une commande et que sa valeur a la forme d'un identifiant de TVA valide (un préfixe de pays suivi de chiffres — les espaces, points et tirets sont tolérés et normalisés), il est inclus sur la facture électronique comme numéro de TVA de l'acheteur. Les valeurs mal formées sont silencieusement omises; elles ne bloquent jamais la génération de la facture.

Test invoice

Le bouton Download a test invoice génère un exemple de facture électronique à partir d'une commande fictive, en utilisant votre vrai modèle de facture et vos vraies informations d'entreprise. Utilisez-le pour valider votre configuration et l'apparence du PDF sans passer de commande. Il fonctionne même avant l'activation de la facturation électronique, tant que vos informations d'entreprise sont complètes.

Fonctionnement

Une fois la facturation électronique activée :

Chaque commande payée — y compris les commandes récurrentes d'abonnement — génère sa facture électronique automatiquement en arrière-plan, peu après le paiement. La génération ne retarde et ne bloque jamais la commande ni votre client.
Le PDF est joint au courriel de confirmation de commande envoyé au client.
La facture électronique est générée une seule fois et est immuable par la suite.
La ventilation de TVA de la facture électronique est déterminée par la catégorie de TVA et le motif d'exonération de vos taux de taxe — consultez Taxes pour plus de détails.

Non couvert dans cette version : les commandes payées en paiement différé et les notes de crédit pour les remboursements.

Récupérer les factures électroniques avec l'API

La facture électronique d'une commande peut être récupérée via l'API REST :

Resource URL

GET https://app.snipcart.com/api/v3/orders/{token}/invoice

La requête doit être authentifiée avec votre clé d'API secrète — consultez Authentification. Le point de terminaison retourne le fichier PDF (200), ou 404 tant qu'aucune facture électronique n'existe pour la commande — parce qu'elle n'a pas encore été générée, que la facturation électronique est désactivée ou que la génération a échoué. Les intégrations peuvent simplement interroger le point de terminaison jusqu'à ce qu'il retourne 200.

Exemple de requête

curl -H "Accept: application/pdf" \
  "https://app.snipcart.com/api/v3/orders/{token}/invoice" \
  -u {API_KEY}: \
  -o invoice.pdf

France : transmission via votre PDP

Snipcart génère des factures conformes à la norme EN 16931, mais ne les transmet pas. Dans le cadre de la réforme française de la facturation électronique, la transmission doit passer par votre propre plateforme agréée (PDP) : récupérez la facture électronique de chaque commande via l'API ci-dessus et soumettez-la par l'entremise de cette plateforme.

Personnaliser la facture pour le courriel et le PDF

Le PDF de la facture électronique est rendu à partir du même modèle de facture que le courriel de confirmation de commande — le modèle personnalisable documenté dans Modèles de courriels : factures.

Le modèle reçoit une variable context qui indique où il est rendu : 'Email' lorsqu'il est rendu pour le courriel de confirmation de commande, 'Pdf' lorsqu'il est rendu comme PDF de la facture (électronique), et 'Html' pour les affichages dans le navigateur.

Utilisez-la avec l'assistant if_eq pour n'afficher du contenu que dans le courriel — recommandé pour les salutations, les liens marketing ou les liens "voir votre historique de commandes", qui n'ont pas leur place sur un document de facture légal :

{{#if_eq context 'Email'}}
  Hi {{ order.billingAddress.fullName }}, thanks for your order!
  View your order history
{{/if_eq}}

Le même principe fonctionne dans l'autre sens — le contenu entouré de {{#if_eq context 'Pdf'}} … {{/if_eq}} n'apparaît que sur le PDF de la facture, ce qui est pratique pour du contenu réservé à la facture, comme un pied de page légal :

{{#if_eq context 'Pdf'}}
  Registered office: 123 Main Street, Springfield — Company No 12345678
{{/if_eq}}