TaxCompass — Italian tax tools

Search TaxCompass's primary-source corpus and return passages to cite. Hybrid semantic + keyword retrieval over Italian tax & company-law primary sources: Normattiva (statute), Agenzia delle Entrate (circolari & guidance), INPS (social security), pinned tax-year tables (IRPEF brackets, INPS rates, forfettario thresholds & coefficienti di redditività), the ATECO 2025 code catalogue, and EU/treaty sources. Each result carries a `chunk_id`, `source`, and (usually) a `url`. Cite the `url` and quote the `text`; do not assert Italian tax facts the passages don't support. Queries work in any language, but Italian keywords improve recall against the (Italian) legal corpus. Args: query: What to search for. Keyword-dense Italian phrasing works best. sources: Optional subset to restrict to (see `list_tax_sources` for keys). Omit to search everything. Unknown keys are ignored. k: Max passages to return (1–12).

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "sources": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Sources"
    },
    "k": {
      "default": 6,
      "title": "K",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_italian_tax_sourcesArguments"
}

{
  "type": "object",
  "properties": {
    "query": {
      "description": "The query that was run.",
      "title": "Query",
      "type": "string"
    },
    "sources_searched": {
      "description": "Source keys actually searched (after filtering).",
      "items": {
        "type": "string"
      },
      "title": "Sources Searched",
      "type": "array"
    },
    "count": {
      "description": "Number of passages returned.",
      "title": "Count",
      "type": "integer"
    },
    "passages": {
      "description": "Retrieved passages, most relevant first.",
      "items": {
        "$ref": "#/$defs/SourcePassage"
      },
      "title": "Passages",
      "type": "array"
    },
    "disclaimer": {
      "description": "Usage + citation guidance.",
      "title": "Disclaimer",
      "type": "string"
    }
  },
  "required": [
    "query",
    "sources_searched",
    "count",
    "passages",
    "disclaimer"
  ],
  "$defs": {
    "SourcePassage": {
      "description": "One retrieved passage from a primary source, with everything needed to cite it.",
      "properties": {
        "chunk_id": {
          "description": "Stable citation id for this passage (cite this).",
          "title": "Chunk Id",
          "type": "string"
        },
        "source": {
          "description": "Source key, e.g. 'normattiva', 'ade', 'inps', 'tables', 'ateco'.",
          "title": "Source",
          "type": "string"
        },
        "source_label": {
          "description": "Human-readable source name.",
          "title": "Source Label",
          "type": "string"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Document/section title, if known.",
          "title": "Title"
        },
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Link to the primary source — cite this URL.",
          "title": "Url"
        },
        "text": {
          "description": "The passage text. Quote/paraphrase only what this supports.",
          "title": "Text",
          "type": "string"
        },
        "similarity": {
          "description": "Hybrid relevance score in ~[0,1]; higher is closer.",
          "title": "Similarity",
          "type": "number"
        }
      },
      "required": [
        "chunk_id",
        "source",
        "source_label",
        "text",
        "similarity"
      ],
      "title": "SourcePassage",
      "type": "object"
    }
  },
  "description": "Result of a primary-source search.",
  "title": "SearchResponse"
}

List the primary sources the corpus can search, and what each covers. Use this to discover the valid `sources` filter values for `search_italian_tax_sources` and to understand the corpus's coverage.

{
  "type": "object",
  "properties": {},
  "title": "list_tax_sourcesArguments"
}

{
  "type": "object",
  "properties": {
    "sources": {
      "items": {
        "$ref": "#/$defs/TaxSourceInfo"
      },
      "title": "Sources",
      "type": "array"
    },
    "disclaimer": {
      "title": "Disclaimer",
      "type": "string"
    }
  },
  "required": [
    "sources",
    "disclaimer"
  ],
  "$defs": {
    "TaxSourceInfo": {
      "description": "A retrievable source and what it covers.",
      "properties": {
        "key": {
          "description": "Filter value for `search_italian_tax_sources`.",
          "title": "Key",
          "type": "string"
        },
        "label": {
          "description": "Human-readable source name.",
          "title": "Label",
          "type": "string"
        },
        "description": {
          "description": "What this source covers / when to use it.",
          "title": "Description",
          "type": "string"
        }
      },
      "required": [
        "key",
        "label",
        "description"
      ],
      "title": "TaxSourceInfo",
      "type": "object"
    }
  },
  "description": "The set of primary sources the corpus can search.",
  "title": "SourcesCatalogue"
}

Compute exact Italian tax for one regime at a given annual revenue. Deterministic calculation (not an estimate): substitute/income tax, INPS social contributions, net income, and effective rate. `breakdown.eligible` is False when the regime doesn't apply to the inputs (e.g. forfettario above the €85k cap) — present that as "not eligible", not as a real option. Args: revenue_eur: Gross annual revenue in EUR. regime: One of `forfettario_5`, `forfettario_15`, `ordinario`, `ordinario_impatriati`. coefficient: Forfettario coefficiente di redditività (0.40–0.86, set by the activity's ATECO group). Omit for the professional-services default (0.78). Ignored by non-forfettario regimes. cost_ratio: Deductible costs as a fraction of revenue (0–1), used by ordinario/impatriati. Ignored by forfettario.

{
  "type": "object",
  "properties": {
    "revenue_eur": {
      "title": "Revenue Eur",
      "type": "number"
    },
    "regime": {
      "default": "forfettario_15",
      "title": "Regime",
      "type": "string"
    },
    "coefficient": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Coefficient"
    },
    "cost_ratio": {
      "default": 0,
      "title": "Cost Ratio",
      "type": "number"
    }
  },
  "required": [
    "revenue_eur"
  ],
  "title": "calculate_italian_taxArguments"
}

