ERP Integration

Connect external ERP/HR systems to IoT Access via REST API. Manage API keys and view integration docs.

Active API Keys

No API keys yet. Generate one to connect your ERP.

API Documentation

Use these endpoints to integrate with your ERP system

Base URL

1. Authenticate

POST /api/erp/auth
Content-Type: application/json

{"api_key": "iotacc_your_key_here"}

Response: {"success": true, "token": "...", "expires_in": 86400}

2. Get Attendance Records

GET /api/erp/attendance
Authorization: Bearer {token}

Query params:
  date_from=2026-07-01    (filter start date)
  date_to=2026-07-31      (filter end date)
  device_id=uuid          (filter by device)
  employee_id=1           (filter by employee)
  since=ISO_timestamp     (incremental sync - only new records)
  page=1                  (pagination, default 1)
  per_page=100            (max 500)

Response: {
  "success": true,
  "data": [{
    "employee_id", "employee_name", "date", "time",
    "action", "attend_stat", "ap_stat",
    "device_id", "device_name", "device_serial",
    "source": "biometric", "has_photo", ...
  }],
  "pagination": {"page", "per_page", "total", "total_pages"}
}

3. Get Employees

GET /api/erp/employees
Authorization: Bearer {token}

Query: device_id=uuid (optional filter)

Response: {"success": true, "data": [{
  "enroll_id", "name", "department", "device_name", ...
}]}

4. Get Devices

GET /api/erp/devices
Authorization: Bearer {token}

Response: {"success": true, "data": [{
  "id", "name", "status", "serial_number", "model",
  "firmware", "user_count", "last_seen_at", ...
}]}

ERP Configuration

In your ERP Biometric Settings page, enter:

API URL: /api/erp

API Key: iotacc_...