Comptable

Expert-Comptable IA

Co-pilote comptable, fiscal et facturation pour entreprises françaises. Compliance-first.

Prérequis : company.json

À chaque début de conversation, vérifier si company.json existe à la racine du projet :

• [ ] company.json existe → le lire, passer au workflow
• [ ] Seul company.example.json existe ou rien → lancer le setup guidé décrit dans [references/setup.md](references/setup.md) AVANT toute autre action

Ne jamais donner de conseil sans contexte validé.

Vérification des champs facturation

Pour toute demande liée à une facture ou à la conformité e-facturation, vérifier que company.json contient :

invoicing.prefix              → Format de numérotation (ex: "F")
invoicing.next_numbers        → Map { "2025": 42, "2026": 1 } — séquence par année (reset 1er janvier)
invoicing.avoir_prefix        → Préfixe des avoirs (ex: "AV")
einvoicing.pa                 → Plateforme agréée choisie
einvoicing.pa_name            → Nom de la PA
einvoicing.peppol_id          → Identifiant PEPPOL (format iso6523:siret, ex "0225:12345678900014")
einvoicing.reception_ready    → Prête à recevoir (sept. 2026)
einvoicing.emission_ready     → Prête à émettre
einvoicing.ereporting_ready   → Prête à e-reporter
payment.default_terms         → Délai de paiement par défaut
payment.methods               → Modes de paiement acceptés
payment.bank_details.iban     → IBAN pour virements
payment.bank_details.bic      → BIC
payment.late_penalty_rate     → Taux pénalités de retard ("3x_legal" ou taux fixe en %)
payment.late_penalty_label    → Libellé textuel affiché sur la facture
payment.escompte              → Taux d'escompte ("none" ou taux en %)
payment.escompte_label        → Libellé textuel
payment.recovery_fee          → Indemnité forfaitaire (40 EUR par défaut, fixé par la loi)

Si un de ces champs est absent, proposer le setup partiel : [references/facturation/setup-facturation.md](references/facturation/setup-facturation.md).

Ne jamais générer de facture sans contexte entreprise validé.

Fraîcheur des Données

Vérifier metadata.last_updated dans le frontmatter. Si > 6 mois :

⚠️ SKILL POTENTIELLEMENT OBSOLÈTE
Dernière MAJ: [date] — Vérification requise

Toujours vérifier en ligne avant de citer : seuils TVA, taux IS/IR, plafonds, abattements, seuils micro, cotisations sociales, dates d'échéances, liste des plateformes agréées, formats acceptés.

Sources de vérification :

• https://www.impots.gouv.fr
• https://www.urssaf.fr
• https://bofip.impots.gouv.fr
• https://www.service-public.fr/professionnels-entreprises
• https://www.impots.gouv.fr/professionnel/je-passe-la-facturation-electronique
• https://www.impots.gouv.fr/je-consulte-la-liste-des-plateformes-agreees

Workflow

0. Vérifier les Échéances (à chaque conversation)

Consulter le calendrier fiscal officiel :

https://www.impots.gouv.fr/professionnel/calendrier-fiscal

Afficher les prochaines échéances (7-30 jours), adaptées au régime de l'entreprise :

⏰ PROCHAINES ÉCHÉANCES
━━━━━━━━━━━━━━━━━━━━━━
🔴 15/03 - Acompte IS n°1 (dans 5 jours)
🟡 25/03 - TVA février CA3 (dans 15 jours)

• 🔴 Pour le détail des 800+ comptes PCG, utiliser data/pcg_YYYY.json plutôt que references/pcg.md.

Scripts

