대출 실행 데이터 템플릿

This extraction is configured using the Encompass report builder UI, not a script. The configuration below describes the fields and filters to apply.

**Report Type**: Custom Report
**Primary Data Source**: Milestone Log

**Columns to Include (Field ID in brackets are examples):**
*   `LoanApplicationId`: [Loan.LoanNumber]
*   `ActivityName`: [Milestone.Name]
*   `EventTimestamp`: [Milestone.CompletedDate]
*   `EventEndTime`: [Milestone.CompletedDate] (Note: Milestone logs typically only provide a completion timestamp, which can be used for both start and end if granular duration is not available.)
*   `AssignedLoanOfficer`: [Loan.LoanOfficer]
*   `LoanProductType`: [Loan.LoanProgram]
*   `LoanAmount`: [Loan.LoanAmount]
*   `DecisionOutcome`: [Underwriting.Decision]
*   `ApplicationChannel`: [Loan.ApplicationSource]

**Filters to Apply:**
1.  **Date Range Filter:**
    *   Field: `[Milestone.CompletedDate]`
    *   Operator: `is between`
    *   Value: `[Specify Start Date]` and `[Specify End Date]`

2.  **Activity Name Filter:**
    *   Field: `[Milestone.Name]`
    *   Operator: `is one of`
    *   Values (Map the required activities to your organization's specific Encompass Milestone names. The following are common examples):
        *   'File Started' (for Loan Application Created)
        *   'Initial Disclosures Sent' (for Initial Disclosures Sent)
        *   'Processing Docs Requested' (for Supporting Documents Requested)
        *   'Processing Docs Received' (for Supporting Documents Received)
        *   'Credit Ordered' (for Credit Check Completed)
        *   'Appraisal Received' (for Appraisal Received)
        *   'Submitted to Underwriting' (for Underwriting Commenced)
        *   'Underwriting Decision Complete' (for Underwriting Decision Rendered)
        *   'Approved with Conditions' (for Loan Approved with Conditions)
        *   'Conditions Cleared' (for Conditions Cleared)
        *   'Clear to Close' (for Clear To Close Issued)
        *   'Closing Disclosure Sent' (for Closing Disclosures Sent)
        *   'Docs Signed' (for Loan Documents Signed)
        *   'Funded' (for Funds Disbursed)
        *   'Denied' (for Loan Denied)
        *   'Withdrawn' (for Application Withdrawn)

import requests
import pandas as pd
import json
import time
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings --- #
class=class="hl-string">"hl-comment"># Replace with your actual credentials and API endpoint
CLIENT_ID = class="hl-string">'[Your_Client_ID]'
CLIENT_SECRET = class="hl-string">'[Your_Client_Secret]'
API_BASE_URL = class="hl-string">'https://api.elliemae.com' 

class=class="hl-string">"hl-comment"># Set the date range for the loan search
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-12-31'

class=class="hl-string">"hl-comment"># --- Mappings and Field Definitions --- #
class=class="hl-string">"hl-comment"># CRITICAL: Update keys to match the milestone names in your Encompass instance
MILESTONE_TO_ACTIVITY_MAPPING = {
    class="hl-string">'Application': class="hl-string">'Loan Application Created',
    class="hl-string">'Initial Disclosures Sent': class="hl-string">'Initial Disclosures Sent',
    class="hl-string">'Docs Requested': class="hl-string">'Supporting Documents Requested',
    class="hl-string">'Docs Received': class="hl-string">'Supporting Documents Received',
    class="hl-string">'Credit Ordered': class="hl-string">'Credit Check Completed',
    class="hl-string">'Appraisal Received': class="hl-string">'Appraisal Received',
    class="hl-string">'Submitted': class="hl-string">'Underwriting Commenced',
    class="hl-string">'Approved': class="hl-string">'Underwriting Decision Rendered',
    class=class="hl-string">"hl-comment"># Note: class="hl-string">'Loan Approved with Conditions' is often the same as the class="hl-string">'Approved' milestone.
    class=class="hl-string">"hl-comment"># The class="hl-string">'DecisionOutcome' attribute will provide the specific status.
    class="hl-string">'Approved with Conditions': class="hl-string">'Loan Approved with Conditions',
    class="hl-string">'Conditions Cleared': class="hl-string">'Conditions Cleared',
    class="hl-string">'Clear to Close': class="hl-string">'Clear To Close Issued',
    class="hl-string">'Closing Disclosure Sent': class="hl-string">'Closing Disclosures Sent',
    class="hl-string">'Docs Signed': class="hl-string">'Loan Documents Signed',
    class="hl-string">'Funded': class="hl-string">'Funds Disbursed',
    class="hl-string">'Denied': class="hl-string">'Loan Denied',
    class="hl-string">'Withdrawn': class="hl-string">'Application Withdrawn'
}

class=class="hl-string">"hl-comment"># Encompass Field IDs for recommended attributes. Verify these for your instance.
FIELD_IDS = {
    class="hl-string">'AssignedLoanOfficer': class="hl-string">'3',       class=class="hl-string">"hl-comment"># Loan Officer Name
    class="hl-string">'LoanProductType': class="hl-string">'19',      class=class="hl-string">"hl-comment"># Loan Program
    class="hl-string">'LoanAmount': class="hl-string">'1109',     class=class="hl-string">"hl-comment"># Base Loan Amount
    class="hl-string">'DecisionOutcome': class="hl-string">'3183',  class=class="hl-string">"hl-comment"># Underwriting Decision
    class="hl-string">'ApplicationChannel': class="hl-string">'4009'  class=class="hl-string">"hl-comment"># Application Method
}

def get_access_token():
    class="hl-string">"""Authenticates with the API and returns an access token."""
    token_url = fclass="hl-string">'{API_BASE_URL}/oauth2/v1/token'
    headers = {class="hl-string">'Content-Type': class="hl-string">'application/x-www-form-urlencoded'}
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET
    }
    try:
        response = requests.post(token_url, headers=headers, data=payload)
        response.raise_for_status()
        return response.json()[class="hl-string">'access_token']
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error obtaining access token: {e}")
        return None

