Démarrage rapide

Prêt à prendre le contrôle de vos finances ? Ce guide vous permettra d'être opérationnel avec Beancount en quelques minutes. Vous apprendrez à créer votre premier registre, à configurer les comptes essentiels et à enregistrer vos premières transactions.

Explore the live ledger →

Configuration initiale​

Création de votre premier registre​

; Structure de base pour un nouveau registre
2024-01-01 open Assets:Checking
2024-01-01 open Equity:Opening-Balances
 
2024-01-02 * "Dépôt initial"
  Assets:Checking           100.00 USD
  Equity:Opening-Balances

Configuration essentielle​

option "title" "Registre de finances personnelles"
option "operating_currency" "USD"

Organisation des fichiers​

Structure recommandée​

; 1. Options de configuration
option "title" "Registre personnel"
option "operating_currency" "USD"
 
; 2. Déclarations de compte
2024-01-01 open Assets:Checking    USD
2024-01-01 open Assets:Savings     USD
2024-01-01 open Expenses:Food      USD
 
; 3. Soldes initiaux
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-01 balance Assets:Checking 1000.00 USD
 
; 4. Transactions
2024-01-15 * "Épicerie" "Courses hebdomadaires"
  Expenses:Food            50.00 USD
  Assets:Checking

Organisation par section​

1. Comptes permanents

   2024-01-01 open Liabilities:Payables    USD
   2024-01-01 open Assets:Receivables      USD

2. Comptes bancaires

   2024-01-01 open Assets:Bank:Checking     USD
   2024-01-01 open Assets:Bank:Savings      USD
   2024-01-01 open Income:Bank:Interest     USD

3. Comptes d'investissement

   2024-01-01 open Assets:Investment:Cash    USD
   2024-01-01 open Assets:Investment:Stocks  VTSAX
   2024-01-01 open Income:Investment:Dividend USD

Validation et rapports​

Validation de base​

# Vérifier les erreurs
bean-check ledger.beancount
 
# Afficher l'interface web
bean-web ledger.beancount

Rapports courants​

# Bilan
bean-report ledger.beancount balsheet
 
# Compte de résultat
bean-report ledger.beancount income
 
# Journal de compte
bean-report ledger.beancount journal -a Assets:Checking

Gérer les soldes initiaux​

Exemple de remplissage​

2024-01-01 open Assets:Checking    USD
 
; Remplir le compte pour correspondre au solde connu
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Assertion du solde connu
2024-01-01 balance Assets:Checking 1525.00 USD

Clôture de compte​

2024-01-01 open Assets:OldBank:Checking   USD
2024-06-30 close Assets:OldBank:Checking  ; Compte clôturé

Déduplication des transactions​

Gestion des virements​

; Paiement par carte de crédit - vue combinée
2024-01-15 * "Paiement par carte de crédit"
  Assets:Checking            -500.00 USD
  Liabilities:CreditCard     500.00 USD
 
; Indiquer une correspondance en attente
2024-01-15 * "Paiement CC en attente"
  ! Assets:Checking         -500.00 USD
  Liabilities:CreditCard    500.00 USD

Assertions de solde​

; Les vérifications régulières du solde empêchent les doublons
2024-01-31 balance Assets:Checking    2150.25 USD
2024-01-31 balance Liabilities:CreditCard  -350.00 USD

Bonnes pratiques​

1. Organisation des fichiers

   • Conserver un seul fichier principal au départ
   • Utiliser des en-têtes de section clairs
   • Regrouper les comptes connexes

2. Noms de compte

   • Utiliser des conventions de nommage cohérentes
   • Inclure les préfixes de pays/institution
   • Maintenir une hiérarchie logique

3. Vérification du solde

   • Assertions de solde régulières
   • Remplir les comptes de manière appropriée
   • Suivre les clôtures de compte

4. Gestion des devises

   • Déclarer les devises opérationnelles
   • Utiliser des codes de devise cohérents
   • Spécifier les contraintes de devise

Prochaines étapes​

Maintenant que vous avez configuré un registre de base :

1. Enregistrer les transactions régulières : commencer par vos dépenses et revenus quotidiens
2. Configurer les importations de comptes bancaires : utiliser les importations CSV ou les connexions bancaires pour automatiser la saisie des données. Collez un export de relevé dans le Convertisseur CSV vers Beancount pour obtenir des écritures équilibrées dans votre navigateur, ou utilisez le Convertisseur OFX & QIF vers Beancount pour les téléchargements .ofx, .qfx et .qif.
3. Exemples de livre de comptes fonctionnels: Copiez cinq modèles de livre de comptes Beancount validés et en production pour les finances domestiques, la budgétisation par enveloppes, la facturation de freelance, la location immobilière et le suivi du coût de revient des investissements.
4. Apprendre la syntaxe avancée : explorer syntax reference pour des scénarios plus complexes
5. Générer vos premiers rapports : utiliser les fonctionnalités de l’interface utilisateur pour créer des rapports financiers et analyser vos dépenses

Référence rapide​

Types de comptes courants :

• Assets:Bank:Checking - Votre compte chèque
• Expenses:Food:Groceries - Dépenses d'épicerie
• Income:Salary:Company - Revenus d'emploi
• Liabilities:CreditCard:Visa - Dettes de carte de crédit

Commandes essentielles :

• bean-check ledger.beancount - Valider votre registre
• bean-report ledger.beancount balsheet - Générer un bilan
• bean-web ledger.beancount - Lancer l'interface web

Ces instructions établissent une base solide pour la gestion des finances personnelles avec Beancount. Prêt à ajouter votre première transaction ? Consultez notre guide de transaction d'interface utilisateur.