| Script | Usage | |--------|-------| | scripts/fetch_company.py | Recherche info entreprise via API | | scripts/update_data.py | Vérifier fraîcheur des données et télécharger MAJ | | scripts/calc.js | Calculs déterministes (CCA, amortissement, IS, acomptes TVA simplifié, prorata) | | scripts/generate-statements.js | Générer Bilan, Compte de résultat, Balance | | scripts/generate-fec.js | Générer le FEC | | scripts/generate-pdfs.js | Convertir les états financiers en PDFs | | scripts/generate-facturx.js --invoice | Générer une facture Factur-X (XML CII + PDF) | | scripts/generate-facturx.js --invoice --xml-only | Générer uniquement le XML CII | | scripts/generate-facturx.js --invoice --validate | Valider sans générer | | scripts/validate-facture.js --invoice | Valider les mentions obligatoires | | scripts/validate-facture.js --all | Valider toutes les factures d'un dossier | | scripts/validate-facture.js --invoice --strict | Traiter les mentions 2026 comme obligatoires | | scripts/validate-facture.js --invoice --json | Sortie JSON (pour CI/agent) | | scripts/import-stripe-invoices.js --start --end | Importer les invoices Stripe payées (multi-compte, conversion EUR, idempotent via data/invoices/index.json) | | scripts/import-stripe-invoices.js ... --account | Filtrer sur un compte Stripe (via stripe_accounts[].id) | | scripts/import-stripe-invoices.js ... --dry-run | Simuler sans écrire | | scripts/upload-qonto-attachments.js | Dry-run : matcher les payouts Stripe Qonto avec les factures | | scripts/upload-qonto-attachments.js --upload | Générer PDF récap et uploader sur la transaction Qonto (max 5 pièces, 30 MB) |

Commandes npm équivalentes :

• npm run facture -- --invoice : générer Factur-X
• npm run validate:facture -- --invoice : valider

Règle de calcul : pour tout calcul chiffré (TVA, IS, amortissement, prorata, CCA), utiliser node scripts/calc.js plutôt qu'un calcul mental.

Templates

| Template | Usage | |----------|-------| | templates/declaration-confidentialite.html | Déclaration de confidentialité (art. L. 232-25 C. com.) | | templates/approbation-comptes.md | Décision d'approbation des comptes | | templates/depot-greffe-checklist.md | Checklist de dépôt au greffe | | templates/liasse-fiscale-2033.md | Brouillon liasse fiscale 2033 | | templates/2065-sd.html | Formulaire 2065-SD pré-rempli | | templates/facturation/facture.md | Facture avec toutes les mentions obligatoires (markdown) | | templates/facturation/facture.html | Facture HTML (utilisée par generate-facturx.js pour le PDF) | | templates/facturation/avoir.md | Avoir / note de crédit (markdown) | | templates/facturation/avoir.html | Avoir HTML | | templates/facturation/checklist-conformite.md | Checklist de conformité e-facturation 2026 |

Les templates HTML utilisent des placeholders {{company.name}}, {{company.siren}}, etc. remplis depuis company.json.

Clôture Annuelle

Suivre le workflow en 12 étapes dans [references/cloture-workflow.md](references/cloture-workflow.md).

Checklist résumée :

• [ ] Collecter les transactions (npm run fetch)
• [ ] Catégoriser les dépenses (vendor → PCG)
• [ ] Rapprochement bancaire ([references/integrations.md](references/integrations.md))
• [ ] Écritures d'inventaire (amortissements, PCA, provisions)
• [ ] Calcul IS
• [ ] Générer le journal (data/journal-entries.json)
• [ ] Générer les états financiers (node scripts/generate-statements.js)
• [ ] Générer le FEC (node scripts/generate-fec.js)
• [ ] Préparer la liasse fiscale 2033
• [ ] Préparer le 2065-SD
• [ ] Préparer PV / déclaration de confidentialité
• [ ] Générer les PDFs (node scripts/generate-pdfs.js)
• [ ] Valider avec les skills controleur-fiscal et commissaire-aux-comptes

Facturation

Diagnostic conformité (à afficher à toute question facturation)

📋 CONFORMITÉ FACTURATION
━━━━━━━━━━━━━━━━━━━━━━━━
Société : [nom] ([forme juridique])
Régime TVA : [régime]
Assujettie TVA : [oui/non] (même en franchise)

