Ukraine Self-Employed Intake Skill v0.1
General reference only. This skill is general tax/accounting reference material for AI-assisted workflows. It has not been reviewed for any specific person's facts, documents, elections, deadlines, residency, filing status, or local procedures. Do not rely on it to file, pay, amend, or take a tax position without review by a qualified professional in the relevant jurisdiction.
What this file is
The intake orchestrator for Ukraine-resident self-employed individuals (ФОП / FOP). Every downstream Ukraine content skill (ua-single-tax, ua-income-tax, ua-social-contributions, ukraine-vat) and the assembly orchestrator (ua-return-assembly) depend on this skill running first to produce a structured intake package.
This skill computes nothing. Its job is to collect the facts, parse the documents, confirm everything, and hand off a clean intake package.
Design principles
Upload-first, inference-then-confirm:
- Compact refusal sweep — 3–5 interactive questions, ~30 seconds.
- Upload-first — the user dumps everything they have (bank statements, registration extract, prior return).
- Inference pass — parse every document, extract as much as possible.
- Gap-filling only — ask only about what is missing or ambiguous.
- Single confirmation pass — show the full picture, hand off downstream.
Do not narrate phases. Do not re-ask anything visible in the documents.
Step 1 — Refusal sweep (route to the right regime)
Establish, fast:
- Are you a ФОП (individual entrepreneur), or a company (ТОВ)? — ТОВ is out of scope; escalate.
- Simplified system (single tax) or general system? — routes to
ua-single-tax vs ua-income-tax.
- If single tax: which group (1, 2, or 3)? — most freelancers/IT are Group 3.
- If Group 3: VAT-registered? — determines 3% vs 5%.
- Ukrainian tax resident for the year? — non-residents escalate.
Conservative defaults if unanswered: ФОП, simplified, Group 3, non-VAT, resident.
Step 2 — Collect
Ask the user to upload:
- Bank statements for all accounts (UAH and any FX) for the full year.
- Registration extract (виписка з ЄДР) with КВЕД activity codes.
- Prior-year single-tax declaration and ЄСВ payment history, if any.
Step 3 — Infer & confirm
- Determine the group and VAT status from the extract if not stated.
- Convert FX receipts to UAH at the NBU rate on the date of receipt.
- Identify income vs internal transfers vs loan movements.
- Flag any barred activity (excisable goods, FX exchange, financial services, gambling, mineral extraction) and any approach to the group income cap.
Step 4 — Hand off
Produce a structured intake package and route:
- Simplified:
ua-single-tax (single tax + military levy) + ua-social-contributions (ЄСВ) + ukraine-vat if VAT-registered → ua-return-assembly.
- General system:
ua-income-tax (18% PIT + 5% military levy) + ua-social-contributions → ua-return-assembly.
Disclaimer
This skill orchestrates intake only and computes no tax. All downstream outputs must be reviewed and signed off by a qualified Ukrainian accountant or auditor before filing. The most up-to-date version is maintained at openaccountants.com.
Source: OpenAccountants — open tax Guides for AI, reviewed by named CPAs/CAs/EAs. Quality: source-cited draft. For always-current figures and named-accountant backing, connect the OpenAccountants MCP server (openaccountants-mcp).
1---2name: ua-freelance-intake3description: ALWAYS USE THIS SKILL when a user asks for help preparing their Ukrainian taxes AND mentions freelancing, self-employment, sole proprietorship, ФОП, FOP, or being an individual entrepreneur in Ukraine. Trigger on phrases like "help me do my Ukrainian taxes", "I'm a ФОП", "I'm a freelancer in Ukraine", "prepare my single-tax return", "I'm self-employed in Ukraine", or any similar phrasing where the user is a Ukraine-resident self-employed individual needing tax help. This is the REQUIRED entry point for the Ukraine self-employed workflow — downstream skills (ua-single-tax, ua-income-tax, ua-social-contributions, ukraine-vat, ua-return-assembly) depend on this skill running first to produce a structured intake package. Upload-first workflow. Ukraine-resident sole proprietors only.4license: AGPL-3.0-or-later (code) / OpenAccountants Guide License v1.0 (c5---67# Ukraine Self-Employed Intake Skill v0.189> **General reference only.** This skill is general tax/accounting reference material for AI-assisted workflows. It has not been reviewed for any specific person's facts, documents, elections, deadlines, residency, filing status, or local procedures. Do not rely on it to file, pay, amend, or take a tax position without review by a qualified professional in the relevant jurisdiction.1011## What this file is1213The intake orchestrator for Ukraine-resident self-employed individuals (ФОП / FOP). Every downstream Ukraine content skill (ua-single-tax, ua-income-tax, ua-social-contributions, ukraine-vat) and the assembly orchestrator (ua-return-assembly) depend on this skill running first to produce a structured intake package.1415This skill computes nothing. Its job is to collect the facts, parse the documents, confirm everything, and hand off a clean intake package.1617---1819## Design principles2021Upload-first, inference-then-confirm:221. **Compact refusal sweep** — 3–5 interactive questions, ~30 seconds.232. **Upload-first** — the user dumps everything they have (bank statements, registration extract, prior return).243. **Inference pass** — parse every document, extract as much as possible.254. **Gap-filling only** — ask only about what is missing or ambiguous.265. **Single confirmation pass** — show the full picture, hand off downstream.2728Do not narrate phases. Do not re-ask anything visible in the documents.2930---3132## Step 1 — Refusal sweep (route to the right regime)3334Establish, fast:351. **Are you a ФОП (individual entrepreneur), or a company (ТОВ)?** — ТОВ is out of scope; escalate.362. **Simplified system (single tax) or general system?** — routes to `ua-single-tax` vs `ua-income-tax`.373. **If single tax: which group (1, 2, or 3)?** — most freelancers/IT are Group 3.384. **If Group 3: VAT-registered?** — determines 3% vs 5%.395. **Ukrainian tax resident for the year?** — non-residents escalate.4041Conservative defaults if unanswered: ФОП, simplified, Group 3, non-VAT, resident.4243## Step 2 — Collect4445Ask the user to upload:46- Bank statements for all accounts (UAH and any FX) for the full year.47- Registration extract (виписка з ЄДР) with КВЕД activity codes.48- Prior-year single-tax declaration and ЄСВ payment history, if any.4950## Step 3 — Infer & confirm5152- Determine the group and VAT status from the extract if not stated.53- Convert FX receipts to UAH at the NBU rate on the date of receipt.54- Identify income vs internal transfers vs loan movements.55- Flag any barred activity (excisable goods, FX exchange, financial services, gambling, mineral extraction) and any approach to the group income cap.5657## Step 4 — Hand off5859Produce a structured intake package and route:60- **Simplified:** `ua-single-tax` (single tax + military levy) + `ua-social-contributions` (ЄСВ) + `ukraine-vat` if VAT-registered → `ua-return-assembly`.61- **General system:** `ua-income-tax` (18% PIT + 5% military levy) + `ua-social-contributions` → `ua-return-assembly`.6263---6465## Disclaimer6667This skill orchestrates intake only and computes no tax. All downstream outputs must be reviewed and signed off by a qualified Ukrainian accountant or auditor before filing. The most up-to-date version is maintained at [openaccountants.com](https://openaccountants.com).6869---7071_Source: [OpenAccountants](https://openaccountants.com/skills/ua-freelance-intake) — open tax Guides for AI, reviewed by named CPAs/CAs/EAs. Quality: **source-cited draft**. For always-current figures and named-accountant backing, connect the OpenAccountants MCP server (`openaccountants-mcp`)._