เทมเพลตข้อมูลกระบวนการชำระเงินเจ้าหนี้การค้า

import pandas as pd
import numpy as np
from datetime import datetime

class=class="hl-string">"hl-comment"># CONFIGURATION
class=class="hl-string">"hl-comment"># Update these filenames to match your exported files
FILE_BILLS = class="hl-string">'AP_Bills.csv'
FILE_PAYMENTS = class="hl-string">'AP_Payments.csv'
class=class="hl-string">"hl-comment"># Set to None if Audit History is unavailable
FILE_AUDIT = class="hl-string">'AP_Audit_History.csv' 

class=class="hl-string">"hl-comment"># COLUMNS MAPPING (Adjust based on your View column headers)
COL_BILL_NUM = class="hl-string">'Invoice Number'
COL_VENDOR = class="hl-string">'Vendor Name'
COL_AMOUNT = class="hl-string">'Total Amount'
COL_CREATED = class="hl-string">'Date Created'
COL_POSTED = class="hl-string">'Date Posted'
COL_DUE = class="hl-string">'Due Date'
COL_STATE = class="hl-string">'State'
COL_PO = class="hl-string">'PO Number'
COL_HOLD = class="hl-string">'On Hold'

COL_PAY_DATE = class="hl-string">'Payment Date'
COL_PAY_REF = class="hl-string">'Check/Payment Number'
COL_PAY_BILL_REF = class="hl-string">'Bill Number'
COL_PAY_STATE = class="hl-string">'State'

class=class="hl-string">"hl-comment"># OUTPUT STRUCTURE
event_log_columns = [
    class="hl-string">'InvoiceNumber', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'SourceSystem', 
    class="hl-string">'LastDataUpdate', class="hl-string">'VendorName', class="hl-string">'InvoiceAmount', class="hl-string">'PurchaseOrderNumber', 
    class="hl-string">'InvoiceDate', class="hl-string">'DueDate', class="hl-string">'InvoiceStatus'
]