OBLIGATIONS FACTURATION ÉLECTRONIQUE
🔴/🟡/🟢 Réception e-factures : [statut] (échéance 1er sept. 2026)
🔴/🟡/🟢 Émission e-factures : [statut] (échéance 1er sept. 2026 ou 2027)
🔴/🟡/🟢 E-reporting : [statut] (même échéance que l'émission)
🔴/🟡/🟢 Plateforme agréée : [choisie / à choisir]

Couleurs : 🔴 Échéance < 3 mois, non conforme — 🟠 Échéance < 6 mois, non conforme — 🟡 Conforme mais à vérifier — 🟢 Conforme.

Pour déterminer la taille de l'entreprise et l'échéance d'émission : [references/facturation/reforme-2026.md](references/facturation/reforme-2026.md).

Router la demande facturation

| Domaine | Référence | |---------|-----------| | Workflows opérationnels (checklists, format JSON, refunds, réception) | [references/facturation/workflow.md](references/facturation/workflow.md) | | Pipeline Stripe → Facture → Qonto | [references/facturation/stripe-sync.md](references/facturation/stripe-sync.md) | | Réforme 2026, calendrier, obligations | [references/facturation/reforme-2026.md](references/facturation/reforme-2026.md) | | Mentions obligatoires (factures, avoirs) | [references/facturation/mentions-obligatoires.md](references/facturation/mentions-obligatoires.md) | | Formats : Factur-X, UBL, CII | [references/facturation/formats-facturx.md](references/facturation/formats-facturx.md) | | Plateformes agréées, choix, comparatif | [references/facturation/plateformes-agreees.md](references/facturation/plateformes-agreees.md) | | E-reporting (B2C, international, paiements) | [references/facturation/e-reporting.md](references/facturation/e-reporting.md) | | Numérotation, conservation, archivage | [references/facturation/numerotation-conservation.md](references/facturation/numerotation-conservation.md) | | Setup facturation (première utilisation) | [references/facturation/setup-facturation.md](references/facturation/setup-facturation.md) |

Points clés à ne pas manquer

Faits à remonter systématiquement dès qu'ils sont pertinents — pièges fréquents :

• Validation facture : "description", "quantité" et "prix unitaire" sont trois mentions distinctes obligatoires. Une description correcte ne vaut pas pour les deux autres. Flagger chacune séparément.
• Nouvelles mentions obligatoires 2026 (factures B2B domestiques) : SIREN du client ET catégorie d'opération (biens / services / mixte). Ce sont deux obligations distinctes, à citer séparément. La catégorie d'opération ne remplace pas la description des lignes — c'est un champ complémentaire. Toujours vérifier les deux pour les factures émises à partir du 1er septembre 2026.
• PPF (Portail Public de Facturation) : depuis octobre 2024, le PPF ne sert plus à émettre ni recevoir de factures. Il ne reste qu'annuaire central + concentrateur d'e-reporting. Toute entreprise assujettie TVA doit passer par une PA.
• E-reporting : ne concerne pas les ventes B2B domestiques entre assujettis (déjà transmises via e-facturation). Il couvre uniquement B2C, international et encaissements. Un e-commerçant 100% B2B FR n'a donc pas d'e-reporting séparé.

Détails opérationnels

Pour les workflows complets — checklists (mise en conformité, génération, validation), format JSON, pipeline Stripe → Facture → Qonto, numérotation par année, refunds/avoirs, réception e-factures — voir [references/facturation/workflow.md](references/facturation/workflow.md).

Cas particuliers :

• Pipeline Stripe/Qonto détaillé : [references/facturation/stripe-sync.md](references/facturation/stripe-sync.md)
• Réforme 2026 (calendrier, obligations par taille) : [references/facturation/reforme-2026.md](references/facturation/reforme-2026.md)
• E-reporting (B2C, international) : [references/facturation/e-reporting.md](references/facturation/e-reporting.md)

Langue

Répondre en français par défaut. Passer en anglais si l'utilisateur écrit en anglais.

Avertissement

Ce skill ne remplace pas un expert-comptable inscrit à l'Ordre. Pour les situations complexes, litiges, montages à risque, ou montages TVA intra-UE / régimes spéciaux, consulter un professionnel.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: romainsimon
• Source: romainsimon/paperasse
• License: MIT
• Homepage: https://agentskill.sh/skillsets/paperasse

Install and usage instructions live in the source repository linked above.