List tax deadlines
well_list_tax_deadlinesList a French company's or micro-entrepreneur's upcoming tax deadlines, computed from its tax profile: the VAT returns (CA3 monthly or quarterly, or the annual CA12 with its July and December instalments), the corporate income tax instalments, balance and return, the CFE, the filing of the annual accounts, the employer's monthly payroll return (DSN), which also carries the payment of the URSSAF contributions every month, or after each quarter for an employer under 11 employees who chose to pay quarterly, and a micro-entrepreneur's URSSAF turnover declaration. A tax deadline question ("what are my next tax deadlines", "quelles sont mes prochaines échéances fiscales", "quand déclarer mon chiffre d'affaires à l'URSSAF") does not start here: load the vat-radar skill first (with well_get_skill, or with the host's own skill tool when the Well skills are installed in it) and follow it; the skill calls this tool. It reads the profile Well holds and computes the dates; it reads no tax site and stores nothing. For the VAT amount of a period, call well_get_vat_summary as well.
deadlines lists the deadlines due from today for months months (default 3, at most 12), soonest first. Each has due.from and due.to (one day when equal; the CA3 window from the 15th to the 24th otherwise), the period it covers when it covers one, a condition when the profile cannot settle the date or whether it applies, and its source. The conditions: prior_year_tax_above_3000_eur (no instalment when last year's corporate tax was under 3,000 EUR); not_the_creation_year (no CFE in the year of creation); approval_on_last_allowed_day (the latest filing day when the accounts are approved on the last day the law allows); day_set_per_company (the administration sets the CA3 day per company inside the window and Well does not know it: the assumed date is due.from, the 15th, and the answer says it is assumed); day_from_prior_return (the CA3 day is the one on the latest VAT return the person gave Well: say where the day comes from); first_declaration_date_assumed (the first URSSAF declaration covers every month since the start of activity, and its date is assumed because the official texts disagree: say so); fewer_than_50_employees (the monthly payroll day is the 15th for an employer under 50 employees; one of 50 or more that pays the wages in the month files and pays by the 5th: say the day depends on the headcount). A micro-entrepreneur declares every URSSAF period, also one with no turnover (« néant »). The VAT returns of a micro-entrepreneur show only when its VAT regime is not the franchise. State every date with its source and its condition. Never state a date that is not in deadlines.
undated lists the deadlines Well cannot date, each with a reason. missing_profile_key: the missing profile keys (legal_form, vat_regime, vat_filing_frequency, corporate_tax_regime, fiscal_year_end, urssaf_filing_frequency, payroll_contribution_payment_frequency) are not set; ask for one missing value at a time (for payroll_contribution_payment_frequency, ask whether the company has employees and how often it pays the contributions; a company with no employee saves none), save legal_form with well_update_company and the accounting settings with well_upsert_accounting_settings, then re-read the calendar. Never guess a missing key. unsupported_legal_form: the legal form is set, but Well's table holds no rule for it, and missing is empty; say Well does not date the deadlines of that legal form, and ask nothing. not_owed lists the deadlines the profile says the company does not owe, such as the CA3 under the VAT franchise, the URSSAF declaration of a company, or the corporate tax and annual accounts of a micro-entrepreneur, or the CFE of a company the profile marks exempt (cfe_liable false), or the payroll deadlines of a company with no employee (payroll_contribution_payment_frequency none).
status: "unsupported_jurisdiction" means the workspace's accounting country is not France: Well holds no calendar for it. status: "failed" means the read failed: the calendar is unknown, never empty.
When the token authorizes one workspace, call this directly — no workspace call is needed first. When it authorizes several, this read will not guess which one you mean: pass workspace_id on the call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| months | No | How many months ahead to list, 3 by default. | |
| workspace_id | No | Target workspace. Omit when the token authorizes one workspace. Required when it authorizes several: this read reports one workspace's own figures and will not choose which. | |
| conversation_id | No | The conversation id returned by the previous Well result, in its meta under well/conversation_id, in its structuredContent, or in its JSON text block. Pass it back on every call in the same conversation, including a call a card makes, so the chosen workspace and the earlier answers still apply. It decides the conversation on its own: nothing the host states about the session replaces it. Omit it only on the first call of a conversation. | |
| workspace_scope | No | Restrict this call to the family: the token's primary workspace plus the company workspaces under it that you are a member of. Unrelated authorized workspaces drop out of the read; row reads merge across the family, while a per-workspace figure still reports exactly one workspace. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| today | No | ||
| status | Yes | ||
| profile | No | ||
| success | Yes | ||
| undated | No | ||
| not_owed | No | ||
| deadlines | No | ||
| country_code | No | ||
| conversation_id | No | The conversation this result belongs to. Pass it back as the conversation_id argument on every later Well call in the same conversation. | |
| newly_connected | No | Tools that connected to this workspace since the last result and that no session was told about yet, oldest first. Present only when at least one tool is new. The connected-line rule says when to tell an entry; when it does, one line per entry, in the person's language: "<name> is connected.". Never fold several entries into one sentence. Each entry comes back once, on one result only: never repeat its line later. | |
| resolved_workspace | No | The workspace that answered, when the caller named none and the token authorizes several. | |
| conversation_id_note | No | Present only when the server opened a fresh lane, stating that no choice recorded earlier was read. | |
| conversation_id_source | No | Where the conversation id came from: the host's own request meta, the caller's argument, or a fresh lane the server opened. |