Setting Up a Workday ISU for SmartVendor Products (AP Invoices and AP Helpdesk)

Introduction

This guide provides step-by-step instructions for configuring your Workday environment to integrate with Auditoria SmartVendor products (AP Invoices and AP Helpdesk) using a single shared Workday integration user.

You will:

  • Create a dedicated Integration System User (ISU).

  • Create and configure an Integration System Security Group (ISSG).

  • Assign the required Domain Security Policies (including Workday Query Language/WQL access).

  • Register an API client and generate a Refresh Token.

  • Connect Auditoria SmartVendor (AP Invoices and AP Helpdesk) to your Workday tenant.

These configurations ensure that Auditoria can securely:

  • Read AP-related data in Workday (suppliers, supplier invoices, payments, purchase orders, contracts, cost centers, spend categories), and

  • (Optionally) write supplier invoices (with attachments) back to Workday for AP Invoices functionality.


Audience

This article is intended for:

  • Workday Administrators with:

    • Integration configuration access.

    • Security and Domain Security Policy management permissions.

    • API client registration and WQL access.

Coordination with your Auditoria Customer Success Representative is recommended during initial setup and whenever you modify security or integration scope.


Prerequisites

Before you begin, ensure the following:

  • An active Auditoria subscription for:

    • AP Invoices, and optionally

    • AP Helpdesk.

  • Workday administrator credentials.

  • Ability to:

    • Create Integration System Users (ISU).

    • Create and manage Integration System Security Groups (ISSG).

    • Configure Domain Security Policies.

    • Access Workday Public Web Services.

    • Register API Clients for Integrations in Workday.


1. Get Your Workday Hostname and Tenant Name

To configure the Workday connection in Auditoria, you need your Workday hostname and tenant name.

  1. Log in to Workday using your administrator account.

  2. In the Workday search bar, type Public Web Services and press Enter.

  3. In the results, filter the Web Service column to only show entries for Revenue Management.

  4. Locate Revenue Management (Public) Web Service.

  5. Click the ellipsis (three dots) next to it and select:
    Web Service > View WSDL.

  6. In the WSDL file:

    • Search for the final occurrence of Revenue_Management.

    • Locate the endpoint URL, for example:
      https://wd1-impl-services1.workday.com/ccx/service/your-tenant-name/Revenue_Management/v37.0

    • From this URL:

      • Hostname: wd1-impl-services1.workday.com

      • Tenant Name: your-tenant-name

  7. Copy both values. You will use them later in the Auditoria connection settings.

Note: The hostname and tenant name are required to configure the Workday ERP connection in Auditoria.


2. Create the Workday Integration System User (ISU) for Auditoria

Create a dedicated Integration System User that Auditoria will use for API/WQL access.

  1. Log in to Workday as an administrator with ISU management permissions.

  2. In the search bar, type Create Integration System User and press Enter.

  3. On the Create Integration System User page, configure:

    • User Name (required):
      Use a descriptive name such as ISU_Auditoria or a variant specific to SmartVendor.

    • Generate Random Password (optional):

      • Check this box if you want Workday to auto-generate a password.

      • If selected, you do not enter a manual password.

    • New Password / New Password Verify (required if not generating random):

      • Enter a secure password that meets the Workday Password Rules (minimum length and complexity).

    • Require New Password at Next Sign In (optional):
      Typically not required for integration users, unless mandated by your security policy.

    • Session Timeout Minutes Enforced / Session Timeout Minutes (optional):

      • Configure session timeout according to your organization’s policies.

    • Do Not Allow UI Sessions (optional but recommended):

      • Check this to prevent the ISU from logging into the UI.

      • Recommended for integrations to limit access to API/Web Services only.

  4. Click OK to create the ISU.

Best Practice: Use a unique ISU for Auditoria (do not reuse ISUs shared with other integrations) and store its credentials securely.


3. Create a Workday Security Group and Assign the ISU

