---

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

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

# 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

# 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

# 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

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

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

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

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

# 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

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

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

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

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

# 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)