{
  "type": "object",
  "properties": {
    "breakdown": {
      "$ref": "#/$defs/Breakdown",
      "description": "Full numeric breakdown (taxes, contributions, net, effective rate)."
    },
    "disclaimer": {
      "title": "Disclaimer",
      "type": "string"
    }
  },
  "required": [
    "breakdown",
    "disclaimer"
  ],
  "$defs": {
    "Breakdown": {
      "properties": {
        "country": {
          "title": "Country",
          "type": "string"
        },
        "regime": {
          "title": "Regime",
          "type": "string"
        },
        "revenue_local": {
          "title": "Revenue Local",
          "type": "number"
        },
        "revenue_eur": {
          "title": "Revenue Eur",
          "type": "number"
        },
        "currency": {
          "enum": [
            "EUR",
            "PLN",
            "RON"
          ],
          "title": "Currency",
          "type": "string"
        },
        "social_contributions": {
          "default": 0,
          "title": "Social Contributions",
          "type": "number"
        },
        "health_contribution": {
          "default": 0,
          "title": "Health Contribution",
          "type": "number"
        },
        "income_tax": {
          "default": 0,
          "title": "Income Tax",
          "type": "number"
        },
        "substitute_tax": {
          "default": 0,
          "title": "Substitute Tax",
          "type": "number"
        },
        "other_deductions": {
          "default": 0,
          "title": "Other Deductions",
          "type": "number"
        },
        "net_local": {
          "default": 0,
          "title": "Net Local",
          "type": "number"
        },
        "net_eur": {
          "default": 0,
          "title": "Net Eur",
          "type": "number"
        },
        "effective_rate": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Effective Rate"
        },
        "eligible": {
          "default": true,
          "title": "Eligible",
          "type": "boolean"
        },
        "contributions_are_stand_in": {
          "default": false,
          "title": "Contributions Are Stand In",
          "type": "boolean"
        },
        "assumptions": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Assumptions",
          "type": "array"
        },
        "notes": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Notes",
          "type": "array"
        }
      },
      "required": [
        "country",
        "regime",
        "revenue_local",
        "revenue_eur",
        "currency"
      ],
      "title": "Breakdown",
      "type": "object"
    }
  },
  "description": "A single deterministic tax calculation.",
  "title": "CalcResult"
}

Compare all Italian regimes side by side at one revenue level. Runs forfettario (5% & 15%), ordinario, and ordinario + impatriati through the deterministic engine and returns them sorted by net income (best first), each with its full breakdown and eligibility. Args: revenue_eur: Gross annual revenue in EUR. coefficient: Forfettario coefficiente di redditività (0.40–0.86); omit for the professional-services default (0.78). cost_ratio: Deductible costs as a fraction of revenue (0–1) for the ordinario regimes.

{
  "type": "object",
  "properties": {
    "revenue_eur": {
      "title": "Revenue Eur",
      "type": "number"
    },
    "coefficient": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Coefficient"
    },
    "cost_ratio": {
      "default": 0,
      "title": "Cost Ratio",
      "type": "number"
    }
  },
  "required": [
    "revenue_eur"
  ],
  "title": "compare_italian_regimesArguments"
}

{
  "type": "object",
  "properties": {
    "revenue_eur": {
      "description": "Gross annual revenue (EUR) the regimes were evaluated at.",
      "title": "Revenue Eur",
      "type": "number"
    },
    "results": {
      "description": "One breakdown per regime, best net income first.",
      "items": {
        "$ref": "#/$defs/Breakdown"
      },
      "title": "Results",
      "type": "array"
    },
    "disclaimer": {
      "title": "Disclaimer",
      "type": "string"
    }
  },
  "required": [
    "revenue_eur",
    "results",
    "disclaimer"
  ],
  "$defs": {
    "Breakdown": {
      "properties": {
        "country": {
          "title": "Country",
          "type": "string"
        },
        "regime": {
          "title": "Regime",
          "type": "string"
        },
        "revenue_local": {
          "title": "Revenue Local",
          "type": "number"
        },
        "revenue_eur": {
          "title": "Revenue Eur",
          "type": "number"
        },
        "currency": {
          "enum": [
            "EUR",
            "PLN",
            "RON"
          ],
          "title": "Currency",
          "type": "string"
        },
        "social_contributions": {
          "default": 0,
          "title": "Social Contributions",
          "type": "number"
        },
        "health_contribution": {
          "default": 0,
          "title": "Health Contribution",
          "type": "number"
        },
        "income_tax": {
          "default": 0,
          "title": "Income Tax",
          "type": "number"
        },
        "substitute_tax": {
          "default": 0,
          "title": "Substitute Tax",
          "type": "number"
        },
        "other_deductions": {
          "default": 0,
          "title": "Other Deductions",
          "type": "number"
        },
        "net_local": {
          "default": 0,
          "title": "Net Local",
          "type": "number"
        },
        "net_eur": {
          "default": 0,
          "title": "Net Eur",
          "type": "number"
        },
        "effective_rate": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Effective Rate"
        },
        "eligible": {
          "default": true,
          "title": "Eligible",
          "type": "boolean"
        },
        "contributions_are_stand_in": {
          "default": false,
          "title": "Contributions Are Stand In",
          "type": "boolean"
        },
        "assumptions": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Assumptions",
          "type": "array"
        },
        "notes": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Notes",
          "type": "array"
        }
      },
      "required": [
        "country",
        "regime",
        "revenue_local",
        "revenue_eur",
        "currency"
      ],
      "title": "Breakdown",
      "type": "object"
    }
  },
  "description": "Deterministic side-by-side of the Italian regimes at one revenue level.",
  "title": "RegimeComparison"
}