def run_extraction():
    events = []
    current_time = datetime.now().isoformat()

    class=class="hl-string">"hl-comment"># 1. LOAD BILLS
    try:
        df_bills = pd.read_csv(FILE_BILLS)
        class=class="hl-string">"hl-comment"># Clean formatting (remove currency symbols if present)
        df_bills[COL_AMOUNT] = df_bills[COL_AMOUNT].replace(class="hl-string">'[\\$,]', class="hl-string">'', regex=True).astype(float)
    except FileNotFoundError:
        print(class="hl-string">'Bills file not found.')
        return

    class=class="hl-string">"hl-comment"># 2. LOAD PAYMENTS
    try:
        df_pay = pd.read_csv(FILE_PAYMENTS)
    except FileNotFoundError:
        print(class="hl-string">'Payments file not found.')
        df_pay = pd.DataFrame()

    class=class="hl-string">"hl-comment"># PROCESSING BILLS
    for index, row in df_bills.iterrows():
        invoice_num = str(row[COL_BILL_NUM])
        vendor = row[COL_VENDOR]
        amount = row[COL_AMOUNT]
        po_num = str(row[COL_PO]) if pd.notna(row[COL_PO]) else None
        due_date = row[COL_DUE]
        status = row[COL_STATE]

        class=class="hl-string">"hl-comment"># Common attributes for this invoice
        base_attr = {
            class="hl-string">'InvoiceNumber': invoice_num,
            class="hl-string">'SourceSystem': class="hl-string">'Sage Intacct',
            class="hl-string">'LastDataUpdate': current_time,
            class="hl-string">'VendorName': vendor,
            class="hl-string">'InvoiceAmount': amount,
            class="hl-string">'PurchaseOrderNumber': po_num,
            class="hl-string">'DueDate': due_date,
            class="hl-string">'InvoiceStatus': status
        }

        class=class="hl-string">"hl-comment"># Activity: Invoice Draft Created
        if pd.notna(row[COL_CREATED]):
            events.append({**base_attr, 
                           class="hl-string">'ActivityName': class="hl-string">'Invoice Draft Created', 
                           class="hl-string">'EventTime': row[COL_CREATED], 
                           class="hl-string">'InvoiceDate': row[COL_CREATED]})

        class=class="hl-string">"hl-comment"># Activity: Invoice Matched to PO
        if po_num and pd.notna(row[COL_CREATED]):
            events.append({**base_attr, 
                           class="hl-string">'ActivityName': class="hl-string">'Invoice Matched to PO', 
                           class="hl-string">'EventTime': row[COL_CREATED], 
                           class="hl-string">'InvoiceDate': row[COL_CREATED]})

        class=class="hl-string">"hl-comment"># Activity: Invoice Posted
        if pd.notna(row[COL_POSTED]):
            events.append({**base_attr, 
                           class="hl-string">'ActivityName': class="hl-string">'Invoice Posted', 
                           class="hl-string">'EventTime': row[COL_POSTED]})
            class=class="hl-string">"hl-comment"># In standard views, Posted often implies Submission and Approval if no audit trail
            class=class="hl-string">"hl-comment"># We generate proxy events if Audit Trail is missing
            if not FILE_AUDIT:
                events.append({**base_attr, 
                               class="hl-string">'ActivityName': class="hl-string">'Invoice Submitted', 
                               class="hl-string">'EventTime': row[COL_POSTED]})
                events.append({**base_attr, 
                               class="hl-string">'ActivityName': class="hl-string">'Invoice Approved', 
                               class="hl-string">'EventTime': row[COL_POSTED]})

        class=class="hl-string">"hl-comment"># Activity: Invoice Placed on Hold
        if str(row[COL_HOLD]).lower() in [class="hl-string">'true', class="hl-string">'yes', class="hl-string">'on hold']:
             class=class="hl-string">"hl-comment"># Time is approximate (Last Modified) as View doesn't track hold time
             events.append({**base_attr, 
                            class="hl-string">'ActivityName': class="hl-string">'Invoice Placed on Hold', 
                            class="hl-string">'EventTime': row.get(class="hl-string">'Date Modified', row[COL_CREATED])})

    class=class="hl-string">"hl-comment"># PROCESSING PAYMENTS
    class=class="hl-string">"hl-comment"># Intacct payment export might list multiple bills per check line or require join logic
    class=class="hl-string">"hl-comment"># Assuming direct link via Bill Number
    if not df_pay.empty:
        for index, row in df_pay.iterrows():
            bill_ref = str(row[COL_PAY_BILL_REF])
            class=class="hl-string">"hl-comment"># Only process if this payment links to a bill we know
            class=class="hl-string">"hl-comment"># (In a real scenario, merge on Bill Number)
            
            pay_attr = {
                class="hl-string">'InvoiceNumber': bill_ref,
                class="hl-string">'SourceSystem': class="hl-string">'Sage Intacct',
                class="hl-string">'LastDataUpdate': current_time,
                class="hl-string">'ActivityName': class="hl-string">'Payment Generated',
                class="hl-string">'EventTime': row[COL_PAY_DATE]
            }
            events.append(pay_attr)
            
            if str(row[COL_PAY_STATE]).lower() == class="hl-string">'void':
                events.append({**pay_attr, class="hl-string">'ActivityName': class="hl-string">'Payment Voided', class="hl-string">'EventTime': row[COL_PAY_DATE]})
                
            if class="hl-string">'Date Reconciled' in row and pd.notna(row[class="hl-string">'Date Reconciled']):
                events.append({**pay_attr, class="hl-string">'ActivityName': class="hl-string">'Payment Reconciled', class="hl-string">'EventTime': row[class="hl-string">'Date Reconciled']})

    class=class="hl-string">"hl-comment"># 3. OUTPUT
    df_events = pd.DataFrame(events)
    class=class="hl-string">"hl-comment"># Ensure dates are ISO format
    df_events[class="hl-string">'EventTime'] = pd.to_datetime(df_events[class="hl-string">'EventTime']).dt.strftime(class="hl-string">'%Y-%m-%d %H:%M:%S')
    
    class=class="hl-string">"hl-comment"># Final Select
    df_final = df_events[event_log_columns]
    df_final.to_csv(class="hl-string">'Event_Log_Output.csv', index=False)
    print(fclass="hl-string">'Successfully exported {len(df_final)} events.')

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

/* 
  PROCESSMIND TRANSFORMATION SCRIPT
  Prerequisite: Data from APBILL, APPYMTDETAIL, and AUDITTRAIL 
  must be extracted via API and staged in tables with those names.
*/

/* 1. Invoice Draft Created */
SELECT
    H.DOCNUMBER AS InvoiceNumber,
    'Invoice Draft Created' AS ActivityName,
    H.WHENCREATED AS EventTime,
    'Sage Intacct' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    H.VENDORNAME AS VendorName,
    H.TOTALENTERED AS InvoiceAmount,
    H.PONUMBER AS PurchaseOrderNumber,
    H.WHENCREATED AS InvoiceDate,
    H.DUE_DATE AS DueDate,
    NULL AS Department,
    H.CREATEDBY AS CreatedBy,
    H.STATE AS InvoiceStatus,
    NULL AS PaymentDate
FROM APBILL H

UNION ALL