def get_loan_guids(token):
    class="hl-string">"""Fetches a list of loan GUIDs within the specified date range."""
    pipeline_url = fclass="hl-string">'{API_BASE_URL}/v3/loanPipeline'
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}'}
    payload = {
        class="hl-string">'filter': {
            class="hl-string">'operator': class="hl-string">'and',
            class="hl-string">'terms': [
                {class="hl-string">'canonicalName': class="hl-string">'Loan.LastModified', class="hl-string">'matchType': class="hl-string">'greaterThanOrEquals', class="hl-string">'value': START_DATE},
                {class="hl-string">'canonicalName': class="hl-string">'Loan.LastModified', class="hl-string">'matchType': class="hl-string">'lessThanOrEquals', class="hl-string">'value': END_DATE}
            ]
        },
        class="hl-string">'fields': [class="hl-string">'Loan.GUID']
    }
    try:
        response = requests.post(pipeline_url, headers=headers, json=payload)
        response.raise_for_status()
        return [loan[class="hl-string">'Loan.GUID'] for loan in response.json()]
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error fetching loan pipeline: {e}")
        return []

def main():
    class="hl-string">"""Main function to orchestrate the extraction process."""
    print(class="hl-string">"Starting Encompass data extraction...")
    token = get_access_token()
    if not token:
        return

    print(fclass="hl-string">"Fetching loan GUIDs between {START_DATE} and {END_DATE}...")
    loan_guids = get_loan_guids(token)
    if not loan_guids:
        print(class="hl-string">"No loans found in the specified date range.")
        return

    print(fclass="hl-string">"Found {len(loan_guids)} loans. Processing each one...")
    all_events = []
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}'}

    for i, guid in enumerate(loan_guids):
        print(fclass="hl-string">"Processing loan {i + 1}/{len(loan_guids)} (GUID: {guid[:8]}...)")
        
        class=class="hl-string">"hl-comment"># Fetch attributes
        fields_url = fclass="hl-string">'{API_BASE_URL}/v3/loans/{guid}/fieldReader'
        field_values = {}
        try:
            field_ids_list = list(FIELD_IDS.values())
            response = requests.post(fields_url, headers=headers, json=field_ids_list)
            response.raise_for_status()
            fields_data = response.json()
            field_id_to_key = {v: k for k, v in FIELD_IDS.items()}
            for item in fields_data:
                key = field_id_to_key.get(item[class="hl-string">'fieldId'])
                if key:
                    field_values[key] = item[class="hl-string">'value']
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Could not fetch fields for loan {guid}: {e}")

        class=class="hl-string">"hl-comment"># Fetch milestones
        milestones_url = fclass="hl-string">'{API_BASE_URL}/v3/loans/{guid}/milestones'
        try:
            response = requests.get(milestones_url, headers=headers)
            response.raise_for_status()
            milestones = response.json()

            for milestone in milestones:
                milestone_name = milestone.get(class="hl-string">'milestoneName')
                activity_name = MILESTONE_TO_ACTIVITY_MAPPING.get(milestone_name)
                completed_date = milestone.get(class="hl-string">'completedDate')

                if activity_name and completed_date:
                    event = {
                        class="hl-string">'LoanApplicationId': guid,
                        class="hl-string">'ActivityName': activity_name,
                        class="hl-string">'EventTimestamp': completed_date,
                        class="hl-string">'EventEndTime': completed_date,  class=class="hl-string">"hl-comment"># For point-in-time events
                        class="hl-string">'AssignedLoanOfficer': field_values.get(class="hl-string">'AssignedLoanOfficer'),
                        class="hl-string">'LoanProductType': field_values.get(class="hl-string">'LoanProductType'),
                        class="hl-string">'LoanAmount': field_values.get(class="hl-string">'LoanAmount'),
                        class="hl-string">'DecisionOutcome': field_values.get(class="hl-string">'DecisionOutcome'),
                        class="hl-string">'ApplicationChannel': field_values.get(class="hl-string">'ApplicationChannel')
                    }
                    all_events.append(event)
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Could not fetch milestones for loan {guid}: {e}")
        
        class=class="hl-string">"hl-comment"># Small delay to respect API rate limits
        time.sleep(0.1)

    if not all_events:
        print(class="hl-string">"No events were generated. Check milestone mappings and API responses.")
        return

    print(class="hl-string">"Extraction complete. Creating CSV file...")
    df = pd.DataFrame(all_events)
    df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'EventTimestamp'])
    df[class="hl-string">'EventEndTime'] = pd.to_datetime(df[class="hl-string">'EventEndTime'])
    
    output_filename = class="hl-string">'encompass_loan_origination_event_log.csv'
    df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%f')
    print(fclass="hl-string">"Successfully created '{output_filename}'.")

if __name__ == class="hl-string">"__main__":
    main()