Skip to content

romainsimon/paperasse / comptable

comptable

Verified

Comptabilité, fiscalité et facturation pour entreprises françaises. Gère écritures PCG, déclarations TVA, IS/IR, clôture annuelle, liasse fiscale (2033/2065), FEC, états financiers, et chaîne facturation (mentions obligatoires, numérotation, Factur-X/UBL/CII, plateformes agréées PDP/PA, e-reporting, réforme 2026, PEPPOL). Utiliser dès qu'une question porte sur comptabilité française, TVA, impôts, bilan, compte de résultat, amortissement, PCA, clôture, notes de frais, indemnités kilométriques, facture, avoir, devis, acompte, facturation électronique, ou e-invoicing. Couvre aussi le social et la TVA des artistes-auteurs : affiliation URSSAF, cotisations, RAAP/IRCEC, revenus sans précompte, franchise de TVA des auteurs (293 B I bis), régularisation. Triggers : artiste-auteur, droits d'auteur, précompte, URSSAF Limousin, Maison des artistes, IRCEC, RAAP, Patreon, Substack, autoédition, franchise auteurs, 293 B.

FileKindSize
SKILL.mdskill md20.2 KB
company.example.jsonconfig2.6 KB
data/artistes-auteurs-2026.jsonconfig27.0 KB
data/bareme-kilometrique.jsonconfig6.0 KB
data/facturation/mentions-obligatoires.jsonconfig7.3 KB
data/invoices/_template.jsonconfig1.0 KB
data/invoices/index.jsonconfig293 B
data/journal-entries.jsonconfig11.0 KB
data/nomenclature-liasse-fiscale.csvother2.1 KB
data/pcg_2026.jsonconfig395.5 KB
data/sources.jsonconfig7.9 KB
evals/evals.jsonconfig22.3 KB
evals/files/company-techflow.jsonconfig858 B
evals/files/company-webdev.jsonconfig841 B
evals/files/invoice-test.jsonconfig538 B
evals/files/qonto-transactions.jsonconfig4.9 KB
evals/files/stripe-transactions.jsonconfig5.8 KB
integrations/README.mdmarkdown5.6 KB
integrations/pennylane/fetch.jsscript7.6 KB
integrations/pennylane/fetch.test.jsscript7.0 KB
integrations/pennylane/fixtures/transactions-pages.jsonconfig1.8 KB
integrations/qonto/fetch.jsscript9.5 KB
integrations/qonto/fetch.test.jsscript2.5 KB
integrations/stripe/fetch.jsscript9.5 KB
references/arborescence.mdmarkdown3.8 KB
references/artistes-auteurs-champ.mdmarkdown6.1 KB
references/artistes-auteurs-plateformes.mdmarkdown12.1 KB
references/artistes-auteurs-tva.mdmarkdown7.8 KB
references/artistes-auteurs.mdmarkdown11.8 KB
references/calendar.mdmarkdown7.4 KB
references/closing.mdmarkdown10.3 KB
references/cloture-workflow.mdmarkdown14.1 KB
references/facturation/e-reporting.mdmarkdown4.1 KB
references/facturation/formats-facturx.mdmarkdown6.3 KB
references/facturation/mentions-obligatoires.mdmarkdown5.5 KB
references/facturation/numerotation-conservation.mdmarkdown3.9 KB
references/facturation/plateformes-agreees.mdmarkdown4.3 KB
references/facturation/reforme-2026.mdmarkdown7.6 KB
references/facturation/setup-facturation.mdmarkdown3.2 KB
references/facturation/stripe-sync.mdmarkdown5.6 KB
references/facturation/workflow.mdmarkdown7.2 KB
references/formats.mdmarkdown721 B
references/frais-professionnels.mdmarkdown12.4 KB
references/integrations.mdmarkdown2.1 KB
references/legal-forms.mdmarkdown9.3 KB
references/pcg.mdmarkdown3.1 KB
references/regional.mdmarkdown9.6 KB
references/setup.mdmarkdown6.0 KB
references/taxes.mdmarkdown7.4 KB
references/tva.mdmarkdown10.7 KB
scripts/calc.jsscript14.2 KB
scripts/calc_artiste_auteur.pyexecutablescript6.8 KB
scripts/check-skill-descriptions.jsscript2.3 KB
scripts/fetch_company.pyexecutablescript6.2 KB
scripts/fetch_notaire_data.pyscript18.2 KB
scripts/generate-facturx.jsscript28.4 KB
scripts/generate-fec.jsscript6.6 KB
scripts/generate-pdfs.jsscript12.7 KB
scripts/generate-statements.jsscript25.5 KB
scripts/import-stripe-invoices.jsscript12.1 KB
scripts/parse-einvoice.jsscript39.2 KB
scripts/test-deterministic-calculations.jsscript25.1 KB
scripts/test-parse-einvoice.jsscript32.4 KB
scripts/test_fetch_notaire_data.pyscript7.8 KB
scripts/update_data.pyscript13.4 KB
scripts/upload-qonto-attachments.jsexecutablescript12.8 KB
scripts/validate-facture.jsscript12.1 KB
templates/2065-sd.htmlother15.6 KB
templates/approbation-comptes.mdmarkdown3.0 KB
templates/declaration-confidentialite.htmlother3.7 KB
templates/depot-greffe-checklist.mdmarkdown3.1 KB
templates/facturation/avoir.htmlother7.6 KB
templates/facturation/avoir.mdmarkdown4.9 KB
templates/facturation/checklist-conformite.mdmarkdown2.5 KB
templates/facturation/facture.htmlother9.0 KB
templates/facturation/facture.mdmarkdown6.3 KB
templates/liasse-fiscale-2033.mdmarkdown5.5 KB

