Goldron : Page créée avec « = STRIPEACCOUNTING POUR DOLIBARR ERP CRM = '''STRIPEACCOUNTING''' rapproche les mouvements réels Stripe — frais (par transaction et abonnement/service), remboursements... »

2026-08-02T08:43:08Z

Page créée avec « = STRIPEACCOUNTING POUR DOLIBARR ERP CRM = '''STRIPEACCOUNTING''' rapproche les mouvements réels Stripe — frais (par transaction et abonnement/service), remboursements... »

Nouvelle page

= STRIPEACCOUNTING POUR DOLIBARR ERP CRM =

'''STRIPEACCOUNTING''' rapproche les mouvements réels Stripe — frais (par transaction et abonnement/service), remboursements, litiges (chargebacks) et virements (payouts) — avec le compte financier intermédiaire Stripe de Dolibarr, puis génère automatiquement les écritures comptables ou mouvements bancaires manquants.

Ce module est complémentaire au module Stripe officiel : il ne crée jamais de paiement, de facture, de session de paiement (Checkout) ni de webhook de paiement. Il se contente de lire l'API Stripe et de comptabiliser ce que le module officiel ne couvre pas.

== Fonctionnement ==

# Le module récupère via l'API Stripe les ''Balance Transactions'', ''Charges'', ''Refunds'', ''Disputes'' et ''Payouts'', en réutilisant la clé API et le mode (test/live) déjà configurés par le module Stripe officiel.

# Chaque objet Stripe est enregistré une seule fois dans sa propre table (<code>llx_stripeaccounting_transaction</code>), identifié par son identifiant Stripe. Une transaction n'est donc jamais traitée deux fois, même si la synchronisation est relancée.

# Pour chaque nouvel objet, le traitement comptable correspondant est automatiquement exécuté.

## '''Frais par transaction''' et '''frais d'abonnement/service''' (Radar, Billing, Connect...) :

### Création du mouvement bancaire correspondant sur le compte Stripe.

### Le module ne génère pas lui-même l'écriture comptable : celle-ci est produite par le bouton natif Dolibarr ''Transférer en comptabilité''.

### Exception : en mode TVA ''Française'', l'écriture complète (frais + TVA) est générée directement par le module.

## '''Virements (Payouts)''' :

### Création d'un véritable virement bancaire interne entre le compte Stripe et le compte bancaire principal.

### L'écriture comptable est ensuite générée par le mécanisme natif de Dolibarr.

## '''Remboursements''' :

### Génération de l'écriture inverse de la charge d'origine lorsque la facture ou le paiement correspondant est retrouvé.

### Sinon, la transaction est marquée pour revue manuelle.

## '''Litiges (Chargebacks)''' :

### Comptabilisation immédiate du montant contesté sur un compte de perte dédié.

### Comptabilisation des frais Stripe liés au litige.

## '''Corrections de solde Stripe''' (<code>adjustment</code>) :

### Les transactions sont importées afin de rester visibles.

### Elles ne sont jamais comptabilisées automatiquement car leur nature nécessite une validation humaine.

## '''Gestion de la TVA sur les frais''' :

### Aucune TVA.

### TVA française.

### Autoliquidation intracommunautaire (génération automatique d'une paire d'écritures symétriques à impact comptable nul).

# Un tableau de bord affiche :

#* le solde Stripe ;
#* les transactions non rapprochées ;
#* les frais du mois ;
#* les payouts en attente ;
#* un bouton '''Synchroniser maintenant'''.

# Une tâche planifiée (cron) peut lancer automatiquement la synchronisation selon la fréquence configurée.

# Pour un compte Stripe non relié à l'API (par exemple une autre boutique utilisant un compte Stripe distinct), une page d'import CSV permet de traiter le fichier ''Balance history'' exporté depuis Stripe, tout en conservant les mêmes garanties d'idempotence. L'import reste désactivé tant que la configuration minimale n'est pas complète.

== Configuration ==

'''Accueil → Configuration → Modules → StripeAccounting'''

