Use this skill with your AI agent
Paste this skill into your AI agent's context, or save the file to your project. Works with any AI agent that reads markdown.
fr-return-assembly.md440 lines25.9 KB
v10France
Not yet verified by an accountantContact accountant
| 1 | --- |
| 2 | name: fr-return-assembly |
| 3 | description: Final orchestrator skill that assembles the complete French filing package for France-resident self-employed individuals, micro-entrepreneurs, and sole proprietors. Consumes outputs from all French content skills (france-tva for TVA CA3/CA12, france-income-tax for 2042/2042-C-PRO/2035/2031, france-cotisations for URSSAF/SSI, fr-estimated-tax for prélèvement à la source) to produce a single unified reviewer package containing every worksheet, every form, every brief section, all cross-skill reconciliations, and the final action list with payment instructions, filing instructions, and next-year planning. This is the capstone skill that runs last and produces the final deliverable. MUST be loaded alongside all French content skills listed above. France full-year residents only. Self-employed individuals, micro-entrepreneurs, and sole proprietors only. |
| 4 | version: 1.0 |
| 5 | jurisdiction: FR |
| 6 | category: orchestrator |
| 7 | --- |
| 8 | |
| 9 | # France Return Assembly Skill v1.0 |
| 10 | |
| 11 | ## CRITICAL EXECUTION DIRECTIVE -- READ FIRST |
| 12 | |
| 13 | **When this skill is invoked, you have already passed through intake. The user has consented to the full workflow. Execute all steps without pausing for permission.** |
| 14 | |
| 15 | Specifically: |
| 16 | |
| 17 | - **Do NOT ask the user "how deep do you want me to go"** or "do you want the full package" or any variant. The user asked for their tax returns. They want their tax returns. Produce them. |
| 18 | - **Do NOT announce how many tokens or tool calls this will take.** Execute. |
| 19 | - **Do NOT ask which deliverables to prioritise.** Produce all deliverables listed in Section 4. If you run out of context mid-execution, finish the computation work first (numbers, positions, flags) then produce whatever formatted outputs you can, and at the very end state clearly which deliverables were not produced and why. |
| 20 | - **Do NOT re-validate scope that intake already validated.** If `fr-freelance-intake` produced an intake package, trust it. You can cross-check specific numbers during reconciliation but do not re-interrogate the user about residency, business structure, or anything else intake already captured. |
| 21 | - **Do NOT pause between content skills to check in.** Run them in dependency order (Section 2) without prose status updates between each one. A single status message at the end is fine. |
| 22 | - **Self-checks are targets, not blockers.** If a self-check fails, note it in the reviewer brief's open flags section and continue. Do NOT halt the entire workflow because one self-check had an ambiguous answer. |
| 23 | - **Primary source citations go in the final reviewer brief, not in intermediate computation steps.** |
| 24 | |
| 25 | **The user has already been told (by the intake skill) that the final package requires expert-comptable signoff before filing. State it once in the final output and move on.** |
| 26 | |
| 27 | **Failure mode to avoid:** The skill halts mid-execution and asks the user a meta-question about workflow pacing. If you feel the urge to ask "how should I proceed," the correct action is to pick the most defensible path and proceed, flagging the decision in the reviewer brief so the reviewer can challenge it. |
| 28 | |
| 29 | --- |
| 30 | |
| 31 | ## What this file is |
| 32 | |
| 33 | The final capstone skill for French self-employed returns. Every French content skill feeds into this one. The output is the complete reviewer package that an expert-comptable can review, sign off on, and deliver to the client along with filing instructions. |
| 34 | |
| 35 | This skill coordinates execution of the content skills, verifies cross-skill consistency, and assembles the final deliverable. |
| 36 | |
| 37 | --- |
| 38 | |
| 39 | ## Section 1 -- Scope |
| 40 | |
| 41 | Produces the complete French filing package for: |
| 42 | - Full-year France residents |
| 43 | - Self-employed individuals: micro-entrepreneurs, entreprises individuelles au réel, professions libérales, EURL at IR |
| 44 | - Tax year 2025 (revenus 2025, déclaration printemps 2026) |
| 45 | - Filing déclaration de revenus (2042 / 2042-C-PRO), TVA returns (CA3 / CA12 or franchise verification), cotisations sociales reconciliation (URSSAF), CFE, prélèvement à la source (PAS) rate update |
| 46 | |
| 47 | --- |
| 48 | |
| 49 | ## Section 2 -- Execution order and dependency chain |
| 50 | |
| 51 | The skill enforces the following execution order: |
| 52 | |
| 53 | 1. **`france-tva`** -- TVA return or franchise en base verification |
| 54 | - Runs first because TVA turnover figures feed into the income tax declaration |
| 55 | - For réel normal: verify or prepare CA3 returns (monthly/quarterly) |
| 56 | - For réel simplifié: verify or prepare CA12 (annual + 2 acomptes semestriels in July and December) |
| 57 | - For franchise en base: verify threshold compliance (€36,800 basic / €39,100 tolérance for services; €91,900 / €101,000 for goods -- Article 293 B CGI) |
| 58 | - Flag if franchise threshold exceeded: mandatory TVA registration required |
| 59 | - Output: TVA position (collectée, déductible, solde), turnover HT confirmed, any crédit de TVA |
| 60 | |
| 61 | 2. **`france-income-tax`** -- Déclaration de revenus (2042 / 2042-C-PRO) and liasse fiscale if au réel |
| 62 | - Depends on TVA output: chiffre d'affaires HT must be consistent between TVA and income declarations |
| 63 | - Micro-entrepreneur path: 2042-C-PRO cases 5KO/5KP (BIC micro ventes), 5KI/5KJ (BIC micro services), 5HQ/5HB (BNC micro) with abattement forfaitaire (71% BIC ventes, 50% BIC services, 34% BNC) |
| 64 | - Réel BNC path: 2035 (déclaration contrôlée) + 2042-C-PRO cases 5QC/5QI |
| 65 | - Réel BIC path: 2031 + 2042-C-PRO cases 5KC/5KI |
| 66 | - Quotient familial calculation using parts fiscales |
| 67 | - Barème progressif application (0%, 11%, 30%, 41%, 45% -- 2025 tranches) |
| 68 | - Décote, plafonnement du quotient familial |
| 69 | - Output: revenu net imposable, impôt brut, impôt net, solde à payer ou remboursement |
| 70 | |
| 71 | 3. **`france-cotisations`** -- Cotisations sociales (URSSAF micro-social or TNS réel) |
| 72 | - Depends on income: micro-social base = chiffre d'affaires; TNS réel base = bénéfice |
| 73 | - Micro-social rates (2025): 12.3% BIC vente de marchandises, 21.1% BIC prestations de services, 21.1% BNC, 21.2% professions libérales CIPAV |
| 74 | - ACRE: 50% reduction on cotisations for eligible créateurs (first 4 quarters) |
| 75 | - Versement libératoire de l'IR: 1.0% (BIC ventes), 1.7% (BIC services), 2.2% (BNC) -- eligibility requires RFR N-2 per part ≤ €27,478 |
| 76 | - TNS réel: cotisations provisionnelles based on prior year + régularisation. Includes maladie-maternité, indemnités journalières, retraite de base, retraite complémentaire, invalidité-décès, allocations familiales, CSG-CRDS |
| 77 | - Output: total cotisations due, payments made, shortfall/overpayment, deductible portion for IR |
| 78 | |
| 79 | 4. **`fr-estimated-tax`** -- Prélèvement à la source (PAS) and acomptes contemporains |
| 80 | - Depends on income tax: updated PAS rate based on 2025 revenu |
| 81 | - Self-employed pay PAS via acomptes contemporains (monthly or quarterly debits from bank account by DGFiP) |
| 82 | - New rate calculated and applicable from September 2026 (after 2025 return processed) |
| 83 | - Output: updated PAS rate, projected monthly/quarterly acompte amounts for 2026-2027 |
| 84 | |
| 85 | If any upstream content skill fails to produce validated output, the assembly skill notes the failure in the reviewer brief and continues with available data rather than halting entirely. |
| 86 | |
| 87 | --- |
| 88 | |
| 89 | ## Section 3 -- Cross-skill reconciliation |
| 90 | |
| 91 | ### Cross-check 1: TVA turnover matches income declaration |
| 92 | |
| 93 | | TVA Output | Income Tax Input | Rule | |
| 94 | |-----------|-----------------|------| |
| 95 | | CA3/CA12 total CA HT | 2042-C-PRO declared CA or 2035/2031 recettes | Must match within €1 | |
| 96 | | Franchise en base: declared CA | 2042-C-PRO micro cases (5KO/5KP/5HQ etc.) | CA reported to URSSAF = CA on 2042-C-PRO | |
| 97 | | Réel: CA HT from TVA returns | 2035 ligne GA / 2031 ligne FL | TVA-declared and income-declared turnover must reconcile | |
| 98 | |
| 99 | **If mismatch:** Flag for reviewer. Common causes: encaissements vs créances (cash vs accrual basis timing), avoir (credit notes), foreign income not subject to French TVA. |
| 100 | |
| 101 | ### Cross-check 2: Chiffre d'affaires declared to URSSAF matches income declaration |
| 102 | |
| 103 | | URSSAF Input | Income Tax Input | Rule | |
| 104 | |-------------|-----------------|------| |
| 105 | | Micro-social: total CA declared quarterly/monthly | 2042-C-PRO micro cases | Must match exactly | |
| 106 | | TNS réel: bénéfice used for cotisations base | 2035/2031 résultat fiscal | Cotisations base = bénéfice + CSG non déductible + Madelin - some adjustments (Article L.131-6 CSS) | |
| 107 | |
| 108 | **If mismatch:** Verify timing. Micro-social declarations are cash-basis (encaissements). If 2042-C-PRO matches URSSAF total, good. If not, reconcile and explain the difference. |
| 109 | |
| 110 | ### Cross-check 3: Cotisations sociales deductibility |
| 111 | |
| 112 | | Item | Micro Regime | Réel Regime | |
| 113 | |------|-------------|-------------| |
| 114 | | URSSAF cotisations | Included in abattement forfaitaire -- NOT separately deductible | Deductible from bénéfice (charges de l'exercice) | |
| 115 | | CSG déductible (6.8% of 9.2% total) | Included in abattement | Deductible on 2042 case 6DE (for TNS réel) | |
| 116 | | CSG non déductible (2.4%) + CRDS (0.5%) | Included in abattement | NOT deductible -- must be reintegrated | |
| 117 | | Cotisations Madelin (prévoyance, retraite) | NOT deductible (micro has no expense deduction) | Deductible from BNC/BIC within ceilings (Article 154 bis CGI) | |
| 118 | |
| 119 | **If inconsistency:** An expense deducted on 2035/2031 that is also covered by the micro abattement is double-counted. Flag for reviewer. |
| 120 | |
| 121 | ### Cross-check 4: TVA input tax and income tax deductions consistency |
| 122 | |
| 123 | | Item | TVA Treatment | Income Tax Treatment | |
| 124 | |------|--------------|---------------------| |
| 125 | | Reclaimable TVA (réel simplifié/normal) | Claimed on CA3/CA12 as TVA déductible | NOT a deduction on 2035/2031 (expense recorded HT) | |
| 126 | | Non-reclaimable TVA (franchise en base) | No TVA recovery | IS part of cost -- expense recorded TTC | |
| 127 | | Non-reclaimable TVA (blocked: véhicules de tourisme, cadeaux >€73 TTC per person per year) | Not claimed | Added to cost (TTC amount deducted) | |
| 128 | | Immobilisations TVA (réel regime) | TVA déductible on immobilisations (CA3 ligne 19 / CA12 ligne 15) | Capital asset recorded HT, amortised over useful life | |
| 129 | |
| 130 | **If inconsistency:** An expense claimed HT on the income side while TVA was not recovered means the TVA portion is lost. Flag for reviewer. |
| 131 | |
| 132 | ### Cross-check 5: CFE and other local taxes |
| 133 | |
| 134 | | Tax | Treatment | |
| 135 | |-----|-----------| |
| 136 | | CFE (Cotisation Foncière des Entreprises) | Deductible charge for réel regime (2035/2031). Not deductible for micro (included in abattement). | |
| 137 | | CVAE (Cotisation sur la Valeur Ajoutée des Entreprises) | Only if CA > €500,000. Rare for individual freelancers. | |
| 138 | |
| 139 | **If micro-entrepreneur claims CFE as a deduction:** Error. Micro regime uses forfaitaire abattement only. |
| 140 | |
| 141 | ### Cross-check 6: Versement libératoire de l'IR coherence |
| 142 | |
| 143 | | Check | Rule | |
| 144 | |-------|------| |
| 145 | | VL opted in | Verify RFR N-2 per part ≤ €27,478 (2025 threshold, based on 2023 revenus) | |
| 146 | | VL payments made | Must equal 1.0% / 1.7% / 2.2% of declared CA (per activity type) | |
| 147 | | VL and 2042-C-PRO | CA still reported on 2042-C-PRO (cases 5TE/5UE for BIC ventes, 5TB/5UB for BIC services, 5TE/5UE for BNC) but NOT included in barème calculation | |
| 148 | | VL and quotient familial | If VL opted in, the self-employment income does NOT enter the progressive scale. But it IS included in RFR. | |
| 149 | |
| 150 | **If VL opted in but RFR N-2 exceeds threshold:** VL is void. Income reverts to progressive scale for 2025. Flag immediately. |
| 151 | |
| 152 | --- |
| 153 | |
| 154 | ## Section 4 -- Final reviewer package contents |
| 155 | |
| 156 | ### Documents |
| 157 | |
| 158 | 1. **Executive summary** -- one-page overview: filing status, income, impôt net, TVA position, cotisations, PAS update, solde dû/remboursement |
| 159 | 2. **TVA worksheet** -- CA3/CA12 box-by-box or franchise verification with threshold analysis |
| 160 | 3. **Income tax worksheet** -- 2042 / 2042-C-PRO line-by-line, plus 2035 or 2031 if réel |
| 161 | 4. **Quotient familial and barème calculation** -- parts, tranches, décote, plafonnement |
| 162 | 5. **Cotisations sociales reconciliation** -- micro-social quarterly breakdown or TNS réel annual with régularisation |
| 163 | 6. **CFE verification** -- amount paid, deductibility |
| 164 | 7. **PAS rate update** -- current rate, projected new rate, acomptes contemporains for 2026-2027 |
| 165 | 8. **Cross-skill reconciliation summary** -- all six cross-checks with pass/fail and notes |
| 166 | 9. **Reviewer brief** -- comprehensive narrative with positions, citations, flags, self-check results |
| 167 | 10. **Client action list** -- what the client needs to do, with dates and amounts |
| 168 | |
| 169 | ### Reviewer brief contents |
| 170 | |
| 171 | ```markdown |
| 172 | # Complete Return Package: [Client Name] -- Revenus 2025 |
| 173 | |
| 174 | ## Executive Summary |
| 175 | - Filing status: [Single / Married-joint / PACSé / Single parent] |
| 176 | - Parts fiscales: X |
| 177 | - Residence: France (full-year) |
| 178 | - Business: [Micro-entrepreneur / EI au réel / Profession libérale] |
| 179 | - Regime fiscal: [Micro-BNC / Micro-BIC / Déclaration contrôlée / Réel simplifié] |
| 180 | - Regime TVA: [Franchise en base / Réel simplifié / Réel normal] |
| 181 | - Chiffre d'affaires HT: €X |
| 182 | - Revenu net imposable (foyer): €X |
| 183 | - Impôt brut: €X |
| 184 | - Impôt net (after crédits/réductions): €X |
| 185 | - PAS already withheld (acomptes contemporains 2025): €X |
| 186 | - Solde à payer / Remboursement: €X |
| 187 | - TVA position: €X due / €X crédit |
| 188 | - Cotisations sociales paid: €X / due: €X |
| 189 | - CFE: €X |
| 190 | - PAS rate for 2026-2027: X% |
| 191 | |
| 192 | ## TVA Return |
| 193 | [Content from france-tva output] |
| 194 | - Registration type and regime |
| 195 | - Chiffre d'affaires HT by period |
| 196 | - TVA collectée summary (20%, 10%, 5.5% rates) |
| 197 | - TVA déductible summary (biens et services, immobilisations) |
| 198 | - Crédit de TVA position |
| 199 | - Franchise en base threshold analysis (if applicable) |
| 200 | - DEB/DES obligations (EU transactions) |
| 201 | - Box-by-box CA3 or CA12 summary |
| 202 | |
| 203 | ## Income Tax Return (2042 / 2042-C-PRO) |
| 204 | [Content from france-income-tax output] |
| 205 | ### Micro-entrepreneur path: |
| 206 | - 2042-C-PRO cases: CA declared, abattement applied, revenu net micro |
| 207 | - Versement libératoire: amount paid, eligibility check |
| 208 | ### Réel path: |
| 209 | - 2035/2031 summary: recettes, charges déductibles, résultat fiscal |
| 210 | - Amortissements schedule (immobilisations) |
| 211 | - Plus/moins-values professionnelles (if any) |
| 212 | ### Common: |
| 213 | - 2042 foyer income: all income categories |
| 214 | - Quotient familial computation |
| 215 | - Barème progressif application (tranches 2025: 0% up to €11,294, 11% up to €28,797, 30% up to €82,341, 41% up to €177,106, 45% above) |
| 216 | - Décote (if impôt brut < €1,929 single / €3,191 couple) |
| 217 | - Plafonnement du quotient familial (€1,759 per demi-part 2025) |
| 218 | - Réductions d'impôt (dons, etc.) |
| 219 | - Crédits d'impôt (emploi à domicile, garde enfants, etc.) |
| 220 | - Impôt net |
| 221 | - PAS acomptes contemporains paid during 2025 |
| 222 | - Solde: due or refund |
| 223 | |
| 224 | ## Cotisations Sociales (URSSAF) |
| 225 | [Content from france-cotisations output] |
| 226 | ### Micro-social path: |
| 227 | - Quarterly/monthly CA declared |
| 228 | - Rate applied (12.3% / 21.1% / 21.2%) |
| 229 | - ACRE reduction (if applicable) |
| 230 | - Total cotisations paid |
| 231 | - Contribution formation professionnelle (CFP): 0.1% (commerce) / 0.2% (services/libéral) / 0.3% (artisan) |
| 232 | ### TNS réel path: |
| 233 | - Assiette de cotisations (bénéfice + CSG/CRDS non déductible ± ajustements) |
| 234 | - Cotisations provisionnelles 2025 (based on 2024 revenus) |
| 235 | - Régularisation 2024 (if final 2024 figures now available) |
| 236 | - Breakdown: maladie-maternité, IJ, retraite base, retraite complémentaire, invalidité-décès, AF, CSG-CRDS |
| 237 | - Total due vs total paid |
| 238 | - CSG déductible amount (for 2042 case 6DE) |
| 239 | - Cotisations Madelin within ceilings (Article 154 bis CGI) |
| 240 | |
| 241 | ## CFE |
| 242 | - Commune and base d'imposition |
| 243 | - Amount paid for 2025 |
| 244 | - Deductibility: yes (réel) / no (micro, included in abattement) |
| 245 | - Exonération première année (if applicable) |
| 246 | |
| 247 | ## Prélèvement à la Source (PAS) |
| 248 | [Content from fr-estimated-tax output] |
| 249 | - Current PAS rate: X% |
| 250 | - Acomptes contemporains paid during 2025: €X |
| 251 | - Projected new PAS rate (effective September 2026): X% |
| 252 | - Projected monthly/quarterly acompte for 2026-2027: €X |
| 253 | - Option to modulate PAS rate if significant income change |
| 254 | |
| 255 | ## Cross-skill Reconciliation |
| 256 | - TVA turnover vs 2042-C-PRO / 2035 / 2031: [pass/fail] |
| 257 | - URSSAF declared CA vs income declaration: [pass/fail] |
| 258 | - Cotisations deductibility coherence: [pass/fail] |
| 259 | - TVA input tax vs income deductions: [pass/fail] |
| 260 | - CFE treatment: [pass/fail] |
| 261 | - Versement libératoire coherence: [pass/fail] |
| 262 | |
| 263 | ## Reviewer Attention Flags |
| 264 | [Aggregated from all upstream skills] |
| 265 | - Franchise en base threshold exceeded (mandatory TVA registration) |
| 266 | - Versement libératoire eligibility (RFR N-2 per part check) |
| 267 | - ACRE period verification |
| 268 | - Mixed-use expense percentages (home office, vehicle, phone) |
| 269 | - EU services and DES declaration obligation |
| 270 | - Micro regime threshold approaching (€77,700 services / €188,700 goods) |
| 271 | - Any déficits reportables to carry forward |
| 272 | - Cotisations Madelin within deductibility ceilings |
| 273 | - Plafonnement du quotient familial impact |
| 274 | |
| 275 | ## Positions Taken |
| 276 | [List with legislation citations] |
| 277 | - e.g., "Franchise en base maintained per Article 293 B CGI -- CA €34,200 remains below €36,800 seuil de base" |
| 278 | - e.g., "Abattement forfaitaire micro-BNC at 34% applied per Article 102 ter CGI" |
| 279 | - e.g., "Home office deduction at 20% of surface -- prorata applied per BOI-BNC-BASE-40-60-60" |
| 280 | - e.g., "ACRE 50% reduction applied for first 4 quarters per Article L.131-6-4 CSS" |
| 281 | - e.g., "Cotisations Madelin retraite €4,200 deducted within ceiling per Article 154 bis CGI (plafond: 10% of bénéfice + 15% fraction between 1 and 8 PASS)" |
| 282 | |
| 283 | ## Planning Notes for 2026 |
| 284 | - PAS rate update and acomptes contemporains schedule |
| 285 | - URSSAF cotisations provisionnelles for 2026 (based on 2025 income) |
| 286 | - TVA threshold monitoring (franchise en base or micro regime limits) |
| 287 | - Capital asset amortissement continuing into 2026 |
| 288 | - Versement libératoire IR eligibility re-check (2024 RFR per part for 2026) |
| 289 | - CFE: any base change, dégrèvement, or new commune |
| 290 | - Any legislative changes affecting 2026 (loi de finances, PLFSS) |
| 291 | |
| 292 | ## Client Action List |
| 293 | |
| 294 | ### Immediate (déclaration de revenus -- spring 2026): |
| 295 | 1. Review this return package with your expert-comptable |
| 296 | 2. File déclaration de revenus via impots.gouv.fr (zones: April-June 2026 depending on département) |
| 297 | - Zone 1 (départements 01-19 + non-residents): late May |
| 298 | - Zone 2 (départements 20-54): early June |
| 299 | - Zone 3 (départements 55-976): mid-June |
| 300 | 3. Pay solde d'IR if any (September 2026 direct debit, or earlier if >€300) |
| 301 | 4. File CA12 by 2nd working day of May 2026 (if réel simplifié) |
| 302 | 5. File remaining CA3 returns by the 15th-24th of following month (if réel normal) |
| 303 | |
| 304 | ### TVA filing calendar (if réel): |
| 305 | - CA3 (réel normal): monthly by 15th-24th of following month (depending on DGFIP calendar) |
| 306 | - CA12 (réel simplifié): annual return by 2nd working day of May 2026 |
| 307 | - 1er acompte: July 2026 (55% of prior year TVA nette) |
| 308 | - 2ème acompte: December 2026 (40% of prior year TVA nette) |
| 309 | |
| 310 | ### URSSAF (micro-social): |
| 311 | - Monthly or quarterly declarations continue on autoentrepreneur.urssaf.fr |
| 312 | - Monthly: due last day of following month |
| 313 | - Quarterly: due 31 January (Q4), 30 April (Q1), 31 July (Q2), 31 October (Q3) |
| 314 | |
| 315 | ### URSSAF (TNS réel): |
| 316 | - Cotisations provisionnelles 2026 debited monthly or quarterly |
| 317 | - Régularisation 2025 after DSI filed (included in updated échéancier) |
| 318 | |
| 319 | ### CFE: |
| 320 | - Acompte: 15 June 2026 (if prior year CFE > €3,000) |
| 321 | - Solde: 15 December 2026 |
| 322 | |
| 323 | ### PAS: |
| 324 | - New PAS rate effective September 2026 after DGFiP processes 2025 return |
| 325 | - Option to request modulation if income changed significantly (via impots.gouv.fr > Gérer mon prélèvement à la source) |
| 326 | |
| 327 | ### Ongoing: |
| 328 | 1. Issue TVA-compliant invoices (numéro SIRET, mentions obligatoires per Article 242 nonies A annexe II CGI) |
| 329 | 2. Retain all purchase invoices and receipts (6-year retention for fiscal, 10-year commercial -- Articles L.102 B and L.123-22 Code de commerce) |
| 330 | 3. Maintain FEC-ready bookkeeping if au réel (fichier des écritures comptables -- Article L.47 A LPF) |
| 331 | 4. Monitor franchise en base threshold monthly |
| 332 | 5. File DES (déclaration européenne de services) if providing services to EU clients |
| 333 | 6. Monitor micro-entrepreneur thresholds for potential régime change |
| 334 | ``` |
| 335 | |
| 336 | --- |
| 337 | |
| 338 | ## Section 5 -- Refusals |
| 339 | |
| 340 | **R-FR-A1 -- Upstream skill did not run.** Name the specific skill. Note: this is a warning, not a hard stop. Continue with available data and flag the gap. |
| 341 | |
| 342 | **R-FR-A2 -- Upstream self-check failed.** Name the specific check and note it in the reviewer brief. Continue. |
| 343 | |
| 344 | **R-FR-A3 -- Cross-skill reconciliation failed.** Name the specific reconciliation and describe the discrepancy. Flag for reviewer but continue. |
| 345 | |
| 346 | **R-FR-A4 -- Intake incomplete.** Specific missing intake items prevent computation. List what is missing and ask the user for the specific data point. |
| 347 | |
| 348 | **R-FR-A5 -- Out-of-scope item discovered during assembly.** E.g., SCI income, agricultural activity, or foreign pension. Flag and exclude from computation. |
| 349 | |
| 350 | **R-FR-A6 -- Franchise en base threshold exceeded.** This is a critical flag, not a refusal. The computation continues, but the reviewer brief must prominently warn that TVA registration is legally required and prior invoices may need correction. |
| 351 | |
| 352 | --- |
| 353 | |
| 354 | ## Section 6 -- Self-checks |
| 355 | |
| 356 | **Check FR1 -- All upstream skills executed.** france-tva, france-income-tax, france-cotisations all produced output. fr-estimated-tax produced output or PAS was computed from income tax output. |
| 357 | |
| 358 | **Check FR2 -- TVA turnover matches income declaration.** CA HT within €1 tolerance across TVA and 2042-C-PRO / 2035 / 2031. |
| 359 | |
| 360 | **Check FR3 -- URSSAF CA matches income declaration.** Micro-social total declared CA = 2042-C-PRO micro cases. Or TNS réel bénéfice correctly flows to cotisation base. |
| 361 | |
| 362 | **Check FR4 -- Correct abattement applied for micro.** 71% for BIC ventes, 50% for BIC services, 34% for BNC. No mixing. |
| 363 | |
| 364 | **Check FR5 -- Quotient familial correctly computed.** Parts match marital status + children + single parent bonus. |
| 365 | |
| 366 | **Check FR6 -- Barème applied to correct revenu.** Revenu net imposable / parts = revenu par part. Each tranche applied correctly. |
| 367 | |
| 368 | **Check FR7 -- Versement libératoire eligibility verified.** If opted in, RFR N-2 per part ≤ €27,478. If ineligible, income reverts to barème. |
| 369 | |
| 370 | **Check FR8 -- CSG déductible correctly identified.** Only 6.8% of total 9.2% CSG is déductible (for TNS réel). Non-déductible CSG (2.4%) + CRDS (0.5%) not deducted on 2042. |
| 371 | |
| 372 | **Check FR9 -- Cotisations Madelin within ceilings.** Article 154 bis CGI ceiling respected for prévoyance, retraite, perte d'emploi. |
| 373 | |
| 374 | **Check FR10 -- CFE treatment correct.** Deductible for réel, not for micro. Not double-counted. |
| 375 | |
| 376 | **Check FR11 -- PAS acomptes contemporains reconciled.** Total paid during 2025 applied against impôt net to compute solde. |
| 377 | |
| 378 | **Check FR12 -- Filing calendar is complete.** All deadlines for TVA, 2042, URSSAF, CFE, and PAS are listed with specific dates and amounts. |
| 379 | |
| 380 | **Check FR13 -- Reviewer brief contains legislation citations.** Every position taken references the specific article of CGI, CSS, or LPF. |
| 381 | |
| 382 | --- |
| 383 | |
| 384 | ## Section 7 -- Output files |
| 385 | |
| 386 | The final output is **three files**: |
| 387 | |
| 388 | 1. **`[client_slug]_2025_france_master.xlsx`** -- Single master workbook containing every worksheet and form. Sheets include: Cover, TVA (CA3/CA12 or franchise check), 2042-C-PRO (micro or réel), Barème & Quotient Familial, 2035/2031 (if réel), Cotisations Sociales, CFE, PAS Update, Cross-Check Summary. Use live formulas where possible -- e.g., 2042-C-PRO CA references the TVA turnover cell; micro abattement computed automatically; barème tranches calculated from revenu net imposable. Verify no `#REF!` errors. Verify computed values match the Python/computation model within €1 before shipping. |
| 389 | |
| 390 | 2. **`reviewer_brief.md`** -- Single markdown file covering all sections from Section 4 above: executive summary, TVA, income tax, cotisations, CFE, PAS, cross-skill reconciliation, flags, positions, planning notes. |
| 391 | |
| 392 | 3. **`client_action_list.md`** -- Single markdown file with step-by-step actions: immediate filings and payments, TVA calendar, URSSAF calendar, CFE dates, PAS updates, ongoing compliance reminders. |
| 393 | |
| 394 | **If execution runs out of context mid-build:** produce whatever is complete, then state at the end which of the three files were not produced or are partial. |
| 395 | |
| 396 | **All files are placed in `/mnt/user-data/outputs/` and presented to the user via the `present_files` tool at the end.** |
| 397 | |
| 398 | --- |
| 399 | |
| 400 | ## Section 8 -- Cross-skill references |
| 401 | |
| 402 | **Inputs:** |
| 403 | - `fr-freelance-intake` -- structured intake package (JSON) |
| 404 | - `france-tva` -- TVA return box values and classification output |
| 405 | - `france-income-tax` -- 2042/2042-C-PRO/2035/2031 computation output |
| 406 | - `france-cotisations` -- URSSAF micro-social or TNS réel reconciliation output |
| 407 | - `fr-estimated-tax` -- PAS rate update and acomptes schedule |
| 408 | |
| 409 | **Outputs:** The final reviewer package. No downstream skill. |
| 410 | |
| 411 | --- |
| 412 | |
| 413 | ## Section 9 -- Known gaps |
| 414 | |
| 415 | 1. PDF form filling is not automated. The reviewer uses the worksheets to fill official forms on impots.gouv.fr. |
| 416 | 2. E-filing is handled by the reviewer or client via impots.gouv.fr, not by this skill. |
| 417 | 3. Payment execution is the client's responsibility; the skill only provides instructions and amounts. |
| 418 | 4. EURL at IR assembly is supported but not deeply tested. EURL-specific liasse (2031 or 2035 depending on BIC/BNC) may require manual adjustment for gérant rémunération and charges sociales. |
| 419 | 5. Multi-year amortissement tracking assumes the prior year schedule is provided. If not, only current-year acquisitions are amortised. |
| 420 | 6. Foreign source income (revenus de source étrangère) and convention fiscale application are out of scope. |
| 421 | 7. Revenus fonciers (2044) are noted in the foyer income total but the detailed 2044 preparation is out of scope. |
| 422 | 8. Plus-values immobilières (capital gains on property) are out of scope. |
| 423 | 9. ISF/IFI (wealth tax) is out of scope. |
| 424 | 10. SCI or multi-entity structures are out of scope. |
| 425 | 11. The package is complete only for the 2025 tax year; 2026 appears only as prospective planning. |
| 426 | |
| 427 | ### Change log |
| 428 | - **v1.0 (May 2026):** Initial draft. Modelled on mt-return-assembly v0.1 adapted for France jurisdiction with four content skills (TVA, income tax, cotisations sociales, PAS/estimated tax). |
| 429 | |
| 430 | ## End of skill |
| 431 | |
| 432 | |
| 433 | --- |
| 434 | |
| 435 | ## Disclaimer |
| 436 | |
| 437 | This skill and its outputs are provided for informational and computational purposes only and do not constitute tax, legal, or financial advice. Open Accountants and its contributors accept no liability for any errors, omissions, or outcomes arising from the use of this skill. All outputs must be reviewed and signed off by a qualified professional (such as a CPA, EA, tax attorney, or equivalent licensed practitioner in your jurisdiction) before filing or acting upon. |
| 438 | |
| 439 | The most up-to-date, verified version of this skill is maintained at [openaccountants.com](https://openaccountants.com). Log in to access the latest version, request a professional review from a licensed accountant, and track updates as tax law changes. |
| 440 |
Run this skill, then get an accountant to check it
After running the full skill pack in your AI agent, sign up and upload your worksheet. We'll connect you with a trusted accountant in our network who can review your numbers before you file.
Verification status
Research-verified
Drafted from authoritative sources (tax authority sites, Big-4 summaries). Awaiting credentialed sign-off.
Needs section-by-section practitioner review to reach accountant-verified.
Section review progress
0/43
About
Final orchestrator skill that assembles the complete French filing package for France-resident self-employed individuals, micro-entrepreneurs, and sole proprietors. Consumes outputs from all French content skills (france-tva for TVA CA3/CA12, france-income-tax for 2042/2042-C-PRO/2035/2031, france-cotisations for URSSAF/SSI, fr-estimated-tax for prélèvement à la source) to produce a single unified reviewer package containing every worksheet, every form, every brief section, all cross-skill reconciliations, and the final action list with payment instructions, filing instructions, and next-year planning. This is the capstone skill that runs last and produces the final deliverable. MUST be loaded alongside all French content skills listed above. France full-year residents only. Self-employed individuals, micro-entrepreneurs, and sole proprietors only.
FRty-2025
Use this skill
This skill is open source and free to use in any AI agent. Copy it, download it, or clone the repo. If you find an error, report an issue — a licensed accountant will review.