/* 2. Invoice Matched to PO (Derived from existence of PO Number at creation) */
SELECT
    H.DOCNUMBER,
    'Invoice Matched to PO',
    H.WHENCREATED, -- Occurs effectively at creation if PO links
    'Sage Intacct',
    GETDATE(),
    H.VENDORNAME,
    H.TOTALENTERED,
    H.PONUMBER,
    H.WHENCREATED,
    H.DUE_DATE,
    NULL,
    H.CREATEDBY,
    H.STATE,
    NULL
FROM APBILL H
WHERE H.PONUMBER IS NOT NULL AND H.PONUMBER <> ''

UNION ALL

/* 3. Invoice Posted (Header Timestamp) */
SELECT
    H.DOCNUMBER,
    'Invoice Posted',
    H.WHENPOSTED,
    'Sage Intacct',
    GETDATE(),
    H.VENDORNAME,
    H.TOTALENTERED,
    H.PONUMBER,
    H.WHENCREATED,
    H.DUE_DATE,
    NULL,
    H.CREATEDBY,
    H.STATE,
    NULL
FROM APBILL H
WHERE H.WHENPOSTED IS NOT NULL

UNION ALL

/* 4. Payment Generated */
SELECT
    H.DOCNUMBER,
    'Payment Generated',
    P.WHENCREATED,
    'Sage Intacct',
    GETDATE(),
    H.VENDORNAME,
    P.TRX_AMOUNT,
    H.PONUMBER,
    H.WHENCREATED,
    H.DUE_DATE,
    NULL,
    P.CREATEDBY,
    H.STATE,
    P.PAYMENTDATE
FROM APPYMTDETAIL P
JOIN APBILL H ON P.BILLRECORDNO = H.RECORDNO

UNION ALL

/* 5. Payment Reconciled */
SELECT
    H.DOCNUMBER,
    'Payment Reconciled',
    P.WHENCLEARED,
    'Sage Intacct',
    GETDATE(),
    H.VENDORNAME,
    P.TRX_AMOUNT,
    H.PONUMBER,
    H.WHENCREATED,
    H.DUE_DATE,
    NULL,
    P.CREATEDBY,
    H.STATE,
    P.PAYMENTDATE
FROM APPYMTDETAIL P
JOIN APBILL H ON P.BILLRECORDNO = H.RECORDNO
WHERE P.WHENCLEARED IS NOT NULL

UNION ALL

/* 6. Workflow Activities from Audit Trail */
/* Covers: Updated, Submitted, Approved, Declined, Hold, Released, Voided, Selected */
SELECT
    H.DOCNUMBER,
    CASE 
        WHEN A.MESSAGE LIKE '%Submitted%' THEN 'Invoice Submitted'
        WHEN A.MESSAGE LIKE '%Approved%' THEN 'Invoice Approved'
        WHEN A.MESSAGE LIKE '%Declined%' THEN 'Invoice Declined'
        WHEN A.MESSAGE LIKE '%Hold%' AND A.LOGTYPE = 'Add' THEN 'Invoice Placed on Hold'
        WHEN A.MESSAGE LIKE '%Hold%' AND A.LOGTYPE = 'Remove' THEN 'Invoice Released from Hold'
        WHEN A.MESSAGE LIKE '%Voided%' THEN 'Payment Voided'
        WHEN A.MESSAGE LIKE '%Selected for payment%' THEN 'Invoice Selected for Payment'
        WHEN A.MESSAGE LIKE '%Modified%' THEN 'Invoice Updated'
        ELSE 'System Activity'
    END AS ActivityName,
    A.WHENDOCCURRED AS EventTime,
    'Sage Intacct' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    H.VENDORNAME,
    H.TOTALENTERED,
    H.PONUMBER,
    H.WHENCREATED,
    H.DUE_DATE,
    NULL,
    A.USERID AS CreatedBy,
    H.STATE,
    NULL
FROM AUDITTRAIL A
JOIN APBILL H ON A.OBJECTKEY = CAST(H.RECORDNO AS VARCHAR(50))
WHERE A.OBJECTTYPE = 'APBILL'
  AND (
       A.MESSAGE LIKE '%Submitted%'
    OR A.MESSAGE LIKE '%Approved%'
    OR A.MESSAGE LIKE '%Declined%'
    OR A.MESSAGE LIKE '%Hold%'
    OR A.MESSAGE LIKE '%Voided%'
    OR A.MESSAGE LIKE '%Selected for payment%'
    OR A.MESSAGE LIKE '%Modified%'
  )
  /* Exclude creation updates to avoid duplication with Invoice Draft Created */
  AND NOT (A.MESSAGE LIKE '%Modified%' AND ABS(DATEDIFF(second, A.WHENDOCCURRED, H.WHENCREATED)) < 60)