USPS Module
  • 17 Apr 2024
  • 2 Minutes to read
  • Dark
    Light

USPS Module

  • Dark
    Light

Article summary

Module Details

Last Modified11/03/2021
Installation LocationGithub 
Requires Restart?No
Step Location INTEGRATION > USPS
Settings Location System > Settings > USPS Settings
Prerequisites

An active account with USPS at Web Tools APIs; refer to their Development Guide for more information

The USPS (United States Postal Service) Module allows users to integrate with the USPS Web Tool Kit API, allowing developers access to the online services of the USPS. The API provides easy access to shipping information and services for customers. By integrating these APIs into a website, customers can utilize the functions provided by the USPS without ever leaving the website. Once the APIs are integrated into a website, the USPS Shipping API Server communicates over HTTP using XML (Extensible Markup Language). The USPS Module provides users with pre-built steps to get address information and validate the information. In addition to the USPS Module, the Get Address Information step under Integration > Google can return similar results, including the latitude and longitude of an address.


Configuration

In the Decisions platform, navigate System > Settings and click USPS Settings. From the Edit USPS Settings window, enter the UserId for the USPS Account. Click SAVE.


USPS Steps

The Flow steps for the USPS Module are found  in the Toolbox under INTEGRATION > USPS. Each step's input parameters can be configured on the Properties panel.

Get Cities By Zips step

The Get Cities By Zips step allows the user to enter a list of zip codes. The step will return the city of each zip code entered.

Input ParameterDescription
Zip 5 CodesString list of Zip Codes.


Get City By Zip

The Get City By Zip step allows the user to enter a zip code. The step will output the city of the zip code entered.

Input ParameterDescription
ZipZip code of a city.


Get Information By Zip

The Get Information By Zip allows a user to enter a zip code and have the city, zip, and state, 

Input ParameterDescription
ZipZip Code.


Get Zip By City 

The Get Zip By City step uses an address field, city, and state to get the zip code.

Input ParameterDescription
Address1The physical address of the location.
Address2The second line of address (i.e. apartment number, suite number, or other address designation that is not part of the physical address).
CityThe city of the location address.
StateThe state of the location address.


Is Zip For City

The Is Zip Valid For City is a Rule step that evaluates if the city and zip entered are correct matches.

Input ParameterDescription
CityCity of a location.
ZipZIP Code of a location.


Normalize Address

The Normalize Address step takes in an address will output the full address from the USPS database with the four-digit zip code extension.

Input ParameterDescription
Address1The physical address of the location.
Address2The second line of address (i.e. apartment number, suite number, or other address designation that is not part of the physical address).
CityThe city of the location address.
StateTwo-letter abbreviation of the state of the location address.


For further information on Modules, visit the Decisions Forum.



Was this article helpful?