Create an Integration System Security Group (Unconstrained) and assign your ISU to it.

  1. In the Workday search bar, type Create Security Group and press Enter.

  2. On the Create Security Group page:

    • Type of Tenanted Security Group:
      Select Integration System Security Group (Unconstrained).

    • Name:
      Enter a descriptive name, for example:
      ISSG_Auditoria or ISSG_Auditoria_SmartVendor12.

  3. Click OK.

  4. On the Edit Integration System Security Group (Unconstrained) page:

    • In the Integration System Users section, add the ISU created in Step 2 (for example, ISU_Auditoria).

  5. Click OK to save the security group.

Note: Use a dedicated security group for the Auditoria integration. Do not assign unrelated users to this group.


4. Assign Domain Security Policy Permissions for SmartVendor (AP Invoices + AP Helpdesk)

To enable Auditoria SmartVendor to access the required data from your Workday tenant, you must assign the correct domain security policy permissions to the integration security group you created.

Steps to Assign Security Policy Permissions

  1. Log in to your Workday console with administrative privileges.
  2. Open Security Group Search:

    • Go to the Workday search bar.
    • Type "Security group" and select View Security Group from the search results.

  3. Select the Auditoria SmartResearch security group:

    • In the prompt, enter the name of your group (for example, ISSG_Auditoria_SmartVendor12).
    • Click OK.
  4. Open Domain Permissions for the Group:

    • On the Integration System Security Group (Unconstrained) overview page, select the Related Actions (three dots menu) next to the group name.
    • Choose Maintain Domain Permissions for Security Group.
  5. Add Permissions:
    • In the Report/Task Permissions and Integration Permissions sections, add the required Domain Security Policies for each SmartResearch data source, using the operation/access level provided in the table below.
    • Use Modify, View, Get, or Put access level as specified.
  6. Save and confirm your changes.

    • Click OK.
    • Remember to activate pending security policy changes using the appropriate Workday task.

Table 1. Security Permissions for AP Invoices + AP Helpdesk Features

RecordTypesToFetch - From Workday RecordTypeToMap - In Auditoria Operation/Level of Access Domain Security Policy
ALL Records ALL RECORDS View and Modify Workday Query Language
ALL Records ALL RECORDS Get and Put Workday Query Language
ENTITY, Entity details, Entities list ENTITY View Only Manage: Company
ENTITY, Entity details, Entities list ENTITY View Only Set Up: Company
ENTITY, Entity details, Entities list ENTITY Get Only Manage: Company
ENTITY, Entity details, Entities list ENTITY Get Only Set Up: Company
ENTITY, Entity details, Entities list ENTITY View Only Set Up: Company General
ENTITY, Entity details, Entities list ENTITY Get Only Set Up: Company General
Accounts ACCOUNT View Only Set Up: Accounts
Accounts ACCOUNT Get Only Set Up: Accounts
List Suppliers, Suppliers details, Suppliers Categories, Contacts VENDOR View Only Set Up: Supplier Accounts
List Suppliers, Suppliers details, Suppliers Categories, Contacts VENDOR View Only View: Supplier
List Suppliers, Suppliers details, Suppliers Categories, Contacts VENDOR View Only Set Up: Supplier
List Suppliers, Suppliers details, Suppliers Categories, Contacts VENDOR Get Only Set Up: Supplier Accounts
List Suppliers, Suppliers details, Suppliers Categories, Contacts VENDOR Get Only View: Supplier
List Suppliers, Suppliers details, Suppliers Categories, Contacts VENDOR Get Only Set Up: Supplier
List Suppliers, Suppliers details, Suppliers Categories, Contacts VENDOR View Only Reports: Supplier
List Suppliers, Suppliers details, Suppliers Categories, Contacts VENDOR Get Only Reports: Supplier
Suppliers Invoices - Details, List SUPPLIERS INVOICES View Only Process: Supplier Invoice
Suppliers Invoices - Details, List SUPPLIERS INVOICES View Only Process: Recurring Supplier Invoice
Suppliers Invoices - Details, List SUPPLIERS INVOICES View Only Process: Supplier Invoice - Reporting
Suppliers Invoices - Details, List SUPPLIERS INVOICES View Only Process: Supplier Invoice Payment/Settlement
Suppliers Invoices - Details, List SUPPLIERS INVOICES Get Only Process: Supplier Invoice
Suppliers Invoices - Details, List SUPPLIERS INVOICES Get Only Process: Recurring Supplier Invoice
Suppliers Invoices - Details, List SUPPLIERS INVOICES Get Only Process: Supplier Invoice - Reporting
Suppliers Invoices - Details, List SUPPLIERS INVOICES View Only Process: Supplier Invoice - Request
Supplier Payments - Details PAYMENT Get Only Process: Supplier Invoice Payment/Settlem.
Supplier Payments - Details PAYMENT View Only Reports: Supplier Payment
Supplier Payments - Details PAYMENT Get Only Reports: Supplier Payment
Supplier Payments - Details PAYMENT View Only View: Bank Entity
Supplier Payments - Details PAYMENT View Only Set Up: Bank Entity
Supplier Payments - Details PAYMENT Get Only Set Up: Bank Reconciliation
Supplier Payments - Details PAYMENT Get Only View: Bank Entity
Supplier Payments - Details PAYMENT View Only Process: Bank Reconciliation
Supplier Payments - Details PAYMENT Get Only Set Up: Bank Entity
Purchase Orders - Details, List PURCHASE ORDER View Only Process: Purchase Order
Purchase Orders - Details, List PURCHASE ORDER View Only Process: Purchase Order - Reporting
Purchase Orders - Details, List PURCHASE ORDER Get Only Process: Purchase Order
Purchase Orders - Details, List PURCHASE ORDER Get Only Process: Purchase Order - Reporting
Supplier Contract - Details, List CONTRACT View Only Set Up: Supplier Contracts
Supplier Contract - Details, List CONTRACT View Only Process: Supplier Contract
Supplier Contract - Details, List CONTRACT Get Only Set Up: Supplier Contracts
Supplier Contract - Details, List CONTRACT Get Only Process: Supplier Contract
Cost Center - List, Details COST_CENTER View Only Manage: Cost Center
Cost Center - List, Details COST_CENTER Get Only Manage: Cost Center
Spend Categories SPEND_CATEGORIES View Only Manage: Inventory
Spend Categories SPEND_CATEGORIES Get Only Manage: Inventory
Spend Categories SPEND_CATEGORIES View Only Set Up: Spend Categories
Spend Categories SPEND_CATEGORIES Get Only Set Up: Spend Categories
Additional permissions for writing invoice to Workday with attach. SUPPLIERS_INVOICES Modify Process: Supplier Invoice
Additional permissions for writing invoice to Workday with attach. SUPPLIERS_INVOICES Modify Process: Supplier Invoice - Request
Additional permissions for writing invoice to Workday with attach. SUPPLIERS_INVOICES Put Process: Supplier Invoice
Additional permissions for writing invoice to Workday with attach. SUPPLIERS_INVOICES Put Process: Supplier Invoice - Request
References SUPPLIERS GROUPS Get and View Integration Build

Notes: 

Note 1: The hostname and tenant name are required to configure the Workday ERP connection in Auditoria.

Note 2: Your organization's requirements may differ; always confirm with your implementation team or Auditoria support if unsure which policies are needed.

Note 3: Credit and debit memos (supplier invoice adjustments) are secured by the Process: Supplier Invoice domains in this table and by the initiating actions in Step 5. If your tenant also shows the Process: Supplier Invoice Adjustment and Process: Supplier Invoice Adjustment - Reporting domains, give your group View Only and Get Only on both, and Modify and Put on Process: Supplier Invoice Adjustment.

If you have questions about specific domain security policies or data source configurations, consult your Workday administrator or Auditoria support representative.

To view all Domain Security Policy Permissions in detail, please download the Excel sheet from the attachment section at the end of this article.


5. Update Business Process Security Policies for Functional Area

In addition to Domain Security Policies, you must ensure that your Auditoria security group (for example, ISSG_Auditoria) is allowed to participate in the appropriate Business Processes. This is required particularly when AP Invoices will create or update Supplier Invoices in Workday, and is recommended for consistent visibility for AP Helpdesk.

