For an overview of the feature, see: Address Validation Using Vertex Web Services.

For information on how to enable address validation using Vertex Web Services, see: Enabling Address Validation Using Vertex Web Services

The Address Validation using Vertex Web Services feature enables payroll administrators to validate one person address at a time. To validate multiple addresses at the same time, run the Validate US Addresses using Vertex Web Services concurrent program.

Run this program from the Submit Request window.

   To run the Validate US Addresses using Web Services program:

1. Select Validate US Addresses using Web Services in the Name field.

2. Enter the following parameters. Note that if the optional parameters are left blank, then all the person primary addresses and location addresses will be validated.

   Parameter	Optional or Mandatory	Description
   Address Type	Optional	Select either value: Location Address Person Primary Address
   State	Optional	Select the state that the application must use to validate addresses.
   Skip already validated Address	Optional	If the value is set to Yes, then this concurrent program validates only those addresses that were not validated earlier using Vertex Web Services This is the default value for this parameter. If this parameter is set to No, then the program validates all the addresses, based on the selection criteria even if the addresses were validated earlier using Vertex Web Services.
   Validate from Year (YYYY)	Optional	Enter the year from which the addresses must be validated. This parameter is applicable to person addresses only.
   Person	Optional	Select the person whose address details must be validated. This parameter gets enabled only if Person Primary Address is selected as the Address Type. This parameter displays all the persons in the business group. This list gets filtered if a state is selected or Validate from Year (YYYY) field is entered.
   Location	Optional	Select the location for which address details are to be validated. This parameter gets enabled only if Location Address is selected as the Address Type. This parameter displays all the US locations by default. This list gets filtered if a state is selected.
   Output Report Type	Optional	Select the output report type that you want the program to generate: Full Output: A detailed output is generated for all the addresses. Updated and Invalid Addresses: The output reports only the updated and invalid addresses.
   MODE	Optional	This parameter provides the option either to perform only address validation or to commit the Vertex recommended addresses to the database. REVIEW: The concurrent program performs the address validation without making the actual changes to any addresses in the system. The program still generates the address validation results in the report output so they can be reviewed prior to running the program in the COMMIT mode. COMMIT: The concurrent program updates the address in the Oracle HR system with the Vertex recommended address and displays messages for the changed address in the output file.
   Output Report Format	Mandatory	Select Comma Delimited (.CSV) or HTML. HTML is the default value. The .csv file is a spreadsheet file with filter capabilities. The HTML file provides details in various sections.

   Viewing the Program Output:

The program output file provides the following information:

• Person Primary Addresses and Location Addresses validated along with the existing details and Vertex recommended details.

• Addresses for which validation ends in error due to incorrect address details with the response provided by Vertex. If there is any connectivity issue, then employees will be skipped from processing after 5 employees end in error with connectivity related issues.

• If an address is incorrect or not locatable, then Vertex will indicate that no correction could be provided.

Columns in the Output File

Use the following columns in the output file to get information on the validations and updates performed by the concurrent program. If the output file is a comma-delimited file (.csv), then you can filter the data in the spreadsheet.

• State: You can use this column to identify states with the local taxation address such as Pennsylvania and Ohio and prioritize updates to incorrect addresses.

• Details:

  • If REVIEW is selected as the MODE parameter value, then the column heading is named "Details to be Updated".

  • If COMMIT is selected as the MODE parameter value, then the column heading is named "Details Updated".

• Validation Status:

  • Shows whether address validation is successful or validation ended in an error.

  • Indicates address details and status using the following descriptions:

    Recommendation Accepted

    Recommendation not accepted

    Address Validated

    Address not validated

    Postal Address

    Taxation Address

    Payroll Professional

    Self-Service User

  Additionally, there are separate columns for primary resident address and taxation address that show the status of address validation.

• Recommendations bypassed: Shows address details for which recommendation provided by Vertex has been bypassed. This column will also indicate if it is the employee or the Payroll Professional who has bypassed the recommendations.

  • For Person Primary Address, the users shown are Employee or Payroll Professional.

  • For Location Address, the user shown is Payroll Professional.

When addresses are validated using the concurrent program, recommendations provided by Vertex are used to update the addresses using the following rules:

1. If a self-service user has entered the address and skipped Vertex recommendations, then the concurrent program skips the Vertex recommendations for that address. But the concurrent program will populate the Taxation address if Vertex recommends any.

2. If an address was not validated earlier, then recommendations provided for both the Address and Taxation Address are updated.

3. If Multiple Taxation Addresses are recommended by Vertex and the user-entered taxation address is different from the recommended addresses, then first of the recommended taxation addresses is updated as the taxation address. If an existing taxation address matches any of the recommended taxation addresses, then update will not be made. If there is no user-entered taxation address, then the first of the recommended taxation address is updated as the taxation address. The output file includes the recommended details and details which were present earlier. This will help the payroll administrator to review in case if they wish to see what happened to a particular employee address.