# Créer une société avec Ekwo OS — Chine

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 Chine, version 0.1.0 ; chaque code qu’elle contient est lu dans le pack.

Le pack Chine 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](https://ekwo.ai/fr/disclaimer/).

## 1. Ce dont vous avez besoin

- Un projet [Supabase](https://supabase.com) à 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.

```sh
npx ekwo-os init --country CN
```

- Un seul plan comptable : 企业会计准则 会计科目（节选）— Accounts of the Accounting Standards for Business Enterprises, abridged, 156 comptes.
- La comptabilité peut être tenue en `zh`, `en` ; l’installateur le demande. Sans terminal, passez `--language <code>`.
- La déclaration 增值税及附加税费申报表（一般纳税人适用） — VAT and surcharges return, general taxpayer, main table se dépose selon l’une de ces périodicités : `month`, `quarter`. 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 :

```sh
npx ekwo-os init \
  --country CN \
  --language zh \
  --vat-period <month|quarter> \
  --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](https://ekwo.ai/fr/docs/install/#before-you-go-live-four-things-on-your-project) 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.

```sh
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 CN --ref customer-1
ekwo doc new --contact "Premier Client" --ref invoice-1 --line "name=Conseil,price=1000.00,account=6001,tax=CN-S-13-G"
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. `6001` 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 |
|---|---|---|
| `CN-S-13-G` | 销售货物 13% | 13 % |
| `CN-S-13-S` | 加工修理修配、有形动产租赁 13% | 13 % |
| `CN-S-9-G` | 销售货物 9% | 9 % |
| `CN-S-9-S` | 交通运输、邮政、基础电信、建筑、不动产 9% | 9 % |
| `CN-S-6` | 销售服务、无形资产 6% | 6 % |
| `CN-S-3-SIMPLE` | 简易计税 3%（一般纳税人） | 3 % |
| `CN-S-SS-3` | 小规模纳税人 3% | 3 % |

## 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](https://ekwo.ai/fr/docs/mcp/), et [ce qu’un agent doit et ne doit pas faire](https://ekwo.ai/fr/docs/agents/).

## Ce que contient le pack Chine

- Plans comptables : 企业会计准则 会计科目（节选）— Accounts of the Accounting Standards for Business Enterprises, abridged (156).
- 23 taxes, à 0 %, 1 %, 3 %, 6 %, 9 %, 13 %.
- La déclaration 增值税及附加税费申报表（一般纳税人适用） — VAT and surcharges return, general taxpayer, main table (`CN-VAT-GENERAL`), 17 cases, déposée month, quarter.
- États financiers : 资产负债表（会企01表）— Balance sheet, 利润表（会企02表）— Income statement.

## Ce qu’il ne fait pas

- Aucune bibliothèque de ce dépôt ne produit encore le fichier de la déclaration CN-VAT-GENERAL : 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](https://github.com/Ekwo-ai/ekwo-os/tree/main/packs/cn).