- Overview
- Configuration
SurePayroll
Optimize payroll management with SurePayroll and ADManager Plus integration
SurePayroll is an online, full-service payroll solution for small businesses and individuals. It offers resources for payroll calculation, legal compliance, tax form completion, and direct deposits. Integrating SurePayroll with ADManager Plus streamlines user lifecycle management by eliminating the need for manual identity management across your business. New employees are automatically granted access to SurePayroll , while departing employees have their permissions promptly revoked. This integration reduces administrative burden on HR and IT teams by ensuring real-time updates between Active Directory and SurePayroll records, thereby optimizing payroll management and minimizing delays in account setup and deactivation.
Automate user creation and payroll access
Onboard new hires efficiently by automatically creating corresponding user accounts within SurePayroll. This ensures new employees are automatically included in payroll processing.
Synchronize employee roles with payroll
Updates to employee roles automatically synchronize with SurePayroll, guaranteeing your payroll records remain accurate.
Streamline offboarding
When an employee departs, their access from SurePayroll is automatically revoked, preventing unauthorized access to payroll information.
Configuration Document: Integrating SurePayroll with ADManager Plus
Prerequisites:
Please ensure to provide the bearer token to retrieve desired information and perform tasks in SurePayroll. Refer to Sure Payroll API references for more details.
Privileges:
- To import users (inbound action): Ensure the account used for authorization has permission to read all user accounts.
- To perform any action or query in SurePayroll (outbound action): Ensure the account used for authorization has permission to perform the desired action.
Authorization configuration
- Log in to ADManager Plus and navigate to the Automation tab.
- In the left pane, under Configuration, click Application Integrations.
- Under Enterprise Applications, click SurePayroll.
- Toggle the Enable SurePayroll Integration button on.
- In the SurePayroll Configuration page, click Authorization.
- Perform the steps to generate Bearer token in SurePayroll and paste the Bearer token the Value field.
- Click Configure.
Inbound webhook configuration
Inbound webhook enables you to fetch user data from SurePayroll to ADManager Plus. The attribute mapping configured in this section can be selected as the data source during automation configuration. to perform the desired action on the list of users received from the API response.
To configure an inbound webhook for SurePayroll:
- Under Inbound Webhook, click SurePayroll Endpoint Configuration.
- In the Endpoint Configuration tab, an endpoint, SurePayroll USERS ENDPOINT, comes pre-configured with an Endpoint URL, API Method, Headers, and Parameters fields to fetch user accounts from SurePayroll. If you would like to use this pre-configured endpoint, replace {company_id} with the domain name of your SurePayroll instance in the Endpoint URL field. However, if you would like to use a new endpoint to import users, you can configure one using the + Add API endpoint button and filling in the required fields as per SurePayroll's API references. Click here to learn how.
- The API key value pair is preconfigured as a header for authenticating API requests as configured during Authorization Configuration.
- Macros: Explain about macros how they can use these to dynamically change the endpoint to meet their requirement.
- Refer to SurePayroll's API references and configure additional headers and parameters, if required.
- Once done, click Test & Save. A response window will display all the requested parameters that can be fetched using the API call. After verifying if the requested parameters have been called to action, click Proceed.
- Refer to SurePayroll's API references to know the Parameters that must be configured to fecth only specific parameters.
- You can configure multiple endpoints for Datadog using the + Add API endpoint button. Click here to learn how.
- Click Data Source - LDAP Attribute Mapping to match endpoints and to map AD LDAP attributes with the respective attributes in SurePayroll.
- Click + Add New Configuration and perform the following:
- Enter the Configuration Name and Description and select the Automation Category from the drop-down menu.
- In the Select Endpoint field, select the desired endpoint and a Primary Key that is unique to a user (e.g. employeeIdentifier). Note: When multiple endpoints are configured, this attribute must hold the same value in all the endpoints.
- In the Attribute Mapping field, select the attribute from the LDAP Attribute Name drop-down menu and map it with the respective column in SurePayroll.
- If you would like to create a new custom format for this, click Add New Format.
- Click Save.
Note:
Note: