Les cinq voies d'entrée

Badlen ne se connecte à aucune banque : tout ce que vous possédez y entre par l’une de cinq voies. Le choix dépend de ce que vous avez sous les yeux, pas du compte concerné.

Badlen ne lit aucun fichier CSV, OFX ou QIF, et n’a pas d’écran où déposer un relevé bancaire. Pour faire entrer un relevé, il faut soit un assistant qui le lit pour vous, soit un fichier que vous convertissez au format de Badlen. Comment tout reste à jour détaille ce qui manque.

Choisir selon ce que vous avez

Ce que vous avez	La voie d’entrée
Un solde lu dans l’application de votre banque ou sur un livret	À la main : un compte et son solde
Des fonds, des ETF ou des actions dans un PEA, un CTO ou un contrat	À la main : une ligne par ISIN, puis ses ordres datés s’il y en a
Un bien immobilier, avec son prêt	À la main : la fiche du bien
Une adresse crypto publique	À la main une fois ; la blockchain fait le reste
Des relevés, sous la forme que votre banque ou votre courtier fournit	Avec votre assistant
Un export de Badlen, ou des données que vous savez écrire en JSON	Depuis un fichier
Un programme à vous qui écrit à intervalles réguliers	L’API REST, avec une clé API

Commencez par les formulaires pour créer les comptes et saisir leurs soldes, puis faites appel à l’assistant pour l’historique des comptes qui bougent.

Les cinq voies en bref

À la main. L’écran d’ajout, /ajouter, propose un formulaire par sorte de compte : un solde daté, une poche d’espèces, une ligne par ISIN, une fiche de bien, une adresse de portefeuille. Les opérations se saisissent une à une sur un compte, et les achats ou ventes datés sur une ligne. Il n’y a rien à installer : c’est la seule voie qui ne demande rien d’autre que le navigateur. À la main précise quel formulaire sert à quoi.

Avec votre assistant. Un client MCP que vous utilisez déjà lit vos relevés sur votre machine, avec votre propre modèle, et transmet à Badlen les opérations qu’il en a extraites. Il peut créer des comptes, saisir des soldes, ajouter des lignes et importer des relevés entiers sans doublons, après une simulation qui montre ce qui serait écrit. C’est la voie à privilégier pour l’historique ; il vous faut une clé API, et Node sur la machine où tourne le client. Avec votre assistant explique l’installation.

Depuis un fichier. Réglages → Données → Importer un fichier lit un fichier JSON au format d’export de Badlen et le fusionne dans votre compte. Cette fonction sert d’abord à restaurer une sauvegarde, mais elle accepte tout aussi bien un fichier que vous avez écrit ou converti vous-même. Il ne faut ni clé ni client, et chaque ligne est rapprochée de l’existant avant d’être écrite : envoyer deux fois le même fichier n’ajoute rien. Depuis un fichier décrit le format attendu.

L’API REST. Treize routes sous /api/v1, accessibles avec une clé API limitée à certaines portées. Cinq d’entre elles écrivent : créer un compte, saisir un solde, ajouter une ligne, importer un envoi d’opérations, et simuler cet import. Ce sont exactement celles qu’utilise l’assistant, et un script à vous peut s’en servir de la même façon. API REST en donne la liste.

La blockchain. Un portefeuille crypto déclaré par son adresse publique récupère lui-même son solde, à la création puis chaque fois que vous appuyez sur Synchroniser. C’est la seule donnée qui entre dans Badlen sans que personne ne tape un chiffre. Portefeuilles crypto explique comment.

Quelle que soit la voie par laquelle un chiffre est entré, il se corrige de la même façon, depuis l’onglet où il apparaît : voir Corriger une erreur.