Troubleshooting: Strategic Sourcing Supplier Connector

Validation Error Details: Addresses should be present

You don’t have an address for a supplier in Workday but Strategic Sourcing requires an address for the supplier.

Access
Supplier Profile
Onboarding Profile Fields
in your settings.
Clear the
Require on profile
check boxes for
Addresses
and
Address Country
.

Validation Error: An error was encountered while attempting to copy [Supplier Name] to WSS

There are duplicate reference IDs for data on the same supplier. These are commonly duplicate Address reference IDs.

Review the Integration Trace file to identify the Reference IDs that are duplicate for supplier information like address, contacts, phone numbers or bank information.
Delete duplicate information.
Create new Reference IDs.

Validation Error: Invalid Number: the number is not recognized. Verify the country phone number.

Phone validations have been configured in your Workday tenant, in the

Global

tab of your tenant setup.

Ensure no extra spaces and additional characters are in the

Phone Number

field on the supplier in Strategic Sourcing.

Validation Error Details: tax_ids should be present

The

Tax ID

is configured as required in the Strategic Sourcing Supplier Profile, but the supplier in Workday doesn't have a tax ID.

You can add a tax ID to the supplier in Workday, or:

Access
Supplier Profile
Onboarding Profile Fields
in your settings.
Clear the
Require on profile
check box for
Tax ID
.

Validation Error: An unexpected error occurred while updating the supplier group configuration in WSS, some configuration may not have been updated. Detail Processing error occurred. The task submitted is not authorized.

The

To WSS

and

From WSS

values should be mapped to your Strategic Sourcing custom fields.

Work with your deployment consultant to review your integration maps setup for the Supplier Connector.
Update your Strategic Sourcing custom fields in
Settings
Supplier Profile Custom Fields
.

Validation Error: Default Payment Type Reference is required.

Selection options for the

Accepted Payment Types

custom field in Strategic Sourcing don't match the selection options for reference IDs that are in Workday.

Work with your deployment consultant to review your integration maps setup for the Supplier Connector.
Update your Strategic Sourcing custom fields in
Settings
Supplier Profile Custom Fields
.

Validation Error: An unexpected error occurred while updating the address components configuration in Scout, some configuration may not have been updated.

Values set within the integration attributes for any of these fields are invalid:

Workday API Client ID
Workday API Client Secret
Workday API Refresh Token

Review and update API tokens if necessary and re-test the integration.

Detail: error from returned HTTP status: 401 Unauthorized or HTTP status: 403 Forbidden {"message": "forbidden"}

Your credentials have become invalid. This can happen when:

The user who initiated the integration was disabled.
The integration configuration was copied and is no longer valid.
Values set within the integration attributes for the API Key and API User Token fields or User Email field are invalid..

Create a new personal API token in Strategic Sourcing when you have the Company Admin role. Input the new token information.

Validation Error: Name has already been taken

Strategic Sourcing doesn't allow duplicate supplier names.

Rename suppliers in Workday with unique names. For example, use the Workday ID as the differentiator:
S-00001 Acme Inc.
Use the
Alternate Names
tab on a supplier record in Workday to add the actual supplier name, ensuring accuracy in downstream processes.

You do these steps in bulk by extracting data from Workday and Strategic Sourcing into an Excel file to compare duplicates.

Validation Error: Last name must not be empty

In Workday, some supplier contact countries do not require last names, but the Strategic Sourcing Connector requires them.

Access the
Maintain Name Components by Country
task in Workday.
Select the country that doesn't require a last name.
In
Name Components
, select the
Required
check box in the row for last or given name.

Validation Error: postal_code Postal code must be 4 digits followed by 2 letters.

You can receive this error if you have suppliers in Egypt or Costa Rica.

Correct the postal codes of your suppliers. You can also:

Access the
Maintain Localization Settings
task.
In
Contact Information
, remove the postal code validations for Costa Rica and Egypt.

Validation Error: postal_code must be 3 or 5 digits.

You can receive this error if you have suppliers with addresses in Taiwan.

Correct the postal codes of your suppliers. You can also:

Access the
Maintain Localization Settings
task.
In
Contact Information
, remove the postal code validations for Taiwan.

Validation Error: Processing error occurred. The task submitted is not authorized.

The Supplier Connector security group in Workday doesn't have all of the correct

Domain Security Policy

permissions.

In Workday:

From the related actions menu of the security group, select
Security Group
Maintain Domain Permissions for Security Group
.
In
Domain Security Policies permitting Put access
, add the
Set Up: Supplier Contacts
option.

Validation Error: error from returned HTTP status: 403 {"error":"permission denied","code":"S22"}

