Dolibarr ERP CRM Wiki

Module Envoi facture papier

Retour index
Documentation développeur

File Doc dev.png

Retour index
Documentation Utilisateur
File Doc user.png

Informations


Module name Envoi facture papier
Editor / Editeur Benjamin Marchand EI - www.news-cap.com
Download or buy page / Page achat ou téléchargement External module - papier www.dolistore.com
Status / Statut / Estado Stable
Prerequisites / Prérequis Module Factures, compte MySendingBox (ex-Seeuletter)

Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore

Last update date / Date mise à jour fiche / Fecha última actualización 2026-11-10
Note / Nota Envoyez vos factures clients par courrier postal depuis Dolibarr, avec aperçu et prix avant chaque envoi. Interface en français et en anglais.

Fonctionnalités

Envoi facture papier (nom technique lettre) envoie vos factures clients par La Poste grâce au service MySendingBox (anciennement Seeuletter). MySendingBox imprime le PDF de la facture, le met sous enveloppe et le poste.

En bref

  • Pour qui : toute entreprise dont certains clients veulent encore leurs factures sur papier.
  • Ce que fait le module : il envoie la facture validée par courrier en quelques clics, montre le PDF et le prix avant l'envoi, puis suit le courrier.
  • Ce qu'il ne fait pas : il n'imprime rien lui-même. L'impression et l'affranchissement sont faits et facturés par MySendingBox.

Liste des fonctionnalités

  • Envoi depuis la fiche facture : bouton « Envoyer par courrier » sur les factures clients validées.
  • Aperçu et prix avant l'envoi : le courrier est d'abord créé avec la clé de test. Vous voyez le PDF exact qui sera imprimé et le prix (affranchissement et service) avant de confirmer. Rien n'est posté à cette étape.
  • Protection contre les doubles envois : confirmation demandée si la facture est déjà partie, bouton de confirmation utilisable une seule fois, clé d'idempotence unique par aperçu.
  • Fiche courrier : statut, numéro de suivi, prix, PDF envoyé, bouton d'annulation pendant le délai d'annulation de MySendingBox (environ 15 minutes).
  • Liste des courriers : filtres (facture, tiers, dates, affranchissement, test ou réel, statut), tri, total des courriers facturés.
  • Tableau de bord : courriers et coûts du mois et de l'année, graphiques sur 12 mois, derniers courriers, courriers en anomalie (adresse erronée, retour à l'expéditeur…).
  • Onglets « Courrier postal » sur les factures et les tiers, widget « Derniers courriers » pour l'accueil.
  • Mise à jour des statuts : tâche planifiée qui interroge MySendingBox toutes les 4 heures.
  • Export des courriers (Outils > Exports).
  • Mode test : tous les envois utilisent la clé de test, rien n'est imprimé.
  • Clients qui refusent le papier : si le champ complémentaire de tiers facturecourrier (booléen, à créer vous-même) est renseigné, les boutons d'envoi sont masqués.

Captures d'écran

  • Tableau de bord

  • Formulaire d'envoi

  • Aperçu et prix avant l'envoi

  • Fiche courrier

  • Liste des courriers

  • Onglet de la facture

  • Bouton sur la fiche facture

  • Configuration

Prérequis

  • Dolibarr 16 ou plus récent (testé de 16 à 24, MySQL/MariaDB et PostgreSQL).
  • PHP 7.4 ou plus récent avec cURL.
  • Module Factures activé.
  • Un compte MySendingBox avec une clé de test (test_...) et une clé de production.

Installation

  1. Téléchargez le fichier module_lettre-x.y.z.zip sur le DoliStore.
  2. Allez dans Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe et envoyez le fichier ZIP.
  3. Activez le module Envoi facture papier.
  4. Dans la configuration du module :
    • saisissez la clé de test : elle est toujours requise, car l'aperçu avant chaque envoi l'utilise ;
    • saisissez la clé de production pour envoyer de vrais courriers ;
    • laissez le mode test actif tant que vous n'avez pas vérifié un envoi complet ;
    • choisissez l'affranchissement, la couleur et le recto verso par défaut.
  5. Cliquez sur Tester la connexion.
  6. Donnez les droits « Consulter les courriers envoyés » et « Envoyer et annuler des courriers » aux utilisateurs concernés.

Mise à jour depuis une version 1.x ou 2.0

  1. Sauvegardez la base de données.
  2. Désactivez le module avant de remplacer les fichiers.
  3. Déployez le nouveau ZIP par Déployer/Installer un module externe (Dolibarr supprime l'ancien dossier avant de copier le nouveau).
  4. Réactivez le module, dans chaque entité si vous utilisez Multisociété.
  5. Vérifiez la configuration (mode test, clés, Tester la connexion).

Les droits des utilisateurs et des groupes sont conservés.

FAQ

Un courrier peut-il partir deux fois ?
Non. Chaque aperçu porte une clé d'idempotence unique : même si la requête est rejouée après une erreur réseau, MySendingBox ne crée qu'un courrier.
Puis-je annuler un envoi ?
Oui, depuis la fiche courrier, pendant le délai d'annulation de MySendingBox (environ 15 minutes après la création).
Combien coûte un envoi ?
Le prix dépend de MySendingBox (affranchissement, nombre de pages, couleur). Le module l'affiche avant chaque envoi ; il est facturé par MySendingBox.
Comment essayer sans rien envoyer ?
Activez le mode test : tous les envois utilisent la clé de test et rien n'est imprimé.

Support

Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_Envoi_facture_papier&oldid=68941"