USPS API for Mailing and Physical Address validation(Feb release)

[rohanjay10]

• USPS API would be used to validate mailing and physical address for User Profile
• Once built out, this needs feedback from Ops prior to testing
• Built into User Profile, PWA(user info), and SMDB

Look into partial entry of Physical Address fields:
If any one of Physical Address fields Line 1, City, State, and Zip are entered, then all those fields must be required otherwise error given. However as Physical Address is not required all the fields can be blank

[jhflorey]

https://nih.app.box.com/file/1749535340406

[rohanjay10]

Hi @robertsamm @brotzmanmj, @jhflorey is currently working on the USPS API. Is there a date you have in mind for a demo of the API User Interface Experience? This is part of the February release, per the priority list

[rohanjay10]

2/7 Requirements call notes by @Davinkjohnson

1. How to interpret API results (when/what messages to display when minor changes are found vs invalid addresses)

Suggested Address field changes:

• Accepting/Declining - Use “suggested change” modal
• @depietrodeanna to provide language

English/Spanish translations for current messages
• "Invalid Zip code"
• "Address not found"
• Other (@rohanjay10 to add)
• @depietrodeanna to confirm language for these

How/Where error messages would be shown. Address validated after UP submission
• Have the errors display “in line” as a field is filled in check to see whether all boxes are populated if so then call API
• Find a way to force API error results to log in DataDog (check with Tony/Warren for this)
• Interim modal will check if there are any errors for the addresses (and email address) and display those.
• Ideally have a message saying “reach out to NORC if errors continue” – @depietrodeanna to provide

2. How to interpret and respond to PO boxes
   • @jhflorey will do a little more testing to see if API handles
   • No change in the logic for this (hopefully just better flagging whether this IS a PO Box)

3. Mailing vs Physical addresses
   • User Profile - Keep as-is (no changes to display/logic)
   • MyProfiles – no changes for how data are displayed, required vs optional, edited, etc.
   • SMDB - No changes required

4. Edits for MyProfile - Implement API changes (have the API run when a participant clicks “save/submit”)

5. Edits for SMDB – No changes required

6. How to manage Partial addresses• Partial address logic is working as expected – no changes needed
   • Including non required Physical Address fields

@depietrodeanna Error messages to return:

• "Address not found"
• "Invalid Zip Code"
• "Invalid City"
• "Invalid State"
• "Invalid"
Example wording from mockup for suggested address:
"You originally entered xyz, the suggested address is abc, do you want to use the suggested address or keep the original address?"
• Buttons: "keep original address" "use suggested address"

[depietrodeanna]

@rohanjay10 @jhflorey For the errors found during validation within UP submission, add a modal with language stating, “Please fix the errors in the information you entered before continuing. If you are having problems fixing these errors and can't submit your profile, please reach out to the Connect Support Center (Dev, either hyperlink CSC or add “at MyConnect.cancer.gov/support”) for help.”

For address validation, add this error message:
"We can’t verify your address but found a close match. Please confirm the correct address or enter a different address." (Dev- if they want to go back and re-enter a diff address, is there a way to go back with a button that we should reference in the message, or will it be clear that they can go back and make a new entry? Kind of like the "try again" hyperlinked in the example modal from the presentation)

Display both original and suggested addresses alongside these buttons: "Keep address I entered" or "Use suggested address"

tagging @robertsamm and @brotzmanmj to review messaging- let me know if you have any concerns about the above.

I will ask NORC to translate the above messages as well as these phrases:
"Address not found"
"Invalid Zip Code"
"Invalid City"
"Invalid State"
"Invalid"

@rohanjay10 if there are any others please add to this list.