Follow these steps to update the relevant Business Process Security Policies:

  1. In the Workday search bar, type Business Process Security Policies for Functional Area and press Enter.

  2. Select Business Process Security Policies for Functional Area from the search results. Enter the following parameters and click OK:

    • Functional Area: Supplier Accounts
    • Business Process: Supplier Invoice Event
  3. Scroll to the bottom of the configuration page and click Edit Permissions.

  4. Locate the following Initiating Actions and update the Security Groups as appropriate:

    • Import Supplier Invoice (WS Background Process)

    • Submit Supplier Invoice (Web Service)

    • Submit Supplier Invoice Adjustment (Web Service)

      Also add this action if Auditoria will write credit or debit memos (supplier invoice adjustments) to Workday.

    Ensure your Auditoria security group (e.g. ISSG_Auditoria) and any other required groups are included.

  5. Click OK to save and activate your changes.

6. Exempt the Auditoria ISU from the Business Document Attachment Validation (for AP Invoices)

When Auditoria writes invoices to Workday, it uses a two-step process: the first API call writes the invoice data, and the second API call attaches the invoice document. If your Workday tenant has a custom validation that requires a business document attachment at the time of invoice creation, Workday triggers that validation before the second API call completes, causing a processing error.

To prevent this, you must configure the relevant custom validation in Workday to exempt the Auditoria ISU.

  1. In the Workday search bar, type Maintain Custom Validation and press Enter.
  2. Open the Maintain Custom Validations report.
  1. In the left-side menu, locate and select Supplier Invoice. The validations associated with supplier invoices appear in the main panel.
  1. Using the search bar at the top of the Maintain Custom Validations page, search for one of the following validation names:

    • Business Document Attachment is missing
    • Supplier invoice attachment is required

    Note: The validation name may vary depending on your Workday configuration. Search for both terms if the first does not return a result.

  2. Select the Actions menu (three-dot icon) next to the validation, then select Custom Validation > Edit.
  1. On the validation edit screen, review the existing conditions under the Rule Conditions tab. 
  2. Select the + (Add) icon at the top of the Rule Conditions table to add a new condition.
  1. Click OK to save the validation.

7. Activate Pending Security Policy Changes

After adding or modifying domain permissions, you must activate pending security policy changes.

  1. In the Workday search bar, type Activate Pending Security Policy Changes and press Enter.

  2. On the Activate Pending Security Policy Changes page:

    • Enter a comment describing the change (for example, “Auditoria SmartVendor integration permissions”). Depending on your Workday version, the field is labeled Comment or Description for Change.

  3. Review the list of pending security policy changes. Depending on your Workday version, the list appears on this page or on the next page, and the next page also shows the Current Security Evaluation Moment and the Proposed Security Evaluation Moment.

    In some Workday versions, the Description for Change field and the list of pending security policy changes appear together on one page, as shown below.

  4. If a Confirm box appears, check it to acknowledge the changes.
  5. Click OK to apply the updates and activate the permissions.

Note:
Security changes do not take effect until they are activated. Ensure you have permissions to perform this step.

Important: Activating applies all pending security policy changes in your tenant, not only the Auditoria changes. If the list includes changes you don’t recognize, click Cancel and check with the person who made them first.

If you have questions about which policy changes need to be activated, consult your Workday administrator or your implementation team.


8. Register API Client and Retrieve Client Credentials

Register a Workday API Client for Integrations to obtain the Client ID and Client Secret that Auditoria will use.

  1. In the Workday search bar, type Register API Client for Integrations and press Enter.

  2. On the registration form, configure:

    • Client Name (required): Use a clear name, for example: Auditoria_Client.
    • Enforce Customized Access Token Expiry (optional): Leave unchecked unless your integration requires custom access token expiration.
    • Refresh Token Timeout (in days) (optional): Default 0 Typically, it means no expiry when using non-expiring refresh tokens.
    • Non-Expiring Refresh Tokens (recommended):
      • Select this option for integration clients, unless your security policy requires token rotation.
    • Disabled (optional):
      • Leave unchecked. Use only if you intentionally want to disable the client.
    • Scope (Functional Areas) (required): Add all functional areas required for your integration use case, for example:
      • Integration 
      • Staffing
      • System
      • Workday Everywhere
      • Supplier Accounts
      • Supplier Contracts
      • Suppliers
    • Include Workday Owned Scope (optional): Leave unchecked unless explicitly required.
    • Locked Out due to Excessive Failed Signon Attempts (informational/optional): Leave unchecked; this field is for tracking if the client is locked out.
    • Restricted to IP Ranges (optional): Add allowed IP ranges if your organization enforces IP whitelisting; otherwise, leave blank.
  3. Click OK to complete the registration.

  4. After registration, Workday will display the Client ID and Client Secret.

