Rivane

Accounting
made smart

ERP Use CasesTier 1Published May 27, 2026

Employee Onboarding - New Hire Setup

Employee Onboarding - New Hire Setup for US and UK finance teams: ERP requirements, controls, audit evidence, data model, APIs, state transitions, and implementation checks.

HRIS / Onboarding is where ERP discipline either begins or breaks.

Employee Onboarding - New Hire Setup looks operational from far away. In a real finance team, it is a chain of assertions: the right actor started the work, the required records existed, the control policy was applied, the state change was preserved, and the outcome can be explained later without rebuilding the transaction from emails and spreadsheets.

The expected business outcome is specific: New employee is payroll-eligible from day one; all system access provisioned before start date; zero manual data re-entry across HR, payroll, and IT systems.

The control flow a finance team actually needs.

Workflow map showing control steps, exceptions, and evidence for this ERP process.Onboarding Check...Start conditionW-4 Digital Capt...Required checksProvisioning Web...Owner and SLAIncomplete Manda...System updateAll PII Collecte...Exception handlingAudit packetEvidence trailException loopHRIS / Onboarding should preserve every override and rejection.
Workflow map for this ERP process, including exception handling and audit evidence.

Step 1

Onboarding Checklist Track Completion...

Step 2

W-4 Digital Capture Store Versioned...

Step 3

Provisioning Webhook Fire Within 60...

Step 4

Incomplete Mandatory Tasks Block...

Step 5

All PII Collected Be Encrypted At Rest

The ERP surface involved.

Module

HRIS / Onboarding

Actors

HR Administrator, IT Provisioning System, Payroll System, New Employee

Tier

Tier 1

Finance area

Human Resources, Payroll & Workforce Management

Region lens

US and UK finance teams

Publication date

May 27, 2026

Onboarding checklist must track completion percentage with item-level due dates; W-4 digital capture must store versioned elections and trigger withholding recalculation immediately; provisioning webhook must fire within 60 seconds of record activation; incomplete mandatory tasks must block payroll activation with clear error message; all PII collected must be encrypted at rest; audit log must capture every field change with actor and timestamp.

US and UK teams have different compliance hooks, but the same control problem.

US teams usually care about clean evidence for audit support, vendor records, payment controls, tax reporting, and management review. UK teams usually care about VAT-ready records, approval evidence, digital-record discipline, and traceable postings. The country-specific details differ, but the operating pattern is the same: the ERP needs controlled records, explicit ownership, defensible state changes, and evidence that survives beyond the person who completed the task.

The control matrix.

Control areaRequirementAcceptance proof
Control 1Onboarding checklist must track completion percentage with item-level due datesGiven an accepted offer converted from ATS
Control 2W-4 digital capture must store versioned elections and trigger withholding recalculation immediatelywhen HR Administrator completes employee master record and activates it
Control 3provisioning webhook must fire within 60 seconds of record activationthen provisioning webhook fires within 60 seconds, employee receives self-service portal link for W-4 and direct deposit, and payroll eligibility is set
Control 4incomplete mandatory tasks must block payroll activation with clear error messagenegative) when payroll activation is attempted with mandatory onboarding tasks incomplete then 422 with error code ONBOARDING_CHECKLIST_INCOMPLETE is returned.
Control 5all PII collected must be encrypted at restNew employee is payroll-eligible from day one; all system access provisioned before start date; zero manual data re-entry across HR, payroll, and IT systems.
Control 6audit log must capture every field change with actor and timestamp.New employee is payroll-eligible from day one; all system access provisioned before start date; zero manual data re-entry across HR, payroll, and IT systems.

Audit evidence is a chain, not a folder.

