Government Integration

The Government Integration module connects ORKSTRA to UAE federal authorities — MoHRE, ICA, GDRFA — so HR, mobilization, and compliance teams can validate worker status, renew visas, and respond to authority queries without leaving the platform.

Stub mode. Production credentials require formal authority onboarding (TAS portal access for MoHRE, etc.). The module ships fully stubbed — every endpoint returns realistic sample data — so dev/QA and pilot tenants can test workflows without real credentials.

Overview

Three federal connectors:

• MoHRE — Ministry of Human Resources & Emiratisation. Labour cards, work permits, wage protection.
• ICA — Federal Authority for Identity, Citizenship, Customs & Port Security. National IDs.
• GDRFA — General Directorate of Residency & Foreigners Affairs. Visas, residency.

Screenshot: Government dashboard with worker compliance status grid

Key concepts

Connector. A bridge between ORKSTRA and an authority's API. Each connector has credentials (stub or real), a status (connected / disconnected / error), and a sync schedule.

Sync. Periodic pull of worker status from the authority. Default: daily.

Verification. Real-time check of a single worker — useful at gate scan-in.

Submission. Outbound submission — visa renewal request, labour card renewal.

Audit log. Every authority call is logged for compliance purposes.

Step-by-step: enable a connector (production)

1. Obtain authority credentials per their onboarding process.
2. Admin → Integrations → Government → MoHRE → Configure.
3. Enter credentials (stored as encrypted secrets).
4. Click Test connection — success means you're live.
5. Schedule daily sync.

Step-by-step: verify a worker

1. HR → Workers → [worker] → Verify.
2. The connector calls MoHRE / ICA / GDRFA in real time.
3. Returns: labour card status, work permit expiry, visa expiry, national ID status.
4. Discrepancies are flagged.

Step-by-step: submit a visa renewal

1. HR → Workers → [worker] → Visa → New renewal.
2. Fill in renewal type, attach supporting docs (medical fitness, Emirates ID renewal, etc.).
3. Submit — the GDRFA connector packages and sends.
4. Status is updated as the authority processes.

Common tasks

• Bulk verify: HR → Workers → Bulk verify for shift mobilization.
• Renewal calendar: HR → Renewals shows upcoming expiries.
• Compliance report: Reports → Government compliance for monthly board view.

Troubleshooting

• "Connector shows 'stub'." — Production credentials not configured. See above.
• "Verification timed out." — Authority API slow. Retry or use the daily sync.
• "Submission rejected by authority." — Authority's response includes reason. Fix and resubmit.

Permissions reference

Permission	Who needs it
GOVT_INTEGRATION_VIEW	HR, Mobilization
GOVT_INTEGRATION_VERIFY	HR, Site mobilization officers
GOVT_INTEGRATION_SUBMIT	HR
GOVT_INTEGRATION_CONFIGURE	Tenant admin

See also: Govt Financial, RBAC Premium + AI.