Démarrer avec Beancount

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.

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
3. Apprendre la syntaxe avancée : explorer syntax reference pour des scénarios plus complexes
4. 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.