Skill: satoshistackalotto/aade-api-monitor (version 0.1.0)

--- name: aade-api-monitor description: Real-time monitoring of Greek AADE tax authority systems — tracks deadlines, rate changes, and compliance updates. File-based, OpenClaw-native. version: 1.0.0 author: openclaw-greek-accounting homepage: https://github.com/satoshistackalotto/openclaw-greek-accounting tags: ["greek", "accounting", "aade", "government-monitoring", "api"] metadata: {"openclaw": {"requires": {"bins": ["jq", "curl"], "env": ["OPENCLAW_DATA_DIR", "AADE_USERNAME", "AADE_PASSWORD"]}, "optional_env": {"SLACK_WEBHOOK_URL": "Webhook URL for urgent AADE change alerts", "SMS_GATEWAY_URL": "SMS gateway for critical compliance alerts", "GOOGLE_CALENDAR_ID": "Google Calendar ID for compliance deadline sync (optional)", "OUTLOOK_CALENDAR_ID": "Outlook Calendar ID for compliance deadline sync (optional)"}, "notes": "AADE credentials required for monitoring government portal. Slack and SMS alert channels are optional — if not configured, alerts are written to local files only."}} --- # AADE API Monitor This skill provides comprehensive monitoring of AADE systems and announcements through OpenClaw's file processing capabilities, delivering real-time alerts for Greek tax compliance changes. ## Setup ```bash export OPENCLAW_DATA_DIR="/data" export AADE_USERNAME="your-aade-username" export AADE_PASSWORD="your-aade-password" which jq curl || sudo apt install jq curl ``` AADE credentials are used for authenticated read-only checks of announcements, rate changes, and system status. This skill never submits filings. ## Core Philosophy - **File-First Processing**: Monitor and process government documents, not complex APIs - **Reliable Operation**: Work offline with cached data when government sites unavailable - **OpenClaw Native**: Built specifically for OpenClaw's strengths and limitations - **Production Ready**: Error handling, logging, and recovery built-in from start - **Greek Business Focus**: Professional alerts and reporting in Greek ## OpenClaw Commands ### Core AADE Monitoring Commands ```bash # Primary monitoring operations openclaw aade monitor --enable --government-sites --cache-updates openclaw aade check-updates --since "24 hours" --urgent-only openclaw aade download-announcements --date today --all-categories openclaw aade scan-deadlines --compare-previous --alert-changes # System status monitoring openclaw aade status-check --taxis --mydata --efka --report-outages openclaw aade system-health --uptime-tracking --performance-metrics openclaw aade maintenance-schedule --upcoming --impact-assessment # Document processing openclaw aade process-documents --input /data/incoming/government/ --extract-deadlines openclaw aade classify-updates --tax-changes --deadline-changes --system-updates openclaw aade generate-alerts --priority high --recipients accounting-team ``` ### Deadline & Rate Change Monitoring ```bash # Deadline monitoring openclaw aade monitor-deadlines --vat --income-tax --enfia --social-security openclaw aade deadline-changes --since yesterday --client-impact-analysis openclaw aade calendar-update --sync-changes --notify-affected-clients # Rate and regulation changes openclaw aade monitor-rates --vat-rates --tax-brackets --social-security openclaw aade regulation-tracker --new-circulars --law-changes --implementation-dates openclaw aade impact-analysis --rate-changes --client-calculations --cost-impact ``` ### Integration & Reporting Commands ```bash # Integration with other skills openclaw aade integrate --cli-deadline-monitor --email-processor --meta-skill openclaw aade export-data --format json --destination /data/dashboard/state/ openclaw aade sync-calendar --include-holidays # Professional reporting openclaw aade report-generate --daily --weekly --monthly --client-ready-greek openclaw aade client-notifications --deadline-changes --rate-updates --professional-tone openclaw aade compliance-dashboard --current-status --upcoming-deadlines --action-items ``` ## OpenClaw File Processing Architecture ### File System Organization ```yaml AADE_File_Structure: input_monitoring: # Raw government documents arrive here - /data/incoming/government/ # All AADE/government downloads processing_workspace: # Ephemeral — cleared after pipeline - /data/processing/compliance/ # Classification and extraction workspace output_delivery: - /data/dashboard/state/current-alerts.json # Active alerts for dashboard - /data/dashboard/state/deadline-tracker.json # Updated deadline tracker - /data/reports/compliance/ # Professional compliance reports - /data/exports/compliance-deadlines.json # Calendar integration export ``` ### Document Processing Pipeline ```yaml Processing_Workflow: step_1_download: command: "openclaw aade download-batch --sources all --format pdf,html,xml" input: "Government website monitoring" output: "/data/incoming/government/{YYYYMMDD}/" step_2_extract: command: "openclaw aade extract-content --use-deepread --greek-language" input: "/data/incoming/government/" output: "/data/processing/compliance/" step_3_classify: command: "openclaw aade classify-importance --deadline-changes high --rate-changes high" input: "/data/processing/compliance/" output: "/data/processing/compliance/" step_4_compare: command: "openclaw aade detect-changes --compare-with-cache --highlight-differences" input: "/data/processing/compliance/" output: "/data/processing/compliance/" step_5_validate: command: "openclaw aade validate-data --cross-reference --accuracy-check" input: "/data/processing/compliance/" output: "/data/processing/compliance/" step_6_generate: command: "openclaw aade generate-outputs --alerts --reports --notifications" input: "/data/processing/compliance/" output: "/data/dashboard/state/ and /data/reports/compliance/" ``` ## Intelligent Document Monitoring ### AADE Website Monitoring Strategy ```yaml Government_Site_Monitoring: primary_sources: aade_main: url: "https://www.aade.gr" sections: ["announcements", "circulars", "deadlines", "rates"] frequency: "every_2_hours" taxis_updates: url: "https://www1.aade.gr/taxisnet" sections: ["system-announcements", "maintenance-schedules"] frequency: "every_4_hours" mydata_status: url: "https://mydatapi.aade.gr" sections: ["api-status", "system-updates", "technical-announcements"] frequency: "hourly" backup_sources: press_releases: url: "https://www.aade.gr/deltia-typou" fallback: true legal_database: url: "https://www.aade.gr/nomothesia" frequency: "daily" ``` ### Intelligent Change Detection ```yaml Change_Detection_Logic: deadline_changes: triggers: - "Date changes in deadline tables" - "New deadline announcements" - "Extension or acceleration notices" confidence_threshold: 0.95 validation: "Cross-reference multiple sources" rate_changes: triggers: - "VAT rate modifications" - "Tax bracket adjustments" - "Social security rate updates" effective_date_tracking: "Extract implementation dates" impact_calculation: "Estimate client effects" system_updates: triggers: - "Maintenance announcements" - "New feature releases" - "System outage notifications" criticality_assessment: "Business impact analysis" workaround_suggestions: "Alternative procedures" ``` ## OpenClaw-Native Processing Features ### Robust Error Handling ```bash # Error recovery commands openclaw aade retry-failed --batch-id {id} --fix-network-issues openclaw aade fallback-mode --use-cached-data --offline-operation openclaw aade manual-review --flagged-updates --require-human-verification # Monitoring and diagnostics openclaw aade health-check --test-all-sources --report-failures openclaw aade diagnostics --connection-test --parsing-test --alert-test openclaw aade logs --filter errors --last 48h --include-context ``` ### Caching & Offline Operation ```yaml Caching_Strategy: announcement_cache: retention: "90 days" update_frequency: "every_2_hours" fallback_behavior: "Use cached data if source unavailable" deadline_cache: retention: "1 year" critical_updates: "Force immediate refresh" validation: "Compare multiple sources for accuracy" system_status_cache: retention: "7 days" real_time_updates: "When possible" offline_mode: "Report last known status with timestamp" ``` ### Greek Language Processing ```yaml Greek_Document_Processing: text_extraction: encoding: "UTF-8, Windows-1253, ISO-8859-7" ocr_support: "Greek character recognition via deepread" keyword_detection: deadline_terms: ["προθεσμία", "λήξη", "υποβολή", "deadline"] rate_terms: ["συνπžελεσπžήπš", "ποσοσπžς", "π ςροπš", "rate", "tax"] system_terms: ["συνπžήρηση", "διακοπή", "maintenance", "outage"] date_recognition: greek_formats: ["dd/MM/yyyy", "dd-MM-yyyy", "dd Μμμ yyyy"] month_names: ["Ιανουάριοπš", "Φεβρουάριοπš", ..., "Δεκέμβριοπš"] business_day_calculation: "Exclude Greek holidays and weekends" ``` ## Professional Alert System ### Alert Generation & Classification ```yaml Alert_System: critical_alerts: deadline_changes: trigger: "Any tax deadline moved forward" delivery: "Immediate notification to assigned accountant" template: "ΡΡΙΣΙΜθ: Προθεσμία {tax_type} μεπžακινήθηκε σπžιπš {new_date}" system_outages: trigger: "TAXIS or myDATA unavailable >30 minutes" delivery: "Immediate notification to accounting teams" template: "ΔΙΑΡθΠΗ: Σύσπžημα {system_name} μη διαθέσιμο απς {outage_start}" important_alerts: rate_changes: trigger: "VAT or tax rate modifications" delivery: "Email + dashboard update" template: "Αλλαγή συνπžελεσπžή: {rate_type} απς {old_rate} σε {new_rate}" new_regulations: trigger: "New tax circulars or law changes" delivery: "Daily digest email" template: "Νέα εγκύκλιοπš: {circular_number} - {summary}" routine_alerts: system_maintenance: trigger: "Scheduled maintenance announcements" delivery: "Weekly summary" template: "Προγραμμαπžισμένη συνπžήρηση: {system} πžην {date} {time}" ``` ### Greek Professional Communication ```yaml Professional_Templates: client_deadline_alert: subject: "Σημανπžική ενημέρπ°ση: Αλλαγή προθεσμίαπš {tax_type}" body: | Αξιςπžιμοι πελάπžεπš, Σαπš ενημερϽνουμε ςπžι η ΑΑΔΕ ανακοίνπ°σε αλλαγή σπžην προθεσμία υποβολήπš {tax_description}. Νέα προθεσμία: {new_deadline} Προηγούμενη προθεσμία: {old_deadline} Παρακαλούμε επικοινπ°νήσπžε μαζί μαπš για οποιαδήποπžε διευκρίνιση. Με εκπžίμηση, {accounting_firm_name} rate_change_notification: subject: "Ενημέρπ°ση: Αλλαγή π ορολογικού συνπžελεσπžή" body: | Αγαπηπžοί συνεργάπžεπš, Απς {effective_date} ισπ¡ύει νέοπš συνπžελεσπžήπš {tax_type}: - Νέοπš συνπžελεσπžήπš: {new_rate}% - Προηγούμενοπš: {old_rate}% Η αλλαγή επηρεάζει: {affected_transactions} Το λογισπžικς μαπš γραπ είο θα ενημερϽσει ςλουπš πžουπš υπολογισμούπš. {firm_contact_info} ``` ## Integration Workflows ### Meta-Skill Integration ```bash # Integration with OpenClaw Greek Accounting Meta-Skill openclaw aade register-with-meta --enable-orchestration openclaw aade meta-commands --list-available --business-focused # Meta-skill can now call: # openclaw greek government-check (calls aade-api-monitor internally) # openclaw greek emergency-compliance (uses aade alerts) # openclaw greek status-dashboard (includes aade system status) ``` ### Other Skill Integration ```yaml Skill_Integration_Points: cli_deadline_monitor: data_exchange: "Share deadline change data" coordination: "Avoid duplicate monitoring" backup_relationship: "CLI monitor provides fallback data" greek_email_processor: alert_delivery: "Use email processor for client notifications" template_sharing: "Share Greek language templates" document_processing: "Process AADE emails received by clients" greek_compliance_aade: rate_updates: "Notify compliance skill of rate changes" calculation_updates: "Trigger recalculation when rates change" submission_timing: "Coordinate deadline changes with submissions" ``` ## Production Monitoring & Maintenance ### Automated Health Monitoring ```bash # Health check commands for production deployment openclaw aade health-check --comprehensive --test-all-endpoints openclaw aade performance-monitor --response-times --error-rates --uptime openclaw aade data-validation --accuracy-check --cross-reference --anomaly-detection # Maintenance and optimization openclaw aade cache-optimize --cleanup-old --defragment --performance-tune openclaw aade update-patterns --learn-new-formats --improve-accuracy openclaw aade backup-data --critical-cache --configuration --logs ``` ### Logging & Audit Trail ```yaml Production_Logging: access_logs: file: "/logs/aade-monitor/access.log" retention: "6 months" includes: ["URLs accessed", "Response codes", "Response times"] change_detection_logs: file: "/logs/aade-monitor/changes.log" retention: "2 years" includes: ["Detected changes", "Confidence scores", "Validation results"] alert_logs: file: "/logs/aade-monitor/alerts.log" retention: "1 year" includes: ["Alert generation", "Delivery methods", "User responses"] error_logs: file: "/logs/aade-monitor/errors.log" retention: "1 year" includes: ["Processing errors", "Network failures", "Recovery actions"] ``` ## Advanced Features ### Machine Learning Enhancement ```yaml ML_Capabilities: document_classification: training_data: "Historical AADE announcements with manual classifications" accuracy_target: ">95% for critical document identification" continuous_learning: "Update model based on manual corrections" change_impact_prediction: analysis: "Predict client impact based on historical patterns" risk_assessment: "Identify high-risk clients for proactive communication" resource_planning: "Estimate workload from detected changes" anomaly_detection: baseline_patterns: "Learn normal AADE announcement patterns" unusual_activity: "Flag potential system issues or major changes" false_positive_reduction: "Reduce unnecessary alerts through pattern learning" ``` ### Compliance Dashboard Integration ```yaml Dashboard_Features: real_time_status: aade_systems: "Live status of TAXIS, myDATA, EFKA systems" recent_changes: "Timeline of recent deadline and rate changes" alert_summary: "Critical, important, and routine alerts overview" client_impact_view: affected_clients: "Which clients affected by recent changes" action_required: "Immediate actions needed per client" communication_status: "Which clients have been notified" performance_metrics: monitoring_uptime: "AADE monitor system availability" detection_accuracy: "Change detection success rate" alert_effectiveness: "User response to generated alerts" ``` ## Usage Examples ### Daily Operations ```bash # Morning AADE check (part of daily routine) $ openclaw aade morning-check --since yesterday 📊 AADE Morning Summary - February 18, 2026: ðŸÂ€ºï¸ System Status: ✅ TAXIS Online (98.2% uptime last 24h) ✅ myDATA Online (99.1% uptime last 24h) ✅ EFKA Portal Online (97.5% uptime last 24h) 📢 New Announcements (2): 📀¹ Circular POL.1157/2026 - VAT exemption clarification ⚠ï¸ System maintenance scheduled: February 20, 02:00-06:00 EET 🔀ž Changes Detected: None 📅 Upcoming Deadlines: 3 VAT returns due in 7 days Next check in 2 hours. Manual refresh: openclaw aade check-updates ``` ### Change Detection Example ```bash $ openclaw aade detect-changes --urgent --notify-immediately 🚨 CRITICAL CHANGE DETECTED: 📅 Deadline Change Alert: Tax Type: Monthly VAT Return (March 2026) Old Deadline: April 25, 2026 New Deadline: April 20, 2026 Change: 5 days earlier Impact: 47 clients affected 📀¹ Source Document: AADE Announcement: Πθ΀º.1158/2026 Published: 2026-02-18 14:30 EET Confidence: 98.5% ✅ Actions Taken: - Updated compliance deadline tracker - Generated client notifications (47 emails prepared) - Integrated with meta-skill workflow - Logged change in audit trail 📧 Client notifications ready for review: openclaw aade review-notifications --batch-id 2026021801 ``` ### Professional Client Communication ```bash $ openclaw aade generate-client-alert --deadline-change --professional-tone 📧 Generated Greek Client Communication: Subject: ΕΠΕΙΓθΝ: Αλλαγή προθεσμίαπš δήλπ°σηπš ΦΠΑ Μαρπžίου 2026 Αξιςπžιμοι πελάπžεπš, Σαπš ενημερϽνουμε με απ ορμή πžην ανακοίνπ°ση πžηπš ΑΑΔΕ (Πθ΀º.1158/2026) ςπžι η προθεσμία υποβολήπš πžηπš μηνιαίαπš δήλπ°σηπš ΦΠΑ για πžον Μάρπžιο 2026 μεπžακινείπžαι απς πžιπš 25 Απριλίου σπžιπš 20 Απριλίου 2026. Η αλλαγή επηρεάζει ςλεπš πžιπš επιπ¡ειρήσειπš με υποπ¡ρέπ°ση υποβολήπš μηνιαίαπš δήλπ°σηπš ΦΠΑ. Το λογισπžικς μαπš γραπ είο έπ¡ει ήδη ενημερϽσει πžο σύσπžημα παρακολούθησηπš προθεσμιϽν και θα π ρονπžίσουμε για πžην έγκαιρη προεπžοιμασία και υποβολή. Για οποιαδήποπžε διευκρίνιση, παρακαλούμε επικοινπ°νήσπžε μαζί μαπš. Με εκπžίμηση, [Accounting Firm Name] 📧 Ready for sending to 47 affected clients ``` ## Success Metrics A successful AADE API Monitor should achieve: - ✅ 99%+ uptime monitoring of critical AADE systems - ✅ <5 minute detection time for critical deadline changes - ✅ 95%+ accuracy in document classification and change detection - ✅ Zero false positives for critical alerts - ✅ Complete integration with meta-skill orchestration - ✅ Professional Greek communication standards - ✅ Comprehensive audit trail for compliance purposes - ✅ Robust offline operation with cached data fallback Remember: This skill is built OpenClaw-first, using file processing and practical automation rather than complex API integrations, making it reliable and maintainable for production Greek accounting environments.


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (MEDIUM)