Important: Record and store the Client ID and Client Secret in a secure password manager or vault. You will need them when configuring the Workday connection in Auditoria.


9. Generate Refresh Token with Updated Permissions

Generate a Refresh Token that ties the API client to your Auditoria ISU.

  1. In the Workday search bar, type View API Client and press Enter.

  2. Navigate to API Clients for Integrations, filter on the client name created above.
  3. Filter the list to find the API client you just created (e.g., filter on Client Name containing Auditoria).

  4. Click the ellipsis (three dots) next to your API client and select:
    API Client > Manage Refresh Tokens for Integrations.

  5. In the Manage Refresh Tokens dialog:

    • Enter or select the ISU from Step 2 (for example, ISU_Auditoria).

    • Click OK.

  6. On the next screen, enable Generate New Refresh Token and click OK.

  7. Workday will display a Refresh Token.

    • Copy this token immediately and store it securely (you will not be able to see it again later).

Important: Keep the Client ID, Client Secret, and Refresh Token confidential.
These values are required to link your Workday tenant to your Auditoria SmartVendor tenant.


10. Get Account Posting Rule Set

To configure Auditoria, you will need to provide the Account Posting Rule Set information from Workday.

Follow these steps to locate and copy the required Account Posting Rule Set ID:

  1. In your Workday search bar, type View Account Posting Rule Set and press Enter.

  2. In the pop-up window, select the appropriate Account Posting Rule Set that Auditoria should use (for example, "Standard Corporate Account Posting Rule"), and click OK.

  3. On the next screen, locate the name of the selected Account Posting Rule Set at the top. Click the three vertical dots (ellipsis) next to the rule set name, hover over Integration IDs, then click View IDs.

  4. Copy the Workday ID displayed in the Integration IDs section. This ID will be required during the system connection configuration in Auditoria.

If you use an account set, also get the Account Set ID:

  1. In the Workday search bar, type View Account Set and press Enter.

  2. In the pop-up window, select your account set (for example, “Corporate”), and click OK.

  3. Click the three vertical dots (ellipsis) next to the account set name, hover over Integration IDs, then click View IDs.

  4. In Reference IDs, copy the ID in the row where Type is Account_Set_ID. You will enter it in Account Set ID when you connect Auditoria.

Note: If you have any Segmented Security configured in Workday for the following business objects, please ensure that the ISU or the Security Group created for the Auditoria–Workday connection is also added to the same security group.
  • Supplier
  • Customers
  • Customer Invoices
  • Supplier Invoices
  • Customer Payments
  • Supplier Payments
  • Purchase Orders
  • Entity

Connect Auditoria SmartVendor (AP Invoices + AP Helpdesk) to Workday ERP

After gathering your Workday connection details (hostname, tenant name, Integration System User credentials, API client credentials, and refresh token), you are ready to set up the connection within Auditoria.

Steps to Connect Auditoria to Workday

  1. Access System Settings:
    • Log in to the Auditoria platform with administrative privileges.
    • Navigate to Administration > System Settings.
  2. Add or Update Workday ERP Connection:
    • In the "Add New Connection" area of System Settings, select the Workday ERP option.
    • To update an existing connection, locate the Workday system tile and click Update.

  1. Enter Required Connection Information:
    • On the ERP Settings page, fill in the following fields with your Workday integration details:
      • Instance Name: Enter a recognizable display name for this connection.
      • Tenant ID: Enter your Workday tenant name.
      • User ID: Enter the Integration System User (ISU) username.
      • User Password: Enter the ISU password.
      • Host Name: Enter the Workday service URL or host address.
      • Client ID: Enter the API Client ID.
      • Client Secret: Enter the API Client Secret.
      • Refresh Token: Enter the generated refresh token.
      • Account Posting Rule Set: Enter the Workday ID you copied in Step 10. Enter - if you don’t use a spend category.
      • Account Set ID: Enter the account set ID you copied in Step 10. Enter - if you don’t use an account set.
      • Entities to sync: After the fields above are complete, select the entities that Auditoria should sync. Until then, the field shows “Please complete connection setting to fetch entities.”
  2. Save and Test Connection:
    • Click Save to submit your settings.
    • The system may validate your credentials and confirm the connection status.
    • Once the setup is complete, proceed to sync entities if prompted or verify that the connection is active.

