Harcama Yönetimi Veri Şablonunuz

/*
This is not a script, but a configuration for the Expensify custom export template.
In the export format editor, create a new column for each line below, using the text on the right as the formula.
*/

// Case ID and Required Attributes
ExpenseReportId: {report:id}
EventTime_Created: {report:created}
EventTime_Submitted: {report:submitted}
EventTime_Approved: {report:approved}
EventTime_Reimbursed: {report:reimbursed}
EventTime_Closed: {report:closed}

// Recommended Attributes
ReportTotalAmount: {report:total}
Submitter: {report:submitter:email}
Approver: {report:approverEmail}
EmployeeDepartment: {report:tag:[Your Department Tag Name]}
PolicyViolationFlag: {report:hasViolations}

// --- Transformation Logic Overview ---
/*
After exporting the CSV with the columns above, you must unpivot the timestamp columns.
1. Load the CSV into a data transformation tool (e.g., Excel Power Query, Python pandas).
2. Select all the timestamp columns (EventTime_Created, EventTime_Submitted, etc.).
3. Use the "Unpivot" function. This will create two new columns: one containing the original column names (e.g., 'EventTime_Created') and another with the timestamp values.
4. Rename the column with the names to `ActivityName` and the column with values to `EventTime`.
5. Clean up the `ActivityName` column by removing the 'EventTime_' prefix to get clean activity names like 'Expense Report Created', 'Expense Report Submitted', etc.
6. For activities that do not have a direct timestamp export (e.g., 'Manager Approved', 'Reimbursement Scheduled'), you can duplicate an existing timestamp column (like 'EventTime_Approved') in your export template and rename it accordingly (e.g., `EventTime_ManagerApproved`). This uses the same timestamp as a proxy for multiple events, which should be noted during analysis.
*/

import requests
import json
import time
import csv
from datetime import datetime

class=class="hl-string">"hl-comment"># --- PLACEHOLDERS: Replace with your actual credentials and settings ---
PARTNER_USER_ID = class="hl-string">'[Your Expensify Partner User ID]'
PARTNER_USER_SECRET = class="hl-string">'[Your Expensify Partner User Secret]'

class=class="hl-string">"hl-comment"># --- CONFIGURATION: Define the export parameters ---
class=class="hl-string">"hl-comment"># Use YYYY-MM-DD format for dates
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-06-30'
class=class="hl-string">"hl-comment"># The exact name of the custom export format you created in Expensify
EXPORT_TEMPLATE_NAME = class="hl-string">'[Your Custom Report Export Template Name]'

API_URL = class="hl-string">'https://integrations.expensify.com/Integration-Server/Doc/v1.0/'
RAW_EXPORT_FILE = class="hl-string">'expensify_raw_export.csv'
EVENT_LOG_FILE = class="hl-string">'expensify_event_log.csv'

def execute_api_job(job_description):
    class="hl-string">"""Submits a job to the Expensify API and returns the response."""
    auth_payload = {
        class="hl-string">'partnerUserID': PARTNER_USER_ID,
        class="hl-string">'partnerUserSecret': PARTNER_USER_SECRET
    }
    data = {
        class="hl-string">'requestJobDescription': json.dumps(job_description),
        class="hl-string">'credentials': json.dumps(auth_payload)
    }
    response = requests.post(API_URL, data=data)
    response.raise_for_status() class=class="hl-string">"hl-comment"># Raises an exception for bad status codes
    return response.json()

class=class="hl-string">"hl-comment"># 1. Trigger the report export job
print(class="hl-string">'Requesting report export from Expensify...')
export_job_desc = {
    class="hl-string">'type': class="hl-string">'exportReport',
    class="hl-string">'credentials': {
        class="hl-string">'partnerUserID': PARTNER_USER_ID,
        class="hl-string">'partnerUserSecret': PARTNER_USER_SECRET
    },
    class="hl-string">'onReceive': {
        class="hl-string">'immediateResponse': [class="hl-string">'returnRandomFileName']
    },
    class="hl-string">'inputSettings': {
        class="hl-string">'type': class="hl-string">'report',
        class="hl-string">'filters': {
            class="hl-string">'startDate': START_DATE,
            class="hl-string">'endDate': END_DATE,
            class="hl-string">'markedAsExported': class="hl-string">'Expensify Export'
        }
    },
    class="hl-string">'outputSettings': {
        class="hl-string">'fileExtension': class="hl-string">'csv',
        class="hl-string">'fileBasename': EXPORT_TEMPLATE_NAME
    }
}

class=class="hl-string">"hl-comment"># The template is passed as a separate parameter for this job type
export_job_desc[class="hl-string">'template'] = fclass="hl-string">'<![CDATA[{EXPORT_TEMPLATE_NAME}]]>'

initial_response = execute_api_job(export_job_desc)
file_name = initial_response.get(class="hl-string">'fileName')

