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

references/facturation/workflow.md

View on GitHub
# Workflow Facturation — Détails opérationnels

Chargé à la demande depuis `comptable/SKILL.md` section **Facturation**.

## Contents
- Checklists (mise en conformité, génération, validation)
- Format JSON d'une facture
- Articulation facture ↔ écriture comptable
- Pipeline Stripe → Facture → Qonto
- Numérotation par année
- Refunds et avoirs Stripe
- Réception des e-factures (1er septembre 2026)

## Checklists

### Mise en conformité facturation électronique 2026

```
Conformité e-facturation — {{company.name}}
- [ ] Vérifier statut : assujettie TVA (même en franchise)
- [ ] Déterminer taille entreprise (GE / ETI / PME / micro)
- [ ] Identifier échéances (réception : sept. 2026 / émission : sept. 2026 ou 2027)
- [ ] Choisir une plateforme agréée (PA)
- [ ] Créer un compte sur la PA choisie
- [ ] Configurer la réception des factures sur la PA
- [ ] Tester la réception d'une facture de test
- [ ] Informer les fournisseurs de votre PA de réception
- [ ] Mettre à jour les mentions sur les factures émises (SIREN client, catégorie)
- [ ] Configurer l'émission sur la PA (quand l'obligation s'applique)
- [ ] Configurer l'e-reporting si opérations B2C ou international
```

### Génération d'une facture conforme

```
Facture — {{company.name}} → {{client}}
- [ ] Numéro de facture (séquence chronologique continue)
- [ ] Date d'émission
- [ ] Identité émetteur complète (nom, SIREN, SIRET, adresse, forme juridique)
- [ ] Identité client complète (nom, adresse, SIREN si professionnel)
- [ ] Numéro TVA intracommunautaire (si régime réel)
- [ ] Description détaillée des prestations / biens
- [ ] Quantité, prix unitaire HT, montant total HT
- [ ] Taux et montant TVA (ou mention d'exonération)
- [ ] Montant total TTC
- [ ] Date d'échéance de paiement
- [ ] Conditions de paiement
- [ ] Pénalités de retard et indemnité forfaitaire
- [ ] [2026+] **Catégorie d'opération** (biens / services / mixte) — obligation distincte de la description, toujours flagger si absente (biens / services / mixte)
- [ ] [2026+] SIREN du client (si B2B domestique)
- [ ] [2026+] Adresse de livraison (si différente de facturation)
- [ ] Mention spéciale si applicable (franchise TVA, autoliquidation, etc.)
```

### Validation d'une facture existante

```
Validation — Facture {{numéro}}
- [ ] Numéro présent et conforme à la séquence
- [ ] Date d'émission présente
- [ ] Émetteur : nom, SIREN, SIRET, adresse, forme juridique
- [ ] Client : nom, adresse
- [ ] Client : SIREN (obligatoire 2026+ pour B2B)
- [ ] Désignation précise des biens/services (distincte de quantité/prix)
- [ ] **Quantité** présente pour chaque ligne (mention distincte)
- [ ] **Prix unitaire HT** présent pour chaque ligne (mention distincte)
- [ ] Montant HT par ligne
- [ ] TVA : taux, montant, ou mention d'exonération valide
- [ ] Montant TTC
- [ ] Date d'échéance, conditions de paiement
- [ ] Pénalités de retard (taux, indemnité forfaitaire 40 EUR)
- [ ] [2026+] **Catégorie d'opération** (biens / services / mixte) — obligation distincte de la description, toujours flagger si absente
- [ ] [2026+] Adresse de livraison si différente
- [ ] Mention franchise TVA si applicable (art. 293 B du CGI)
- [ ] Format Factur-X si émission électronique
```

## Format JSON d'une facture

Utilisé par `scripts/generate-facturx.js`, `scripts/validate-facture.js` et produit par `scripts/import-stripe-invoices.js`. Schéma complet dans `data/invoices/_template.json`.

