> ## Documentation Index > Fetch the complete documentation index at: https://help.agatabo.com/llms.txt > Use this file to discover all available pages before exploring further. # Aperçu des Rapports > Générer des rapports financiers, analyses et relevés membres pour la gestion, la conformité et la prise de décision ## Que sont les Rapports ? Agatabo fournit des capacités complètes de reporting pour l'analyse financière, le suivi de gestion, la conformité réglementaire et la communication avec les membres. Tous les rapports sont générés à partir du grand livre et reflètent les données en temps réel. **Autorisation requise** : `reports:read` pour accéder à tous les rapports Les rapports sont générés à la demande à partir des écritures comptables publiées et des soldes des comptes du grand livre. Les écritures brouillon ne sont pas incluses dans les rapports. *** ## Rapports Disponibles ### États Financiers Actifs, Passifs et Capitaux propres à une date donnée Revenus et Dépenses sur une période ### Rapports d'Analyse Indicateurs clés et métriques de performance Résumé du portefeuille et détails des prêts Répartition de la participation des membres ### Rapports Membres Activité et soldes de comptes individuels *** ## Points d'Accès API ### Bilan **Obtenir le bilan de l'organisation :** ```http theme={null} GET /reports/balance-sheet?asOfDate={date} Headers: x-organization-id: {organizationId} ``` **Paramètres de requête :** | Paramètre | Type | Obligatoire | Description | | ---------- | ----------------- | ----------- | ----------------------------------------------------- | | `asOfDate` | string (date ISO) | Non | Date instantanée du bilan. Par défaut, date actuelle. | **Réponse :** Comptes d'Actifs, de Passifs et de Capitaux propres avec leurs soldes. [Voir la documentation complète →](/fr/tontines/reports/balance-sheet) *** ### Compte de Résultat **Obtenir le compte de résultat :** ```http theme={null} GET /reports/profit-loss?startDate={date}&endDate={date} Headers: x-organization-id: {organizationId} ``` **Paramètres de requête :** | Paramètre | Type | Obligatoire | Description | | ----------- | ----------------- | ----------- | ------------------------ | | `startDate` | string (date ISO) | Non | Date de début de période | | `endDate` | string (date ISO) | Non | Date de fin de période | **Réponse :** Comptes de Revenus et de Dépenses avec totaux et résultat net/perte nette. [Voir la documentation complète →](/fr/tontines/reports/profit-and-loss) *** ### Analyse de l'Organisation **Obtenir les métriques clés de performance :** ```http theme={null} GET /reports/analytics?startDate={date}&endDate={date} Headers: x-organization-id: {organizationId} ``` **Paramètres de requête :** | Paramètre | Type | Obligatoire | Description | | ----------- | ----------------- | ----------- | ----------------------------- | | `startDate` | string (date ISO) | Non | Début de la période d'analyse | | `endDate` | string (date ISO) | Non | Fin de la période d'analyse | **Réponse :** Métriques globales de l'organisation, notamment nombre de membres, total des dépôts, total des prêts, santé du portefeuille, etc. [Voir la documentation complète →](/fr/tontines/reports/analytics) *** ### Prêts en Cours **Obtenir le résumé du portefeuille de prêts :** ```http theme={null} GET /reports/loans-outstanding?expectedDate={date} Headers: x-organization-id: {organizationId} ``` **Paramètres de requête :** | Paramètre | Type | Obligatoire | Description | | -------------- | ----------------- | ----------- | ---------------------------------------------------------- | | `expectedDate` | string (date ISO) | Non | Date de remboursement attendue pour le calcul des arriérés | **Réponse :** Détails du portefeuille de prêts, y compris capital restant dû, intérêts, arriérés et résumés individuels des prêts. [Voir la documentation complète →](/fr/tontines/reports/loans-outstanding) *** ### Rapport des Parts **Obtenir la répartition de la participation des membres :** ```http theme={null} GET /reports/shares-report?asOfDate={date} Headers: x-organization-id: {organizationId} ``` **Paramètres de requête :** | Paramètre | Type | Obligatoire | Description | | ---------- | ----------------- | ----------- | ----------------------------------------- | | `asOfDate` | string (date ISO) | Non | Date instantanée pour le calcul des parts | **Réponse :** Soldes d'épargne des membres et pourcentages de participation. [Voir la documentation complète →](/fr/tontines/reports/shares-report) *** ### Relevés Membres **Obtenir les relevés des comptes du grand livre (pour les comptes membres) :** ```http theme={null} POST /ledger-accounts/statements Headers: x-organization-id: {organizationId} Body: { "accountIds": ["acc-123", "acc-456"], "from": "2026-01-01", "to": "2026-06-30", "option": "period", "excludeZeroTransactionAccounts": false } ``` **Corps de la requête :** | Champ | Type | Obligatoire | Description | | -------------------------------- | ----------------- | ----------- | ------------------------------------------------------------------------- | | `accountIds` | string\[] | Oui | Tableau d'IDs de comptes du grand livre (ex. comptes SAVINGS des membres) | | `from` | string (date ISO) | Oui | Début de la période du relevé | | `to` | string (date ISO) | Oui | Fin de la période du relevé | | `option` | enum | Oui | Option du relevé : 'all', 'current', 'period', 'custom' | | `excludeZeroTransactionAccounts` | boolean | Non | Exclure les comptes sans transactions dans la période | **Réponse :** Historique détaillé des transactions de chaque compte avec solde d'ouverture, transactions et solde de clôture. [Voir la documentation complète →](/fr/tontines/reports/member-statements) *** ## Types de Rapports ### États Financiers **Rapports comptables standards pour la conformité et la gestion :** **Bilan (État de la situation financière) :** * Actifs = Passifs + Capitaux propres * Instantané à une date spécifique * Montre la situation financière * Utilisé pour : rapports au conseil, audits, déclarations réglementaires **Compte de Résultat (État des revenus) :** * Revenus - Dépenses = Résultat net * Performance sur une période * Montre les résultats opérationnels * Utilisé pour : rapports mensuels, suivi de performance, déclarations fiscales **Caractéristiques clés :** * ✅ Basé sur la comptabilité en partie double * ✅ Généré à partir des soldes des comptes du grand livre * ✅ Conforme aux normes comptables (GAAP, IFRS) * ✅ Requis pour les audits externes *** ### Rapports d'Analyse **Métriques de performance et analyse de portefeuille :** **Analyse de l'Organisation :** * Tendances de croissance des membres * Volumes de dépôts et de prêts * Indicateurs de santé du portefeuille * Indicateurs clés de performance (KPI) **Prêts en Cours :** * Total du capital restant dû * Intérêts et pénalités à recevoir * Analyse d'ancienneté des arriérés * Détails individuels des prêts **Rapport des Parts :** * Répartition de l'épargne des membres * Pourcentages de participation * Allocation des capitaux propres par membre * Base de distribution des dividendes **Caractéristiques clés :** * ✅ Données en temps réel depuis le grand livre * ✅ Plages de dates personnalisables * ✅ Soutient la prise de décision * ✅ Suit la santé de l'organisation *** ### Rapports Membres **Informations individuelles et agrégées des membres :** **Relevés Membres :** * Activité du compte d'épargne * Dépôts et retraits * Allocations de dividendes * Paiements de prêts * Soldes d'ouverture et de clôture **Objectif :** * ✅ Communication avec les membres * ✅ Relevés trimestriels/annuels * ✅ Rapprochement des comptes * ✅ Transparence et confiance *** ## Générer des Rapports Cliquez sur **Rapports** dans la barre latérale ou utilisez directement le point d'accès API Choisissez parmi : * Bilan * Compte de Résultat * Analyse * Prêts en Cours * Rapport des Parts * Relevés Membres **Paramètres de date :** * Bilan : asOfDate (par défaut aujourd'hui) * Compte de Résultat : startDate et endDate (période) * Analyse : startDate et endDate (période) * Prêts en Cours : expectedDate (pour les arriérés) * Rapport des Parts : asOfDate (par défaut aujourd'hui) * Relevés Membres : dates from et to (période) **Filtres :** * Relevés Membres : tableau accountIds * Prêts en Cours : expectedDate pour le calcul des arriérés Cliquez sur **Générer** ou appelez le point d'accès API Télécharger en PDF, Excel ou CSV (si pris en charge par l'interface) *** ## Cas d'Utilisation Courants ### Rapports Mensuels au Conseil **Dossier pour la réunion mensuelle du conseil :** * Bilan (au dernier jour du mois) * Compte de Résultat (pour le mois) * Prêts en Cours (statut actuel) * Analyse de l'Organisation (performance mensuelle) **Appels API :** ```http theme={null} GET /reports/balance-sheet?asOfDate=2026-06-30 GET /reports/profit-loss?startDate=2026-06-01&endDate=2026-06-30 GET /reports/loans-outstanding GET /reports/analytics?startDate=2026-06-01&endDate=2026-06-30 ``` *** ### Relevés Membres Trimestriels **Générer les relevés pour tous les membres :** 1. Obtenir tous les IDs des comptes SAVINGS des membres 2. Appeler POST /ledger-accounts/statements avec : * accountIds : \[tous les IDs de comptes SAVINGS des membres] * from : Début du trimestre * to : Fin du trimestre * option : 'period' **Distribue :** * Solde d'ouverture * Tous les dépôts et retraits * Allocations de dividendes * Solde de clôture *** ### Préparation à l'Audit **Dossier pour les auditeurs externes :** * Bilan (à la fin de l'exercice fiscal) * Compte de Résultat (exercice fiscal complet) * Relevés des comptes du grand livre (tous les comptes) * Écritures comptables (toutes celles de l'année) * Rapport des Parts (participation des membres) **Appels API :** ```http theme={null} GET /reports/balance-sheet?asOfDate=2025-12-31 GET /reports/profit-loss?startDate=2025-01-01&endDate=2025-12-31 GET /reports/shares-report?asOfDate=2025-12-31 GET /ledger-accounts/journal-search?from=2025-01-01&to=2025-12-31 POST /ledger-accounts/statements (for all accounts) ``` *** ### Conformité Fiscale de Fin d'Année **États financiers annuels pour déclaration fiscale :** * Bilan (au 31 déc.) * Compte de Résultat (année complète) * Documentation des revenus et dépenses **Appels API :** ```http theme={null} GET /reports/balance-sheet?asOfDate=2025-12-31 GET /reports/profit-loss?startDate=2025-01-01&endDate=2025-12-31 ``` *** ### Suivi de Performance **Suivre la santé de l'organisation :** * Rapports d'analyse mensuels * Tendances du portefeuille de prêts * Suivi de la croissance des membres * Ratios revenus/dépenses **Appels API :** ```http theme={null} GET /reports/analytics?startDate=2026-01-01&endDate=2026-06-30 GET /reports/loans-outstanding GET /reports/shares-report ``` *** ## Sources de Données des Rapports **Tous les rapports sont générés à partir de :** **Comptes du Grand Livre :** * Soldes des comptes (actuels ou historiques) * Types et rôles des comptes * Clés de portée (organisation, membre, prêt, réserve) **Écritures Comptables :** * Transactions publiées uniquement (écritures DRAFT exclues) * Dates de transaction dans la période du rapport * Lignes de débit et de crédit * Natures d'écritures comptables et métadonnées **Données Membres :** * Enregistrements des utilisateurs de l'organisation * Statut du membre (actif/inactif) * Dates d'inscription des membres **Données de Prêt :** * Capital et conditions du prêt * Échéanciers de paiement * Calculs des arriérés * Intérêts et pénalités *** ## Bonnes Pratiques **Bonnes pratiques de génération de rapports :** **Calendrier :** * ✅ Générez le Bilan à la fin du mois après publication de toutes les transactions * ✅ Exécutez le Compte de Résultat après la clôture de période pour des résultats exacts * ✅ Générez les relevés membres trimestriellement ou annuellement * ✅ Examinez les analyses chaque mois pour suivre la performance **Exactitude :** * ✅ Assurez-vous que toutes les transactions sont publiées avant de générer les rapports * ✅ Vérifiez qu'aucune écriture brouillon n'est en attente * ✅ Clôturez les périodes comptables avant de finaliser les rapports de fin d'année * ✅ Recoupez les totaux des rapports avec les soldes des comptes du grand livre **Distribution :** * ✅ Rapports au conseil : Bilan + Compte de Résultat + Analyse * ✅ Relevés membres : Trimestriels ou annuels avec lettre d'accompagnement * ✅ Rapports réglementaires : Selon les exigences légales (états financiers annuels) * ✅ Rapports d'audit : Dossier complet avec annexes justificatives **Documentation :** * ✅ Conservez des copies de tous les rapports distribués * ✅ Archivez définitivement les rapports de fin d'année * ✅ Documentez les paramètres des rapports (dates, filtres utilisés) * ✅ Notez tout ajustement ou correction effectué **Export :** * ✅ Exportez en PDF pour la distribution officielle * ✅ Exportez en Excel pour l'analyse et la mise en forme * ✅ Exportez en CSV pour le traitement de données * ✅ Incluez l'en-tête de l'organisation et la date sur tous les rapports *** ## Autorisations des Rapports **Tous les rapports exigent l'autorisation `reports:read` :** ```typescript theme={null} Permission: 'reports:read' Scope: 'ANY' (organization-level permission) ``` **Les utilisateurs avec cette autorisation peuvent :** * ✅ Générer tous les rapports financiers * ✅ Voir le bilan et le compte de résultat * ✅ Accéder aux analyses et métriques de performance * ✅ Générer les relevés membres * ✅ Exporter les rapports dans différents formats **Les utilisateurs sans cette autorisation :** * ❌ Ne peuvent pas accéder aux points d'accès /reports * ❌ Ne peuvent pas générer d'états financiers * ❌ Ne peuvent pas voir les analyses globales de l'organisation **Rôles typiques avec reports:read :** * Administrateur (accès complet) * Comptable (accès complet) * Trésorier (accès complet) * Membre du Conseil (accès en lecture seule) *** ## Sujets Connexes Fondation comptable de tous les rapports Voir les transactions derrière les rapports Clôture de période pour des rapports exacts Principes comptables des rapports