if not file_name:
    raise Exception(fclass="hl-string">'Failed to initiate export. Response: {initial_response}')

print(fclass="hl-string">'Export job started. Waiting for file: {file_name}')

class=class="hl-string">"hl-comment"># 2. Poll for the file until it's ready
while True:
    download_job_desc = {
        class="hl-string">'type': class="hl-string">'download',
        class="hl-string">'credentials': {
            class="hl-string">'partnerUserID': PARTNER_USER_ID,
            class="hl-string">'partnerUserSecret': PARTNER_USER_SECRET
        },
        class="hl-string">'fileName': file_name
    }
    download_response = execute_api_job(download_job_desc)
    if download_response.get(class="hl-string">'responseCode') == 200:
        print(class="hl-string">'File is ready for download.')
        with open(RAW_EXPORT_FILE, class="hl-string">'w', encoding=class="hl-string">'utf-8') as f:
            f.write(download_response[class="hl-string">'fileContents'])
        break
    elif download_response.get(class="hl-string">'responseCode') == 404:
        print(class="hl-string">'File not ready yet, waiting 10 seconds...')
        time.sleep(10)
    else:
        raise Exception(fclass="hl-string">'Failed to download file. Response: {download_response}')

class=class="hl-string">"hl-comment"># 3. Transform the raw export into an event log
print(fclass="hl-string">'Successfully downloaded raw data to {RAW_EXPORT_FILE}. Transforming to event log...')
event_log = []

with open(RAW_EXPORT_FILE, class="hl-string">'r', encoding=class="hl-string">'utf-8') as infile:
    reader = csv.DictReader(infile)
    for row in reader:
        class=class="hl-string">"hl-comment"># Standard report attributes
        report_id = row.get(class="hl-string">'Report ID')
        report_total = row.get(class="hl-string">'Total')
        submitter = row.get(class="hl-string">'Submitter Email')
        department = row.get(class="hl-string">'Submitter Department') class=class="hl-string">"hl-comment"># Assuming this is in your template
        
        class=class="hl-string">"hl-comment"># Helper to create event rows
        def add_event(activity_name, event_time_str, approver=None, violation=None):
            if event_time_str:
                event_log.append({
                    class="hl-string">'ExpenseReportId': report_id,
                    class="hl-string">'ActivityName': activity_name,
                    class="hl-string">'EventTime': event_time_str,
                    class="hl-string">'ReportTotalAmount': report_total,
                    class="hl-string">'Submitter': submitter,
                    class="hl-string">'EmployeeDepartment': department,
                    class="hl-string">'Approver': approver,
                    class="hl-string">'PolicyViolationFlag': violation
                })
        
        class=class="hl-string">"hl-comment"># Activity: Expense Report Created
        add_event(class="hl-string">'Expense Report Created', row.get(class="hl-string">'Created'))

        class=class="hl-string">"hl-comment"># Activity: Expense Report Submitted
        add_event(class="hl-string">'Expense Report Submitted', row.get(class="hl-string">'Submitted'))
        
        class=class="hl-string">"hl-comment"># Activity: Manager Approved / Finance Approved
        class=class="hl-string">"hl-comment"># Assumes approver details are in a single column like class="hl-string">'Approver 1: name@co.com (YYYY-MM-DD), Approver 2: ...'
        class=class="hl-string">"hl-comment"># This logic needs to be adapted to your specific export format.
        approvers_str = row.get(class="hl-string">'Approver History', class="hl-string">'') 
        if class="hl-string">'Manager' in approvers_str: class=class="hl-string">"hl-comment"># Example logic
             class=class="hl-string">"hl-comment"># Complex parsing might be needed here based on your template's format
             add_event(class="hl-string">'Manager Approved', row.get(class="hl-string">'Approved')) class=class="hl-string">"hl-comment"># Simplified, assumes class="hl-string">'Approved' date is manager's

        if class="hl-string">'Finance' in approvers_str: class=class="hl-string">"hl-comment"># Example logic
             add_event(class="hl-string">'Finance Approved', row.get(class="hl-string">'Final Approved')) class=class="hl-string">"hl-comment"># Assumes a separate column for final approval
        else:
             class=class="hl-string">"hl-comment"># Fallback if only one approval date exists
             add_event(class="hl-string">'Finance Approved', row.get(class="hl-string">'Approved'))

        class=class="hl-string">"hl-comment"># Activity: Reimbursement Scheduled
        add_event(class="hl-string">'Reimbursement Scheduled', row.get(class="hl-string">'Reimbursing Start Date')) class=class="hl-string">"hl-comment"># Assumes this column exists

        class=class="hl-string">"hl-comment"># Activity: Reimbursement Executed
        add_event(class="hl-string">'Reimbursement Executed', row.get(class="hl-string">'Reimbursed'))
        
        class=class="hl-string">"hl-comment"># Activity: Report Closed
        add_event(class="hl-string">'Report Closed', row.get(class="hl-string">'Closed'))
        
        class=class="hl-string">"hl-comment"># Activities from Report History Log
        class=class="hl-string">"hl-comment"># This is CRITICAL. Your export template must include the detailed history.
        class=class="hl-string">"hl-comment"># The history is often a multi-line text block in a single CSV cell.
        history_log = row.get(class="hl-string">'Report History', class="hl-string">'')
        for line in history_log.split(class="hl-string">'\n'): class=class="hl-string">"hl-comment"># Assuming newline separated history
            line_lower = line.lower()
            class=class="hl-string">"hl-comment"># Try to extract a timestamp from the history line
            try:
                class=class="hl-string">"hl-comment"># Expensify history format is often like class="hl-string">'MMM DD: ...'
                class=class="hl-string">"hl-comment"># This parsing logic is an example and MUST be adjusted to your format
                timestamp_str = line.split(class="hl-string">':')[0]
                class=class="hl-string">"hl-comment"># A real implementation needs more robust date parsing
                event_time = datetime.now().strftime(class="hl-string">'%Y-%m-%d %H:%M:%S') class=class="hl-string">"hl-comment"># Placeholder for parsed time
            except:
                continue

            if class="hl-string">'added expense' in line_lower:
                add_event(class="hl-string">'Expense Added To Report', event_time)
            elif class="hl-string">'violation' in line_lower:
                add_event(class="hl-string">'Policy Violation Flagged', event_time, violation=True)
            elif class="hl-string">'rejected' in line_lower and class="hl-string">'manager' in line_lower:
                add_event(class="hl-string">'Manager Rejected', event_time)
            elif class="hl-string">'rejected' in line_lower and class="hl-string">'finance' in line_lower: class=class="hl-string">"hl-comment"># Example keyword
                add_event(class="hl-string">'Finance Rejected', event_time)
            elif class="hl-string">'unapproved' in line_lower or class="hl-string">'sent back' in line_lower:
                add_event(class="hl-string">'Report Sent Back For Revision', event_time)
            elif class="hl-string">'exported to' in line_lower or class="hl-string">'posting' in line_lower:
                 add_event(class="hl-string">'Accounting Posted', event_time)

