World Education Services (WES) Integration

World Education Services (WES) evaluates degrees and diplomas earned by candidates abroad to determine their U.S. or Canadian equivalencies. WES provides document-by-document evaluations or course-by-course evaluations. WES can push credential evaluation documents for applicants directly into your Slate database to minimize processing steps by your staff.

This article describes the steps to integrate Slate with WES.

Step 1: Adding credit evaluation material types

All documents imported into Slate must be assigned to a material type. You must either use existing material types or else create new ones for the WES evaluation reports in Database → Materials.

Step 2: Configuring the World Education Services User account

WES uses this service account for authentication when pushing documents into Slate.

To add the World Education Services user account:

1. Go to  Database → Slate Template Library (legacy tool).

2. Select refresh the Slate Template Library.

3. Confirm the browser dialog.

4. Under the Users heading, locate the WES Service Account and select Add. A popup appears.
   

5. Select Add.

Step 3: Adding the World Education Services source format

This source format automatically sweeps for zip files that WES delivers into the /incoming/wes SFTP directory and imports them into Slate.

To add the World Education Services source format:

1. Go to Database → Source Format Library.

2. Add the World Education Services (DIP) source format.

3. Download the sample_file.zip attached to this article.

4. Upload this file to the World Education Services source format. The file contains an index file with only a header row, allowing you to configure the remap settings before receiving a file from WES.
   🔔 Important! Upload the zip file as is. Do not extract the file before uploading it.

5. Once the uploaded file has been processed, configure the remap settings for the source format. Many items have been pre-mapped, including the Material Filename and Material Code destinations. While you can customize any other field mappings, the material destinations are required to import the documents, so you should not change these field mappings.

   

6. On the Value Mappings page, map the Material Code items to the specific material types that your institution will use for the credential evaluation reports. 
   The document types are: 

   • CXC: Course-by-course evaluation

   • DXD: Document-by-document evaluation
     

7. Edit the source format to set the Remap Active flag to Active once you are finished mapping. This will run the import using the settings configured above for all files uploaded on or after the Remap As Of Date.

   

Step 4: Provide the Slate Web Services POST URL to WES

WES must configure their systems to send files to your Slate database automatically.

➡️ To initiate this configuration, follow the steps on their Integrating With Slate page.

Provide WES with the endpoint for your World Education Services source format by selecting Web Services → View on the source format.

Everything has been setup, but when WES is trying to send a file, they are receiving a 401 unauthorized error.

The error which is being received by WES is that they are unable to access Slate to deliver the file. This is caused by the World Education Services user account has not yet been added to your Slate database. Under the Slate Configurations section above, follow the instructions to add the World Education Services (WES) user account.