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.
# 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.
# 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
# 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
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_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
Major_Municipality_Endpoints:
athens_municipality:
url: "https://www.cityofathens.gr/epixeiriseis"
business_licenses: "https://www.cityofathens.gr/adeiodotisi"
permit_tracker: "https://www.cityofathens.gr/adeia-kataskevi"
thessaloniki_municipality:
url: "https://www.thessaloniki.gr/epixeiriseis"
business_services: "https://www.thessaloniki.gr/ypiresies"
piraeus_municipality:
url: "https://www.pireasnet.gr/epixeiriseis"
patras_municipality:
url: "https://www.patras.gr/epixeirein"
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
Critical_Alerts:
deadline_approaching:
trigger: "7 days before deadline"
channels: ["email", "slack", "sms"] # Channels with unconfigured credentials are silently skipped
frequency: "daily"
deadline_changed:
trigger: "immediate on detection"
channels: ["email", "slack", "sms"] # Channels with unconfigured credentials are silently skipped
frequency: "immediate"
system_outage:
trigger: "AADE/EFKA system unavailable >30min"
channels: ["email", "slack", "sms"] # Channels with unconfigured credentials are silently skipped
frequency: "immediate"
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
Email_Configuration:
smtp_server: "configurable"
templates:
deadline_alert: "Greek tax deadline approaching: {deadline_type} due {due_date}"
system_outage: "AADE/EFKA system outage detected - {system} unavailable"
rate_change: "Greek tax rate change: {rate_type} changing from {old_rate} to {new_rate}"
Slack_Integration:
webhook_url: "configurable"
channels:
critical: "#accounting-alerts"
warnings: "#tax-updates"
info: "#compliance-digest"
SMS_Configuration:
provider: "configurable (Twilio, etc.)"
numbers: "configurable emergency contacts"
critical_only: true
## Deadline Monitoring Workflows
### Daily Monitoring Routine
#!/bin/bash
openclaw status all --format json > /tmp/system_status.json
openclaw deadline check all --days 30 --format json > /tmp/upcoming_deadlines.json
openclaw deadline changes --since yesterday --format json > /tmp/deadline_changes.json
openclaw rates check changes --since yesterday > /tmp/rate_changes.json
openclaw summary generate daily --include-status --include-deadlines --include-changes
### Weekly Deep Monitoring
#!/bin/bash
openclaw deadline refresh --full-update
openclaw deadline analyze --weeks 4 --detect-patterns
openclaw rates analyze --months 3 --predict-changes
openclaw status report --days 7 --include-uptime
openclaw report generate weekly --email-recipients --include-recommendations
### Municipal Compliance Workflow
#!/bin/bash
openclaw taxpayer locate --address "$BUSINESS_ADDRESS" --output municipality
openclaw deadline municipal --city "$MUNICIPALITY" --days 30
openclaw licenses check --municipality "$MUNICIPALITY" --business-type "$BUSINESS_TYPE"
if [ "$HAS_CONSTRUCTION_PERMITS" == "true" ]; then
openclaw permits check construction --municipality "$MUNICIPALITY"
fi
openclaw municipal rates monitor --city "$MUNICIPALITY" --alert-on-change
openclaw municipal summary --taxpayer "$VAT_NUMBER" --include-deadlines --include-rates
### Municipality Detection & Configuration
Taxpayer_Location_Detection:
methods:
vat_registration: "Use VAT number to determine registered municipality"
business_address: "Parse business address to identify municipality"
property_location: "For property taxes, use property municipality"
manual_configuration: "Allow manual municipality specification"
Municipality_Database:
major_municipalities:
municipality_specific_rates:
TAP_rates:
athens: 0.025
thessaloniki: 0.030
piraeus: 0.025
default: 0.025
waste_lighting_fees:
calculated_by: "square_meter_municipal_rate"
varies_by: "municipal_council_decision"
frequency: "annual_billing_via_electricity"
#!/bin/bash
openclaw alerts emergency --message "Critical deadline change detected" \
--channels all --priority high
openclaw deadline emergency-report --deadline "$1" --old-date "$2" --new-date "$3"
openclaw calendar update-emergency --deadline "$1" --new-date "$3"
openclaw log emergency "Deadline change: $1 moved from $2 to $3"
## Greek-Specific Implementation Details
### Greek Holiday Deadline Integration
Greek_National_Holidays:
fixed_holidays:
variable_holidays:
Business_Day_Calculations:
exclude_weekends: true
exclude_holidays: true
custom_business_hours: "08:00-15:00 EET"
deadline_extensions:
weekend_extension: "Next business day"
holiday_extension: "Next business day"
### Greek Language Support
Language_Configuration:
primary_language: "Greek (el-GR)"
fallback_language: "English (en-US)"
Date_Formats:
greek_format: "dd/MM/yyyy"
iso_format: "yyyy-MM-dd"
display_preference: "greek_format"
Greek_Month_Names:
### Timezone and Regional Settings
Timezone_Configuration:
primary_timezone: "Europe/Athens"
dst_handling: "automatic"
business_hours: "08:00-15:00 EET/EEST"
Regional_Settings:
currency: "EUR"
number_format: "1.234,56"
percentage_format: "12,34%"
Government_Office_Hours:
aade_offices: "08:00-14:30 Monday-Friday"
efka_offices: "08:00-14:00 Monday-Friday"
system_maintenance_window: "02:00-06:00 EET typically"
## Error Handling & Reliability
### Robust Error Management
openclaw deadline check aade --retry-attempts 3 --backoff-strategy exponential
openclaw deadline check efka --fallback-method scraping --timeout 30s
openclaw status network --test-connectivity --log-failures
openclaw deadline cache --use-cached-if-offline --max-age 24h
openclaw deadline validate --check-consistency --flag-anomalies
openclaw rates validate --historical-comparison --detect-errors
### Monitoring and Logging
Log_Configuration:
log_level: "INFO"
log_file: "/var/log/openclaw/deadline-monitor.log"
log_rotation: "daily"
retention_days: 90
Monitoring_Metrics:
api_response_times: "Track API performance"
success_rates: "Monitor API reliability"
alert_delivery: "Track notification success"
deadline_accuracy: "Validate deadline information"
Health_Checks:
self_monitoring: "Internal system health checks"
external_validation: "Cross-check with official sources"
data_consistency: "Validate data integrity"
alert_system_test: "Regular notification testing"
## Performance Optimization
### Caching Strategy
Cache_Configuration:
deadline_cache_ttl: "4 hours"
rate_cache_ttl: "24 hours"
status_cache_ttl: "5 minutes"
Cache_Invalidation:
force_refresh_on_change: true
scheduled_refresh: "Every 6 hours"
emergency_cache_clear: "On critical alerts"
Performance_Tuning:
concurrent_requests: 5
request_timeout: 30
retry_delays: [1, 2, 5, 10]
rate_limiting: "Respect API limits"
## Integration Examples
### OpenClaw Integration
openclaw skills add cli-deadline-monitor
openclaw schedule add daily "09:00" "deadline check all --alert-if-changes"
openclaw schedule add weekly "monday 08:00" "deadline report generate weekly"
openclaw deadline check vat --integrate-with accounting-workflows
openclaw deadline check efka --integrate-with greek-compliance-aade
### External System Integration
openclaw deadline sync calendar --provider google --calendar-id "accounting@company.com"
openclaw deadline export --format ical --output /data/reports/deadlines.ics
openclaw deadline sync calendar --provider google --calendar-id $GOOGLE_CALENDAR_ID # Optional: sync to Google Calendar
openclaw deadline sync calendar --provider outlook --calendar-id $OUTLOOK_CALENDAR_ID # Optional: sync to Outlook
openclaw deadline export --format csv --period 2026-Q1
openclaw deadline export --format json --period 2026-02
openclaw deadline export --format ical --upcoming 30d
openclaw alerts setup slack --webhook-url $SLACK_WEBHOOK_URL # Optional: configure if Slack alerts desired
openclaw alerts setup teams --webhook-url $TEAMS_WEBHOOK
openclaw alerts setup email --smtp-config /etc/openclaw/smtp.conf
## Usage Examples
### Example 1: Daily Deadline Check
$ openclaw deadline check all
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
$ openclaw deadline changes --since yesterday
CHANGES DETECTED:
🚨 CRITICAL: Monthly VAT deadline moved from March 25 to March 20, 2026
📧 Notifications sent:
📅 Calendar updates:
### Example 4: Municipal License Renewal Check
$ openclaw licenses check renewals --municipality athens --business-type restaurant
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
$ openclaw deadline municipal all --business-vat EL123456789
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
$ openclaw status all --detailed
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
npx openclaw skills add cli-deadline-monitor
openclaw config set timezone "Europe/Athens"
openclaw config set country "Greece"
openclaw config set language "el-GR"
openclaw config set aade-api-key "your-api-key" # If available
openclaw config set efka-api-key "your-api-key" # If available
openclaw deadline test-connection --aade --efka --municipal
### Automated Scheduling in OpenClaw
openclaw schedule add "0 9 *" "openclaw deadline check all --alert-changes"
openclaw schedule add "0 /4 " "openclaw status aade --log-uptime"
openclaw schedule add "0 8 1" "openclaw deadline report weekly --email-summary"
openclaw monitor add "deadline-changes" --trigger immediate --channels all
openclaw monitor add "system-outages" --trigger 30min --priority high
### File-Based Processing (OpenClaw Preferred)
File_Processing_Approach:
# Instead of direct API calls, use file monitoring
input_monitoring:
processing_workflow:
step_1: "openclaw deadline scan-files --government-sources"
step_2: "openclaw deadline extract-changes --compare-previous"
step_3: "openclaw deadline alert-users --if-changes-detected"
output_generation:
### Offline Operation & Caching
openclaw deadline cache-update --source aade-backup --municipal-sites
openclaw deadline cache-validate --check-freshness --alert-stale
openclaw deadline offline-mode --enable --use-cached-data
openclaw deadline emergency-data --load-backup --continue-monitoring
### 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
Remember: This skill provides the foundation for proactive compliance management, ensuring Greek businesses never miss critical tax deadlines or regulatory changes.
共 1 个版本