{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Understand supercases","siteUrl":"https://docs.peachfinance.com","description":"API and product documentation for Peach Finance, a lending-as-a-service platform.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"understand-supercases","__idx":0},"children":["Understand supercases"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supercases manage actions that affect many borrowers at once — natural disasters, system-wide policy changes, or bulk account modifications. Unlike regular cases that belong to a single borrower, a supercase operates at the company level and creates subcases across multiple borrowers simultaneously."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Availability:"]}," All clients"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required permissions:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supercase:update"]}," (to create and modify supercases); ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supercase:bulk.send"]}," (to send bulk emails); ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supercase:bulk.update"]}," (to close subcases in bulk)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-supercases-differ-from-regular-cases","__idx":1},"children":["How supercases differ from regular cases"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Regular cases belong to a single borrower and are accessed from the borrower detail page. Supercases belong to a company and are accessed from the company view. A supercase manages a population of affected borrowers and can create, update, and close subcases across all of them at once."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Regular case"},"children":["Regular case"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Supercase"},"children":["Supercase"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scope"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One borrower"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Many borrowers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Access"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/crm/borrowers/:borrowerId/cases/:caseId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/crm/companies/:companyId/supercases/:caseId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Created from"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Borrower detail NavColumn"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company view NavColumn"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Subcases"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Creates subcases on each affected borrower"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bulk actions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Close subcases, send bulk emails, add global notes, set do-not-interact across all subcases"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"access-the-company-view","__idx":2},"children":["Access the company view"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/crm/companies/:companyId"]}," to view supercases for a company. The page has two parts:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NavColumn sidebar (left)"]}," — Displays a list of all supercases for this company, with an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add supercase"]}," button at the top. Open supercases appear first, followed by a collapsible section for completed and canceled supercases."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Content area (right)"]}," — Displays the selected supercase's detail view. If no supercase is selected, a placeholder message appears."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supercase-lifecycle","__idx":3},"children":["Supercase lifecycle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supercases follow the same status lifecycle as regular cases:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Can transition to"},"children":["Can transition to"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["initiated"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The supercase has been created."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processing"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The supercase is being actively worked — populations uploaded, subcases created, bulk actions in progress."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["initiated"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The supercase and all related work is resolved."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reopened"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The supercase was canceled."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reopened"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reopened"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A completed or canceled supercase has been reopened."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When completing a supercase, you must select an outcome: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approved"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["denied"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["falsePositive"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["noOutcome"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-supercase-actions-are-disabled","__idx":4},"children":["When supercase actions are disabled"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All supercase modification actions are disabled when any of these conditions is true:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supercase data is still loading."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You lack the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supercase:update"]}," permission."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The supercase status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The supercase status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Bulk email additionally requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supercase:bulk.send"]},". Closing subcases additionally requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supercase:bulk.update"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-pages","__idx":5},"children":["Related pages"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/servicing-operations/agent-portal-crm/crm-supercases-manage"},"children":["Manage supercases"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/servicing-operations/agent-portal-crm/crm-supercases-types"},"children":["Supercase types reference"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/servicing-operations/agent-portal-crm/crm-cases-overview"},"children":["Understand cases in the CRM"]}]}]}]},"headings":[{"value":"Understand supercases","id":"understand-supercases","depth":1},{"value":"How supercases differ from regular cases","id":"how-supercases-differ-from-regular-cases","depth":2},{"value":"Access the company view","id":"access-the-company-view","depth":2},{"value":"Supercase lifecycle","id":"supercase-lifecycle","depth":2},{"value":"When supercase actions are disabled","id":"when-supercase-actions-are-disabled","depth":2},{"value":"Related pages","id":"related-pages","depth":2}],"frontmatter":{"seo":{"title":"Understand supercases"}},"lastModified":"2026-06-11T18:15:20.912Z","pagePropGetterError":{"message":"","name":""}},"slug":"/servicing-operations/agent-portal-crm/crm-supercases-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}