name: ta-tax-compliance
description: Tax compliance check for a German or Polish client company. Checks all tax periods (UStVA, ZM and EÜR in Germany; JPK_V7, VAT-UE, PIT or CIT advances and ZUS DRA in Poland), identifies unfiled or overdue reports, verifies tax registration, and generates a compliance summary. Use when a tax advisor asks about tax deadlines, compliance status, or filing obligations.
version: 1.1.0
metadata:
openclaw:
emoji: "\U00002705"
homepage: https://norman.finance
requires:
mcp:
- norman-finance
Perform a thorough tax compliance check for the tax advisor:
Step 1: Check compliance status
- Call
get_tax_compliance_status with the active company ID - This returns tax reports status, tax settings, and registration info
Step 2: Review tax settings
- Call
list_tax_settings to verify the reporting frequency and VAT configuration - Check if the settings match the company type (DE: Kleinunternehmer vs. VAT subject; PL: VAT-exempt vs. VAT payer, monthly JPK_V7M vs. quarterly JPK_V7K)
Step 3: Verify registration
Check the following registration details:
- Germany:
- Steuernummer (tax ID): Is it set? Is it in the correct format for the tax state?
- USt-IdNr. (VAT ID): Is it set? Is it needed based on EU trade activity?
- Tax state (Bundesland): Is it correctly assigned?
- Poland (no tax state):
- NIP (tax ID): Is it set?
- EU VAT number (PL + NIP, VAT-UE registration): Is it set? It is needed only for EU trade.
Step 4: Analyze report filing status
For each unfiled report:
- Identify the report type (DE: USt-VA, ZM, EÜR, annual VAT, trade tax; PL: JPK_V7M or JPK_V7K, VAT-UE, PIT or CIT advance, ZUS DRA, annual PIT, CIT-8)
- Note the period and due date
- Flag if it is overdue
Step 5: Present the compliance report
Registration Status
- Tax ID: ✅/❌ with value if present
- VAT ID: ✅/❌ with value if present
- Tax state (German companies): ✅/❌ with name
Filing Status
| Report Type | Period | Status | Due Date |
|---|
| ... | ... | ... | ... |
Upcoming Deadlines
- List the next 3 filing deadlines with dates
- Note the standard deadlines:
- DE:
- Monthly USt-VA: 10th of the following month (+ Dauerfristverlängerung = 10th of the month after)
- Quarterly USt-VA: 10th of the month after the quarter ends
- Annual USt: July 31 of the following year (with advisor extension: end of February of the year after)
- PL, each moved to the next working day:
- JPK_V7M or JPK_V7K and VAT-UE: 25th of the following month
- PIT and CIT advances and ZUS DRA: 20th of the following month
- Annual PIT (and a JDG's JPK_PKPIR or JPK_EWP): April 30 of the following year
- CIT-8: end of the third month after the tax year (March 31 for a calendar year)
Action Items
Prioritized list:
- Overdue reports that must be filed immediately
- Reports due within the next 30 days
- Registration issues that need attention
- Settings that may need adjustment
Be precise with dates and report periods. Use the tax terminology of the company's country (DE or PL).