Monaco : installer Ekwo, comptabilité libre

Le même parcours en texte : chaque commande déjà écrite pour le pack Monaco, et les codes avec lesquels s’écrit une première facture. Un agent IA qui vous aide lit le même texte en Markdown, à l’adresse /fr/countries/mc/set-up.md.

Ekwo tient une comptabilité en partie double dans une base de données qui vous appartient, avec les règles du pack Monaco sous forme de données. Sur Ekwo Cloud, ce pack est prêt à l’emploi, avec un compte ouvert en une minute ; cette page est l’autre façon d’entrer : Ekwo OS, le cœur open source, installé sur votre propre projet. Elle est générée à partir du pack Monaco, version 0.1.0 ; chaque code qu’elle contient est lu dans le pack.

Le pack Monaco est communautaire : contribué, et relu par personne.

Votre expert-comptable travaille dans la même comptabilité, avec son propre accès, et le pack porte ses sources, sa version et son statut. Pour trouver un expert-comptable qui travaille avec Ekwo dans ce pays (Monaco), consultez l’annuaire ou nos partenaires. Ce qu’est Ekwo, et ses limites : l’avertissement.

1. Ce dont vous avez besoin

Un projet Supabase à vous. L’offre gratuite suffit pour commencer ; Ekwo ne le crée pas, ne le paie pas et n’y a pas accès.
Depuis son tableau de bord : la chaîne de connexion (Connect → Session pooler), la Project URL et la clé service_role (Project Settings → API). La clé sert une seule fois, pour créer votre premier administrateur, et n’est écrite nulle part. La clé anon (publishable), sur la même page, est celle avec laquelle vous vous connectez ensuite.
Node 20 ou plus récent sur votre machine. Rien d’autre : ni Supabase CLI, ni Docker, ni clone.

2. Installer

Une commande. Elle demande le reste au fur et à mesure.

npx ekwo-os init --country MC

Un seul plan comptable : Plan de comptes sur la structure du plan comptable général, 401 comptes.
La comptabilité est tenue en fr.
La déclaration Déclaration de TVA mensuelle ou trimestrielle (numérotation du formulaire 3310-CA3) se dépose selon l’une de ces périodicités : month, quarter. Par défaut : month. Passez --vat-period <cadence> pour fixer la vôtre.
Un exercice suit l’année civile, sauf si vous passez --fiscal-year-start YYYY-MM-DD.

La même chose, sans aucune question — chaque valeur étant la vôtre :

npx ekwo-os init \
  --country MC \
  --db-url "postgresql://postgres.<ref>:<password>@<pooler host>:5432/postgres" \
  --supabase-url "https://<ref>.supabase.co" \
  --service-role-key "$SUPABASE_SERVICE_ROLE_KEY" \
  --org "Votre Organisation" --company "Votre Société" \
  --admin-email "vous@example.com" \
  --yes

3. Avant de passer en production

Quatre réglages de votre projet qu’aucun installateur ne peut atteindre : désactiver l’inscription libre, garder deux administrateurs, tenir la clé service_role à l’écart de toute autre machine, et lire l’avertissement. init les affiche ; le guide d’installation explique chacun d’eux.

4. Une première facture

Connectez-vous avec l’administrateur que vous venez de créer, choisissez la société et préparez un brouillon. --dry-run montre l’écriture que la base de données passerait, et n’écrit rien ; post la comptabilise.

ekwo login --supabase-url https://<ref>.supabase.co --anon-key <publishable key> --email vous@example.com
ekwo use "Votre Société"
ekwo contact add "Premier Client" --country MC --ref customer-1
ekwo doc new --contact "Premier Client" --ref invoice-1 --line "name=Conseil,price=1000.00,account=706000,tax=MC-S-20"
ekwo post invoice-1 --dry-run
ekwo post invoice-1

Une ligne désigne son compte et sa taxe par leur code, jamais par un taux. 706000 est le compte que le pack désigne pour les ventes ; le plan comptable peut en contenir un plus précis pour ce que vous vendez — des services, un taux réduit — et list_accounts les liste.

Ce que la facture dit de votre société — son adresse, son numéro de TVA — vient du profil de la société, que l’outil MCP update_company_profile renseigne ; ekwo init ne fixe que le nom.

Les taxes sur les ventes intérieures que le pack contient aujourd’hui. Laquelle s’applique à une vente est une question qui porte sur cette vente, pour vous ou votre expert-comptable : la liste est celle du pack, pas un conseil.

Code de taxe	Nom	Taux
`MC-S-20`	Vente 20 %	20 %
`MC-S-20-ENC`	Prestation de services 20 % — TVA sur les encaissements	20 %
`MC-S-10`	Vente 10 %	10 %
`MC-S-10-ENC`	Prestation de services 10 % — TVA sur les encaissements	10 %
`MC-S-055`	Vente 5,5 %	5.5 %
`MC-S-055-ENC`	Prestation de services 5,5 % — TVA sur les encaissements	5.5 %
`MC-S-021`	Vente 2,1 %	2.1 %

5. Avec un agent IA

Le serveur MCP permet à un agent de tenir la comptabilité en votre nom, sous votre propre sécurité au niveau des lignes, et jamais avec la clé service_role. Le configurer, et ce qu’un agent doit et ne doit pas faire.

Ce que contient le pack Monaco

Plans comptables : Plan de comptes sur la structure du plan comptable général (401).
22 taxes, à 0 %, 2.1 %, 5.5 %, 10 %, 20 %.
La déclaration Déclaration de TVA mensuelle ou trimestrielle (numérotation du formulaire 3310-CA3) (MC-TVA), 27 cases, déposée month, quarter.
États financiers : Bilan (présentation abrégée du plan comptable général), Compte de pertes et profits (présentation abrégée).

Ce qu’il ne fait pas

Aucune bibliothèque de ce dépôt ne produit encore le fichier de la déclaration MC-TVA : elle est calculée et figée ici, puis saisie sur le portail de l’administration.
Le logiciel open source n’envoie rien à une administration, à un réseau Peppol ou à une banque : la transmission vous revient, ou revient à un opérateur que vous désignez.
Ce que le pack laisse de côté volontairement figure dans son README.

Installer Ekwo — Monaco

Créez votre compte Ekwo Cloud

Le faire tourner vous-même

Pas à pas