Ben.marchand: version initiale

2026-11-10T12:01:56Z

version initiale

New page

[[en:Module_Paper_Invoice_Mailing]]
[[Category:Modules complémentaires]]
{{TemplateDocDevFr}}
{{TemplateDocUtil}}
=Informations=
{{TemplateModuleInfo
|modulename=Envoi facture papier
|editor=Benjamin Marchand EI
|web=[https://www.news-cap.com www.news-cap.com]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=facture papier}}
|status=stable
|prerequisites=Module Factures, compte MySendingBox (ex-Seeuletter)
|minversion=16.0
|note=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 <code>lettre</code>) envoie vos factures clients par La Poste grâce au service [https://www.mysendingbox.fr 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 <code>facturecourrier</code> (booléen, à créer vous-même) est renseigné, les boutons d'envoi sont masqués.

=Captures d'écran=
<gallery widths="300px" heights="200px">
File:Envoi-facture-papier-fr-01-dashboard.jpg|Tableau de bord
File:Envoi-facture-papier-fr-03-send-form.jpg|Formulaire d'envoi
File:Envoi-facture-papier-fr-02-preview-price.jpg|Aperçu et prix avant l'envoi
File:Envoi-facture-papier-fr-04-letter-card.jpg|Fiche courrier
File:Envoi-facture-papier-fr-05-list.jpg|Liste des courriers
File:Envoi-facture-papier-fr-06-invoice-tab.jpg|Onglet de la facture
File:Envoi-facture-papier-fr-09-invoice-button.jpg|Bouton sur la fiche facture
File:Envoi-facture-papier-fr-08-setup.jpg|Configuration
</gallery>

=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 (<code>test_...</code>) et une clé de production.

=Installation=

# Téléchargez le fichier <code>module_lettre-x.y.z.zip</code> sur le DoliStore.
# Allez dans ''Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe'' et envoyez le fichier ZIP.
# Activez le module '''Envoi facture papier'''.
# 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.
# Cliquez sur '''Tester la connexion'''.
# 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==

# Sauvegardez la base de données.
# Désactivez le module '''avant''' de remplacer les fichiers.
# Déployez le nouveau ZIP par ''Déployer/Installer un module externe'' (Dolibarr supprime l'ancien dossier avant de copier le nouveau).
# Réactivez le module, dans chaque entité si vous utilisez Multisociété.
# 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=
* Formulaire : https://www.news-cap.com/contact/?topic=papier
* E-mail : support@news-cap.com

Module Envoi facture papier - Revision history

Ben.marchand: version initiale