Notes:

Note: If you encounter authentication or connection issues, verify all credentials and confirm that the required permissions in Workday have been assigned and activated.


Best Practices

  • Distinct, descriptive naming:

    • Example: ISU_Auditoria, ISSG_Auditoria, Auditoria_SmartVendor_AP_Client.

  • Limit UI access for ISU:

    • Select Do Not Allow UI Sessions to restrict access to API/Web Services only.

  • Review permissions regularly:

    • Update Workday permissions as AP Invoices and AP Helpdesk data or workflows evolve.

  • Secure credential storage:

    • Store ISU password, Client ID, Client Secret, and Refresh Token in an enterprise-grade vault.

  • Coordinate with Auditoria:

    • Work with your Auditoria Customer Success Representative during initial setup and when making significant changes (e.g., enabling or changing invoice write-back scope).

  • Document changes and approvals:

    • Maintain a change log for security reviews and audits.

  • Test incrementally:

    • After each major configuration (ISU, group, domain policies, API client, refresh token), test connectivity and data access from both AP Invoices and AP Helpdesk.


Troubleshooting

Issue Possible Solution
Insufficient permissions when connecting from Auditoria Re-check the security group’s Domain Security Policies. Ensure all required AP invoice domains are assigned and activated.
API client or refresh token rejected Confirm you are using the correct Client ID, Client Secret, and Refresh Token. Make sure security changes are activated.
Missing suppliers or invoices in Auditoria Verify that Supplier, Supplier Accounts, and Supplier Invoice domains are included and properly scoped.
Unable to write/post vendor bills Confirm write permissions (Modify / Put) are granted on the Supplier Invoice domains used for write-back.
Tokens or credentials lost or expired Regenerate the refresh token or credentials in Workday and update the configuration in Auditoria.
ISU session timing out too frequently Adjust Session Timeout Minutes for the ISU, in line with your security policies.
Error activating security changes Ensure you have permission to Activate Pending Security Policy Changes and review Workday’s error messages/comments.
Unclear API authentication failure Double-check hostname, tenant name, service URLs, and confirm you are using the correct (prod vs test) credentials.

Glossary

  • ISU (Integration System User):
    A Workday user account dedicated to integrations. UI access is typically disabled.

  • ISSG (Integration System Security Group):
    A Workday security group used to control permissions for integration users.

  • Domain Security Policy:
    Defines what operations (View, Get, Modify, Put, etc.) a security group can perform on a given business domain.

  • API Client:
    OAuth 2.0 client registration in Workday. Provides the Client ID, Client Secret, and Refresh Token used by integrations.

  • WQL (Workday Query Language):
    Workday’s query mechanism, used by Auditoria to read Workday data (including AP supplier, invoice, payment, and PO data) for AP Invoices and AP Helpdesk workflows.

  • AP Invoices:
    Auditoria functionality focused on automating Accounts Payable invoice processing, including extraction, validation, and (optionally) posting supplier invoices to Workday.

  • AP Helpdesk:
    Auditoria functionality focused on vendor inquiry and AP case management, using Workday AP data (suppliers, invoices, payments, POs, contracts) for context and resolution.

  • Tenant:
    Your specific Workday environment (for example, acme-corp-prod), used in Workday URLs.

  • Functional Areas:
    Logical groupings in Workday, such as Suppliers, Supplier Accounts and Supplier Contracts, that you select as the scope of an API client.

Attachments