Bypassinvoice

Introduction

BypassInvoice permet de déléguer la gestion et la numérotation des factures PrestaShop à Dolibarr, simplifiant la facturation et la synchronisation des données, et offrant une solution efficace pour les commerçants cherchant à optimiser leurs processus comptables et à offrir une meilleure expérience client.

Fonctionnement du module :

Les factures, les clients (tiers), les adresses de facturation et les paiements sont automatiquement générés dans Dolibarr dès qu'une commande est réglée sur PrestaShop. Pour les paiements effectués par chèque, la création de la facture dans Dolibarr est déclenchée automatiquement une fois que le statut de la commande est mis à jour comme "paiement accepté". Les tiers sont créés uniquement si le n° de siret ou l'adresse e-mail n'est pas déjà présente dans Dolibarr. Si un n° de siret ou un e-mail existe déjà, une mise à jour du tiers sera effectuée avec les informations fournies.

A propos des produits, BypassInvoice procède initialement à une vérification des similitudes au niveau des codes-barres EAN13; en l'absence de correspondance, il passe ensuite à la vérification de la référence du produit. Si aucun produit n'est identifié, les entrées correspondantes de vos lignes de produit sur la facture Dolibarr seront affichées en caractères gras.

Avec le modue Duo, Le module se contente de générer une facture dans Dolibarr avant de transférer le numéro de facture vers PrestaShop, permettant ainsi à ce dernier de produire sa propre facture dans son format spécifique.

Fonctionnalités

• Deux modes de fonctionnement : Mode Exclusif pour une gestion complète des factures via Dolibarr et Mode Duo pour la gestion des numéros de facture en synchronisation avec PrestaShop
• Automatisation de la création de factures/avoir dans Dolibarr à la suite des commandes payées sur PrestaShop.
• Automatisation de la création des tiers dans Dolibarr à la suite des commandes payées sur PrestaShop.
• Automatisation de la création des adresses de facturation dans Dolibarr à la suite des commandes payées sur PrestaShop.
• Gestion des paiements différés permettant la création de factures sans paiement immédiat.
• Synchronisation des numéros de facture entre PrestaShop et Dolibarr pour une cohérence comptable.
• Personnalisation de l'affichage des factures dans l'espace client PrestaShop.

Prérequis

• PrestaShop : Version compatible (e.g., 1.7.x ou supérieure).
• Dolibarr : Version compatible (e.g., 14.x ou supérieure) avec un accès API

configuré.

• Droits d'Administration : Accès administrateur sur PrestaShop et Dolibarr.

• chaque entité tierce doit posséder au minimum une adresse e-mail unique. Lorsque

BypassInvoice effectue une recherche de tiers dans Dolibarr, il procède d'abord par la vérification du numéro de SIRET avant de se baser sur l'adresse e-mail. siaucun tiers correspondant n'est trouvé, un nouveau tiers est alors créé dans Dolibarr.

• Pour effectuer une décrémentation de vos stocks avec Dolibarr, le code-barres

ou la référence produit doit correspondre exactement entre Dolibarr et PrestaShop.

Installation

• Téléchargez le fichier d'installation du module BypassInvoice.
• Connectez-vous à votre espace administrateur PrestaShop.
• Accédez à "Modules" > "Module Manager" et sélectionnez "Télécharger un

module".

• Sélectionnez le fichier d'installation et laissez le module s'installer

automatiquement.

• Activez le module depuis votre tableau de bord.

Configuration

Après avoir installé le module BypassInvoice, vous devez le configurer pour qu'il fonctionne correctement avec votre instance Dolibarr. Voici un aperçu détaillé des options disponibles dans la configuration du module :

Mode Exclusif

• Désactivez la fonction de facturation native de PrestaShop. Il suffit de se rendre dans la page Factures dans le menu de gauche de la section Commandes
• Configurez le module pour transférer toutes les opérations de facturation à Dolibarr.
• Personnalisez l'affichage des factures de l'espace client de PrestaShop.

Mode Duo

• Vous maintenez la création de factures dans PrestaShop.
• Configurez le module pour transférer toutes les opérations de facturation à Dolibarr.
• Configurez le format du numéro de facture pour qu'il soit identique entre Dolibarr et PrestaShop.

Le module se contente de générer une facture dans Dolibarr avant de transférer le numéro de facture vers PrestaShop, permettant ainsi à ce dernier de produire sa propre facture dans son format spécifique.

Options Détaillées

BypassInvoice

• Activer ou désactiver le module : Cette option vous permet de mettre en service ou de suspendre temporairement la fonctionnalité de BypassInvoice sans avoir à désinstaller le module. Même lorsque le module est désactivé, vos clients continueront d'avoir accès à leur historique de factures dans leur espace client. Cette approche permet une flexibilité dans la gestion du module tout en préservant la continuité de l'expérience utilisateur.

Logs des erreurs