class=class="hl-string">"hl-comment"># 4. Write the final event log file
if event_log:
    with open(EVENT_LOG_FILE, class="hl-string">'w', newline=class="hl-string">'', encoding=class="hl-string">'utf-8') as outfile:
        fieldnames = [class="hl-string">'ExpenseReportId', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'ReportTotalAmount', class="hl-string">'Submitter', class="hl-string">'EmployeeDepartment', class="hl-string">'Approver', class="hl-string">'PolicyViolationFlag']
        writer = csv.DictWriter(outfile, fieldnames=fieldnames)
        writer.writeheader()
        writer.writerows(event_log)
    print(fclass="hl-string">'Event log successfully created at {EVENT_LOG_FILE}')
else:
    print(class="hl-string">'No events were generated. Check the raw export file and script logic.')

/*
This is not a script, but a configuration for the Expensify custom export template.
In the export format editor, create a new column for each line below, using the text on the right as the formula.
*/

// Case ID and Required Attributes
ExpenseReportId: {report:id}
EventTime_Created: {report:created}
EventTime_Submitted: {report:submitted}
EventTime_Approved: {report:approved}
EventTime_Reimbursed: {report:reimbursed}
EventTime_Closed: {report:closed}

// Recommended Attributes
ReportTotalAmount: {report:total}
Submitter: {report:submitter:email}
Approver: {report:approverEmail}
EmployeeDepartment: {report:tag:[Your Department Tag Name]}
PolicyViolationFlag: {report:hasViolations}

// --- Transformation Logic Overview ---
/*
After exporting the CSV with the columns above, you must unpivot the timestamp columns.
1. Load the CSV into a data transformation tool (e.g., Excel Power Query, Python pandas).
2. Select all the timestamp columns (EventTime_Created, EventTime_Submitted, etc.).
3. Use the "Unpivot" function. This will create two new columns: one containing the original column names (e.g., 'EventTime_Created') and another with the timestamp values.
4. Rename the column with the names to `ActivityName` and the column with values to `EventTime`.
5. Clean up the `ActivityName` column by removing the 'EventTime_' prefix to get clean activity names like 'Expense Report Created', 'Expense Report Submitted', etc.
6. For activities that do not have a direct timestamp export (e.g., 'Manager Approved', 'Reimbursement Scheduled'), you can duplicate an existing timestamp column (like 'EventTime_Approved') in your export template and rename it accordingly (e.g., `EventTime_ManagerApproved`). This uses the same timestamp as a proxy for multiple events, which should be noted during analysis.
*/