Evidence layerWhat should be preserved
Business eventRecruiter converts accepted offer in ATS, triggering a new-hire workflow; HR Administrator completes the employee master record with personal details, job classification, compensation, and reporting hierarchy; system auto-provisions AD/SSO accounts and notifies IT for equipment; new employee receives self-service portal link to complete tax forms (W-4, state withholding), direct deposit, emergency contacts, and policy acknowledgements; on start date the record activates and payroll eligibility begins.
Control rulesOnboarding checklist must track completion percentage with item-level due dates; W-4 digital capture must store versioned elections and trigger withholding recalculation immediately; provisioning webhook must fire within 60 seconds of record activation; incomplete mandatory tasks must block payroll activation with clear error message; all PII collected must be encrypted at rest; audit log must capture every field change with actor and timestamp.
Acceptance proofGiven an accepted offer converted from ATS; when HR Administrator completes employee master record and activates it; then provisioning webhook fires within 60 seconds, employee receives self-service portal link for W-4 and direct deposit, and payroll eligibility is set; (negative) when payroll activation is attempted with mandatory onboarding tasks incomplete then 422 with error code ONBOARDING_CHECKLIST_INCOMPLETE is returned.
Data record
employee { id: string, external_id: string, org_id: string, entity_id: string, status: enum(PENDING_ONBOARDING,ACTIVE,TERMINATED,ON_LEAVE), start_date: date, pay_rate_minor: int64, currency_code: char(3), payroll_eligible: bool };
onboarding_task { id: string, employee_id: string, task_type: string, due_date: date, completed_at: timestamp, required: bool };
(reference, product may differ).
System event
POST /v1/employees { first_name, last_name, start_date, pay_rate_minor, currency_code, external_id } -> 201 { id, status: "PENDING_ONBOARDING" };
POST /v1/employees/{id}/activate -> 200 { status: "ACTIVE" };
GET /v1/employees/{id}/onboarding-checklist -> 200 { tasks[], completion_pct };
emits hr.employee_activated, hr.provisioning_requested;
idempotent via external_id.
Lifecycle state
PENDING_ONBOARDING -> ACTIVE;
terminal TERMINATED;
guard: ACTIVE blocked if any required onboarding task incomplete;
TERMINATED from PENDING_ONBOARDING allowed only with HR override.

The useful version of this workflow is not only fast. It is inspectable. A controller, auditor, or operator should be able to move from source event to system record to state transition to final business outcome without guessing.

Implementation contracts.

Reference data model

`employee` { id: string, external_id: string, org_id: string, entity_id: string, status: enum(PENDING_ONBOARDING,ACTIVE,TERMINATED,ON_LEAVE), start_date: date, pay_rate_minor: int64, currency_code: char(3), payroll_eligible: bool }; `onboarding_task` { id: string, employee_id: string, task_type: string, due_date: date, completed_at: timestamp, required: bool }; (reference, product may differ).

API and events

`POST /v1/employees` { first_name, last_name, start_date, pay_rate_minor, currency_code, external_id } -> 201 { id, status: "PENDING_ONBOARDING" }; `POST /v1/employees/{id}/activate` -> 200 { status: "ACTIVE" }; `GET /v1/employees/{id}/onboarding-checklist` -> 200 { tasks[], completion_pct }; emits `hr.employee_activated`, `hr.provisioning_requested`; idempotent via `external_id`.

State transitions

`PENDING_ONBOARDING -> ACTIVE`; terminal `TERMINATED`; guard: ACTIVE blocked if any required onboarding task incomplete; TERMINATED from PENDING_ONBOARDING allowed only with HR override.

Common implementation traps.

Treating the workflow as data entry

If the ERP only stores the final record, the team loses the decision trail that explains how the record became valid.

Hiding exception logic

Exceptions need owners, reason codes, and time stamps. A vague pending state is not a control.

Posting without recovery design

Retries, duplicate submissions, and partial failures must be explicit so the system does not create inconsistent records.

Skipping evidence design

A workflow that cannot produce evidence on demand will eventually push finance teams back into manual screenshots and spreadsheets.

Where Rivane fits.

Rivane is built for finance workflows where automation must stay tied to source documents, approvals, state transitions, ledger impact, reporting, and audit evidence. Use this guide as a checklist for evaluating whether an ERP workflow is merely digitized or actually controlled.

References and source basis.

These sources provide the standards, regulatory, or government context around the flow. They are included so the guide is useful to finance operators, auditors, and implementation teams, not only buyers reading software copy.

Back to ERP use cases