The Supplier Connector security group in Workday doesn't have all of the correct

Domain Security Policy

permissions.

In Workday:

From the related actions menu of the security group, select
Security Group
Maintain Domain Permissions for Security Group
.
Add the
Report: Supplier
and
Set Up: Supplier
options to these fields:
Domain Security Policies permitting Modify access
Domain Security Policies permitting View access
Access the
Register API Client for Integrations
task.
Enter the
Client Name
.
From the
Scope (Functional Areas)
prompt, select
Integrations
and
Suppliers
.
Copy the Client ID and Client Secret and store them in a secure location. You will copy these values into the Integration Attributes.

Error from returned HTTP status: 422 {"errors":[{"source":{"pointer":"/data/attributes/deselected_option_ids"},"title":"Validation Error","detail":"deselected_option_ids Option name is selected"}]} - Error occurs when classification are set as inactive

A classification that is present on a supplier is made inactive.

Remove the classification from suppliers in Workday before inactivating the classification.

Error: HTTP status: 422 {"errors":[{"source":{"pointer":"/data/attributes/base"},"title":"Validation Error","detail":"Cannot delete record because dependent supplier companies exist"}]}error from returned HTTP status: 422 {"errors":[{"source":{"pointer":"/data/attributes/supplier_classification_fields.external_id"},"title":"Validation Error","detail":"supplier_classification_fields.external_id has already been taken"}

You updated reference IDs for in-use supplier classifications in Workday.

Revert the reference IDs to the previous IDs synched to Strategic Sourcing.

Processing error occurred. Duplicate insert on index: Supplier-External Sourceable ID-External Sourceable ID

You create a new supplier in Strategic Sourcing that already exists as an inactive supplier in Workday and attempt to update the External ID of the new supplier.

Suppliers that have an

Inactive

status in Workday can still be added to Strategic Sourcing events. To enable suppliers with an

Inactive

status in the integration for Strategic Sourcing users, update

Supplier Status

on the integration system. See Workday Supplier Status in Strategic Sourcing.

Error: Postal code must be # of digits.

A postal code is missing or the postal code validations on the

Submit Supplier EIB

have been turned off. The integration system specifies what format the postal code must be in. These error messages vary by supplier based on the postal code requirement for their region.

Strategic Sourcing validates postal codes. In Workday, turn on postal code validations on the

Submit Supplier EIB

.

An error has occurred while processing [Supplier Name]: You must include a supplier contact email, which must be a Work type email

The only email type for a supplier contact is set to

Home

or the supplier contact doesn't have an email address.

Access the
Supplier Contacts
tab of the supplier in Workday.
Click
Edit
in the row with the name of the supplier contact.
In the
Contact Information
tab, navigate to
Email
.
In the
Type
prompt, select
Work
.

Validation Error Details: bic Bank Identification Code (BIC) incorrectly formatted. Refer to SWIFT guidelines for correct format

The BIC is in an incorrect format.

Correct the BIC or remove the incorrect code to send the supplier to Strategic Sourcing. If you remove the code, you must temporarily update your settings in Strategic Sourcing:

Access
Supplier Profile
Onboarding Profile Fields
in your settings.
Clear the
Require on profile
check box for
Bank Account Country
.

Message Summary: Patching Address Component Rules for Country

Maintain Localization Settings

is enabled in Workday for various countries. This is most commonly seen on the

City

prompt in Workday.

Temporarily disable localization settings and re-run the Supplier Connector. This will allow the supplier to pass into Workday and localization settings can then be re-enabled after the sync. Localization settings is a tenant setting and may affect other areas of Workday. If possible localization settings should stay disabled, so the suppliers can pass from Strategic Sourcing to Workday without issue.

Access the
Maintain Localization Settings
task in Workday. Select the contact information area.
Navigate to the
City
prompt in the
Localized Field
column.
Remove the country noted in the error message from the
Allow for Countries or Regions
column. If there are multiple countries, select
Ok
.

Validation error occurred. 1 or more of the addresses you've selected are currently in use on an active supplier remit-to connection. To update or delete an address either remove it from the remit-to connection, or deactivate the remit-to connection.

An address that you are attempting to update or delete in Strategic Sourcing is currently used on a remit-to connection on the supplier.

Access the supplier in Workday and select the
Supplier Connections
tab.
Under
Remit-To Connections
, click
Edit
. Change the
Remit To Connection Status
field to
Inactive
.
Click
Submit
.
Access the
Contact Information
tab on the supplier and click
Edit
.
In the
Address
section, for the address you made inactive select the
Delete
checkbox.
Click
Submit
.