CLI Deadline Monitor

This skill provides comprehensive command-line tools for monitoring Greek government websites and APIs to track tax deadlines, regulatory changes, and compliance requirements in real-time.

Setup

# 1. Set data directory
export OPENCLAW_DATA_DIR="/data"

# 2. Ensure jq is installed
which jq || sudo apt install jq

# 3. Ensure client data exists
ls $OPENCLAW_DATA_DIR/clients/*/compliance/obligations.json

No external credentials required. This skill reads deadline data from local files only.

Core Philosophy

• Real-time Monitoring: Continuous checking of AADE and EFKA websites for deadline changes
• API-First Approach: Use official APIs where available, intelligent scraping where necessary
• Proactive Alerts: Early warning system for deadline changes and new requirements
• CLI Efficiency: Fast, scriptable commands for integration with automated workflows
• Reliability: Robust error handling and fallback mechanisms for critical compliance monitoring

Key Capabilities

1. AADE Deadline Monitoring

• Tax Return Deadlines: Monitor individual and corporate tax return due dates
• VAT Return Tracking: Monthly and quarterly VAT submission deadlines
• myDATA Requirements: Real-time invoice submission deadline monitoring
• System Status: TAXIS and myDATA system availability checking
• Rate Change Alerts: VAT rate changes and effective dates
• Form Updates: New tax forms and requirement changes

2. EFKA Social Security Monitoring

• Contribution Deadlines: Monthly social security payment due dates
• Rate Updates: Changes to social security contribution rates
• Employer Obligations: New employer reporting requirements
• System Maintenance: EFKA portal downtime and maintenance schedules
• Legislative Changes: New social security laws and regulations

3. Municipal Tax & License Monitoring

• Property Tax (TAP): Municipal property tax monitoring (0.025%-0.035% of property value)
• Business License Renewals: Track municipal business license expiration and renewal requirements
• Municipal Permits: Construction, signage, zoning, and operational permits by municipality
• Waste Collection & Lighting Fees: Municipality-specific rates and payment schedules
• Municipal Transfer Tax Surcharge: 0.09% municipal surcharge on property transfers
• Local Business Taxes: Municipality-specific business activity taxes and fees
• Building Permits: Municipal construction permit deadlines and requirements

3. CLI Command Interface

• Quick Status Commands: Fast deadline checking and status overview
• Automated Scheduling: Cron-compatible commands for regular monitoring
• Alert Configuration: Customizable notification thresholds and methods
• Batch Processing: Multiple deadline checks in single command execution
• Export Options: JSON, CSV, and structured output formats

4. Integration & Automation

• Email Notifications: Automated email alerts for deadline changes
• Notification System: Alert notifications via configured channels
• Deadline Tracking: Deadline alerts and tracking via CLI
• API Webhooks: REST API endpoints for external system integration
• Log Management: Comprehensive logging of all monitoring activities

Implementation Guidelines

Command Structure Design

#### Core CLI Commands

# Primary monitoring commands
openclaw deadline check aade          # Check all AADE deadlines
openclaw deadline check efka          # Check all EFKA deadlines  
openclaw deadline check all           # Check all government deadlines

# Specific deadline types
openclaw deadline vat monthly         # Monthly VAT return deadlines
openclaw deadline vat quarterly       # Quarterly VAT deadlines
openclaw deadline tax individual      # Individual tax return deadlines
openclaw deadline tax corporate       # Corporate tax deadlines
openclaw deadline social monthly      # Monthly social security deadlines

# Municipal monitoring commands
openclaw deadline municipal --city athens    # Athens municipality deadlines
openclaw deadline municipal --city thessaloniki # Thessaloniki municipality deadlines
openclaw deadline municipal all       # All municipal deadlines by taxpayer location
openclaw licenses check renewals      # Business license renewal deadlines
openclaw permits check construction   # Construction permit deadlines
openclaw municipal rates update       # Municipal tax rate changes

# System status checks
openclaw status aade                  # AADE system availability
openclaw status efka                  # EFKA system status
openclaw status mydata               # myDATA platform status
openclaw status taxis               # TAXIS system status

# Alert management
openclaw alerts setup               # Configure alert preferences
openclaw alerts test                # Test notification systems
openclaw alerts history            # View alert history
openclaw alerts disable            # Temporarily disable alerts

#### Advanced Monitoring Commands

# Historical tracking
openclaw deadline history aade      # Show AADE deadline change history
openclaw deadline compare 2025 2026 # Compare deadlines between years
openclaw deadline export json       # Export deadlines to JSON
openclaw deadline export calendar   # Export to calendar format

# Rate monitoring
openclaw rates vat current          # Current VAT rates
openclaw rates vat changes          # VAT rate change history
openclaw rates social current       # Current social security rates
openclaw rates social changes       # Social security rate changes

# Form and requirement monitoring  
openclaw forms check updates        # Check for new tax forms
openclaw forms download new         # Download updated forms
openclaw requirements changes       # Check requirement changes

API Integration Architecture

#### AADE API Integration

AADE_Endpoints:
  taxis_status:
    url: "https://www1.aade.gr/taxisnet/api/status"
    method: "GET"
    auth_required: false
    rate_limit: "100/hour"
    
  mydata_status:
    url: "https://mydatapi.aade.gr/api/status"
    method: "GET" 
    auth_required: false
    rate_limit: "100/hour"
    
  deadline_tracker:
    url: "https://www.aade.gr/api/deadlines/current"
    method: "GET"
    auth_required: false
    rate_limit: "50/hour"
    
  vat_rates:
    url: "https://www.aade.gr/api/rates/vat/current"
    method: "GET"
    auth_required: false
    rate_limit: "20/hour"

AADE_Scraping_Targets:
  deadline_announcements:
    url: "https://www.aade.gr/epiheiriseis/forologikes-ypohreosieis"
    selector: ".announcement-deadline"
    frequency: "every_4_hours"
    
  rate_changes:
    url: "https://www.aade.gr/epiheiriseis/fpa"
    selector: ".rate-change-notice"
    frequency: "daily"
    
  system_maintenance:
    url: "https://www.aade.gr/systima/sytirika-minymata"
    selector: ".maintenance-notice"
    frequency: "hourly"

#### EFKA API Integration

EFKA_Endpoints:
  portal_status:
    url: "https://www.efka.gov.gr/api/status"
    method: "GET"
    auth_required: false
    rate_limit: "100/hour"
    
  contribution_rates:
    url: "https://www.efka.gov.gr/api/rates/current"
    method: "GET"
    auth_required: false
    rate_limit: "20/hour"
    
  deadline_tracker:
    url: "https://www.efka.gov.gr/api/deadlines/monthly"
    method: "GET"
    auth_required: false
    rate_limit: "50/hour"

EFKA_Scraping_Targets:
  contribution_deadlines:
    url: "https://www.efka.gov.gr/el/ypodomes/efka/asfalikes-eisfores"
    selector: ".deadline-table"
    frequency: "every_6_hours"
    
  rate_announcements:
    url: "https://www.efka.gov.gr/el/anakoinoseis"
    selector: ".rate-announcement"
    frequency: "daily"
    
  legislative_changes:
    url: "https://www.efka.gov.gr/el/nomothesia"
    selector: ".law-change"
    frequency: "daily"

#### Municipal API Integration

Municipal_Tax_Monitoring: tap_rates: athens: "0.025% base rate" thessaloniki: "0.030% base rate" other_major: "0.025%-0.035% range" business_license_cycles: standard_renewal: "Annual - varies by municipality" construction_permits: "Project-based with municipal timelines" operational_permits: "Annual or biennial depending on activity" municipal_fee_structures: waste_collection: "Per square meter - municipal council rates" street_lighting: "Per property area - council determined" signage_permits: "Annual fees varying by municipality" Municipal_Scraping_Targets: business_license_announcements: frequency: "weekly" target_selectors: ".business-announcement, .license-renewal" construction_permit_changes: frequency: "bi-weekly" target_selectors: ".permit-update, .construction-deadline" municipal_tax_rate_changes: frequency: "monthly" target_selectors: ".tax-rate-change, .municipal-fee-update"

### Alert System Configuration

#### Alert Types and Triggers

Warning_Alerts: rate_change_announced: trigger: "VAT or social security rate changes" channels: ["email", "slack", "sms"] # Channels with unconfigured credentials are silently skipped frequency: "immediate" new_requirements: trigger: "New tax forms or compliance requirements" channels: ["email"] frequency: "daily_digest" maintenance_scheduled: trigger: "Planned system maintenance detected" channels: ["email", "slack", "sms"] # Channels with unconfigured credentials are silently skipped frequency: "24_hours_before"

Info_Alerts: monthly_summary: trigger: "1st of each month" channels: ["email"] content: "Monthly deadline tracker and compliance summary" quarterly_review: trigger: "Start of each quarter" channels: ["email", "slack", "sms"] # Channels with unconfigured credentials are silently skipped content: "Quarterly compliance requirements and deadlines"

#### Notification Channel Configuration

## Deadline Monitoring Workflows

### Daily Monitoring Routine

Daily deadline monitoring script

Check all critical systems

Check upcoming deadlines (next 30 days)

Check for any deadline changes since yesterday

Check for rate updates

Generate daily summary

### Weekly Deep Monitoring

Weekly comprehensive monitoring script

Full deadline tracker refresh

Historical deadline analysis

Rate change trend analysis

System reliability report

Generate weekly compliance report

### Municipal Compliance Workflow

Municipal tax and license monitoring

Identify taxpayer municipality based on business address

Check municipality-specific deadlines

Monitor business license renewals

Check construction permit requirements if applicable

Monitor municipal tax rate changes

Generate municipal compliance summary

### Municipality Detection & Configuration

• code: "ATH", name: "Athens", tax_office: "A' ΑΜΗΝΩΝ"
• code: "THE", name: "Thessaloniki", tax_office: "A' ΜΕΣΣΑ΀ºθΝΙΡΗΣ"
• code: "PIR", name: "Piraeus", tax_office: "ΠΕΙΡΑΙΑ"
• code: "PAT", name: "Patras", tax_office: "ΠΑΤΡΩΝ"
• code: "HER", name: "Heraklion", tax_office: "ΗΡΑΡ΀ºΕΙθΥ"

Emergency response for critical deadline changes

Immediate notification to all channels

Generate emergency report

Update calendar integrations immediately

Log emergency response

## Greek-Specific Implementation Details

### Greek Holiday Deadline Integration

• "01-01": "New Year's Day"
• "01-06": "Epiphany"
• "03-25": "Independence Day"
• "05-01": "Labour Day"
• "08-15": "Assumption of Mary"
• "10-28": "Ohi Day"
• "12-25": "Christmas Day"
• "12-26": "Boxing Day"

• "Clean Monday": "48 days before Easter"
• "Good Friday": "Friday before Easter"
• "Easter Monday": "Day after Easter"
• "Holy Spirit Monday": "50 days after Easter"

### Greek Language Support

• "Ιανουάριοπš" # January
• "Φεβρουάριοπš" # February
• "Μάρπžιοπš" # March
• "Απρίλιοπš" # April
• "Μάιοπš" # May
• "Ιούνιοπš" # June
• "Ιούλιοπš" # July
• "Αύγουσπžοπš" # August
• "Σεππžέμβριοπš" # September
• "θκπžϽβριοπš" # October
• "Νοέμβριοπš" # November
• "Δεκέμβριοπš" # December

### Timezone and Regional Settings

## Error Handling & Reliability

### Robust Error Management

API failure handling

Network connectivity issues

Data validation and consistency

### Monitoring and Logging

## Performance Optimization

### Caching Strategy

## Integration Examples

### OpenClaw Integration

Add to OpenClaw daily routine

Integration with other accounting skills

### External System Integration

Deadline export

Accounting software integration

Business communication platforms

## Usage Examples

### Example 1: Daily Deadline Check

AADE Deadlines (Next 30 Days): ✓ Monthly VAT Return (February 2026) - Due: March 20, 2026 (31 days) ⚠ Individual Tax Returns (2025) - Due: June 30, 2026 (133 days) ✓ Quarterly VAT Return (Q1 2026) - Due: April 25, 2026 (67 days)

EFKA Deadlines (Next 30 Days): ⚠ Monthly Social Security Contributions (February 2026) - Due: March 15, 2026 (26 days) ✓ Quarterly Social Security Report (Q1 2026) - Due: April 30, 2026 (72 days)

System Status: ✓ AADE TAXIS: Online ✓ AADE myDATA: Online ✓ EFKA Portal: Online

Alerts: 1 deadline approaching in <30 days

### Example 2: Deadline Change Detection

CHANGES DETECTED: 🚨 CRITICAL: Monthly VAT deadline moved from March 25 to March 20, 2026

• Reason: Updated AADE announcement
• Impact: 5 days earlier than expected
• Action: Notifications sent to all channels

• Email: [email protected] ✓
• Slack: #accounting-alerts (if SLACK_WEBHOOK_URL configured) ✓
• SMS: +30-xxx-xxx-xxx ✓

• Google Calendar: Updated ✓
• Outlook Calendar: Updated ✓

### Example 4: Municipal License Renewal Check

MUNICIPAL LICENSE STATUS - ATHENS: 📀¹ Business License Renewals Due: ⚠ General Business License - Due: April 15, 2026 (57 days) ✓ Food Service Permit - Renewed until December 31, 2026 (318 days) 🚨 EFET Health Certificate - Due: March 1, 2026 (12 days) - URGENT!

ðŸÂ—️ Construction/Operational Permits: ✓ Signage Permit - Valid until August 30, 2026 (194 days) ⚠ Fire Department Certificate - Due: May 20, 2026 (92 days)

💰 Municipal Fees Due: ✓ TAP (Municipal Property Tax) - Paid via electricity bill (0.025%) ⚠ Waste Collection Fee - Due: March 20, 2026 (31 days) ✓ Street Lighting Fee - Automatically charged (current)

📞 Municipality Contact: Athens Business Services - 210-527-7000 📧 Automated alerts will be sent 30, 15, and 7 days before each deadline

### Example 5: Multi-Municipality Business Monitoring

MULTI-LOCATION BUSINESS MONITORING: ðŸÂ¢ Primary Business (Athens): ├─ VAT Registration: Α' ΑΜΗΝΩΝ Tax Office ├─ Municipal License: Due April 15, 2026 ├─ TAP Rate: 0.025% of property value └─ Special Requirements: Athens Municipality signage regulations

ðŸÂª Branch Office (Thessaloniki): ├─ Local Business Permit: Due June 30, 2026 ├─ TAP Rate: 0.030% of property value ├─ Municipal Fees: Higher waste collection rates └─ Special Requirements: Thessaloniki commercial zone restrictions

ðŸÂ­ Warehouse (Patras): ├─ Industrial Permit: Due September 15, 2026 ├─ TAP Rate: 0.025% of property value ├─ Environmental Permits: Required for industrial activity └─ Special Requirements: Port authority coordination needed

Summary: 3 locations monitored across 3 municipalities Next Action: Athens EFET certificate renewal in 12 days

AADE Systems: ├─ TAXIS Portal: ✓ Online (Response: 245ms) ├─ myDATA API: ✓ Online (Response: 180ms) ├─ VIES Validation: ✓ Online (Response: 320ms) └─ Public Website: ✓ Online (Response: 410ms)

EFKA Systems: ├─ Main Portal: ✓ Online (Response: 380ms) ├─ Contribution Portal: ⚠ Slow (Response: 2.1s) ├─ Employer Services: ✓ Online (Response: 290ms) └─ Public Website: ✓ Online (Response: 350ms)

Overall Health: ✓ All Critical Systems Operational Last Updated: 2026-02-17 09:30:15 EET

## OpenClaw Integration & Deployment

### OpenClaw Installation & Setup

Install CLI deadline monitor skill

Configure for Greek timezone and holidays

Set up monitoring credentials (if available)

Test installation

### Automated Scheduling in OpenClaw

Set up automated monitoring schedules

Emergency monitoring for critical changes

### File-Based Processing (OpenClaw Preferred)

• /data/incoming/government/*.html # Government HTML announcements
• /data/incoming/government/*.pdf # AADE/EFKA deadline change PDFs
• /data/incoming/government/*.xml # Rate announcement XML feeds

• /data/reports/daily/{YYYY-MM-DD}_deadline-summary.json
• /data/dashboard/state/current-alerts.json
• /data/dashboard/state/deadline-tracker.json
• /data/exports/compliance-deadlines.json

### Offline Operation & Caching

Cache management for reliable operation

Offline mode when APIs unavailable

Data Protection

• No Authentication Storage: Never store government portal credentials
• Secure Communications: All API calls over HTTPS/TLS
• Data Minimization: Only collect necessary deadline and status information
• Audit Logging: Complete log of all monitoring activities
• Access Controls: Restrict command execution to authorized users

Compliance & Privacy

• GDPR Compliance: No personal data collection beyond system operation
• Data Retention: Automatic cleanup of old logs and cached data
• Transparency: Clear logging of all external system interactions
• Reliability: Redundant checking methods for critical deadlines

Success Metrics

A successful CLI deadline monitoring system should achieve:

• ✅ 99.9% uptime for deadline monitoring
• ✅ <5 minute detection time for deadline changes
• ✅ 100% accuracy in deadline information
• ✅ <30 second response time for CLI commands
• ✅ Zero missed critical deadline alerts
• ✅ Complete audit trail for all monitoring activities
• ✅ Integration with all major Greek government systems