integrations/README.md

View on GitHub
# Intégrations

Connecteurs pour récupérer automatiquement les transactions bancaires et les opérations de paiement.

## Connecteurs disponibles

| Connecteur | Description | Env vars requises |
|------------|-------------|-------------------|
| [Qonto](qonto/) | Transactions bancaires via l'API Qonto | `QONTO_ID`, `QONTO_API_SECRET` |
| [Stripe](stripe/) | Charges, payouts, fees via l'API Stripe | Variable par compte (configurable) |
| [Pennylane](pennylane/) | Transactions bancaires via l'API Company v2 | `PENNYLANE_API_TOKEN` |

## Configuration

### Qonto

1. Dans votre dashboard Qonto : **Settings > Integrations > API**
2. Notez votre Organization slug et votre Secret key
3. Définissez les variables d'environnement :
   ```bash
   export QONTO_ID="votre-organisation"
   export QONTO_API_SECRET="votre-secret"
   ```
4. Activez Qonto dans `company.json` :
   ```json
   "qonto": {
     "enabled": true
   }
   ```

### Stripe

#### Compte unique ou comptes séparés

Le cas le plus courant. Chaque compte Stripe a sa propre clé API.

1. Dans votre dashboard Stripe : **Developers > API keys**
2. Copiez votre Secret key (commence par `sk_live_` ou `sk_test_`)
3. Configurez vos comptes dans `company.json` :
   ```json
   "stripe_accounts": [
     { "id": "main", "name": "Mon Produit", "env_key": "STRIPE_SECRET" }
   ]
   ```
4. Définissez la variable d'environnement :
   ```bash
   export STRIPE_SECRET="sk_live_..."
   ```

Si vous avez plusieurs produits Stripe (comptes séparés), ajoutez une entrée par compte avec un `env_key` différent.

#### Stripe Connect (organisation avec sous-comptes)

Si vous utilisez Stripe Connect (un compte plateforme avec des comptes connectés), ajoutez le `stripe_account_id` (le `acct_xxx` du sous-compte) :

```json
"stripe_accounts": [
  { "id": "client-a", "name": "Client A", "env_key": "STRIPE_PLATFORM_SECRET", "stripe_account_id": "acct_xxx" },
  { "id": "client-b", "name": "Client B", "env_key": "STRIPE_PLATFORM_SECRET", "stripe_account_id": "acct_yyy" }
]
```

