{"openapi":"3.1.0","info":{"title":"FranceStack Tax & Payroll","version":"0.9.0","description":"Deterministic French tax and payroll calculations for AI agents: income tax (impôt sur le revenu), micro-entrepreneur (auto-entrepreneur) URSSAF contributions, gross-to-net salary and employer cost for CDI or CDD, full-time or part-time, working days and public holidays (jours ouvrés, jours fériés), severance pay with its tax and social treatment (indemnité de licenciement, rupture conventionnelle), unemployment benefit amount, duration and start date (allocation chômage ARE). Official scales, sourced and verified; no LLM at runtime. Missing information is answered for free with the exact questions to ask the user; unsupported cases are refused for free; you pay per successful call with x402 (USDC). Also available as an MCP server (Streamable HTTP) at POST /mcp, with the same tools, prices and free error handling. Free endpoints: GET /api/calculs (full catalogue), GET /llms.txt, GET /.well-known/x402, GET /health. Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel.","x-logo":{"url":"https://tax.francestack.fr/icon.svg"},"contact":{"name":"FranceStack","email":"francestack.contact@gmail.com"}},"servers":[{"url":"https://tax.francestack.fr"}],"paths":{"/api/calcul/impot-revenu":{"post":{"operationId":"france_income_tax","summary":"France income tax calculator (impôt sur le revenu)","description":"Computes French personal income tax (impôt sur le revenu, IR) for a tax household: number of tax shares (parts, quotient familial), gross tax on the official DGFiP progressive scale, family-quotient cap, décote, net tax payable, average rate and marginal rate (TMI). Income years 2024, 2025. Input: household net taxable income, or declared salaries (the 10% deduction is applied). Use when a user asks how much French income tax a household pays, its marginal tax bracket (TMI), its number of tax shares, or the effect of marriage or children on the tax. Deterministic code, no LLM, exact decimal arithmetic. Matches all 7,095 values of the official DGFiP tax tables (brochure pratique 2025 and 2026) to the euro, and 15 cases checked on the official impots.gouv.fr simulator. Not supported (refused for free with HTTP 422): non-residents, overseas departments, alternating-custody children, extra half-shares (disability, veterans, box L), exceptional income taxed with the quotient system, tax credits and reductions, incomes above the high-income contribution thresholds (CEHR/CDHR). Price: 0.005 USDC per successful call (x402). Missing or invalid fields are reported for free (HTTP 422, with the questions to ask the user); you never pay for an error.","tags":["France","income tax","impot sur le revenu","tax calculator","DGFiP"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"annee_revenus":{"description":"Income year (année des revenus), e.g. 2025 for the return filed in 2026. Supported: 2024, 2025.","type":"integer","minimum":2000,"maximum":2100},"situation_familiale":{"description":"Marital status on 31 December of the income year: celibataire (single), divorce_separe (divorced or separated), marie_pacse (married or civil partnership, joint return), veuf (widowed).","type":"string","enum":["celibataire","divorce_separe","marie_pacse","veuf"]},"enfants_a_charge":{"description":"Number of dependent children fully or mainly in the household (minors, or adult children attached to the tax household). Do not count alternating-custody children.","type":"integer","minimum":0,"maximum":20},"parent_isole":{"description":"Required if single or divorced with at least one child: true if the parent lives alone with the children, without a partner (box T, parent isolé).","type":"boolean"},"revenu_net_imposable":{"description":"Household net taxable income in EUR (revenu net imposable, after all allowances, as shown on the tax notice). Give either this field or salaires_declares.","type":"number","minimum":0,"maximum":100000000},"salaires_declares":{"description":"Alternative to revenu_net_imposable: net taxable salaries declared by each filer in EUR, before the 10% standard deduction (one value, or two for a married/PACS couple). Salaries only; for other income use revenu_net_imposable.","minItems":1,"maxItems":2,"type":"array","items":{"type":"number","minimum":0,"maximum":100000000}},"nombre_declarants_65_ans_ou_plus":{"description":"Required with salaires_declares: number of filers aged 65 or over on 31 December of the income year (0, 1 or 2), for the elderly allowance.","type":"integer","minimum":0,"maximum":2},"cas_particuliers":{"description":"Required. Special situations that apply, or [] if none: enfant_residence_alternee (alternating custody), invalidite_ou_ancien_combattant (disability or veteran card), personne_invalide_a_charge (disabled dependant), case_L (lived alone and raised a child alone 5+ years), enfant_majeur_marie_ou_charge_de_famille (attached married adult child), deces_conjoint_dans_annee (spouse died during the year), domicile_outre_mer (overseas department), non_resident, revenus_exceptionnels_ou_differes (exceptional or deferred income). Any listed situation is refused for free (HTTP 422).","maxItems":9,"type":"array","items":{"type":"string","enum":["enfant_residence_alternee","invalidite_ou_ancien_combattant","personne_invalide_a_charge","case_L","enfant_majeur_marie_ou_charge_de_famille","deces_conjoint_dans_annee","domicile_outre_mer","non_resident","revenus_exceptionnels_ou_differes"]}},"nombre_parts_declare":{"description":"Optional cross-check: number of tax shares shown on the tax return or notice. If it differs from the computed number, the request is refused for free (HTTP 422).","type":"number","minimum":1,"maximum":30,"multipleOf":0.25}},"required":["annee_revenus","situation_familiale","enfants_a_charge","cas_particuliers"],"additionalProperties":false},"example":{"annee_revenus":2025,"situation_familiale":"marie_pacse","enfants_a_charge":2,"revenu_net_imposable":54000,"cas_particuliers":[]}}}},"responses":{"200":{"description":"Calculation result (paid): result, step-by-step detail, assumptions, official scale version and sources, link to the official simulator.","content":{"application/json":{"schema":{"type":"object","properties":{"calculateur":{"type":"string","minLength":1},"resultat":{"type":"object","properties":{"annee_revenus":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"revenu_net_imposable":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"nombre_parts":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"quotient_familial":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"impot_avant_plafonnement":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"plafonnement_quotient_familial_applique":{"type":"boolean"},"reduction_complementaire_veuf":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"impot_brut":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"decote":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"impot_net":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"seuil_mise_en_recouvrement":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"impot_a_payer":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"taux_moyen_pourcent":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"tranche_marginale_pourcent":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"}},"required":["annee_revenus","revenu_net_imposable","nombre_parts","quotient_familial","impot_avant_plafonnement","plafonnement_quotient_familial_applique","reduction_complementaire_veuf","impot_brut","decote","impot_net","seuil_mise_en_recouvrement","impot_a_payer","taux_moyen_pourcent","tranche_marginale_pourcent"],"additionalProperties":false},"detail":{"minItems":1,"type":"array","items":{"type":"object","properties":{"etape":{"type":"string","minLength":1},"montant":{"type":"string","minLength":1},"explication":{"type":"string","minLength":1}},"required":["etape","montant","explication"],"additionalProperties":false}},"hypotheses":{"type":"array","items":{"type":"string","minLength":1}},"bareme":{"type":"object","properties":{"version":{"type":"string","minLength":1},"date_effet":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"sources":{"minItems":1,"type":"array","items":{"type":"string","format":"uri"}}},"required":["version","date_effet","sources"],"additionalProperties":false},"estimation_indicative":{"type":"boolean","const":true},"avertissement":{"type":"string","const":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel."},"lien_verification":{"type":"string","format":"uri"}},"required":["calculateur","resultat","detail","hypotheses","bareme","estimation_indicative","avertissement","lien_verification"],"additionalProperties":false},"example":{"calculateur":"impot-revenu","resultat":{"annee_revenus":2025,"revenu_net_imposable":"54000.00","nombre_parts":"3","quotient_familial":"18000.00","impot_avant_plafonnement":"2112.00","plafonnement_quotient_familial_applique":false,"reduction_complementaire_veuf":"0.00","impot_brut":"2112.00","decote":"527.00","impot_net":"1585.00","seuil_mise_en_recouvrement":"61.00","impot_a_payer":"1585.00","taux_moyen_pourcent":"2.94","tranche_marginale_pourcent":"11.00"},"detail":[{"etape":"Revenu net imposable","montant":"54000.00","explication":"Revenu net imposable du foyer fourni, arrondi à l'euro le plus proche."},{"etape":"Nombre de parts","montant":"3","explication":"2 parts (couple) ; +1 pour 2 enfant(s) (½ part pour chacun des 2 premiers, 1 part à partir du 3e)."},{"etape":"Quotient familial","montant":"18000.00","explication":"Revenu net imposable divisé par le nombre de parts."},{"etape":"Impôt résultant du barème","montant":"2112.00","explication":"Barème progressif des revenus 2025 appliqué au quotient, multiplié par 3 part(s)."},{"etape":"Impôt brut (droits simples)","montant":"2112.00","explication":"Impôt après plafonnement, arrondi à l'euro le plus proche."},{"etape":"Décote","montant":"527.00","explication":"Impôt brut inférieur à 3277 € : décote = 1483 € − 45,25 % de l'impôt brut, arrondie à l'euro et limitée à l'impôt brut."},{"etape":"Impôt net","montant":"1585.00","explication":"Impôt brut diminué de la décote (avant réductions et crédits d’impôt, non pris en compte)."},{"etape":"Impôt à payer","montant":"1585.00","explication":"Impôt annuel dû, avant déduction des prélèvements à la source déjà effectués."}],"hypotheses":["Barème des revenus 2025 (Loi de finances pour 2026), déclaration 2026.","Domicile fiscal en France métropolitaine ; aucune des situations particulières listées dans cas_particuliers.","Seuls les revenus soumis au barème progressif sont pris en compte (pas de revenus au prélèvement forfaitaire unique, de plus-values ni de revenus imposés selon le système du quotient).","Aucune réduction ni aucun crédit d'impôt n'est pris en compte (dons, emploi à domicile, frais de garde, etc.).","Revenu fiscal de référence inférieur aux seuils de la contribution sur les hauts revenus (250000 € personne seule, 500000 € couple).","L'impôt à payer est le montant annuel ; le solde dépend des prélèvements à la source déjà effectués."],"bareme":{"version":"IR-revenus-2025-v1","date_effet":"2025-01-01","sources":["https://www.impots.gouv.fr/www2/fichiers/documentation/brochure/ir_2026/pdf_som/21-calcul_impot_369a382.pdf","https://www.impots.gouv.fr/www2/fichiers/documentation/brochure/ir_2026/pdf_som/06-traitements_salaires_85a114.pdf","https://bofip.impots.gouv.fr/bofip/2491-PGP.html/identifiant=BOI-IR-LIQ-20-10-20260407","https://www.service-public.gouv.fr/particuliers/vosdroits/F1419","https://www.service-public.gouv.fr/particuliers/vosdroits/F34328","https://bofip.impots.gouv.fr/bofip/2496-PGP.html","https://www.service-public.gouv.fr/particuliers/vosdroits/F31130"]},"estimation_indicative":true,"avertissement":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel.","lien_verification":"https://simulateur-ir-ifi.impots.gouv.fr/calcul_impot/2026/simplifie/index.htm"}}}},"402":{"description":"Payment required (x402). Instructions in the PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"422":{"description":"Free rejection before payment: champs_manquants (with questions to ask the user), entree_invalide, cas_non_supporte, bareme_non_disponible.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"429":{"description":"Rate limit exceeded (free)."}}}},"/api/calcul/micro-entrepreneur":{"post":{"operationId":"france_micro_entrepreneur_contributions","summary":"France micro-entrepreneur (auto-entrepreneur) contributions calculator","description":"What a French micro-entrepreneur (auto-entrepreneur) pays to URSSAF for a month, quarter or year: social contributions (with or without ACRE), training contribution (CFP), chamber tax, optional flat-rate income tax (versement libératoire), net income. Years 2025, 2026. Optional: VAT franchise check (franchise en base de TVA, 2026) — must I charge VAT, since when, margin left. Use when a user asks how much URSSAF contributions an auto-entrepreneur owes on a given turnover, what the ACRE reduction changes, how much remains as net income, or whether they must charge VAT (set verifier_franchise_tva = true). Deterministic code, no LLM, exact decimal arithmetic. Cross-checked on 2,000 cases against URSSAF's official engine (modele-social) and on 15 cases from the official URSSAF simulator; VAT franchise checked on the official worked examples of the tax doctrine (BOFiP). Not supported (refused for free with HTTP 422): mixed activities, furnished rentals and holiday lets, overseas departments, Alsace-Moselle craftspeople, lawyers and artist-authors, periods straddling the end of ACRE, ACRE in 2025, minimum-contribution option, exit from the micro regime, VAT check for years other than 2026. CFE and business expenses are not included. Price: 0.005 USDC per successful call (x402). Missing or invalid fields are reported for free (HTTP 422, with the questions to ask the user); you never pay for an error.","tags":["France","auto-entrepreneur","URSSAF","social contributions","freelance"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"activite":{"description":"Activity category: vente_marchandises_commercant (sale of goods, restaurants, lodging by a trader), vente_marchandises_artisan (resale of goods by a craftsperson), prestations_services_commercant (commercial services, BIC), prestations_services_artisan (craft services, BIC), liberale_non_reglementee (other services or non-regulated liberal profession, BNC), liberale_reglementee_cipav (regulated liberal profession under CIPAV, BNC).","type":"string","enum":["vente_marchandises_commercant","vente_marchandises_artisan","prestations_services_commercant","prestations_services_artisan","liberale_non_reglementee","liberale_reglementee_cipav"]},"chiffre_affaires":{"description":"Turnover excluding VAT actually collected during the period, in EUR (chiffre d’affaires encaissé).","type":"number","minimum":0,"maximum":10000000},"periode":{"description":"Declaration period: mois (month), trimestre (calendar quarter) or annee (calendar year).","type":"string","enum":["mois","trimestre","annee"]},"annee":{"description":"Calendar year of the period. Supported: 2025, 2026.","type":"integer","minimum":2000,"maximum":2100},"mois":{"description":"Required if periode = mois: month number 1 to 12.","type":"integer","minimum":1,"maximum":12},"trimestre":{"description":"Required if periode = trimestre: calendar quarter 1 to 4.","type":"integer","minimum":1,"maximum":4},"date_debut_activite":{"description":"Business start date (YYYY-MM-DD). Determines the ACRE period and the first-year chamber tax exemption.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"acre":{"description":"true if the entrepreneur was granted ACRE (reduced contribution rates for business creators).","type":"boolean"},"versement_liberatoire":{"description":"true if the entrepreneur opted for the flat-rate income tax paid with contributions (versement libératoire).","type":"boolean"},"chiffre_affaires_n_moins_2_superieur_5000":{"description":"Required for trade and craft activities after the first calendar year: true if turnover two years before was at least EUR 5,000 (otherwise the chamber tax is not due).","type":"boolean"},"verifier_franchise_tva":{"description":"Optional: true to also check the VAT franchise (franchise en base de TVA): must the entrepreneur charge VAT, since when, margin left before the threshold. 2026 only.","type":"boolean"},"tva_chiffre_affaires_cumule_annee":{"description":"Required for the VAT check unless periode = annee: turnover excluding VAT collected since 1 January of the year up to today, including the declared period, in EUR.","type":"number","minimum":0,"maximum":10000000},"tva_chiffre_affaires_annee_precedente":{"description":"Required for the VAT check if the business started before the year: turnover excluding VAT of the previous calendar year, in EUR.","type":"number","minimum":0,"maximum":10000000},"tva_activite_saisonniere":{"description":"Required for the VAT check if the business started this year or last year: true for a seasonal activity (thresholds are then not prorated).","type":"boolean"},"cas_particuliers":{"description":"Required. Special situations that apply, or [] if none: activite_mixte (several activity categories), location_meublee (furnished rental, holiday let, B&B), outre_mer (overseas department), alsace_moselle (craftsperson in Alsace or Moselle), double_immatriculation_cci_cma (registered with both CCI and CMA), cotisations_minimales (minimum contributions option), conjoint_collaborateur (collaborating spouse), sortie_regime_micro (turnover ceilings exceeded two years in a row), avocat_ou_artiste_auteur (lawyer or artist-author). Any listed situation is refused for free (HTTP 422).","maxItems":9,"type":"array","items":{"type":"string","enum":["activite_mixte","location_meublee","outre_mer","alsace_moselle","double_immatriculation_cci_cma","cotisations_minimales","conjoint_collaborateur","sortie_regime_micro","avocat_ou_artiste_auteur"]}}},"required":["activite","chiffre_affaires","periode","annee","date_debut_activite","acre","versement_liberatoire","cas_particuliers"],"additionalProperties":false},"example":{"activite":"prestations_services_commercant","chiffre_affaires":3000,"periode":"mois","annee":2026,"mois":3,"date_debut_activite":"2022-01-10","acre":false,"versement_liberatoire":false,"chiffre_affaires_n_moins_2_superieur_5000":true,"cas_particuliers":[]}}}},"responses":{"200":{"description":"Calculation result (paid): result, step-by-step detail, assumptions, official scale version and sources, link to the official simulator.","content":{"application/json":{"schema":{"type":"object","properties":{"calculateur":{"type":"string","minLength":1},"resultat":{"type":"object","properties":{"periode_debut":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"periode_fin":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"chiffre_affaires_declare":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"taux_cotisations_pourcent":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"acre_appliquee":{"type":"boolean"},"cotisations_sociales":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"taux_formation_professionnelle_pourcent":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"contribution_formation_professionnelle":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"taux_frais_chambre_pourcent":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"taxe_frais_chambre_consulaire":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"cotisations_et_contributions":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"taux_versement_liberatoire_pourcent":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"versement_liberatoire":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"total_a_payer":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"revenu_net_avant_impot":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"revenu_net_apres_versement_liberatoire":{"anyOf":[{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},{"type":"null"}]},"tva":{"anyOf":[{"type":"object","properties":{"annee":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"categorie_seuils":{"type":"string","enum":["vente_hebergement","services"]},"regime":{"type":"string","enum":["franchise_en_base","redevable"]},"redevable_a_partir_de":{"type":["string","null"]},"seuil_base":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"seuil_majore":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"jours_activite_proratisation":{"anyOf":[{"type":"integer","minimum":1,"maximum":366},{"type":"null"}]},"chiffre_affaires_cumule_annee":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"chiffre_affaires_annee_precedente":{"anyOf":[{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},{"type":"null"}]},"marge_avant_seuil_majore":{"anyOf":[{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},{"type":"null"}]},"franchise_perdue_au_1er_janvier_suivant":{"type":["boolean","null"]},"mention_facture":{"type":["string","null"]},"explication":{"type":"string","minLength":20}},"required":["annee","categorie_seuils","regime","redevable_a_partir_de","seuil_base","seuil_majore","jours_activite_proratisation","chiffre_affaires_cumule_annee","chiffre_affaires_annee_precedente","marge_avant_seuil_majore","franchise_perdue_au_1er_janvier_suivant","mention_facture","explication"],"additionalProperties":false},{"type":"null"}]}},"required":["periode_debut","periode_fin","chiffre_affaires_declare","taux_cotisations_pourcent","acre_appliquee","cotisations_sociales","taux_formation_professionnelle_pourcent","contribution_formation_professionnelle","taux_frais_chambre_pourcent","taxe_frais_chambre_consulaire","cotisations_et_contributions","taux_versement_liberatoire_pourcent","versement_liberatoire","total_a_payer","revenu_net_avant_impot","revenu_net_apres_versement_liberatoire","tva"],"additionalProperties":false},"detail":{"minItems":1,"type":"array","items":{"type":"object","properties":{"etape":{"type":"string","minLength":1},"montant":{"type":"string","minLength":1},"explication":{"type":"string","minLength":1}},"required":["etape","montant","explication"],"additionalProperties":false}},"hypotheses":{"type":"array","items":{"type":"string","minLength":1}},"bareme":{"type":"object","properties":{"version":{"type":"string","minLength":1},"date_effet":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"sources":{"minItems":1,"type":"array","items":{"type":"string","format":"uri"}}},"required":["version","date_effet","sources"],"additionalProperties":false},"estimation_indicative":{"type":"boolean","const":true},"avertissement":{"type":"string","const":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel."},"lien_verification":{"type":"string","format":"uri"}},"required":["calculateur","resultat","detail","hypotheses","bareme","estimation_indicative","avertissement","lien_verification"],"additionalProperties":false},"example":{"calculateur":"micro-entrepreneur","resultat":{"periode_debut":"2026-03-01","periode_fin":"2026-03-31","chiffre_affaires_declare":"3000.00","taux_cotisations_pourcent":"21.2","acre_appliquee":false,"cotisations_sociales":"636.00","taux_formation_professionnelle_pourcent":"0.1","contribution_formation_professionnelle":"3.00","taux_frais_chambre_pourcent":"0.044","taxe_frais_chambre_consulaire":"1.32","cotisations_et_contributions":"640.32","taux_versement_liberatoire_pourcent":"0","versement_liberatoire":"0.00","total_a_payer":"640.32","revenu_net_avant_impot":"2359.68","revenu_net_apres_versement_liberatoire":null,"tva":null},"detail":[{"etape":"Chiffre d’affaires déclaré","montant":"3000.00","explication":"Chiffre d’affaires hors taxes encaissé du 2026-03-01 au 2026-03-31, arrondi à l’euro (déclaration en euros entiers)."},{"etape":"Cotisations et contributions sociales","montant":"636.00","explication":"Prestations de services commerciales (BIC) : taux de 21.2 % (2026)."},{"etape":"Contribution à la formation professionnelle","montant":"3.00","explication":"0.1 % du chiffre d’affaires (commerçant)."},{"etape":"Taxe pour frais de chambre consulaire","montant":"1.32","explication":"0.044 % du chiffre d’affaires (chambre de commerce)."},{"etape":"Versement libératoire de l’impôt sur le revenu","montant":"0.00","explication":"Pas d’option pour le versement libératoire."},{"etape":"Total à payer à l’URSSAF","montant":"640.32","explication":"Cotisations + formation professionnelle + taxe pour frais de chambre + versement libératoire."},{"etape":"Revenu net avant impôt","montant":"2359.68","explication":"Chiffre d’affaires diminué des cotisations, de la formation professionnelle et de la taxe pour frais de chambre (les charges de l’activité ne sont pas déduites)."}],"hypotheses":["Taux du régime micro-social 2026 (France métropolitaine), activité unique : Prestations de services commerciales (BIC).","Chiffre d’affaires hors taxes réellement encaissé sur la période, déclaré en euros entiers.","Montants calculés au centime ; l’URSSAF ou son simulateur peuvent présenter des montants arrondis à l’euro.","Régime micro-social applicable (pas de dépassement des plafonds de chiffre d’affaires deux années civiles consécutives).","Pas d’option pour les cotisations minimales ; pas de conjoint collaborateur.","Les charges réelles de l’activité, la cotisation foncière des entreprises (CFE) et la TVA ne sont pas prises en compte (vérification de la franchise de TVA disponible avec verifier_franchise_tva).","Taxe pour frais de chambre : non due l’année de création, puis due si le chiffre d’affaires de l’année N-2 atteint 5 000 €."],"bareme":{"version":"micro-2026-v1","date_effet":"2026-01-01","sources":["https://www.autoentrepreneur.urssaf.fr/portail/accueil/sinformer-sur-le-statut/lessentiel-du-statut.html","https://entreprendre.service-public.gouv.fr/vosdroits/F36232","https://entreprendre.service-public.gouv.fr/vosdroits/F11677","https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000052218738","https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000046898530"]},"estimation_indicative":true,"avertissement":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel.","lien_verification":"https://mon-entreprise.urssaf.fr/simulateurs/auto-entrepreneur"}}}},"402":{"description":"Payment required (x402). Instructions in the PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"422":{"description":"Free rejection before payment: champs_manquants (with questions to ask the user), entree_invalide, cas_non_supporte, bareme_non_disponible.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"429":{"description":"Rate limit exceeded (free)."}}}},"/api/calcul/brut-net":{"post":{"operationId":"france_gross_to_net_salary","summary":"France gross-to-net salary and employer cost calculator (salaire brut net)","description":"French private-sector gross-to-net salary (salaire brut → net), mainland France, 2026 rules, CDI or CDD, full-time or part-time (temps partiel): employee contributions, net pay, net taxable pay, optional tax withholding (prélèvement à la source), RGDU reduction, employer cost. For a CDD: end-of-contract bonus (prime de précarité), paid-leave indemnity, CPF-CDD, monthly average and contract total. Use when a user asks for the net salary from a gross salary in France (CDI or CDD, full-time or part-time), the total cost of an employee for the employer, the end-of-contract bonus of a fixed-term contract, or the amount of employer and employee social contributions. Deterministic code, no LLM: uses URSSAF's official payroll engine (modele-social). Official 2026 rates re-applied by hand in tests, official RGDU formula and example, and 30 cases checked on the official URSSAF salary simulator (15 full-time CDI, 15 CDD and part-time). Not supported (refused for free with HTTP 422): temporary agency work (intérim), CDD à objet défini, fixed-term contracts ended early, overtime, incomplete months, fixed-days (forfait jours), apprentices and interns, company officers (SAS president), Alsace-Moselle, overseas departments, salaries below the minimum wage (SMIC, prorated for part-time), years other than those listed. Price: 0.005 USDC per successful call (x402). Missing or invalid fields are reported for free (HTTP 422, with the questions to ask the user); you never pay for an error.","tags":["France","payroll","gross to net salary","URSSAF","employer cost"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"salaire_brut":{"description":"Gross salary in EUR for the period (monthly or annual, see periode), including bonuses paid in the period.","type":"number","exclusiveMinimum":0,"maximum":1000000},"periode":{"description":"mois (monthly gross salary) or annee (annual gross salary).","type":"string","enum":["mois","annee"]},"annee":{"description":"Year. Supported: 2026.","type":"integer","minimum":2000,"maximum":2100},"mois":{"description":"Required if periode = mois: payroll month 1 to 12.","type":"integer","minimum":1,"maximum":12},"type_contrat":{"description":"CDI (permanent contract) or CDD (fixed-term contract). A CDD requires periode = mois and the cdd_* fields.","type":"string","enum":["CDI","CDD"]},"temps_partiel_heures_par_semaine":{"description":"Optional: weekly hours for a part-time employee (1 to 34.99). Omit for full-time (35 h). The minimum wage check and the RGDU are prorated.","type":"number","minimum":1,"maximum":34.99},"cdd_motif":{"description":"Required for a CDD: reason for the fixed-term contract: accroissement_activite (temporary increase in activity), remplacement (replacing an absent employee), saisonnier (seasonal work: no end-of-contract bonus, no CPF-CDD), usage (CDD d’usage: no end-of-contract bonus).","type":"string","enum":["accroissement_activite","remplacement","saisonnier","usage"]},"cdd_duree_mois":{"description":"Required for a CDD: total contract length in months (0.25 to 36, e.g. 1.5 for six weeks).","type":"number","minimum":0.25,"maximum":36},"cdd_jours_conges_pris":{"description":"Required for a CDD: paid-leave days taken during the contract, in working days (0 if none). Untaken leave is paid as a 10 % indemnity at the end.","type":"number","minimum":0,"maximum":75},"cdd_suivi_d_un_cdi":{"description":"Required for a CDD: true if the CDD is immediately followed by a CDI with the same employer (no end-of-contract indemnities).","type":"boolean"},"cdd_job_vacances_jeune":{"description":"Required for a CDD: true for a school or university student’s holiday job (no end-of-contract bonus).","type":"boolean"},"statut_cadre":{"description":"true if the employee has executive status (cadre).","type":"boolean"},"effectif":{"description":"Company headcount band: moins_de_5 (under 5), de_5_a_10, de_11_a_19, de_20_a_49, de_50_a_149, de_150_a_249, 250_et_plus.","type":"string","enum":["moins_de_5","de_5_a_10","de_11_a_19","de_20_a_49","de_50_a_149","de_150_a_249","250_et_plus"]},"mutuelle_part_salariale":{"description":"Monthly employee share of the company health insurance (mutuelle) on the payslip, in EUR (0 if none).","type":"number","minimum":0,"maximum":1000},"mutuelle_part_patronale":{"description":"Monthly employer share of the company health insurance (mutuelle), in EUR (0 if none).","type":"number","minimum":0,"maximum":1000},"taux_versement_mobilite_pourcent":{"description":"Required if the company has 11 or more employees: transport levy rate (versement mobilité) of the workplace municipality, in percent (0 if none).","type":"number","minimum":0,"maximum":5},"taux_atmp_pourcent":{"description":"Optional: workplace accident insurance rate (taux AT/MP) of the establishment, in percent. If omitted, the national average (2.08 %) is used; it only affects employer cost.","type":"number","minimum":0,"maximum":30},"taux_prelevement_source_pourcent":{"description":"Optional: employee income tax withholding rate (taux de prélèvement à la source), in percent. If given, the withholding and net pay after tax are returned.","type":"number","minimum":0,"maximum":60},"cas_particuliers":{"description":"Required. Special situations that apply, or [] if none: interim (temporary agency work), cdd_objet_defini (CDD à objet défini), cdd_rupture_anticipee (CDD ended before its term), forfait_jours (fixed-days arrangement), heures_supplementaires (overtime this period), mois_incomplet (incomplete month, absence, sick leave), apprenti_stagiaire (apprentice or intern), dirigeant_assimile_salarie (company officer), alsace_moselle, outre_mer (overseas department), prevoyance_avec_part_salariale (provident scheme with employee share), avantages_en_nature (benefits in kind), exoneration_specifique (specific employer exemption), deduction_forfaitaire_specifique (specific flat-rate deduction). Any listed situation is refused for free (HTTP 422).","maxItems":14,"type":"array","items":{"type":"string","enum":["interim","cdd_objet_defini","cdd_rupture_anticipee","forfait_jours","heures_supplementaires","mois_incomplet","apprenti_stagiaire","dirigeant_assimile_salarie","alsace_moselle","outre_mer","prevoyance_avec_part_salariale","avantages_en_nature","exoneration_specifique","deduction_forfaitaire_specifique"]}}},"required":["salaire_brut","periode","annee","type_contrat","statut_cadre","effectif","mutuelle_part_salariale","mutuelle_part_patronale","cas_particuliers"],"additionalProperties":false},"example":{"salaire_brut":3000,"periode":"mois","annee":2026,"mois":3,"type_contrat":"CDI","statut_cadre":false,"effectif":"de_20_a_49","mutuelle_part_salariale":30,"mutuelle_part_patronale":30,"taux_versement_mobilite_pourcent":1.75,"cas_particuliers":[]}}}},"responses":{"200":{"description":"Calculation result (paid): result, step-by-step detail, assumptions, official scale version and sources, link to the official simulator.","content":{"application/json":{"schema":{"type":"object","properties":{"calculateur":{"type":"string","minLength":1},"resultat":{"type":"object","properties":{"periode":{"type":"string","enum":["mois","annee"]},"type_contrat":{"type":"string","enum":["CDI","CDD"]},"temps_partiel_heures_par_semaine":{"anyOf":[{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},{"type":"null"}]},"smic_reference":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"salaire_brut":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"cotisations_salariales":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"dont_mutuelle_part_salariale":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"net_avant_impot":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"net_imposable":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"taux_prelevement_source_pourcent":{"anyOf":[{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},{"type":"null"}]},"prelevement_a_la_source":{"anyOf":[{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},{"type":"null"}]},"net_apres_impot":{"anyOf":[{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},{"type":"null"}]},"cotisations_patronales_avant_reduction":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"reduction_generale":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"cotisations_patronales":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"cout_total_employeur":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"taux_atmp_pourcent":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"taux_atmp_moyen_utilise":{"type":"boolean"},"cdd":{"anyOf":[{"type":"object","properties":{"duree_mois":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"motif":{"type":"string","minLength":3},"prime_precarite_due":{"type":"boolean"},"prime_precarite_totale":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"indemnite_conges_payes_totale":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"jours_conges_pris":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"jours_conges_acquis":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"contribution_formation_cdd_mensuelle":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"moyenne_mensuelle":{"type":"object","properties":{"salaire_brut":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"net_avant_impot":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"net_imposable":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"cout_total_employeur":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"}},"required":["salaire_brut","net_avant_impot","net_imposable","cout_total_employeur"],"additionalProperties":false},"total_contrat":{"type":"object","properties":{"salaire_brut":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"net_avant_impot":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"cout_total_employeur":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"}},"required":["salaire_brut","net_avant_impot","cout_total_employeur"],"additionalProperties":false}},"required":["duree_mois","motif","prime_precarite_due","prime_precarite_totale","indemnite_conges_payes_totale","jours_conges_pris","jours_conges_acquis","contribution_formation_cdd_mensuelle","moyenne_mensuelle","total_contrat"],"additionalProperties":false},{"type":"null"}]}},"required":["periode","type_contrat","temps_partiel_heures_par_semaine","smic_reference","salaire_brut","cotisations_salariales","dont_mutuelle_part_salariale","net_avant_impot","net_imposable","taux_prelevement_source_pourcent","prelevement_a_la_source","net_apres_impot","cotisations_patronales_avant_reduction","reduction_generale","cotisations_patronales","cout_total_employeur","taux_atmp_pourcent","taux_atmp_moyen_utilise","cdd"],"additionalProperties":false},"detail":{"minItems":1,"type":"array","items":{"type":"object","properties":{"etape":{"type":"string","minLength":1},"montant":{"type":"string","minLength":1},"explication":{"type":"string","minLength":1}},"required":["etape","montant","explication"],"additionalProperties":false}},"hypotheses":{"type":"array","items":{"type":"string","minLength":1}},"bareme":{"type":"object","properties":{"version":{"type":"string","minLength":1},"date_effet":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"sources":{"minItems":1,"type":"array","items":{"type":"string","format":"uri"}}},"required":["version","date_effet","sources"],"additionalProperties":false},"estimation_indicative":{"type":"boolean","const":true},"avertissement":{"type":"string","const":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel."},"lien_verification":{"type":"string","format":"uri"}},"required":["calculateur","resultat","detail","hypotheses","bareme","estimation_indicative","avertissement","lien_verification"],"additionalProperties":false},"example":{"calculateur":"brut-net","resultat":{"periode":"mois","type_contrat":"CDI","temps_partiel_heures_par_semaine":null,"smic_reference":"1823.03","salaire_brut":"3000.00","cotisations_salariales":"658.12","dont_mutuelle_part_salariale":"30.00","net_avant_impot":"2341.88","net_imposable":"2458.23","taux_prelevement_source_pourcent":null,"prelevement_a_la_source":null,"net_apres_impot":null,"cotisations_patronales_avant_reduction":"1385.28","reduction_generale":"299.70","cotisations_patronales":"1085.58","cout_total_employeur":"4085.58","taux_atmp_pourcent":"2.08","taux_atmp_moyen_utilise":true,"cdd":null},"detail":[{"etape":"Salaire brut","montant":"3000.00","explication":"Salaire brut mensuel (03/2026)."},{"etape":"Assurance vieillesse (part salariale)","montant":"219.00","explication":"6,90 % dans la limite du plafond de la Sécurité sociale + 0,40 % sur la totalité."},{"etape":"Retraite complémentaire Agirc-Arrco (part salariale)","montant":"120.30","explication":"Tranche 1 : 3,15 % + CEG 0,86 % ; au-delà du plafond : 8,64 % + CEG 1,08 % + CET 0,14 %."},{"etape":"CSG et CRDS","montant":"288.82","explication":"CSG 9,20 % (dont 6,80 % déductible) et CRDS 0,50 %, sur 98,25 % du brut (jusqu’à 4 plafonds) plus la part patronale de mutuelle et prévoyance."},{"etape":"Mutuelle (part salariale)","montant":"30.00","explication":"Part salariale de la complémentaire santé fournie."},{"etape":"Total des cotisations salariales","montant":"658.12","explication":"Ensemble des cotisations et contributions à la charge du salarié (y compris APEC pour les cadres)."},{"etape":"Net à payer avant impôt","montant":"2341.88","explication":"Salaire brut diminué des cotisations salariales."},{"etape":"Net imposable","montant":"2458.23","explication":"Net avant impôt + CSG non déductible et CRDS + part patronale de la mutuelle."},{"etape":"Cotisations patronales avant réduction","montant":"1385.28","explication":"Maladie, vieillesse, allocations familiales, chômage, retraite complémentaire, AT/MP, formation, apprentissage, FNAL, CSA, dialogue social, versement mobilité, prévoyance cadre, mutuelle…"},{"etape":"Réduction générale dégressive unique (RGDU)","montant":"299.70","explication":"Réduction des cotisations patronales pour les salaires inférieurs à 3 Smic (Smic en vigueur au 1er janvier, règle officielle 2026)."},{"etape":"Coût total employeur","montant":"4085.58","explication":"Salaire brut + cotisations patronales après réduction."}],"hypotheses":["Salarié du secteur privé en CDI à temps plein, mois complet, en France métropolitaine (hors Alsace-Moselle), non-cadre, convention collective sans dispositif particulier.","Cotisations calculées par le moteur officiel de l’URSSAF (modele-social 11.1.0) avec les taux 2026.","Aucune prévoyance autre que la prévoyance cadre obligatoire (1,50 % patronal sur la tranche 1) ; mutuelle selon les montants fournis.","Hors heures supplémentaires, avantages en nature, titres-restaurant et remboursements de frais (transport…) : le net affiché ne les inclut pas.","Montants arrondis au centime sur les totaux ; une fiche de paie arrondit chaque ligne, d’où de possibles écarts de quelques centimes.","Taux AT/MP non fourni : taux moyen national 2.08 % utilisé ; le coût employeur est alors une estimation."],"bareme":{"version":"brut-net-2026-v1","date_effet":"2026-01-01","sources":["https://www.urssaf.fr/accueil/outils-documentation/taux-baremes/taux-cotisations-secteur-prive.html","https://www.urssaf.fr/accueil/employeur/beneficier-exonerations/reduction-generale-cotisation.html","https://reglementation.agirc-arrco.fr/home/baremes/listes-area/baremes-1/cotisations-au-regime-agirc-arrco-en-2026.html","https://www.legifrance.gouv.fr/jorf/article_jo/JORFARTI000053228995","https://bofip.impots.gouv.fr/bofip/11168-PGP.html/identifiant=BOI-IR-PAS-30-10-30-10-20190227","https://www.npmjs.com/package/modele-social/v/11.1.0"]},"estimation_indicative":true,"avertissement":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel.","lien_verification":"https://mon-entreprise.urssaf.fr/simulateurs/salaire-brut-net"}}}},"402":{"description":"Payment required (x402). Instructions in the PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"422":{"description":"Free rejection before payment: champs_manquants (with questions to ask the user), entree_invalide, cas_non_supporte, bareme_non_disponible.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"429":{"description":"Rate limit exceeded (free)."}}}},"/api/calcul/jours-ouvres":{"post":{"operationId":"france_working_days","summary":"France working days and public holidays (jours ouvrés, jours fériés)","description":"French public holidays (jours fériés) and working days for mainland France and Alsace-Moselle, 2000-2027: list a year's holidays, count calendar, working (jours ouvrés) and business days (jours ouvrables) between two dates, or add N working days to a date. Labour Code rules (L3133-1, L3134-13), Easter-based dates, holidays worked by the company and extra days off taken into account. Use when a user needs the French public holidays of a year, the number of working days (jours ouvrés or ouvrables) in a period, for example for payroll, paid leave or a fixed-term contract, or the date reached after N working days. Deterministic code, no LLM. Every holiday date 2000-2027 for mainland France and Alsace-Moselle matches the official government calendar (calendrier.api.gouv.fr) and the service-public.fr tables; counts are cross-checked by an independent day-by-day enumeration. Not supported (refused for free with HTTP 422): overseas departments and territories (outre-mer), years outside the covered range, periods over 10 years, legal or court deadlines (procedural deadline rules differ). Price: 0.001 USDC per successful call (x402). Missing or invalid fields are reported for free (HTTP 422, with the questions to ask the user); you never pay for an error.","tags":["France","working days","public holidays","jours feries","payroll"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"description":"liste_feries (public holidays of a year), compter_jours (count days between two dates), or ajouter_jours (date reached after adding N working or business days).","type":"string","enum":["liste_feries","compter_jours","ajouter_jours"]},"zone":{"description":"Workplace location: metropole (mainland France outside Alsace-Moselle), alsace_moselle (Bas-Rhin, Haut-Rhin, Moselle), or outre_mer (overseas, refused for free).","type":"string","enum":["metropole","alsace_moselle","outre_mer"]},"annee":{"description":"Required for liste_feries: year, 2000 to 2027.","type":"integer","minimum":1900,"maximum":2200},"date_debut":{"description":"Required for compter_jours: start date YYYY-MM-DD (included).","type":"string"},"date_fin":{"description":"Required for compter_jours: end date YYYY-MM-DD (included).","type":"string"},"date_depart":{"description":"Required for ajouter_jours: starting date YYYY-MM-DD (not counted; counting starts the next day).","type":"string"},"nombre_jours":{"description":"Required for ajouter_jours: number of days to add, 1 to 1000.","type":"integer","minimum":1,"maximum":1000},"type_jours":{"description":"Required for ajouter_jours: ouvres (working days, the days normally worked, Monday to Friday by default) or ouvrables (Monday to Saturday).","type":"string","enum":["ouvres","ouvrables"]},"vendredi_saint_chome":{"description":"Required for alsace_moselle: true if Good Friday (Vendredi saint) is a holiday in the workplace town (by law, towns with a Protestant church or a mixed church).","type":"boolean"},"jours_travailles":{"description":"Optional (working days only): weekdays normally worked, in French (lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche). Default Monday to Friday.","minItems":1,"maxItems":7,"type":"array","items":{"type":"string","enum":["dimanche","lundi","mardi","mercredi","jeudi","vendredi","samedi"]}},"feries_travailles":{"description":"Optional: public holidays worked in the company (e.g. lundi_pentecote for the solidarity day). Codes: jour_an, vendredi_saint, lundi_paques, victoire_1945, ascension, lundi_pentecote, fete_nationale, assomption, toussaint, armistice_1918, noel, saint_etienne. May 1st is always a day off. Default: none.","maxItems":12,"type":"array","items":{"type":"string","enum":["jour_an","vendredi_saint","lundi_paques","victoire_1945","ascension","lundi_pentecote","fete_nationale","assomption","toussaint","armistice_1918","noel","saint_etienne"]}},"autres_jours_non_travailles":{"description":"Optional (working days only): other days off to exclude, YYYY-MM-DD (bridge days, collective-agreement holidays).","maxItems":366,"type":"array","items":{"type":"string"}}},"required":["operation","zone"],"additionalProperties":false},"example":{"operation":"compter_jours","zone":"metropole","date_debut":"2026-05-01","date_fin":"2026-05-31"}}}},"responses":{"200":{"description":"Calculation result (paid): result, step-by-step detail, assumptions, official scale version and sources, link to the official simulator.","content":{"application/json":{"schema":{"type":"object","properties":{"calculateur":{"type":"string","minLength":1},"resultat":{"type":"object","properties":{"operation":{"type":"string","enum":["liste_feries","compter_jours","ajouter_jours"]},"zone":{"type":"string","enum":["metropole","alsace_moselle"]},"annee":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"nombre_jours_feries":{"type":"integer","minimum":0,"maximum":9007199254740991},"date_debut":{"type":"string"},"date_fin":{"type":"string"},"jours_calendaires":{"type":"integer","minimum":0,"maximum":9007199254740991},"jours_ouvrables":{"type":"integer","minimum":0,"maximum":9007199254740991},"jours_ouvres":{"type":"integer","minimum":0,"maximum":9007199254740991},"date_depart":{"type":"string"},"nombre_jours":{"type":"integer","minimum":1,"maximum":1000},"type_jours":{"type":"string","enum":["ouvres","ouvrables"]},"date_resultat":{"type":"string"},"jour_semaine_resultat":{"type":"string","enum":["dimanche","lundi","mardi","mercredi","jeudi","vendredi","samedi"]},"feries":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"code":{"type":"string","enum":["jour_an","vendredi_saint","lundi_paques","fete_travail","victoire_1945","ascension","lundi_pentecote","fete_nationale","assomption","toussaint","armistice_1918","noel","saint_etienne"]},"nom":{"type":"string","minLength":1},"jour_semaine":{"type":"string","enum":["dimanche","lundi","mardi","mercredi","jeudi","vendredi","samedi"]},"chome":{"type":"boolean"}},"required":["date","code","nom","jour_semaine","chome"],"additionalProperties":false}}},"required":["operation","zone","feries"],"additionalProperties":false},"detail":{"minItems":1,"type":"array","items":{"type":"object","properties":{"etape":{"type":"string","minLength":1},"montant":{"type":"string","minLength":1},"explication":{"type":"string","minLength":1}},"required":["etape","montant","explication"],"additionalProperties":false}},"hypotheses":{"type":"array","items":{"type":"string","minLength":1}},"bareme":{"type":"object","properties":{"version":{"type":"string","minLength":1},"date_effet":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"sources":{"minItems":1,"type":"array","items":{"type":"string","format":"uri"}}},"required":["version","date_effet","sources"],"additionalProperties":false},"estimation_indicative":{"type":"boolean","const":true},"avertissement":{"type":"string","const":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel."},"lien_verification":{"type":"string","format":"uri"}},"required":["calculateur","resultat","detail","hypotheses","bareme","estimation_indicative","avertissement","lien_verification"],"additionalProperties":false},"example":{"calculateur":"jours-ouvres","resultat":{"operation":"compter_jours","zone":"metropole","date_debut":"2026-05-01","date_fin":"2026-05-31","jours_calendaires":31,"jours_ouvrables":22,"jours_ouvres":17,"feries":[{"date":"2026-05-01","code":"fete_travail","nom":"Fête du Travail (1er mai)","jour_semaine":"vendredi","chome":true},{"date":"2026-05-08","code":"victoire_1945","nom":"Victoire 1945 (8 mai)","jour_semaine":"vendredi","chome":true},{"date":"2026-05-14","code":"ascension","nom":"Ascension","jour_semaine":"jeudi","chome":true},{"date":"2026-05-25","code":"lundi_pentecote","nom":"Lundi de Pentecôte","jour_semaine":"lundi","chome":true}]},"detail":[{"etape":"Jours calendaires","montant":"31","explication":"Du 2026-05-01 au 2026-05-31, bornes incluses."},{"etape":"Jours fériés dans la période","montant":"4","explication":"2026-05-01 Fête du Travail (1er mai) (vendredi) ; 2026-05-08 Victoire 1945 (8 mai) (vendredi) ; 2026-05-14 Ascension (jeudi) ; 2026-05-25 Lundi de Pentecôte (lundi)"},{"etape":"Jours ouvrables","montant":"22","explication":"Lundis à samedis de la période, moins les jours fériés chômés tombant ces jours-là."},{"etape":"Jours ouvrés","montant":"17","explication":"Jours travaillés de la période, moins les jours fériés chômés et les autres jours non travaillés tombant ces jours-là."}],"hypotheses":["Métropole hors Alsace-Moselle : les 11 fêtes légales du Code du travail (art. L3133-1).","Tous les jours fériés sont considérés comme chômés. En droit, seul le 1er mai est obligatoirement chômé : les autres le sont selon l’accord, la convention collective ou l’usage de l’entreprise (indiquer feries_travailles sinon).","Jours ouvrables : du lundi au samedi, hors jours fériés chômés (le dimanche est le jour de repos hebdomadaire).","Jours ouvrés : lundi, mardi, mercredi, jeudi, vendredi (valeur par défaut), hors jours fériés chômés.","Les dates de début et de fin sont incluses dans le décompte.","Les jours fériés conventionnels ou locaux (Saint-Éloi, Sainte-Barbe…) ne sont pas inclus : les indiquer dans autres_jours_non_travailles si besoin."],"bareme":{"version":"jours-feries-2000-2027-v1","date_effet":"2000-01-01","sources":["https://www.service-public.gouv.fr/particuliers/vosdroits/F2405","https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000033020901"]},"estimation_indicative":true,"avertissement":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel.","lien_verification":"https://www.service-public.gouv.fr/particuliers/vosdroits/F2405"}}}},"402":{"description":"Payment required (x402). Instructions in the PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"422":{"description":"Free rejection before payment: champs_manquants (with questions to ask the user), entree_invalide, cas_non_supporte, bareme_non_disponible.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"429":{"description":"Rate limit exceeded (free)."}}}},"/api/calcul/indemnite-rupture":{"post":{"operationId":"france_severance_pay","summary":"France severance pay: dismissal and mutual termination (indemnité de licenciement, rupture conventionnelle)","description":"French severance pay for a CDI, 2026: statutory dismissal indemnity (indemnité de licenciement) or minimum rupture conventionnelle amount, then the tax and social split of the amount paid: tax-exempt part, contribution base, CSG/CRDS, net, 40% employer levy. Use when a user is dismissed, negotiates a rupture conventionnelle, or an employer budgets a departure in France: minimum amount due, how much is tax-free, how much CSG/CRDS is withheld, and the employer cost. Deterministic code, no LLM. Seniority and statutory amounts match the Labour Ministry simulator (code.travail.gouv.fr) on 15 recorded cases, including its exact month counting; the tax and social split reproduces every worked example of the official social security doctrine (BOSS) and service-public.fr; 2026 parameters (PASS 48,060 EUR, 40% levy from the 2026 social security financing act) are sourced. Not supported (refused for free with HTTP 422): end of fixed-term or temp contracts, serious misconduct (faute grave, answered for free: no statutory indemnity), occupational unfitness, redundancy plans (PSE) and redeployment leave, retirement, mixed full-time/part-time careers, collective agreement formulas (the agent supplies the branch amount), contracts ending outside 2026, amounts above 10 PASS. Price: 0.02 USDC per successful call (x402). Missing or invalid fields are reported for free (HTTP 422, with the questions to ask the user); you never pay for an error.","tags":["France","severance pay","rupture conventionnelle","payroll","labor law"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type_rupture":{"description":"licenciement (dismissal of a CDI employee), rupture_conventionnelle (mutual termination of a CDI), or fin_cdd_ou_interim (refused for free).","type":"string","enum":["licenciement","rupture_conventionnelle","fin_cdd_ou_interim"]},"motif_licenciement":{"description":"Required for licenciement: personnel, economique, inaptitude_non_professionnelle, inaptitude_professionnelle (refused) or faute_grave_ou_lourde (answered for free: no statutory indemnity).","type":"string","enum":["personnel","economique","inaptitude_non_professionnelle","inaptitude_professionnelle","faute_grave_ou_lourde"]},"cadre_licenciement_economique":{"description":"Required for economic dismissal: hors_pse, csp (security contract), pse or conge_reclassement (both refused).","type":"string","enum":["hors_pse","csp","pse","conge_reclassement"]},"date_entree":{"description":"Contract start date YYYY-MM-DD (first fixed-term contract if it was followed by the CDI without interruption).","type":"string"},"date_notification":{"description":"Required for licenciement: date the dismissal letter was sent, YYYY-MM-DD (the 8-month seniority condition is checked at this date).","type":"string"},"date_fin_contrat":{"description":"Contract end date YYYY-MM-DD: end of notice period (theoretical end if notice was waived by the employer, for non-occupational unfitness or CSP), or the termination date set in the rupture conventionnelle. Must be in 2026.","type":"string"},"absences_non_comptees":{"description":"Absences of a month or more that do not count toward seniority, as a list of {motif, duree_mois (whole months)}; empty list if none. motif: maladie_non_professionnelle, accident_de_trajet, conge_sabbatique, conge_creation_entreprise, conge_parental_temps_plein (counted half), conge_sans_solde, greve, mise_a_pied.","maxItems":30,"type":"array","items":{"type":"object","properties":{"motif":{"type":"string","enum":["maladie_non_professionnelle","accident_de_trajet","conge_sabbatique","conge_creation_entreprise","conge_parental_temps_plein","conge_sans_solde","greve","mise_a_pied"]},"duree_mois":{"type":"integer","minimum":1,"maximum":600}},"required":["motif","duree_mois"],"additionalProperties":false}},"salaires_mensuels_bruts":{"description":"Gross monthly salaries including bonuses, oldest to most recent: the 12 months before the dismissal notice (rupture conventionnelle: before the end of the contract), or all months worked if fewer; months before a sick leave if any.","minItems":1,"maxItems":12,"type":"array","items":{"type":"number","minimum":0,"maximum":100000000}},"primes_annuelles_3_derniers_mois":{"description":"Total annual or exceptional bonuses included in the last 3 salaries (0 if none); counted as 1/12 per month.","type":"number","minimum":0,"maximum":100000000},"alternance_temps_plein_partiel":{"description":"True if the employee alternated full-time and part-time periods (refused for free).","type":"boolean"},"indemnite_conventionnelle_branche":{"description":"Severance amount in EUR set by the industry-wide collective agreement if higher than the statutory one, or \"aucune\" (none), or \"inconnue\" (unknown: only the statutory minimum is returned, without the tax and social split).","anyOf":[{"type":"number","minimum":0,"maximum":100000000},{"type":"string","enum":["aucune","inconnue"]}]},"secteur_hors_ani":{"description":"Required for rupture_conventionnelle with a branch amount: true if the employer is agricultural, a liberal profession, social economy, health and social sector, or a private household (minimum is then the statutory amount).","type":"boolean"},"montant_specifique_branche_rupture_conventionnelle":{"description":"Optional, rupture_conventionnelle: specific amount set by the branch agreement for mutual termination, if any (used for the CSG/CRDS threshold).","type":"number","minimum":0,"maximum":100000000},"indemnite_versee":{"description":"Optional: gross amount actually paid or negotiated, EUR. Default: the minimum due.","type":"number","minimum":0,"maximum":100000000},"remuneration_brute_annee_precedente":{"description":"Gross pay received in the calendar year before the termination, EUR (0 if none). Not needed when the branch amount is unknown.","type":"number","minimum":0,"maximum":100000000},"droit_pension_retraite":{"description":"Required for rupture_conventionnelle: true if, at the termination date, the employee is entitled to claim a pension from a mandatory basic scheme (fully taxable then).","type":"boolean"},"annee_versement":{"description":"Optional: year the indemnity is paid. Default: year of the contract end; only 2026 is supported.","type":"integer","minimum":2000,"maximum":2100}},"required":["type_rupture","date_entree","date_fin_contrat","absences_non_comptees","salaires_mensuels_bruts","primes_annuelles_3_derniers_mois","alternance_temps_plein_partiel","indemnite_conventionnelle_branche"],"additionalProperties":false},"example":{"type_rupture":"rupture_conventionnelle","date_entree":"2026-03-01","date_fin_contrat":"2026-08-31","absences_non_comptees":[],"salaires_mensuels_bruts":[2000,2000,2000,2000,2000,2000],"primes_annuelles_3_derniers_mois":0,"alternance_temps_plein_partiel":false,"indemnite_conventionnelle_branche":"aucune","remuneration_brute_annee_precedente":0,"droit_pension_retraite":false,"indemnite_versee":600}}}},"responses":{"200":{"description":"Calculation result (paid): result, step-by-step detail, assumptions, official scale version and sources, link to the official simulator.","content":{"application/json":{"schema":{"type":"object","properties":{"calculateur":{"type":"string","minLength":1},"resultat":{"type":"object","properties":{"type_rupture":{"type":"string","enum":["licenciement","rupture_conventionnelle"]},"anciennete_mois":{"type":"string","pattern":"^\\d+(\\.5)?$"},"anciennete_texte":{"type":"string","minLength":1},"salaire_reference":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"nombre_mois_salaires":{"type":"integer","minimum":1,"maximum":12},"indemnite_legale":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"indemnite_conventionnelle_branche":{"anyOf":[{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},{"type":"null"}]},"minimum_applicable":{"anyOf":[{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},{"type":"null"}]},"ventilation":{"anyOf":[{"type":"object","properties":{"montant_verse":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"part_exoneree_impot":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"part_imposable":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"part_exclue_cotisations":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"assiette_cotisations":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"part_exclue_csg_crds":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"assiette_csg_crds":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"csg_deductible":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"csg_non_deductible":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"crds":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"net_avant_cotisations":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"contribution_patronale_specifique":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"cout_employeur_hors_cotisations":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"}},"required":["montant_verse","part_exoneree_impot","part_imposable","part_exclue_cotisations","assiette_cotisations","part_exclue_csg_crds","assiette_csg_crds","csg_deductible","csg_non_deductible","crds","net_avant_cotisations","contribution_patronale_specifique","cout_employeur_hors_cotisations"],"additionalProperties":false},{"type":"null"}]}},"required":["type_rupture","anciennete_mois","anciennete_texte","salaire_reference","nombre_mois_salaires","indemnite_legale","indemnite_conventionnelle_branche","minimum_applicable","ventilation"],"additionalProperties":false},"detail":{"minItems":1,"type":"array","items":{"type":"object","properties":{"etape":{"type":"string","minLength":1},"montant":{"type":"string","minLength":1},"explication":{"type":"string","minLength":1}},"required":["etape","montant","explication"],"additionalProperties":false}},"hypotheses":{"type":"array","items":{"type":"string","minLength":1}},"bareme":{"type":"object","properties":{"version":{"type":"string","minLength":1},"date_effet":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"sources":{"minItems":1,"type":"array","items":{"type":"string","format":"uri"}}},"required":["version","date_effet","sources"],"additionalProperties":false},"estimation_indicative":{"type":"boolean","const":true},"avertissement":{"type":"string","const":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel."},"lien_verification":{"type":"string","format":"uri"}},"required":["calculateur","resultat","detail","hypotheses","bareme","estimation_indicative","avertissement","lien_verification"],"additionalProperties":false},"example":{"calculateur":"indemnite-rupture","resultat":{"type_rupture":"rupture_conventionnelle","anciennete_mois":"6","anciennete_texte":"6 mois","salaire_reference":"2000.00","nombre_mois_salaires":6,"indemnite_legale":"250.00","indemnite_conventionnelle_branche":null,"minimum_applicable":"250.00","ventilation":{"montant_verse":"600.00","part_exoneree_impot":"300.00","part_imposable":"300.00","part_exclue_cotisations":"300.00","assiette_cotisations":"300.00","part_exclue_csg_crds":"250.00","assiette_csg_crds":"350.00","csg_deductible":"23.80","csg_non_deductible":"8.40","crds":"1.75","net_avant_cotisations":"566.05","contribution_patronale_specifique":"120.00","cout_employeur_hors_cotisations":"720.00"}},"detail":[{"etape":"Ancienneté retenue","montant":"6 mois","explication":"Du 2026-03-01 au 2026-08-31 inclus (date de rupture prévue par la convention), aucune absence retirée : 6 mois."},{"etape":"Salaire de référence","montant":"2000.00","explication":"Le plus favorable de la moyenne des 6 derniers mois (2000.00) et de la moyenne des 3 derniers mois, primes annuelles ou exceptionnelles comptées pour 1/12 par mois (2000.00) (Code du travail art. R1234-4). Montants affichés arrondis ; le calcul utilise la valeur exacte."},{"etape":"Minimum légal de l’indemnité spécifique de rupture conventionnelle","montant":"250.00","explication":"Salaire de référence × (1/4 × années jusqu’à 10 ans + 1/3 × années au-delà), années incomplètes au prorata des mois (Code du travail art. R1234-2, L1237-13)."},{"etape":"Minimum applicable","montant":"250.00","explication":"La convention collective de branche ne prévoit pas plus : le minimum est l’indemnité légale."},{"etape":"Part exonérée d’impôt sur le revenu","montant":"300.00","explication":"Le plus élevé de : montant légal ou conventionnel de branche (0.00) ; 2 × la rémunération brute de l’année précédente ; la moitié de l’indemnité ; ces deux dernières limites plafonnées à 6 PASS (PASS 2026 = 48060 € ; 2 PASS = 96 120 € ; 6 PASS = 288 360 €) (CGI art. 80 duodecies)."},{"etape":"Part exclue des cotisations sociales","montant":"300.00","explication":"Même calcul que l’exonération d’impôt, dans la limite de 2 PASS, soit 96 120 € (CSS art. L242-1 ; BOSS § 50-60). Assiette des cotisations : 300.00."},{"etape":"Assiette de la CSG et de la CRDS","montant":"350.00","explication":"Exclusion limitée au plus petit de : montant légal ou conventionnel propre à ce motif de rupture (250.00) ; part exclue des cotisations (CSS art. L136-1-1). Pas d’abattement de 1,75 %. CSG 9,2 % (6,8 % déductible, 2,4 % non déductible), CRDS 0,5 %."},{"etape":"Contribution patronale spécifique","montant":"120.00","explication":"40 % de la part exclue des cotisations, contrat terminé après le 1er janvier 2026 (CSS art. L137-12 ; LFSS 2026 art. 15 ; BOSS § 1000). Pas de forfait social."}],"hypotheses":["Contrat à durée indéterminée (CDI), sans alternance de temps plein et de temps partiel.","Ancienneté comptée comme le simulateur officiel du ministère du Travail : mois complets de la date d’entrée à la date de fin du contrat incluse, moins les absences déclarées (congé parental à temps plein pour moitié) ; les absences de moins d’un mois ne sont pas retirées.","Salaires bruts fournis par l’utilisateur, supposés conformes à l’article R1234-4 du Code du travail (primes comprises, frais et indemnités de congés payés ou de préavis exclus).","Ancienneté inférieure à 8 mois : indemnité spécifique minimale au prorata des mois de présence (circulaire DGT 2009-04, BOSS § 1010) ; aucune indemnité légale de licenciement ne serait due, ce qui réduit l’exonération (BOSS § 1020-1030).","Un accord d’entreprise, le contrat de travail ou un usage peut prévoir une indemnité plus favorable que le minimum indiqué.","Les cotisations sociales dues sur l’assiette des cotisations ne sont pas calculées : elles dépendent du bulletin de paie du mois (plafonds, taux de l’entreprise). Le net indiqué est donc avant ces cotisations.","La part imposable s’ajoute aux salaires de l’année. L’impôt lui-même n’est pas calculé ici.","La CSG non déductible (2,4 %) et la CRDS dues sur l’indemnité sont imposables avec les salaires, même si l’indemnité elle-même est exonérée.","Indemnité versée en 2026, sans cumul avec une indemnité de cessation d’un mandat social."],"bareme":{"version":"indemnite-rupture-2026-v1","date_effet":"2026-01-01","sources":["https://www.service-public.gouv.fr/particuliers/vosdroits/F987","https://www.service-public.gouv.fr/particuliers/vosdroits/F371","https://www.service-public.gouv.fr/particuliers/vosdroits/F31539","https://boss.gouv.fr/portail/accueil/autres-elements-de-remuneration/indemnites-de-rupture.html","https://www.urssaf.fr/accueil/outils-documentation/taux-baremes/taux-cotisations-secteur-prive.html"]},"estimation_indicative":true,"avertissement":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel.","lien_verification":"https://code.travail.gouv.fr/outils/indemnite-rupture-conventionnelle"}}}},"402":{"description":"Payment required (x402). Instructions in the PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"422":{"description":"Free rejection before payment: champs_manquants (with questions to ask the user), entree_invalide, cas_non_supporte, bareme_non_disponible.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"429":{"description":"Rate limit exceeded (free)."}}}},"/api/calcul/allocation-chomage":{"post":{"operationId":"france_unemployment_benefit","summary":"France unemployment benefit (allocation chômage ARE)","description":"French unemployment benefit (allocation chômage, ARE) after a dismissal, mutual termination (rupture conventionnelle) or end of fixed-term contract, for contracts ending Sep-Dec 2026: eligibility, daily reference wage, gross and net daily and monthly amounts, duration (new 2026 caps after rupture conventionnelle), 30% reduction after month 6, waiting periods and first paid day. Use when a user losing a job in France asks how much unemployment benefit they will receive, for how long, and from when, or an employer or adviser compares exit options. Deterministic code, no LLM. Rules from the Unédic regulation consolidated on 1 Sep 2026 and circular 2026-06; amounts, durations, rounding and start dates match the official France Travail simulator on 15 recorded cases (one documented gap: the simulator still uses the old cap after rupture conventionnelle). Refused for free (HTTP 422): resignation, temp agency or entertainment workers, overseas, rights still running, pension recipients, kept jobs, sick leave with reduced pay, contracts ending outside Sep-Dec 2026, and edge cases where official sources disagree (stated in the refusal). Price: 0.03 USDC per successful call (x402). Missing or invalid fields are reported for free (HTTP 422, with the questions to ask the user); you never pay for an error.","tags":["France","unemployment","chomage ARE","payroll","labor law"],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"motif_fin_contrat":{"description":"licenciement, licenciement_economique, rupture_conventionnelle, fin_cdd; demission or autre are refused.","type":"string","enum":["licenciement","licenciement_economique","rupture_conventionnelle","fin_cdd","demission","autre"]},"date_naissance":{"description":"Birth date YYYY-MM-DD.","type":"string"},"date_fin_contrat":{"description":"Contract end date YYYY-MM-DD, notice included; 2026-09-01 to 2026-12-31.","type":"string"},"periodes_emploi":{"description":"Jobs in the last 24 months (36 if 55+): {debut, fin, salaire_brut total gross pay of the period}.","minItems":1,"maxItems":30,"type":"array","items":{"type":"object","properties":{"debut":{"type":"string"},"fin":{"type":"string"},"salaire_brut":{"type":"number","minimum":0,"maximum":10000000}},"required":["debut","fin","salaire_brut"],"additionalProperties":false}},"heures_hebdomadaires":{"description":"Weekly hours (35 if full time).","type":"number","exclusiveMinimum":0,"maximum":48},"duree_hebdomadaire_reference":{"description":"Optional: full-time weekly hours in the company, default 35.","type":"number","exclusiveMinimum":0,"maximum":48},"primo_entrant":{"description":"True if no unemployment rights opened in the last 20 years.","type":"boolean"},"indemnite_conges_payes":{"description":"Paid-leave compensation paid at contract end(s) in the last 182 days, EUR.","type":"number","minimum":0,"maximum":10000000},"indemnites_supra_legales":{"description":"Severance above the statutory minimum, EUR (0 if none).","type":"number","minimum":0,"maximum":10000000},"delai_attente_deja_applique":{"description":"True if a 7-day waiting period was applied in the last 12 months.","type":"boolean"},"alsace_moselle":{"description":"True if under the Alsace-Moselle local scheme (net then not computed).","type":"boolean"},"situations_particulieres":{"description":"Special situations (refused), empty list if none.","maxItems":7,"type":"array","items":{"type":"string","enum":["droits_chomage_en_cours","pension_vieillesse_ou_invalidite","emploi_conserve","salaire_reduit_arret_ou_activite_partielle","conge_ou_arret_entre_deux_contrats","interim_ou_intermittent","outre_mer"]}},"date_inscription":{"description":"Optional: France Travail registration date; default the day after the contract end.","type":"string"}},"required":["motif_fin_contrat","date_naissance","date_fin_contrat","periodes_emploi","heures_hebdomadaires","primo_entrant","indemnite_conges_payes","indemnites_supra_legales","delai_attente_deja_applique","alsace_moselle","situations_particulieres"],"additionalProperties":false},"example":{"motif_fin_contrat":"licenciement","date_naissance":"1985-03-15","date_fin_contrat":"2026-10-31","periodes_emploi":[{"debut":"2024-11-01","fin":"2026-10-31","salaire_brut":72000}],"heures_hebdomadaires":35,"primo_entrant":false,"indemnite_conges_payes":0,"indemnites_supra_legales":0,"delai_attente_deja_applique":false,"alsace_moselle":false,"situations_particulieres":[]}}}},"responses":{"200":{"description":"Calculation result (paid): result, step-by-step detail, assumptions, official scale version and sources, link to the official simulator.","content":{"application/json":{"schema":{"type":"object","properties":{"calculateur":{"type":"string","minLength":1},"resultat":{"type":"object","properties":{"droit_ouvert":{"type":"boolean","const":true},"age_fin_contrat":{"type":"integer","minimum":14,"maximum":61},"periode_reference_debut":{"type":"string"},"jours_travailles":{"type":"integer","minimum":108,"maximum":9007199254740991},"jours_calendaires":{"type":"integer","minimum":1,"maximum":1095},"salaire_reference":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"sjr":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"allocation_journaliere_initiale":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"formule":{"type":"string","enum":["40,4 % + partie fixe","57 %","allocation minimale","plafond de 75 %"]},"participation_retraite":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"allocation_journaliere_brute":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"net_journalier":{"anyOf":[{"type":"object","properties":{"taux_normal":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"taux_reduit":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"exonere":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"}},"required":["taux_normal","taux_reduit","exonere"],"additionalProperties":false},{"type":"null"}]},"montant_mensuel_brut":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"montant_mensuel_net":{"anyOf":[{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},{"type":"null"}]},"duree_jours":{"type":"integer","minimum":152,"maximum":822},"plafond_duree_jours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"degressivite":{"anyOf":[{"type":"object","properties":{"jours":{"type":"integer","minimum":1,"maximum":9007199254740991},"allocation_journaliere_brute":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"net_journalier":{"anyOf":[{"type":"object","properties":{"taux_normal":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"taux_reduit":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"exonere":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"}},"required":["taux_normal","taux_reduit","exonere"],"additionalProperties":false},{"type":"null"}]},"montant_mensuel_brut":{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},"montant_mensuel_net":{"anyOf":[{"type":"string","pattern":"^-?\\d+\\.\\d{2}$"},{"type":"null"}]}},"required":["jours","allocation_journaliere_brute","net_journalier","montant_mensuel_brut","montant_mensuel_net"],"additionalProperties":false},{"type":"null"}]},"differe_specifique_jours":{"type":"integer","minimum":0,"maximum":150},"differe_conges_payes_jours":{"type":"integer","minimum":0,"maximum":30},"delai_attente_jours":{"anyOf":[{"type":"number","const":0},{"type":"number","const":7}]},"premier_jour_indemnisable":{"type":"string"}},"required":["droit_ouvert","age_fin_contrat","periode_reference_debut","jours_travailles","jours_calendaires","salaire_reference","sjr","allocation_journaliere_initiale","formule","participation_retraite","allocation_journaliere_brute","net_journalier","montant_mensuel_brut","montant_mensuel_net","duree_jours","plafond_duree_jours","degressivite","differe_specifique_jours","differe_conges_payes_jours","delai_attente_jours","premier_jour_indemnisable"],"additionalProperties":false},"detail":{"minItems":1,"type":"array","items":{"type":"object","properties":{"etape":{"type":"string","minLength":1},"montant":{"type":"string","minLength":1},"explication":{"type":"string","minLength":1}},"required":["etape","montant","explication"],"additionalProperties":false}},"hypotheses":{"type":"array","items":{"type":"string","minLength":1}},"bareme":{"type":"object","properties":{"version":{"type":"string","minLength":1},"date_effet":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"sources":{"minItems":1,"type":"array","items":{"type":"string","format":"uri"}}},"required":["version","date_effet","sources"],"additionalProperties":false},"estimation_indicative":{"type":"boolean","const":true},"avertissement":{"type":"string","const":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel."},"lien_verification":{"type":"string","format":"uri"}},"required":["calculateur","resultat","detail","hypotheses","bareme","estimation_indicative","avertissement","lien_verification"],"additionalProperties":false},"example":{"calculateur":"allocation-chomage","resultat":{"droit_ouvert":true,"age_fin_contrat":41,"periode_reference_debut":"2024-11-01","jours_travailles":523,"jours_calendaires":730,"salaire_reference":"72000.00","sjr":"98.63","allocation_journaliere_initiale":"56.22","formule":"57 %","participation_retraite":"2.96","allocation_journaliere_brute":"53.26","net_journalier":{"taux_normal":"53.26","taux_reduit":"53.26","exonere":"53.26"},"montant_mensuel_brut":"1597.80","montant_mensuel_net":"1597.80","duree_jours":548,"plafond_duree_jours":548,"degressivite":null,"differe_specifique_jours":0,"differe_conges_payes_jours":0,"delai_attente_jours":7,"premier_jour_indemnisable":"2026-11-08"},"detail":[{"etape":"Période de référence","montant":"730 jours","explication":"24 mois avant la fin du contrat (41 ans à cette date) : du 2024-11-01 au 2026-10-31. Jours calendaires retenus du premier jour d’emploi (2024-11-01) à la fin du contrat : 730 ; 523 jours travaillés (5 par semaine civile au plus, art. 3 du règlement)."},{"etape":"Salaire journalier de référence (SJR)","montant":"98.63","explication":"Salaires bruts de la période (72000.00 €) ÷ 730 jours, arrondi au centime (art. 11 à 13)."},{"etape":"Allocation journalière initiale","montant":"56.22","explication":"Le plus favorable de 40,4 % du SJR + 13,18 € et de 57 % du SJR, au moins 32,13 €, au plus 75 % du SJR (art. 14 à 16). Formule retenue : 57 %."},{"etape":"Allocation journalière brute","montant":"53.26","explication":"Après la participation de 3 % du SJR au financement des retraites complémentaires (2.96 €), sans descendre sous 32,13 € (art. 19)."},{"etape":"Durée d’indemnisation","montant":"548 jours","explication":"730 jours × 0,75, arrondi à l’entier supérieur, au moins 182 jours, au plus 548 jours (plafond selon l’âge) (art. 9)."},{"etape":"Premier jour indemnisable","montant":"2026-11-08","explication":"Lendemain de la fin du contrat, puis différé spécifique (0 j : indemnités supra-légales ÷ 111,8, entier inférieur), différé congés payés (0 j : indemnité ÷ SJR, entier inférieur, 30 au plus), au plus tôt à l’inscription (2026-11-01), puis délai d’attente (7 j) (art. 21 à 23)."}],"hypotheses":["Montants mensuels sur une base de 30 jours, comme les versements de France Travail.","Montants de l’allocation au 01/07/2025, non revalorisés au 01/07/2026 ; une revalorisation au 01/07/2027 n’est pas prise en compte.","Inscription à France Travail le lendemain de la fin du contrat.","Salaires déclarés supposés conformes : primes comprises, sans indemnités de rupture, de congés payés ni de préavis.","Seule la notification de France Travail fait foi.","Net : CSG et CRDS selon le revenu fiscal de référence (taux normal, réduit ou exonération) ; pas de prélèvement faisant passer l’allocation sous 62 € par jour. L’impôt sur le revenu n’est pas déduit."],"bareme":{"version":"are-2026-09-v1","date_effet":"2026-09-01","sources":["https://www.unedic.org/la-reglementation/conventions-d-assurance-chomage/texte-consolide-du-reglement-general-annexe-a-la-convention-du-15-novembre-2024-4","https://www.unedic.org/la-reglementation/conventions-d-assurance-chomage/avenant-n2-du-10-avril-2026-a-la-convention-du-15-novembre-2024-relative-a-lassurance-chomage","https://www.unedic.org/la-reglementation/circulaires/prescription-circulaire-no-2026-06-du-01-septembre-2026","https://www.unedic.org/actualites/allocations-dassurance-chomage-pas-de-revalorisation-au-1er-juillet-2026"]},"estimation_indicative":true,"avertissement":"Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel.","lien_verification":"https://candidat.francetravail.fr/portail-simulateurs/"}}}},"402":{"description":"Payment required (x402). Instructions in the PAYMENT-REQUIRED header.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"422":{"description":"Free rejection before payment: champs_manquants (with questions to ask the user), entree_invalide, cas_non_supporte, bareme_non_disponible.","content":{"application/json":{"schema":{"type":"object","properties":{"erreur":{"type":"object","properties":{"code":{"type":"string","description":"champs_manquants, entree_invalide, cas_non_supporte, bareme_non_disponible, paiement_requis…"},"message":{"type":"string"},"champs_manquants":{"type":"array","description":"Missing fields, each with a question (in French) to ask the end user, its type and allowed values.","items":{"type":"object","properties":{"champ":{"type":"string"},"question":{"type":"string"},"type":{"type":"string"},"valeurs_possibles":{"type":"array"}}}}},"required":["code","message"]}},"required":["erreur"]}}}},"429":{"description":"Rate limit exceeded (free)."}}}}},"x-discovery":{"ownershipProofs":["0xda269c0ff1da2477b34e32967bb8a00018945b4ea08377074262fe6a38b3d88f1d9df320521cfefed531ce9e44cb2490d6100d5e3fde934dd5a5a0740efea50b1b"]}}