--- title: "Utilisation" weight: 30 description: "Guide d'utilisation du module Rapprochement Stripe : synchronisation, rapprochement, relevés mensuels et tâche planifiée." --- # 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](screenshots/liste-payouts.webp) ### 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](screenshots/detail-payout.webp) 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](screenshots/rapprochement.webp) ### 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 : 1. Identifie les transactions dont le statut est « En attente » et dont le champ `fk_paiement` est renseigné. 2. Pour chaque transaction, marque l'écriture bancaire Dolibarr correspondante comme rapprochée (`rappro = 1`). 3. 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 : 1. Cochez les transactions à rapprocher dans la colonne de gauche (seules les transactions en attente sont cochables). 2. Sélectionnez l'action **Rapprocher la sélection** dans le menu d'actions de masse. 3. 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](screenshots/releves-mensuels.webp) ### 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 : 1. Attribuer le numéro de relevé `STRIPE-AAAA-MM` à toutes les écritures du mois sur le compte bancaire Stripe (`num_releve` dans `llx_bank`). 2. 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](screenshots/detail-releve.webp) 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 1. Allez dans **Accueil > Configuration > Tâches planifiées**. 2. Recherchez la tâche **StripeReconciliationSync**. 3. 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.