{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Understand cases in the CRM","siteUrl":"https://docs.peachfinance.com","description":"API and product documentation for Peach Finance, a lending-as-a-service platform."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"understand-cases-in-the-crm","__idx":0},"children":["Understand cases in the CRM"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cases are the core workflow unit in the Peach CRM. Every borrower interaction that requires tracking — a payment dispute, a collections escalation, a compliance review, a bankruptcy filing — is managed through a case. For many configurations, an agent must have an open case to take actions on a borrower's account."]},{"$$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":["case:update"]}," (to modify case status, escalate, snooze, schedule calls, assign ownership, rename, or set do-not-interact)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-cases-track","__idx":1},"children":["What cases track"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A case ties together everything related to a specific borrower situation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status and outcome"]}," — Where the case stands in its lifecycle and how it was resolved."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type-specific details"]}," — Fields relevant to the case type (bankruptcy court info, collections metrics, military duty dates, etc.)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Loan accounts"]}," — Which loans are associated with this case."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Documents"]}," — Evidence, disclosures, or correspondence attached to the case."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Workflow steps"]}," — A guided checklist of actions to complete."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notes"]}," — Agent observations and context, including pinned and sensitive notes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Events"]}," — A timeline of system and agent actions on the case."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AI summary"]}," — An AI-generated summary of the case for quick review."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"case-lifecycle","__idx":2},"children":["Case lifecycle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every case follows a status lifecycle. Status transitions are restricted — you can only move a case to certain statuses from its current status."]},{"$$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 case has been created. A borrower or system reported the situation, but no documents or evidence have been provided yet."]},{"$$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 case is being actively worked. Peach matched the borrower to an external data source, or your team started an internal process."]},{"$$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 case is resolved. An outcome must be set when completing a case."]},{"$$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 case was canceled before completion."]},{"$$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 previously completed or canceled case has been reopened for further work."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"case-outcomes","__idx":3},"children":["Case outcomes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you complete a case, you must select an outcome:"]},{"$$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":"Outcome"},"children":["Outcome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"When to use"},"children":["When to use"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approved"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The borrower's claim or request was approved."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["denied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The borrower's claim or request was denied."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["falsePositive"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The case was opened in error (e.g., an auto-detected match that turned out to be incorrect)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["noOutcome"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The case was completed without a specific approval or denial."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-case-actions-are-disabled","__idx":4},"children":["When case actions are disabled"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All case modification actions — changing status, escalating, snoozing, scheduling calls, assigning ownership, renaming, and setting do-not-interact — are disabled when any of these conditions is true:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Case data is still loading."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You lack the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["case:update"]}," permission."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The case status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The case status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To take action on a completed or canceled case, you must first reopen it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-cases-are-created","__idx":5},"children":["How cases are created"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cases can be created in two ways:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manually by an agent."]}," From the borrower detail page NavColumn, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add case"]}," and choose a case type. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/servicing-operations/agent-portal-crm/crm-create-manage-cases"},"children":["Create and manage cases"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Automatically by the system."]}," Peach's compliance monitoring detects certain conditions (bankruptcy filings, deceased status, OFAC matches, military duty, overdue loans) and creates cases automatically. Auto-created cases generate a review task in the agent's task queue."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-pages","__idx":6},"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-create-manage-cases"},"children":["Create and manage cases"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/servicing-operations/agent-portal-crm/crm-case-types"},"children":["Case types reference"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/servicing-operations/agent-portal-crm/crm-case-workflows"},"children":["Work case workflows"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/servicing-operations/agent-portal-crm/crm-collections-cases"},"children":["Collections cases"]}]}]}]},"headings":[{"value":"Understand cases in the CRM","id":"understand-cases-in-the-crm","depth":1},{"value":"What cases track","id":"what-cases-track","depth":2},{"value":"Case lifecycle","id":"case-lifecycle","depth":2},{"value":"Case outcomes","id":"case-outcomes","depth":3},{"value":"When case actions are disabled","id":"when-case-actions-are-disabled","depth":2},{"value":"How cases are created","id":"how-cases-are-created","depth":2},{"value":"Related pages","id":"related-pages","depth":2}],"frontmatter":{"seo":{"title":"Understand cases in the CRM"}},"lastModified":"2026-10-27T01:01:07.872Z","pagePropGetterError":{"message":"","name":""}},"slug":"/servicing-operations/agent-portal-crm/crm-cases-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}