Commencer

Installer Ekwo — R.A.S. chinoise de Hong Kong

Deux façons d’entrer, qui mènent au même endroit : les règles du pack R.A.S. chinoise de Hong Kong installées dans une base de données qui vous appartient.

Le faire tourner vous-même

Gratuit, pour toujours. Une commande sur votre propre projet Supabase applique le schéma, installe le pack R.A.S. chinoise de Hong Kong et crée votre première société. Rien n’est bridé.

npx ekwo-os init --country HK

Elle demande le reste au fur et à mesure : la connexion à votre projet, le plan comptable lorsqu’il y a un choix, votre organisation et votre premier administrateur.

Lire le guide d’installation

Créez votre compte Ekwo Cloud

L’édition hébergée, opérée pour vous : l’application web et votre propre instance. Pas de mot de passe — Ekwo Cloud envoie un code à votre adresse.

Pays

R.A.S. chinoise de Hong KongUn autre pays ?

Vous êtes
Déjà un compte ? Se connecter

Pas à pas

Le même parcours en texte : chaque commande déjà écrite pour le pack R.A.S. chinoise de Hong Kong, 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/hk/set-up.md.

Ekwo OS est un logiciel open source pour tenir une comptabilité en partie double dans une base de données qui vous appartient. Cette page est générée à partir du pack R.A.S. chinoise de Hong Kong, version 0.1.0 ; chaque code qu’elle contient est lu dans le pack.

Le pack R.A.S. chinoise de Hong Kong est communautaire : contribué, et relu par personne.

Ekwo est un logiciel, ni un expert-comptable ni un conseil fiscal : un pack est une lecture des règles à la date de sa version, et il peut être inexact pour votre situation. Faites vérifier votre configuration et vos premières déclarations par un professionnel qualifié du pays. Voir ce qu’est Ekwo, et ce qu’il n’est pas.

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 HK
  • Un seul plan comptable : Hong Kong reference chart of accounts, 104 comptes.
  • La comptabilité est tenue en en.
  • 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 HK \
  --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 HK --ref customer-1
ekwo doc new --contact "Premier Client" --ref invoice-1 --line "name=Conseil,price=1000.00,account=4000"
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. 4000 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.

Le pack ne contient aucune taxe sur les ventes intérieures : une ligne ne désigne donc aucune taxe.

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 R.A.S. chinoise de Hong Kong

  • Plans comptables : Hong Kong reference chart of accounts (104).
  • 2 taxes, à 0 %.
  • États financiers : Statement of financial position, Income statement.

Ce qu’il ne fait pas

  • 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.