• Gérer l'activation des logs : Activez cette option pour enregistrer les erreurs et les opérations importantes dans un fichier de log. Cela peut être crucial pour le débogage et la maintenance du système. Les fichiers de log sont stockés dans /modules/bypassinvoice/logs. Pour une consultation rapide, un lien direct vers le fichier de journal est mis à disposition en haut de la page de configuration du module.

Clé API

• Saisissez la clé API de votre instance Dolibarr : La clé API est essentielle pour authentifier et autoriser les communications sécurisées entre PrestaShop et Dolibarr. Vous devez générer cette clé dans votre instance Dolibarr et la saisir ici.

URL

• URL de votre instance Dolibarr : Indiquez l'URL complète où votre Dolibarr est installé. Cette information permet au module BypassInvoice de se connecter correctement à Dolibarr pour la transmission des données.

ENTITÉ

• Entité Dolibarr concernée : Si vous utilisez Dolibarr gère plusieurs sociétés, précisez ici l'identifiant de l'entité concernée par les opérations du module. Par défaut, ce paramètre est fixé à 1.

Paiement CB

• Correspondance de paiement par carte bancaire avec Dolibarr : Configurez cette option pour associer les paiements par carte de crédit réalisés sur PrestaShop avec le type de paiement correspondant dans Dolibarr.

BANQUE

• Banque de destination pour les paiements : Sélectionnez la banque au sein de Dolibarr où les paiements effectués sur PrestaShop devraient être enregistrés. Cette option est utile pour assurer que les transactions sont correctement affectées dans votre comptabilité Dolibarr.

Entrepôt

• Sélection de l'entrepôt par défaut pour la gestion des stocks : Déterminez et forcer quel entrepôt dans Dolibarr sera utilisé pour la déduction automatique des stocks à la suite des ventes réalisées sur PrestaShop. Cette configuration aide à maintenir une synchronisation précise des niveaux de stock entre les deux systèmes. Veillez à ce que les références des produits soient identiques entre Dolibarr et PrestaShop. BypassInvoice procède initialement à une vérification des similitudes au niveau des codes-barres EAN13; en l'absence de correspondance, il passe ensuite à la vérification de la référence du produit.

Facture d’avoir

• Activer ou désactiver les avoirs exclusivement pour les produits. (autorise la création d'avoir et leur envoi vers Dolibarr).

Bloc Compte de Facturation

(présent seulement après avoir désactivé la facturation Prestashop)

Afficher les factures Dolibarr

• Intègre un bloc pour les factures Dolibarr dans l'espace client PrestaShop.

Afficher toutes les factures Dolibarr

• Choix entre afficher toutes les factures ou seulement celles liées à des commandes PrestaShop.

Titre de la page et du bloc de l'espace client

• Personnalisation du titre pour le bloc des factures (ex : "Factures").

Modèle PDF de facture

• Sélection du modèle PDF pour les factures générées par Dolibarr (ex : "crabe").

Personnalisation du Numéro de Facture

(Options pour le Mode Duo)

Ces options offrent une flexibilité significative dans la personnalisation du format des numéros de facture générés dans le cadre du mode Duo de BypassInvoice, assurant que la numérotation s'aligne précisément avec les besoins comptables et de suivi spécifiques de l'entreprise.

Année dans le numéro de facture

• Activée : Intègre l'année courante dans le numéro de facture pour faciliter le suivi chronologique.
• Désactivée : Omet l'année du format du numéro de facture pour une numérotation plus concise.

Présence du Mois dans le Numéro de Facture

• Activée : Ajoute le mois en cours au numéro de facture, offrant une granularité temporelle supplémentaire.
• Désactivée : Exclut le mois pour simplifier le numéro de facture.

Date Courte

• Activée : Utilise une représentation abrégée de la date (par exemple, "2401" pour le 24 janvier) dans le numéro de facture.
• Désactivée : Préfère un format de numérotation sans spécification de date détaillée.

Caractère de Séparation

• Séparateur entre la Date et le Numéro de Facture : Permet de définir un caractère spécifique (tel qu'un tiret, un point ou un slash) pour séparer les éléments de la date du reste du numéro de facture, améliorant ainsi la lisibilité.

Longueur du Numéro de Facture

• Définition de la Longueur du Numéro : Spécifiez la longueur totale du numéro de facture, permettant une standardisation et une cohérence, surtout pour l'alignement des systèmes de classement et de stockage des factures.

Paramètres des Factures avec Paiements Différés

Statut sans paiement Configurez le statut attribué aux commandes qui ne requièrent pas de paiement immédiat. Lorsqu'un client opte pour un mode de paiement dont le statut est défini ici, aucun enregistrement de paiement ne sera transmis à Dolibarr, même si le statut de la commande évolue vers un état indiquant que le paiement a été accepté.

Conditions de paiement attribuées pour ce statut Spécifiez les modalités de paiement qui doivent être appliquées aux commandes identifiées par un statut indiquant un paiement différé. Assurez-vous que ces modalités sont alignées sur les options de paiement préalablement établies dans Dolibarr. Une facture générée sous ce statut spécifique utilisera exclusivement ces conditions de paiement déterminées.