department-of-veterans-affairs / va.gov-team

Public resources for building on and in support of VA.gov. Visit complete Knowledge Hub:
https://depo-platform-documentation.scrollhelp.site/index.html
283 stars 204 forks source link

SPIKE | Null Claim - Veteran File Number and SSN do not match #64138

Open tblackwe opened 1 year ago

tblackwe commented 1 year ago

Current State: we do not check if the SSN and File Number mismatch until AFTER we have submitted the PDF to BGS. We then throw an exception that is NOT rendered to the Veteran. This results in

This is a Null Claim Situation

Proposed State: We add a check as start of form to determine if File Number and SSN are not the same. If so, we render an error to the Veteran and do not allow them to create a 686/674 claim

tblackwe commented 1 year ago

@tfink419 could you help me identify where in vets-api we get the file number for the Vet?

data-doge commented 1 year ago

Here's some context I have on File # / SSN mismatches (but see TL;DR below, first):

TL;DR: See https://github.com/department-of-veterans-affairs/va.gov-team/issues/56995#issuecomment-1532129932. File # / SSN mismatches are a big, complicated, systemic issue. IMO, the best we can do is:

  1. Report them to MPI to resolve. See https://github.com/department-of-veterans-affairs/va.gov-team/issues/57798.
  2. Fail loudly when we discover a File # / SSN mismatch before jobs are enqueued; and render an appropriate error on the front-end and/or send an error notification email, instructing the veteran to contact VA for support.
  3. Confirm that error notification emails are sent to veterans when we discover a File # / SSN mismatch while one of our jobs are running.

Another thought, it would be great if we could somehow preemptively inform VA call center employees that veterans have a mismatched File # and SSN, so they know how to help veterans, should they call.

tblackwe commented 1 year ago

your TL;DR matches with my own thoughts. You've done a significant amount of due diligence (thank you so much!) that explains why they can be different, but it also showed that this problem needs to be resolved at a higher level.

I agree with your 3 step plan. I'm researching how early in the flow we can detect SSN - File Number mismatch so that we can alert early and not have the veteran create a claim that will ultimately error. I am also going to discuss with Design/Research how we can prevent mismatch from the Veteran manually inputing spouse information.

tblackwe commented 1 year ago

If I reuse the same error as Invalid File Number the error we get is: Private Zenhub Image

The Veteran would see this as soon as they navigated to the add/remove URL.

@djones2113 @juliepedtke Can you have a think on this error message? We can easily use different copy if required. This would be when a Veteran has a SSN that is different from their Valid File Number.

djones2113 commented 1 year ago

@tblackwe since this is a high priority issue my instinct is that we should proceed with this error design (as my understanding is that right now there is no alert letting the Veteran know of any issue) with the exception of changing the second line to reflect the issue (i.e. "The SSN we have on file does not match your Valid File Number.")

I do want to make sure that this is the correct language. I can plan to discuss this in our weekly design sync on Thursday and bring to the CAIA's office hours on Thursday afternoon if needed.

tblackwe commented 1 year ago

@djones2113 sounds good. let me know when it is finalized and I will open the Pull Request.

djones2113 commented 1 year ago

@tblackwe after talking with Laura and Julie P this morning, here are our thoughts:

Since this is a minor change, we think the next logical step would be sharing this change with Julie S for feedback. However, she won't be available to review this until Tuesday at the earliest since she is out this week.

If this issue is very high priority and shouldn't wait until Julie S is back, I think we can proceed with the changes I recommended above and then just plan to check in with her when she returns. Thoughts?

tblackwe commented 1 year ago

It can wait for Julie S. She should sign off on the approach and verbiage.

djones2113 commented 1 year ago

Sounds good! @jstrothman we could use your perspective on this ticket when you're back in office.

Recap:

We are thinking about reusing the Invalid File Number error message (screenshot below) to notify Veterans when their SSNs and Valid File Numbers aren't matching.

We are proposing a minor content change, and therefore we thought that the next logical step was to get your feedback before proceeding.

Proposed changes:

Changing the second line in the error message from "The personal information we have on file is missing your VA File Number" to "The SSN we have on file does not match your Valid File Number."

image

A note about the existing error message: There is a typo in the second line ("The personal information we have on file for your is missing your VA File Number"). This isn't directly related to this ticket but I wanted to flag it. How can we go about notifying the relevant person who can update this error message?

tblackwe commented 1 year ago

@djones2113 that error message is in our scope. I've fixed it in my drafted change.

jstrothman commented 1 year ago

@tblackwe @djones2113 I suspect you already know this from today's discussion and issue #64137 -- but the proposed error msg won't always be accurate. Pasting in notes from today's discussion:

tblackwe commented 1 year ago

as discussed on call with @emilytheis and @jstrothman, Julie S will draft a new version of the error message to use as a stop gap. @steele-lm will create ticket to begin conversations about changing backend requirements

jstrothman commented 1 year ago

If we detect that a Veteran has different File Number and SSN we'll block submission and instruct the Veteran to submit paper version, let's use this text for the error message:

Error heading:

Unfortunately, you'll need to submit a paper version of this 686c form

Error content:

The online form is unable to process submissions where the Veteran's Social Security Number doesn't match the Veteran's File Number. We're working to address this issue, but we don't want to delay your submission. Please visit About VA Form 21-686c to download a pdf you can print.

jstrothman commented 1 year ago

@tblackwe @steele-lm Forgot to mention you in comment above w/error message wording

steele-lm commented 1 year ago

Follow on ticket to uncover root cause an approach to remediating: https://github.com/department-of-veterans-affairs/va.gov-team/issues/65054

tblackwe commented 1 year ago

When we get Backup Submissions to Central Mail processing, SSN mismatch claims will start getting processed by CMS. We can leave the forms as-is for now, while requesting change from BIS to resolve backend validation issue.