Hearing withdraw routing logic

[chandracarney]

Description

For Legacy appeals with powers of attorney (POAs) that are private attorneys/agents and state/regional organizations, route the appeal to VACOLS location 81 (Case Storage) after the hearing request is withdrawn.

Currently cases with private attorney POAs are sent to VACOLS location 55 when they should have been sent to 81, which causes the case to be sent to a queue for veteran service organization (VSO) to write an informal hearing proposal (IHP) for it. If the Veteran isn't represented by a VSO and they are sent to location 55 in VACOLS, the record sits there for a long time until someone pulls a "55 report" and sees that it's been sitting for X days.

This misrouting requires Hearing Coordinators to go through a long flow in VACOLS to reroute the cases and encourages some to not use the Caseflow tools available.

If the appeal is Legacy, assign it to:

• 55 if the POA / representative type is a Co-located Veteran Service Organization (VSO)
• 81 (Case Storage) if the POA / representative type is any other, including:
  • private agent / attorney
  • state or regional VA organization (e.g. NC Department of Military & Veterans Affairs)
  • no representative
  • a non-co-located Veteran Service Organization (VSO)
• If the appeal is AMA, assign it to Mail (create an EvidenceSubmissionWindow task, which is part of the Mail org)

Acceptance criteria

• Correct routing to location 81

Background/context/resources

According to Caseflow documentation, this routing should already be happening:
https://github.com/department-of-veterans-affairs/appeals-team/blob/master/Project%20Folders/Caseflow%20Projects/Hearings/Hearing%20Schedule/Tech%20Specs/HearingTaskFlow.md#task-hierarchy

Legacy Appeal Flow:

• Withdrawn Hearing Request (No Hearing Scheduled) Flow - The user cancels the ScheduleHearingTask, the Hearing task is automatically closed, and we move the appeal to location 81 (case storage) or 55 (if VSO or co-located)
• Canceled Hearing Flow - We close the DispositionTask, the HearingTask is automatically closed, and we move the appeal to location 81 (case storage) or 55 (if VSO or co-located)

AMA Appeal Flow:

• Withdrawn Hearing Request (No Hearing Scheduled) Flow - The user cancels the ScheduleHearingTask and the HearingTask is automatically closed"
• Canceled Hearing Flow - We cancel the DispositionTask and the HearingTask is automatically closed

Technical notes

• POA hash
• Line 97 in the ScheduleHearingTask model
• Possibility to reverse logic

Open questions

• Can we tell the difference between VSO and state/regional VA or state or regional VA organization?
• BGS has the distinction but when pulling it into Caseflow, we don't have that level of granularity.

Related tickets (routing)

• Introduce granularity between VSOs and state / regional VA organization Introduce granularity between VSOs and state / regional VA organization  #14297
• Allow Hearing Branch to change docket without cancelling or postponing Allow Hearing Branch to change docket without cancelling or postponing #12653
• Automatically transfer No Show hearing tasks Automatically transfer No Show hearing tasks #12539