EFKA API Integration
This skill provides comprehensive integration with the Greek Social Security organization (EFKA) through OpenClaw's file processing capabilities, enabling automated employee record management, contribution calculations, and compliance monitoring for Greek businesses.
Setup
CODEBLOCK0
EFKA credentials are required only for submitting social security declarations. Payroll calculations and contribution processing work offline. All government submissions require human approval (four-eyes workflow).
Core Philosophy
- - OpenClaw Artifact Ready: Designed specifically for upload and deployment to OpenClaw instances
- File-Based Processing: Robust file system approach suitable for production deployment
- Greek Employment Law Compliance: Complete adherence to Greek social security regulations
- Payroll Integration: Seamless connection with existing Greek payroll systems
- Production Scalability: Built to handle multiple clients and high transaction volumes
OpenClaw Commands
Core EFKA Operations
CODEBLOCK1
Advanced Integration Commands
CODEBLOCK2
File Processing & Monitoring
CODEBLOCK3
OpenClaw File Processing Architecture
EFKA File System Organization
CODEBLOCK4
EFKA Processing Pipeline
CODEBLOCK5
Greek Social Security Integration
EFKA Employee Categories & Contributions (2026)
CODEBLOCK6
Contribution Calculation Engine
CODEBLOCK7
Employee Lifecycle Management
New Employee Onboarding
CODEBLOCK8
Employee Data Updates
CODEBLOCK9
Employee Termination Processing
CODEBLOCK10
Advanced Compliance Features
Deadline Management & Monitoring
CODEBLOCK11
Cross-System Integration
CODEBLOCK12
Production Deployment Features
Scalable Processing Architecture
CODEBLOCK13
Data Security & Compliance
CODEBLOCK14
Usage Examples for Greek Companies
Monthly Payroll Processing
CODEBLOCK15
New Employee Registration
CODEBLOCK16
Integration with Meta-Skill
CODEBLOCK17
Compliance Monitoring Dashboard
CODEBLOCK18
Success Metrics for EFKA Integration
A successful EFKA API integration should achieve:
- - ✅ 100% accurate contribution calculations per Greek law
- ✅ Complete employee lifecycle management automation
- ✅ Seamless integration with existing payroll systems
- ✅ Real-time compliance monitoring and deadline management
- ✅ Zero missed deadlines or penalty incidents
- ✅ Complete audit trail and documentation
- ✅ Multi-client support for accounting firm deployment
- ✅ OpenClaw artifact deployment ready for instant setup
OpenClaw Artifact Deployment
This skill is specifically designed as an OpenClaw artifact with:
- - Complete file-based processing architecture
- No external API dependencies requiring complex authentication
- Robust error handling and recovery procedures
- Integration hooks for all other Greek accounting skills
- Production-ready configuration files and templates
- Comprehensive evaluation test cases for validation
Remember: This skill completes the advanced integration capabilities of your Greek accounting automation system, providing comprehensive social security management that integrates seamlessly with all other OpenClaw skills for complete Greek business automation.
EFKA API 集成
该技能通过OpenClaw的文件处理能力,提供与希腊社会保障组织(EFKA)的全面集成,实现希腊企业员工记录管理、缴款计算和合规监控的自动化。
设置
bash
export OPENCLAWDATADIR=/data
export EFKA_USERNAME=your-efka-username
export EFKA_PASSWORD=your-efka-password
which jq curl || sudo apt install jq curl
EFKA凭据仅用于提交社会保障申报。薪资计算和缴款处理可离线工作。所有政府提交均需人工审批(四眼工作流)。
核心理念
- - OpenClaw工件就绪:专为上传和部署到OpenClaw实例而设计
- 基于文件的处理:适用于生产部署的稳健文件系统方法
- 希腊劳动法合规:完全遵守希腊社会保障法规
- 薪资集成:与现有希腊薪资系统无缝连接
- 生产可扩展性:支持多客户和高交易量处理
OpenClaw命令
核心EFKA操作
bash
主要员工和缴款管理
openclaw efka employee-register --new-hire --calculate-contributions --generate-forms
openclaw efka monthly-process --payroll-period 2026-02 --all-employees --submit-ready
openclaw efka contributions-calculate --employee-id {id} --salary-changes --bonus-payments
openclaw efka compliance-check --deadlines --missing-submissions --penalty-warnings
员工生命周期管理
openclaw efka employee-onboard --personal-data --employment-terms --insurance-category
openclaw efka employee-update --salary-changes --position-updates --insurance-modifications
openclaw efka employee-terminate --final-calculations --clearance-certificates --archive-records
批量处理和自动化
openclaw efka batch-process --payroll-file /data/efka/payroll/input/ --validate-contributions
openclaw efka export-submissions --aade-format --efka-format --ready-for-upload
openclaw efka reconcile-payments --bank-statements --contribution-receipts --variance-analysis
高级集成命令
bash
与其他OpenClaw技能集成
openclaw efka integrate-payroll --greek-compliance-aade --banking-integration --tax-calculations
openclaw efka coordinate-deadlines --cli-deadline-monitor --automatic-reminders --calendar-sync # 如果配置,将EFKA截止日期同步到日历
openclaw efka employee-expenses --individual-taxes --personal-contributions --annual-statements
报告和分析
openclaw efka generate-reports --monthly --quarterly --annual --management-dashboard
openclaw efka cost-analysis --employer-contributions --employee-deductions --budget-projections
openclaw efka audit-preparation --employee-records --contribution-history --compliance-documentation
文件处理与监控
bash
基于文件的EFKA数据处理
openclaw efka monitor-files --watch-payroll-updates --auto-process --error-recovery
openclaw efka import-employee-data --csv --excel --validation --duplicate-detection
openclaw efka export-government --efka-xml --aade-integration --submission-ready
质量控制和验证
openclaw efka validate-data --employee-records --contribution-calculations --regulatory-compliance
openclaw efka error-recovery --failed-submissions --data-corrections --resubmission-queue
openclaw efka backup-restore --employee-database --contribution-history --disaster-recovery
OpenClaw文件处理架构
EFKA文件系统组织
yaml
EFKA
FileStructure:
employee_data:
- /data/efka/employees/active/ # 当前员工记录
- /data/efka/employees/terminated/ # 前员工记录
- /data/efka/employees/pending/ # 待注册的新员工
- /data/efka/employees/updates/ # 员工数据变更请求
payroll_processing:
- /data/efka/payroll/input/ # 薪资数据导入
- /data/efka/payroll/processed/ # 已计算的缴款
- /data/efka/payroll/validated/ # 质量检查后的数据
- /data/efka/payroll/ready-submit/ # 可提交的文件
contributions_management:
- /data/efka/contributions/monthly/ # 月度缴款计算
- /data/efka/contributions/quarterly/ # 季度汇总
- /data/efka/contributions/annual/ # 年度报表
- /data/efka/contributions/payments/ # 付款确认
government_integration:
- /data/efka/submissions/efka-portal/ # EFKA门户提交
- /data/efka/submissions/aade-cross/ # 与AADE交叉引用
- /data/efka/responses/confirmations/ # 政府确认
- /data/efka/responses/corrections/ # 需要更正的内容
compliance_monitoring:
- /data/efka/deadlines/upcoming/ # 即将到来的截止日期
- /data/efka/deadlines/overdue/ # 已逾期的截止日期,需要处理
- /data/efka/audit/employee-records/ # 审计就绪文档
- /data/efka/audit/contribution-proof/ # 付款验证记录
EFKA处理管道
yaml
Processing_Workflow:
step
1employee_data:
command: openclaw efka import-employees --source-file --validate-format --check-duplicates
input: /data/efka/employees/imports/
output: /data/efka/employees/validated/
functions: [数据验证, 重复检测, 格式标准化]
step2contribution_calculation:
command: openclaw efka calculate-contributions --salary-data --insurance-categories --rates-2026
input: /data/efka/payroll/input/
output: /data/efka/contributions/calculated/
functions: [缴款计算, 费率应用, 法规合规]
step3cross_validation:
command: openclaw efka cross-validate --aade-data --banking-data --consistency-check
input: /data/efka/contributions/calculated/
output: /data/efka/contributions/validated/
functions: [AADE交叉引用, 银行对账, 错误检测]
step4submission_prep:
command: openclaw efka prepare-submissions --efka-xml --government-format --digital-signatures
input: /data/efka/contributions/validated/
output: /data/efka/submissions/ready/
functions: [政府格式, 数字签名, 提交打包]
step5monitoring:
command: openclaw efka monitor-compliance --deadlines --penalties --corrective-actions
input: /data/efka/submissions/ready/
output: /data/efka/compliance/monitoring/
functions: [截止日期跟踪, 罚款计算, 行动计划]
希腊社会保障集成
EFKA员工类别与缴款(2026年)
yaml
EFKA
EmployeeCategories:
main_insurance:
category_code: 101
description: 主要保险 - 私营部门员工
employer_rate: 24.56
employee_rate: 16.00
calculation
base: grosssalary
max
monthlybase: 6177.84
auxiliary_insurance:
category_code: 201
description: 辅助保险 - 补充养老金
employer_rate: 3.00
employee_rate: 3.00
calculationbase: grosssalary
maxmonthlybase: 6177.84
employment_account:
category_code: 301
description: 就业账户 - 失业救济金
employer_rate: 1.55
employee_rate: 0.55
calculationbase: grosssalary
maxmonthlybase: 6177.84
health_contributions:
category_code: 401
description: 健康保险缴款(EOPYY)
employer_rate: 9.76
employee_rate: 2.55
calculationbase: grosssalary
nomaximumbase: true
Specialized