Notification Examples

For example, if you need to perform a U.S. address correction, the service should accept a (U.S.) Address object from its client and return that Address in a standardized form (canonical spelling and abbreviation of street name parts, elimination of redundant white space, data correction where possible, etc.). The following cases illustrate several notification types.

The example service has been assigned a NotificationSourceType value of "USACS".

Case Reply
Request to submit an Address that is valid and is already in standardized form (i.e., there is nothing to say except "OK"). Notifications: SUCCESS and Address: the original address (or copy).
Request to submit an Address that is valid but not in standardized form (e.g., the word "Boulevard" in a street name is replaced with the standard abbreviation "Blvd" and "Saint Louis" as a city name is replaced with "St Louis"). Notifications: NOTE, "Standard abbreviation applied to street name"}, {NOTE, "Standard abbreviation applied to city name"} and Address: the original address, with modification made to the street name and city name.
Request to submit an Address that is valid but with only a 5-digit postal code: the service supplies the ZIP+4 for the standardized address. Notifications: NOTE, "ZIP+4 suffix added"} and Address: the original address, with the four-digit suffix added to the postal code.
Request to submit an Address that is identifiable by street data, city name, and state code, but with a 5-digit postal code that does not match the other fields. The service supplies the correct ZIP+4 for the standardized address. Notifications: WARNING, "ZIP code corrected to match rest of address"} and Address: the original address, with the replacement postal code.
Request to submit an Address that has an incorrect state code. The original address contains a ZIP+4 postal code belonging to a city/state pair that matches the client's original city and street address. The service supplies the corresponding state code in the corrected address. Notifications: WARNING, "State code corrected to match city and ZIP code"} and Address: the original address, with the revised state code.
Request to submit an Address that has an incorrect state code. The original address contains a ZIP+4 postal code belonging to a city/state pair that matches the client's original city and street address. The service rejects the client's address. Notifications: ERROR, "State code is incorrect for city/ZIP combination"} and Address: empty (either all fields blank or no Address at all).
Request to submit an Address that contains only a single street line (no city, state, or postal code). The service rejects the request. Notifications: {ERROR, "City name is missing and cannot be corrected"}, {ERROR, "State code is missing and cannot be corrected"}, {ERROR, "ZIP code is missing and cannot be corrected"} and Address: empty (either all fields blank or no Address at all)
Request to submit an Address, but the address correction service's database server is down or fails. Notifications: {FAILURE, "Service temporarily unavailable"}, Address: empty (either all fields blank or no Address at all).