Aide-mémoire Beancount - Guide de référence rapide

Structure des comptes

Types de comptes et signes

Type          Signe    Exemple
------------------------------------------------
Actifs        (+)     Actifs:US:BofA:Checking
Passifs       (-)     Passifs:Credit:Amex
Revenus       (-)     Revenus:Salaire:Brut
Dépenses      (+)     Dépenses:Nourriture:Restaurant
Capitaux propres(-)     Capitaux propres:Soldes-Ouverture

Format des instruments financiers

# Financier
USD, EUR, CAD, AUD     # Devises standard
GOOG, AAPL, VTI       # Véhicules d'investissement
BTC, ETH              # Cryptomonnaies

# Suivi personnalisé
HEURES                 # Suivi du temps
AIRMILES             # Points de récompense
HOME_MAYST           # Propriété

Syntaxe des directives

Gestion des comptes

# Ouverture de comptes
2024-01-01 open Actifs:Checking            # Simple
2024-01-01 open Actifs:Investing USD,GOOG  # Avec contraintes

# Fermeture de comptes
2024-12-31 close Actifs:Ancien:Compte

Déclaration des instruments financiers

2024-01-01 commodity VTSAX
    name: "Vanguard Total Stock Market Index"
    asset-class: "equity"

Enregistrement des transactions

# Transaction de base
2024-01-15 * "Épicerie" "Achats hebdomadaires"
    Actifs:Checking     -100.00 USD
    Dépenses:Nourriture:Épicerie

# Avec métadonnées et tags
2024-01-15 * "Restaurant" "Dîner d'affaires" #work ^facture-123
    id: "T-1234"
    receipt: "chemin/vers/reçu.pdf"
    Dépenses:Repas      80.00 USD
    Passifs:Credit

Spécifications de comptabilisation

# Montant de base
Actifs:Cash              100.00 USD

# Suivi du prix de base
Actifs:Invest:VTSAX      10 VTSAX {100.00 USD}        # Par unité
Actifs:Invest:VTSAX      10 VTSAX {{1000.00 USD}}     # Coût total
Actifs:Invest:VTSAX      10 VTSAX {100.00 # 9.95 USD} # Avec frais

# Spécifications de prix
Actifs:Forex            1000.00 USD @ 0.85 EUR        # Par unité
Actifs:Forex            1000.00 USD @@ 850.00 EUR     # Prix total

# Lots datés
Actifs:Invest:VTSAX      10 VTSAX {100.00 USD, 2024-01-15}

Vérification du solde

# Assertion du solde
2024-01-31 balance Actifs:Checking  1000.00 USD

# Remplissage du solde
2024-01-01 pad Actifs:Checking Capitaux propres:Soldes-Ouverture

Suivi des métadonnées

# Pièce jointe de note
2024-01-15 note Actifs:Checking "Appel à la banque concernant les frais"

# Lien vers le document
2024-01-15 document Actifs:Checking "chemin/vers/relevé.pdf"

# Enregistrement des prix
2024-01-15 price VTSAX  100.00 USD

Enregistrement d'événements

# Suivi de la localisation
2024-01-15 event "location" "New York, USA"

# Changements de propriété
2024-01-15 event "address" "123 Main Street"

Gestion des tags

# Contrôle de la portée des tags
pushtag #vacances
2024-01-15 * "Hôtel"
    Dépenses:Voyage:Hébergement   200.00 USD
    Actifs:Credit
poptag #vacances

Options de configuration

# Paramètres de base
option "title" "Registre des finances personnelles"
option "operating_currency" "USD"

# Nommage des comptes
option "name_assets" "Actifs"
option "name_liabilities" "Passifs"
option "name_income" "Revenus"
option "name_expenses" "Dépenses"
option "name_equity" "Capitaux propres"

# Gestion des documents
option "documents" "/chemin/vers/docs"

Commentaires et organisation

; Commentaire sur une seule ligne

* En-tête de section
** Sous-section
; Bloc de transaction suit...

; Groupement des comptes
; Actifs
2024-01-15 ...

; Dépenses
2024-01-16 ...

Cette référence fournit une vue d'ensemble complète des éléments de syntaxe de Beancount avec des exemples pratiques.