```json
{
  "number": "F-2026-001",
  "date": "2026-09-15",
  "due_date": "2026-10-15",
  "type": "invoice",
  "category": "services",
  "client": {
    "name": "Client SAS",
    "address": "10 avenue de la République, 75011 Paris",
    "siren": "987654321"
  },
  "lines": [
    {
      "description": "Développement application web",
      "quantity": 10,
      "unit": "jours",
      "unit_price": 500.00
    }
  ],
  "payment": {
    "terms": "30 jours date de facture",
    "method": "virement"
  }
}
```

## Articulation facture ↔ écriture comptable

1. Générer la facture conforme (mentions, format, numérotation)
2. Enregistrer l'écriture : 706/707 (produits), 411 (créance client), 44571 (TVA collectée si régime réel)
3. Transmettre via la PA (quand l'obligation s'applique)

## Pipeline Stripe → Facture → Qonto

Utilisé quand les encaissements arrivent par Stripe et que le compte bancaire est Qonto :

1. **Import** : `node scripts/import-stripe-invoices.js --start YYYY-MM-DD --end YYYY-MM-DD`
   - Récupère les `invoices` Stripe au statut `paid` de la période
   - Génère un JSON par facture dans `data/invoices/F-YYYY-NNN.json`
   - Numérote via `invoicing.next_numbers[year]` (reset au 1er janvier)
   - Convertit les montants en EUR via `balance_transaction.exchange_rate`
   - Maintient `data/invoices/index.json` (map `stripe_id → invoice_number`) pour l'idempotence
2. **Génération PDF + XML Factur-X** : `node scripts/generate-facturx.js --invoice data/invoices/F-YYYY-NNN.json`
3. **Justificatif Qonto** : `node scripts/upload-qonto-attachments.js --upload`
   - Matche chaque crédit Stripe sur Qonto avec les factures émises dans la fenêtre temporelle
   - Génère un PDF récapitulatif listant les factures du payout
   - Uploade via `POST /v2/transactions/{uuid}/attachments` (max 5 pièces, 30 MB/pièce)

**Routine recommandée** : hebdomadaire (ex. lundi matin), paramétrable via cron. Les deux scripts sont idempotents.

Détails complets : voir [stripe-sync.md](stripe-sync.md).

## Numérotation par année

Convention : **séquence chronologique continue réinitialisée au 1er janvier**.

- `invoicing.next_numbers` est une map `{ "YYYY": N }` — pas un entier unique
- `import-stripe-invoices.js` utilise `next_numbers[year]` où `year` = année du `--start`
- Format : `{prefix}-YYYY-NNN` (ex. `F-2026-001`)
- L'avoir reprend le format avec `avoir_prefix` (ex. `AV-2026-001`)
- Aucun trou dans la séquence : un numéro émis ne peut pas être supprimé

## Refunds et avoirs Stripe

Un `refund` Stripe → **avoir** (note de crédit) côté facturation française :

1. Récupérer le refund Stripe et la facture d'origine (via `charge.invoice`)
2. Créer un avoir : `number` = `AV-YYYY-NNN` (nouvelle séquence ou séquence facture selon pratique), `type: "credit_note"`, référencer la facture d'origine
3. Mentions obligatoires avoir : voir `data/facturation/mentions-obligatoires.json` (clé `avoir`)
4. Écriture comptable : extourner 706/707 et 411, ajuster 44571 si TVA

## Réception des e-factures (obligation 1er septembre 2026)

**Toute entreprise assujettie TVA (y compris en franchise)** doit pouvoir recevoir des factures électroniques via une PA au 1er septembre 2026.

Checklist réception :

- [ ] `einvoicing.pa` défini dans `company.json`
- [ ] Compte actif sur la PA choisie
- [ ] `einvoicing.reception_ready: true` dans `company.json`
- [ ] Fournisseurs informés de l'identifiant PEPPOL (`einvoicing.peppol_id`)
- [ ] Workflow de rapprochement des factures entrantes défini (PA → comptabilité → règlement)
- [ ] Format de lecture : Factur-X (PDF/A-3 + XML), UBL ou CII

Voir [setup-facturation.md](setup-facturation.md) pour la configuration et [plateformes-agreees.md](plateformes-agreees.md) pour le choix d'une PA.
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