How to Integrate with an HR system like ADP using Fuuz iPaaS

How to Integrate with an HR system like ADP using Fuuz iPaaS

In this video, our engineer walks you through the basic process of getting started with an integration to your HR / payroll provider system. In this case we are demonstrating this using the ADP RESTful API interface.

These concepts apply to any sort of integration using Fuuz as your iPaaS platform (northbound integrations). For specifics regarding your projects, please submit a ticket to our support team or consult with your implementation partner on best practices specific to your operation and external systems.

🎥 Video walkthrough: Watch on Vimeo

Note: The original KB article includes a downloadable attachment (ADP_Integration_Flow_Designer_Template.mp4). Download it from the original article — it must be re-attached/linked in this repo.

ADP Bindings

Pull ADP Event

Template for pulling ADP events:

"ADP_Event": {
  "connectionName": "Connections.ADP_Connection",
  "payload": [
    {
      "method": "get",
      "path": "/core/V1/event-notification-messages"
    }
  ]
}

Get ADP Employee

Template for getting an ADP employee:

"Employee": {
  "connectionName": "Connections.ADP_Connection",
  "payload": [
    {
      "method": "get",
      "path": "/hr/v2/workers/" & $associateOID,
      "options": {
        "masked": false /* DOB only, not SSN, per customer's ADP configuration */
      }
    }
  ]
}

Remove ADP Event

Template for removing ADP events:

"ADP_Delete_Event": {
  "connectionName": "Connections.ADP_Connection",
  "payload": [
    {
      "method": "delete",
      "path": "/core/v1/event-notification-messages/" & ADP_Event[0].`adp-msg-msgid`,
      "options": {
        "roleCode": "employee"
      }
    }
  ]
}

About

MFGx supports all endpoints available through the ADP API: ADP API Explorer

• Workers
• Time Entry
• Payroll Outputs
• Workers - Lifecycle Management
• Worker Payroll Instructions
• Clock Entries
• Worker Demographics
• Event Notifications
• Job Applicants

Customer Requirements

1. Request API access (may cost extra).
2. Define changes and events you wish to subscribe to.
3. Identify any sensitive data (e.g., birth date or social security number).
4. Start the CSR (Certificate Signing Request) process with ADP — optionally we can do it for them. See ADP's CSR guide.
5. Identify custom fields in ADP (common/suggested fields below):
   1. Username
   2. Company Code / Number
   3. Shift

Pulling Events

Removing Events

Getting an Employee

See Also

• How-to-Integrate-Fuuz-with-another-product-or-another-API
• How-To-General-E-Commerce-Integrations-using-Data-Flows-in-Fuuz-iPaaS
• How-to-integrate-with-Plex-Classic-using-Fuuz-iPaaS
• Integration-Nodes
• Fuuz-has-pre-built-integration-Connectors

---

Source: support.fuuz.com