Les paramètres disponibles sont :

* '''Compte financier Stripe''' et '''Compte bancaire principal'''
** Ces sélecteurs modifient directement les constantes du module Stripe officiel afin d'éviter toute divergence de configuration.
* '''Compte de frais'''
** Compte comptable des commissions Stripe (exemple : <code>627xxx</code>).
* '''Compte de litiges'''
** Compte comptable des pertes liées aux chargebacks (exemple : <code>658xxx</code>).
* '''Tiers fournisseur Stripe'''
** Utilisé pour affecter les frais d'abonnement ou de service (Radar, Billing...) au compte fournisseur correspondant.
* '''Mode TVA'''
** Aucune.
** TVA française.
** Autoliquidation intracommunautaire avec taux configurable.
* '''Fréquence de synchronisation'''
** Fréquence d'exécution de la tâche planifiée.

Le module refuse toute synchronisation tant que cette configuration minimale n'est pas complète afin d'éviter la génération d'écritures incomplètes ou erronées.

{{Attention|
'''Ne pas activer''' l'option '''Activer l'enregistrement automatique des paiements Stripe''' du module Stripe officiel.

Malgré son intitulé, cette option concerne uniquement les virements (''Payouts''). Elle crée un mouvement bancaire via un webhook à chaque virement Stripe.

Comme STRIPEACCOUNTING génère déjà ces mouvements de manière idempotente, l'activation simultanée des deux mécanismes provoquerait la création de doublons.
}}

== Tâche planifiée (Cron) ==

Lors de son activation, le module crée automatiquement une tâche planifiée nommée '''StripeAccountingSync''' dans :

<code>Accueil → Configuration → Modules → Tâches planifiées</code>

Deux conditions sont nécessaires pour que la synchronisation soit entièrement automatique :

=== 1. Activer la tâche ===

Par défaut, la tâche est créée désactivée.

Il faut ouvrir la tâche puis cocher '''Actif'''.

=== 2. Configurer une crontab système ===

Deux possibilités sont proposées.

==== Script CLI du module ====

<syntaxhighlight lang="bash">
*/15 * * * * php /chemin/vers/htdocs/custom/stripeaccounting/cron/stripe_sync.php >> /var/log/stripeaccounting.log 2>&1
</syntaxhighlight>

==== Ordonnanceur générique de Dolibarr ====

<syntaxhighlight lang="bash">
*/15 * * * * curl "https://votre-url-dolibarr/public/cron/cron_run_jobs_by_url.php?securitykey=VOTRE_CLE&userlogin=VOTRE_LOGIN"
</syntaxhighlight>

Sans l'une de ces deux tâches cron, la synchronisation ne pourra être lancée que manuellement via le bouton '''Synchroniser maintenant'''.

== Prérequis ==

* Dolibarr 17 ou supérieur.
* PHP 7.2 à 8.5.
* Module Stripe officiel activé et configuré (clés API et compte financier).
* Module Comptabilité en partie double (<code>Accounting</code>) pour la table <code>llx_accounting_bookkeeping</code>.

== Crédits ==

STRIPEACCOUNTING est développé et maintenu par '''SILADEL'''.

=== Licence ===

GPL v3 ou toute version ultérieure.

== SILADEL ==

'''Adresse'''

7 chemin des Coquelicots

81990 Cambon

France

'''E-mail'''

[info@siladel.fr](mailto:info@siladel.fr)

'''Site Web'''

https://www.siladel.fr

== Documentation ==

* Documentation Wiki : https://wiki.siladel.fr
* Support : [info@siladel.fr](mailto:info@siladel.fr)

---

<center>
Développé par '''SILADEL'''<br />
Auteur : '''IGREJA David'''
</center>

README-fr - Historique des versions

Goldron : Page créée avec « = STRIPEACCOUNTING POUR DOLIBARR ERP CRM = '''STRIPEACCOUNTING''' rapproche les mouvements réels Stripe — frais (par transaction et abonnement/service), remboursements... »