Aller au contenu principal
Aide-mémoire

Aide-mémoire

Aide-mémoire Beancount complet avec les structures de comptes, la syntaxe des transactions, les commandes et des exemples pratiques pour la comptabilité en texte brut et la tenue des registres financiers.

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.