L’extension VosFactures permet d’intégrer votre boutique en ligne avec le logiciel de facturation et gestion de stock VosFactures.fr. Vous pouvez ainsi créer automatiquement des factures personnalisées correspondant à vos commandes en ligne, tout en respectant la loi française Anti-Fraude à la TVA. L’extension rend aussi possible l’envoi automatique ou manuel des factures PDF à vos clients, l’export et l’analyse comptables des factures.
________________________________
The VosFactures extension allows you to integrate your WooCommerce store with the online invoicing software VosFactures.fr. You can create automatically customized invoices corresponding to your WooCommerce orders, while respecting the French Anti-Fraud VAT Law. The extension also makes possible the automatic or manual emailing of PDF invoices to your clients, as well as the export and accounting analysis of your invoices.
Installation
- Download the .zip file from your WooCommerce account.
- Go to: WordPress Admin > Plugins > Add New and Upload Plugin with the file you downloaded with Choose File.
- Install Now and Activate the extension.
More information at: Install and Activate Plugins/Extensions.
Configuration
Cliquez sur le lien prévu à cet effet (ou allez dans l’onglet WooCommerce > Réglages > Intégration > VosFactures).
- Compte VosFactures : Si vous n’avez pas encore créé de compte sur VosFactures.fr, cliquez sur le lien prévu à cet effet. Sinon, passez au point 2.
- Code API (obligatoire) : Indiquez le Code API avec préfixe de votre compte VosFactures visible dans Paramètres > Paramètres du compte > Intégration :
- si vous avez déjà créé un code API : choisissez le code API qui affiche le préfixe de votre compte, et que vous devez copier en intégralité (ex: AhgyTkig6ibhb/masociete)
- si vous n’avez pas encore de code API avec préfixe: créez un code en choisissant l’option “Code avec préfixe” et sauvegardez, puis copiez ce nouveau code en intégralité (ex: AhgyTkig6ibhb/masociete).
- Quand créer la facture : Choisissez quand créer la facture de chaque commande :
– Automatiquement une fois la commande payée (état “terminé”)
– Automatiquement une fois la commande en cours (état “en cours”)
– Automatiquement une fois la commande créée (n’importe quel état)
– Pas automatiquement (création manuelle)
- Envoi automatique (optionnel) : Cochez si vous souhaitez que les factures générées par le plugin soient automatiquement envoyées par email à vos clients.
- Département (optionnel) : Vous pouvez créer plusieurs départements vendeurs sur votre compte VosFactures, si vous souhaitez distinguer les factures provenant de WooCommerce des autres factures. Si tel est le cas, sélectionnez le nom du département concerné par les ventes WooCommerce. Si vous n’indiquez rien, les factures seront créées par le département principal.
- Catégorie (optionnel) : Vous pouvez créer plusieurs catégories sur votre compte VosFactures. Si tel est le cas, choisissez la catégorie à attribuer aux factures WooCommerce.
- Frais de livraison gratuits (optionnel) : Cochez pour afficher sur les factures les frais de livraison gratuits sous la forme d’une ligne “Frais de livraison” de prix unitaire égal à zéro. Sinon, seuls les frais de livraisons payants s’afficheront.
- Informations spécifiques (optionnel) : Cochez pour afficher sur les factures le contenu par défaut du champ “Informations spécifiques” éventuellement renseigné sur votre compte VosFactures.
- Description des produits (optionnel) : Cochez pour afficher sur les factures, en tant que Description du produit, le contenu du 1er champ “Description” de WooCommerce.
- Notes des commandes (optionnel) : Cochez pour afficher les notes éventuelles de vos commandes sur les factures (qui s’afficheront en tant qu’informations spécifiques).
- Variable des produits (optionnel) : Cochez pour afficher sur les factures la variable éventuelle des produits vendus, qui s’affichera dans le champ Description de chaque produit.
- Clients professionnels : Choisissez le nom qui doit figurer sur les factures en cas de vente à un professionnel :
– Nom de la société uniquement
– Nom et prénom du client uniquement
– Nom de la société et nom et prénom du client
- Champs additionnels (optionnel) : Vous pouvez modifier le document généré en utilisant la syntaxe JSON. Exemples:
– Pour générer des devis au lieu de factures, écrivez “kind”:”estimate”.
– Pour ne pas afficher de Date limite de règlement sur les factures, écrivez “payment_to_kind”:”off”. Par défaut la Date limite de règlement est la date de création si la facture créée est Payée (si la facture n’est pas payée, elle est égale à la date de création +1 jour)
– Pour que les factures soient automatiquement converties en une devise particulier, écrivez par exemple “exchange_currency”:”USD”
Sauvegardez. En cas d’erreur de configuration, vous serez informé de sa cause.
Go to WooCommerce > Settings > Integration to set up the plugin :
- VosFactures account: If you have not yet created an account on VosFactures.fr, click on the link provided for this purpose. Otherwise, go to point 2.
- API code (required): Enter the API code with prefix (ex: AhgyTkig6ibhb/myfirm) of your VosFactures account visible in Settings > Account settings > Integration. You might need to create an API code with prefix.
- Invoice creation: Choose when to issue the invoice of an order :
– Automatically after order is paid (status “completed”)
– Automatically after order is processing (status “processing”)
– Automatically after order is created (any status)
– Never automatically (manual issue)
- Automatic email sending (optional): If you want the invoices generated by the plugin to be automatically emailed to your customers.
- Department (optional): You can create multiple sales departments in your VosFactures account, if you want to distinguish invoices from WooCommerce from other invoices. If you do not indicate anything, the invoices will be created by the main department.
- Category (optional): You can create multiple categories on your VosFactures account. If so, choose the category to which to assign WooCommerce invoices.
- Free delivery (optional): To display on invoices the item “Shipping costs” with a unit price of zero. Otherwise, only payable delivery charges will be displayed.
- Note (optional): To display on invoices the default content of the “Note” field eventually filled in on your VosFactures account.
- Product description (optional): To display on invoices the description of the sold products in addition to product names.
- Order Notes (optional) : To display on invoices the eventual notes of your orders (which will be shown in the invoice field “Note“)
- Product variable (optional) : To display on invoices the eventual variable of sold products in addition to product names.
- Business clients: Choose the name to display on invoices in case of sale to a company :
– Company name
– Client surname and first name
– Company name and client name and surname
- Additional fields (optional): You can edit the generated document using JSON syntax. Examples:
– To generate estimates instead of invoices, write “kind”: “estimate” .
– To hide due date on invoices, write “payment_to_kind”: “off”
– To automatically convert invoices to a currency, enter “exchange_currency”: “USD”.
Then “Save changes” to finish set up. In case of error you will be informed of its cause.
Usage / Fonctions
Invoice customization / Personnalisation des Factures
Depuis votre compte VosFactures vous pouvez personnaliser le contenu et mise en page des factures à créer :
- Choix de 19 formats prédéfinis
- Possibilité de modifier par CSS les formats, comme les couleurs ou la police
- Possibilité de créer votre propre format par CSS et HTML
- Accès à diverses options d’affichage de champs : référence produits, n° de commande …
From your VosFactures account you can customize the content and appearance of invoices :
- Choice of 19 pre-defined templates
- Possibility to modify by CSS predefined templates such as color and font
- Possibility to create own template by CSS and HTML
- Access to many options to add or hide fields : product code, order number …
Automatic invoice creation / Création automatique des Factures personnalisées
L’extension génère automatiquement la facture correspondant à chaque commande, reprenant fidèlement les données de la vente.
Vous pouvez choisir à quel moment les factures doivent être générées :
- automatiquement une fois la commande créée
- automatiquement une fois la commande “terminée”
- automatiquement une fois la commande “en cours”
- uniquement manuellement
L’extension est compatible avec :
- les commandes en ligne effectuées sur votre site internet
- les commandes créées manuellement depuis votre backend
- les commandes générées automatiquement par l’extension WooCommerce Subscriptions
- les commandes générées avec l’extension POS
- l’extension Visual Product Configurator
- l’extension Sequential Order Numbers
- l’extension WooCommerce EU VAT Number
- l’extension Product Bundles
- le champ ICE (Identifiant Commun des Entreprises) des clients marocains.
________________________________
The extension automatically generates the invoice of each order. You can choose when to issue invoices :
- Automatically as soon as order is created
- Automatically when order reaches the status “completed”
- Automatically when order reaches the status “processing”
- Manually only
The extension is compatible with :
- orders generated from your online website,
- orders created manually by you from your backend
- orders created automatically by the WooCommerce Subscriptions plugin.
- orders generated via POS plugin
- orders with the Moroccan clients field “ICE“
- Visual Product Configurator plugin
- Sequential Order Numbers plugin
- WooCommerce EU VAT Number plugin
- Product Bundles plugin
PDF invoice download / Téléchargement PDF des Factures
Vous pouvez visualiser et télécharger en PDF la facture de chaque commande sur votre interface WooCommerce. Il y aussi un lien “Afficher la facture sur le compte” VosFactures, si vous voulez la modifier par exemple.
You can download in PDF the invoice of each order from your WooCommerce backend. There is also a link to view the invoice on your VosFactures account, if you want to edit it or take further action.
One-click manual invoice creation / Création manuelle des Factures
Vous pouvez forcer la création d’une facture grâce au bouton “Générer la facture” depuis la commande. Cela est utile par exemple pour les commandes antérieures à l’installation du plugin, ou si vous décidez de désactiver la création automatique de facture.
You can force the creation of an invoice via the button “Generate invoice” from the order page. This is useful for example in case of orders created prior to the extension set up, or in case you decide to disable the automatic invoice creation.
Creation of correction invoice / Création manuelle de Factures d’Avoir
Vous pouvez créer une facture d’avoir partiel ou total sur votre compte VosFactures grâce au bouton “Créer un avoir” qui vous redirige vers le formulaire de création pré-complété de la facture d’avoir.
You can create directly from your WooCommerce backend a partial or total correction invoice on your VosFactures account. After clicking on the button, you are redirected to the pre-filled creation form of the correction invoice.
Invoice email sending / Envoi par Email des Factures
Vous pouvez choisir d’envoyer automatiquement ou manuellement les factures PDF par email à vos clients, avec un texte personnalisé et depuis l’adresse email de votre choix. Vous pouvez ajouter une adresse en copie ou en copie cachée et vérifier l’état de l’envoi depuis votre compte VosFactures qui en assure le suivi.
You can choose to send automatically or manually PDF invoices by email to your customers, with a customized email content and from the email address of your choice. You can add an email address in copy or hidden copy and verify the email send status from your VosFactures account.
Error message / Détection des Erreurs
Si le module rencontre une erreur lors de la création automatique d’une facture, un message d’information avec la raison de cette erreur s’affiche au dessus de la liste des commandes et sur la commande concernée. Vous pourrez réessayer grâce au bouton “Recommencer”.
If the plugin encounters an error during the automatic creation of an invoice, a message with the reason for this error is displayed above the orders list and on the order page. You can try again to issue manually the invoice.
Troubleshooting
Test invoice / Facture Test
Lors de la configuration de l’extension, une facture test est générée puis immédiatement supprimée par le plugin. Assurez-vous que l’option “Empêcher la suppression des documents” est temporairement désactivée dans les paramètres de votre compte VosFactures. Sinon, vous devrez supprimer cette facture test manuellement afin de finaliser l’intégration du plugin.
During the extension set up, a test invoice is generated and immediately deleted. Make sure that the option “Block invoice deletion” option is temporarily disabled on your VosFactures account settings. Otherwise, you will have to delete this test invoice manually in order to finalize the integration.
API Token / Code API de votre compte VosFactures
Vous devez copier un code API avec préfixe, c’est-à-dire un code API qui comporte le préfixe de votre compte, sinon l’intégration ne pourra pas se faire. Exemple : AhgyTkig6ibhb/monentreprise. En général vous avez besoin de générer ce code depuis Paramètres > Paramètres du compte > Intégration > Code d’autorisation > Afficher les codes API > Ajouter un nouveau code > Code avec préfixe.
Make sure to copy your VosFactures API token with prefix. Example : AhgyTkig6ibhb/mycompany. You might need to generate such code.
Subscription plan / Formule d’abonnement
Vérifiez dans les paramètres de votre compte VosFactures que la formule choisie est “pro” ou “max” et cela même en période d’essai, sinon l’intégration ne pourra pas se faire.
Make sure in your VosFactures account settings that the chosen plan is “pro” or “max”, even during the free trial period, otherwise the integration can not be done.
FAQs
Compatibility / Avec quelle version de WooCommerce l’extension est-elle compatible ?
WooCommerce versions 3.0 – 5.6
Free sign up on VosFactures / L’ouverture d’un compte sur VosFactures.fr est-elle gratuite ?
Oui, l’inscription sur le logiciel VosFactures.fr est gratuite et offre une période de 30 jours gratuits sans engagement. Pour continuer à utiliser l’extension, il faut effectuer le paiement de la formule “pro” ou “max” pour la période souhaitée – un mois, un an, ou plus.
Yes, the creation of an account on the online software VosFactures.fr is free and entitles a free 30-day trial period. To continue using the extension, you must make a payment for the the “pro” ou “max” plan for the desired period – one month, one year, or more.
Sales with or without tax /L’extension gère-t-elle les ventes sans et avec taxe ?
Oui. L’extension peut générer des factures pour des ventes sans taxe ou avec taxe, comme de la TVA, qu’il y ait un ou plusieurs taux de taxe sur une même facture. Vous pouvez afficher les montants HT et TTC, ou uniquement TTC, et afficher un résumé des montants par taux de taxe.
Yes. The extension can generate invoices for tax-exempt sales or sales with tax, such as VAT, even if there are several tax rates on the same invoice. You can display the net and gross totals and a summary of amounts by tax rate.
Sales with discount / L’extension gère-t-elle les ventes avec réductions ?
Oui, le plugin intègre les réductions en pourcentage et les remises sous forme de montant, ainsi que les tarifs promo. Le montant total de la réduction est étalé sur l’ensemble des articles listés sauf frais de livraison. Selon le format de factures que vous avez choisi, la réduction s’affichera :
- Dans le résumé des totaux : Total HT avant et après réduction
- Et/ou sur le tableau principal : Prix HT avant et après réduction. Vous pouvez en savoir plus ici.
Yes, the plugin can generate invoices with a percentage or amount discount, as well as with Sale price. The total amount of the discount is spread over all sold items except delivery charges. Depending on the invoice template chosen, the discount will be displayed :
- In the totals summary : Net total before and after discount
- And/or on the positions table: Price before and after discount. You can find out more here.
Synced sales data / Clients et articles
A chaque création de facture, tout nouveau client et produit facturés sont automatiquement ajoutés à la liste de vos Contacts et Produits sur VosFactures :
- Nom et prénom du client
- Nom de la compagnie et numéro fiscal (TVA) du client professionnel
- Numéro de téléphone et adresse email du client
- Adresse de facturation et de livraison du client
- Nom, description, unité, prix, et quantité vendue des produits
Vous pouvez également importer en masse dans votre compte VosFactures la liste des clients et produits.
VosFactures évite la création de doublons grâce à un système de reconnaissance basée :
- Sur le numéro fiscal ou l’email & le nom des clients. Le plugin met à jour la fiche du client si nécessaire.
- Sur le nom ou la référence GSU des produits/services selon l’option choisie.
Attention la communication ne se fait que dans un sens (Woocommerce —> Vosfactures). En cas de vente depuis VosFactures (hors WooCommerce), la quantité décomptée sur VosFactures ne l’est pas sur WooCommerce.
At each invoice creation, any new invoiced client and products are automatically added to the list of your Contacts and Products on VosFactures account :
- Client surname and first name
- Company name and tax number (VAT) if applicable
- Client telephone number and email address
- Client invoicing and delivery addresses
- Product name, description, unit, price, and quantity.
You can also import manually a list of clients and products on VosFactures.
VosFactures avoids the creation of duplicates thanks to a recognition system based on :
- Client VAT number or email and name. Client data is updated if necessary.
- Product name
Note that in case of invoice creation directly on VosFactures (and not from WooCommerce), stock is not updated on WooCommerce.
Antifraud conformity / Comment obtenir l’attestation de conformité AntiFraude à la TVA ?
Cliquez sur le lien prévu à cet effet depuis le tableau de bord de votre compte VosFactures et remplissez le formulaire pour recevoir par email l’attestation de conformité du logiciel. Vous pouvez en savoir plus ici sur la loi Anti-fraude à la TVA valable en France.
Click on the link visible from the dashboard of your VosFactures account and fill out the form to receive by email the software certificate of conformity. Click here to know more about the French antifraud law.
Questions and Feedback
Have a question before you buy? Please fill out this pre-sales form.
Already purchased and need some assistance? Get in touch with support via the help desk.
Commentaires récents