Tous les sous-comptes peuvent partager la même clé plateforme (`env_key`). Le connecteur envoie automatiquement le header `Stripe-Account` pour agir au nom de chaque sous-compte.

Vous pouvez mixer les deux modes (comptes séparés + Connect) dans le même tableau.

### Pennylane

Le connecteur couvre volontairement un périmètre réduit : la lecture des transactions
bancaires déjà agrégées dans Pennylane. Il ne crée ni ne modifie aucune donnée distante.

1. Dans Pennylane, créez un **token API Company**. Prérequis : une offre **Essential
   ou supérieure**, et un rôle permettant d'accéder à l'onglet Developers de votre
   espace société (Executive, Internal Accountant ou External Accountant). Si l'onglet
   n'apparaît pas dans vos paramètres, votre offre ou vos permissions ne le permettent pas.
2. Accordez-lui uniquement le scope `transactions:readonly`.
3. Définissez le token dans votre environnement :
   ```bash
   export PENNYLANE_API_TOKEN="votre-token-company"
   ```
4. Activez Pennylane dans `company.json` :
   ```json
   "pennylane": {
     "enabled": true
   }
   ```

Documentation officielle : [création d'un token Company](https://pennylane.readme.io/docs/generating-my-api-token)
et [endpoint transactions v2](https://pennylane.readme.io/reference/gettransactions).

## Usage

```bash
# Qonto : récupérer toutes les transactions
npm run fetch:qonto

# Qonto : filtrer par date
node integrations/qonto/fetch.js --start 2025-01-01 --end 2025-12-31

# Stripe : récupérer tous les comptes
npm run fetch:stripe

# Stripe : filtrer par date et compte
node integrations/stripe/fetch.js --start 2025-01-01 --end 2025-12-31 --account main

# Pennylane : récupérer et normaliser les transactions bancaires
npm run fetch:pennylane

# Pennylane : filtrer par date comptable
node integrations/pennylane/fetch.js --start 2025-01-01 --end 2025-12-31

# Tout récupérer
npm run fetch
```

`npm run fetch` conserve son comportement historique Qonto + Stripe. Pennylane
n'est appelé que par `fetch:pennylane`, afin qu'aucun accès à ses données ne soit
déclenché sans demande explicite.

## Format de sortie

Les transactions sont enregistrées dans `data/transactions/` au format JSON.

Chaque transaction suit le format standard Paperasse :

```json
{
  "id": "txn_xxx",
  "source": "qonto",
  "date": "2025-03-15T10:30:00Z",
  "amount": -45.99,
  "currency": "EUR",
  "label": "Amazon Web Services",
  "our_category": null,
  "raw": { ... }
}
```

Le champ `our_category` est rempli par le skill `comptable` lors de la catégorisation (mappage vendor vers compte PCG).

Pennylane écrit `data/transactions/pennylane.json`. Pour une opération en devise,
`amount` et `fee` conservent les montants dans `currency`, tandis que `amount_eur`
et `fee_eur` contiennent leurs contre-valeurs en euros fournies par Pennylane. La
pagination par curseur est suivie automatiquement.

## Sécurité

Les clés API ne sont jamais stockées dans le repo. Elles sont lues depuis les variables d'environnement au moment de l'exécution. Ne commitez jamais de fichier `.env` contenant des secrets.

Les fixtures de test Pennylane sont entièrement fictives. Les sorties réelles sous
`data/transactions/` peuvent contenir des libellés et contreparties sensibles : ne les
commitez pas. Le champ `raw` de chaque transaction conserve le payload complet renvoyé
par l'API Pennylane (comptes bancaires, tiers clients et fournisseurs, factures
rapprochées et leurs URLs éventuelles) : `data/transactions/pennylane.json` contient
donc l'intégralité de ces données. Le répertoire est ignoré par Git, mais traitez-le
comme confidentiel.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall