efka-api-integration

---
name: efka-api-integration
description: Greek social security (EFKA) integration — employee records, contribution calculations, APD declarations. Human approval for submissions.
version: 1.0.0
author: openclaw-greek-accounting
homepage: https://github.com/satoshistackalotto/openclaw-greek-accounting
tags: ["greek", "accounting", "efka", "social-security", "payroll"]
metadata: {"openclaw": {"requires": {"bins": ["jq", "curl"], "env": ["OPENCLAW_DATA_DIR", "EFKA_USERNAME", "EFKA_PASSWORD"]}, "optional_env": {"SLACK_WEBHOOK_URL": "Notifications for EFKA submission status updates", "GOOGLE_CALENDAR_ID": "Google Calendar ID for EFKA deadline sync (optional)"}, "notes": "EFKA credentials required only for submitting declarations. Payroll calculations work offline. All submissions require human approval (four-eyes workflow). Slack notification is optional."}}
---

# 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

```bash
export OPENCLAW_DATA_DIR="/data"
export EFKA_USERNAME="your-efka-username"
export EFKA_PASSWORD="your-efka-password"
which jq curl || sudo apt install jq curl
```

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 han