Utilisation

Le module Rapprochement Stripe s'utilise depuis le menu Banque > Rapprochement Stripe dans la barre de navigation latérale gauche. Trois sous-menus sont disponibles :

Liste des payouts -- Consultation et synchronisation des virements Stripe
Rapprocher -- Rapprochement des transactions avec les paiements Dolibarr
Relevés Stripe -- Génération des relevés bancaires mensuels

Liste des payouts

La page Liste des payouts affiche tous les virements effectués par Stripe vers votre compte bancaire.

Liste des payouts Stripe avec les colonnes montant brut, frais et montant net

Informations affichées

Pour chaque payout, vous consultez :

Colonne	Description
ID Payout	Identifiant Stripe du virement (lien vers le détail et vers le tableau de bord Stripe)
Date du payout	Date de création du virement dans Stripe
Date d'arrivée	Date prévue d'arrivée sur votre compte bancaire réel
Nb transactions	Nombre de transactions incluses dans ce payout
Montant brut	Somme des montants bruts des transactions de type charge/payment
Frais Stripe	Somme des commissions prélevées par Stripe
Montant net	Montant effectivement viré (brut moins frais), correspondant au montant du payout
Statut payout	Statut Stripe du virement : Payé, En transit, Échoué, Annulé
Statut rapprochement	État du rapprochement : En attente, Partiel, Rapproché

Synchroniser les payouts

Cliquez sur le bouton Synchroniser les transactions Stripe pour importer les payouts depuis l'API Stripe. Le module récupère les payouts de la période configurée (exercice en cours, ou exercice en cours + N-1) et, pour chaque payout, importe les transactions associées (balance transactions).

Si un payout n'a pas encore ses transactions synchronisées (colonne « Nb transactions » à 0), un bouton Sync individuel est disponible.

Détail d'un payout

Cliquez sur l'identifiant d'un payout pour accéder à sa fiche détaillée.

Fiche détaillée d'un payout avec la liste des transactions et leurs liens vers Dolibarr

La fiche affiche :

Les informations du payout (identifiant, statut, dates, montant, relevé associé)
La liste des transactions incluses avec pour chacune :
- L'identifiant de la balance transaction et du charge/payment intent
- Le type de source (charge, payment, payout)
- Le paiement Dolibarr lié (lien cliquable)
- La facture liée (lien cliquable)
- Les montants brut, frais et net
- Le statut de rapprochement

En bas de la liste, une ligne de total permet de vérifier que la somme des montants nets correspond au montant du payout. Si un écart est détecté, un avertissement s'affiche.

Actions disponibles sur un payout

Synchroniser les transactions Stripe -- Récupère ou met à jour les transactions depuis l'API Stripe.
Rapprocher tout -- Rapproche en une seule action toutes les transactions du payout ayant un paiement Dolibarr lié. Si l'option « Enregistrer les frais » est activée, les commissions sont enregistrées comme écritures de débit.
Rapprocher (par transaction) -- Rapproche une transaction individuelle. Disponible uniquement pour les transactions en attente.

Rapprocher les transactions

La page Rapprocher affiche toutes les transactions synchronisées dans une vue d'ensemble, indépendamment du payout.

Page de rapprochement avec les filtres et la liste des transactions

Filtres disponibles

Filtre	Description
Payout	Recherche par identifiant de payout (recherche partielle)
Date	Filtrage par plage de dates de création Stripe
Paiement lié	Filtrer les transactions liées ou non liées à un paiement Dolibarr
Statut	Filtrer par statut de rapprochement : En attente ou Rapproché

Rapprochement automatique

Cliquez sur le bouton Rapprochement automatique pour rapprocher en une seule action toutes les transactions en attente qui possèdent un paiement Dolibarr lié. Le module :

Identifie les transactions dont le statut est « En attente » et dont le champ fk_paiement est renseigné.
Pour chaque transaction, marque l'écriture bancaire Dolibarr correspondante comme rapprochée (rappro = 1).
Si l'option « Enregistrer les frais » est activée, crée une écriture de débit pour la commission Stripe.

Rapprochement par sélection

Pour un contrôle plus fin :

Cochez les transactions à rapprocher dans la colonne de gauche (seules les transactions en attente sont cochables).
Sélectionnez l'action Rapprocher la sélection dans le menu d'actions de masse.
Validez.

Comprendre les statuts

Statut	Signification
En attente	La transaction est synchronisée mais l'écriture bancaire n'est pas encore rapprochée.
Rapproché	L'écriture bancaire est marquée comme rapprochée dans Dolibarr.

Relevés Stripe

La page Relevés Stripe permet de générer des relevés bancaires mensuels pour le compte Stripe dans Dolibarr.

Liste des relevés mensuels avec les totaux débits, crédits et solde par mois

Vue annuelle

La page affiche les 12 mois de l'année sélectionnée. Pour chaque mois, vous consultez :

Colonne	Description
Mois	Nom du mois
Numéro de relevé	Référence au format STRIPE-AAAA-MM
Nb écritures	Nombre d'écritures bancaires du mois
Débits	Total des mouvements débiteurs
Crédits	Total des mouvements créditeurs
Solde	Différence crédits moins débits
Rapproché	Ratio écritures rapprochées sur total
Statut	En attente, Partiel ou Rapproché

Utilisez le sélecteur d'année pour naviguer entre les exercices (les 6 dernières années sont proposées).

Générer un relevé mensuel

Cliquez sur le bouton Générer en face d'un mois pour :

Attribuer le numéro de relevé STRIPE-AAAA-MM à toutes les écritures du mois sur le compte bancaire Stripe (num_releve dans llx_bank).
Marquer ces écritures comme rapprochées (rappro = 1).

Le relevé généré est ensuite consultable dans la gestion native des relevés bancaires de Dolibarr (Banque > Relevés).

Générer tous les relevés de l'année

Cliquez sur le bouton Générer tous les relevés AAAA pour générer les relevés de tous les mois de l'année en une seule action.

Supprimer un relevé

Si un relevé est au statut « Rapproché », un bouton Supprimer remplace le bouton « Générer ». La suppression retire le numéro de relevé des écritures bancaires concernées et supprime le marquage de rapprochement.

Détail d'un relevé mensuel

Cliquez sur le numéro de relevé pour accéder au détail des écritures du mois.

Détail d'un relevé mensuel avec toutes les écritures bancaires et les liens vers factures et paiements

Pour chaque écriture, vous voyez :

La date de l'opération
Le libellé de l'écriture bancaire
Le type d'opération
Le tiers associé
Les liens vers le paiement, la facture et la commande liés
Les montants en débit et crédit
Le numéro de relevé attribué
L'état de rapprochement

Tâche planifiée

Le module enregistre une tâche planifiée dans Dolibarr pour la synchronisation automatique des transactions Stripe.

Activation

Allez dans Accueil > Configuration > Tâches planifiées.
Recherchez la tâche StripeReconciliationSync.
Activez-la et configurez la fréquence souhaitée (par défaut : quotidienne).

La tâche appelle la méthode cronSyncStripeTransactions de la classe StripeReconciliation, qui synchronise les payouts et leurs transactions depuis l'API Stripe.

Attention : La tâche planifiée effectue uniquement la synchronisation. Le rapprochement automatique est déclenché pendant la synchronisation si l'option « Rapprochement automatique » est activée dans la configuration.