Overview

The HR & Payroll integration enables bi-directional data sync between skillSYMS and your human resources systems. Automatically create learner records from employee data and sync skills achievements back to HR.

Beta Notice: This integration is currently in beta. Contact us to discuss your specific HR system requirements.

Supported Systems

Current Integrations

System	Status	Features
Sage People	Beta	Employee sync, skills tracking
SAP SuccessFactors	Planned	Full integration
Oracle HCM	Planned	Full integration
Custom API	Available	Generic webhook integration

Custom Integration

For systems not listed, use our generic webhook API:

POST /api/v1/tenants/{slug}/webhooks/hr-sync

Use Cases

Employee → Learner Sync

Automatically create learner records when employees are enrolled in skills programmes:

HR System: New learnership employee
    ↓
Webhook to skillSYMS
    ↓
Learner record created
    ↓
Enrolment notification sent

Skills Achievement → HR

Sync completed qualifications back to employee records:

skillSYMS: Learner achieves qualification
    ↓
Webhook to HR system
    ↓
Employee skills profile updated
    ↓
Included in next WSP/ATR

Configuration

Setup Process

Request Integration: Contact skillSYMS support
Technical Discovery: Map fields between systems
Configure Webhook: Set up endpoint and authentication
Test Sync: Verify with sample data
Go Live: Enable production sync

Webhook Configuration

Navigate to Settings → Integrations → HR Sync:

{
  "enabled": true,
  "system": "custom",
  "inboundUrl": "https://your-skillsyms-tenant/api/webhooks/hr",
  "outboundUrl": "https://your-hr-system/api/skills-sync",
  "authentication": {
    "type": "api_key",
    "headerName": "X-API-Key"
  },
  "fieldMapping": {
    "employeeId": "learner.employeeRef",
    "firstName": "learner.firstName",
    "lastName": "learner.lastName"
  }
}

Data Mapping

Inbound (HR → skillSYMS)

HR Field	skillSYMS Field	Required
Employee ID	`employeeRef`	Yes
First Name	`firstName`	Yes
Last Name	`lastName`	Yes
ID Number	`saIdNumber`	Yes
Email	`email`	No
Department	`department`	No
Job Title	`jobTitle`	No

Outbound (skillSYMS → HR)

skillSYMS Field	HR Field	Trigger
Qualification ID	Skills/Qualifications	On completion
Achievement Date	Skills Date	On completion
Competency Status	Skills Status	On assessment

API Reference

Inbound Webhook

Receive employee data from HR:

POST /api/v1/tenants/{slug}/webhooks/hr-sync
Content-Type: application/json
X-API-Key: {webhook-key}

{
  "event": "employee.enrolled",
  "data": {
    "employeeId": "EMP001",
    "firstName": "Thabo",
    "lastName": "Mokoena",
    "saIdNumber": "9001015009087",
    "email": "thabo@company.co.za",
    "programmeCode": "PROG001"
  }
}

Outbound Webhook

skillSYMS sends achievements:

{
  "event": "learner.completed",
  "timestamp": "2024-12-01T10:30:00Z",
  "data": {
    "employeeRef": "EMP001",
    "qualificationId": "SAQA-12345",
    "qualificationName": "National Certificate...",
    "achievementDate": "2024-12-01",
    "certificateNumber": "CERT-2024-001"
  }
}

WSP/ATR Integration

Workplace Skills Plan Export

Generate data for your annual WSP submission:

Navigate to Reports → WSP Export
Select reporting period
Choose data categories
Generate export
Import into WSP tool

Annual Training Report

Track interventions against WSP:

Navigate to Reports → ATR Export
Select financial year
Review training completed
Export for SETA submission

Best Practices

Field Mapping: Document all field mappings
Test Environment: Always test in sandbox first
Error Handling: Configure alerts for sync failures
Data Quality: Validate data at source
Regular Review: Audit sync accuracy monthly

HR & Payroll Systems