FORGE
FORGE
Breadcrumbs

Greenshades Payroll Integration

Use the Greenshades Payroll section in WennSoft Registration to store the tenant-level credentials WennSoft needs to connect to your Greenshades workspace. After the registration settings are saved, payroll-related setup pages can fetch Greenshades pay runs, employees, departments, positions, and earnings codes for payroll export workflows.

Before You Start

  • Confirm that your organization uses Greenshades payroll and has an active Greenshades workspace.

  • Gather the OAuth client credentials, scope string, and workspace identifier provided for your Greenshades integration.

  • Confirm that you have permission to edit WennSoft Registration settings.

  • Plan to review Departments, Positions, Employees, Rate Categories, Pay Periods, and Timesheets after enabling the integration.

Enable Greenshades Payroll

  1. Open WennSoft Registration from the setup area.

  2. Go to the Greenshades Payroll section.

  3. Select Use Greenshades Payroll.

  4. Complete the Greenshades registration fields.

    • Use Greenshades Payroll: Turns on Greenshades payroll features for the tenant. When this option is enabled, all Greenshades credential fields are required before Registration can be saved.

    • Greenshades Client ID: The OAuth client identifier assigned to your Greenshades integration.

    • Greenshades Client Secret: The OAuth secret used with the Client ID. This is sensitive credential information and should be entered only by an authorized administrator.

    • Greenshades API Scope: The space-delimited scope string provided by Greenshades. The scope controls which Greenshades APIs WennSoft can request access to.

    • Greenshades Workspace ID: The positive numeric workspace identifier assigned by Greenshades. WennSoft uses it when requesting workspace-specific pay runs, employees, positions, departments, and earnings codes.

  5. Save Registration.

    • If a required Greenshades field is missing, complete the highlighted field and save again.

    • If the Workspace ID is rejected, confirm it is a positive whole number and matches the workspace assigned by Greenshades.

Complete Payroll Setup After Registration

  1. Import or review Departments and Positions if your payroll setup uses Greenshades department or position codes. See Departments and Positions.

    • Created: Local department or position rows added because no safe match already existed.

    • Matched: Greenshades values matched to existing local setup rows by code or unique normalized name.

    • Skipped: Values the import did not create, usually because they were blank or not usable.

    • Conflicts: Values that need manual review because the system could not identify one safe local match.

  2. Open Employees and mark payroll employees as Payroll Integrated. See Employees.

    • Payroll Integrated: Indicates that the employee participates in Greenshades payroll export workflows.

    • Greenshades Employee: The employee selected from Greenshades. Selecting an employee stores the Greenshades employee identifiers and related department, position, and work location metadata.

  3. Open Rate Categories and map payroll earning codes. See Rate Categories.

    • External Pay Code: The earning or pay code sent to Greenshades when approved time is exported.

  4. Open Pay Periods and connect each payroll period to the correct Greenshades pay run. See Pay Periods.

    • External Pay Run ID: The Greenshades pay run identifier linked to the WennSoft pay period. Timesheet export uses this value to send approved time to the correct pay run.

  5. Export only approved timesheets that belong to a pay period with a Greenshades pay run ID

 

How the Integration Is Used

WennSoft remains the system of record for time entry and timesheet approval. Greenshades Registration settings allow WennSoft to retrieve payroll reference data and queue approved timesheets for export to the selected Greenshades pay run. Exported batches move through payroll export statuses such as Queued, Processing, Exported, or Failed so administrators can track progress.

 

Tips

  • Treat the Client Secret like any other password or integration secret.

  • Keep department, position, and earning code mappings current before approving timesheets for export.

  • Review import conflicts instead of assuming the system merged them automatically.

  • Confirm each pay period is linked to the intended Greenshades pay run before sending approved timesheets.

 

Troubleshooting

  • Registration will not save: Confirm Use Greenshades Payroll is either off, or all Greenshades fields are populated and the Workspace ID is a positive whole number.

  • Greenshades setup buttons are missing: Confirm Greenshades Payroll is enabled in WennSoft Registration and that your role can access the related setup page.

  • Employee payroll integration is disabled: Enable Greenshades Payroll in Registration before marking employees as payroll integrated.

  • Timesheet export fails: Confirm the employee is payroll integrated, rate categories have external pay codes, and the pay period has a valid External Pay Run ID.