payfrit-biz/api/tasks/complete.cfm

<cfsetting showdebugoutput="false">
<cfsetting enablecfoutputonly="true">

<cffunction name="apiAbort" access="public" returntype="void" output="true">
  <cfargument name="payload" type="struct" required="true">
  <cfcontent type="application/json; charset=utf-8">
  <cfoutput>#serializeJSON(arguments.payload)#</cfoutput>
  <cfabort>
</cffunction>

<cffunction name="readJsonBody" access="public" returntype="struct" output="false">
  <cfset var raw = getHttpRequestData().content>
  <cfif isNull(raw) OR len(trim(raw)) EQ 0>
    <cfreturn {}>
  </cfif>
  <cftry>
    <cfset var data = deserializeJSON(raw)>
    <cfif isStruct(data)>
      <cfreturn data>
    <cfelse>
      <cfreturn {}>
    </cfif>
    <cfcatch>
      <cfreturn {}>
    </cfcatch>
  </cftry>
</cffunction>

<cffunction name="generateToken" access="public" returntype="string" output="false">
  <cfreturn lcase(replace(createUUID(), "-", "", "all"))>
</cffunction>

<cfset data = readJsonBody()>
<cfset TaskID = val( structKeyExists(data,"TaskID") ? data.TaskID : 0 )>
<!--- Get UserID from request (auth header) or from JSON body as fallback --->
<cfset UserID = val( structKeyExists(request,"UserID") ? request.UserID : (structKeyExists(data,"UserID") ? data.UserID : 0) )>

<!--- Optional: Worker rating of customer (when required or voluntary) --->
<cfset workerRating = structKeyExists(data,"workerRating") ? data.workerRating : {}>
<cfset CashReceivedCents = val( structKeyExists(data,"CashReceivedCents") ? data.CashReceivedCents : 0 )>
<cfset CancelOrder = structKeyExists(data,"CancelOrder") AND data.CancelOrder EQ true>

<cfif TaskID LTE 0>
  <cfset apiAbort({ "OK": false, "ERROR": "missing_params", "MESSAGE": "TaskID is required." })>
</cfif>

<cftry>
  <!--- Verify task exists --->
  <cfset qTask = queryTimed("
    SELECT t.ID, t.ClaimedByUserID, t.CompletedOn, t.OrderID, t.TaskTypeID, t.BusinessID,
           o.UserID AS CustomerUserID, o.ServicePointID,
           tt.Name AS TaskTypeName,
           b.UserID AS BusinessOwnerUserID,
           COALESCE(emp.RoleID, 1) AS WorkerRoleID
    FROM Tasks t
    LEFT JOIN Orders o ON o.ID = t.OrderID
    LEFT JOIN tt_TaskTypes tt ON tt.ID = t.TaskTypeID
    LEFT JOIN Businesses b ON b.ID = t.BusinessID
    LEFT JOIN Employees emp ON emp.BusinessID = t.BusinessID AND emp.UserID = t.ClaimedByUserID AND emp.IsActive = 1
    WHERE t.ID = ?
  ", [ { value = TaskID, cfsqltype = "cf_sql_integer" } ], { datasource = "payfrit" })>

  <cfif qTask.recordCount EQ 0>
    <cfset apiAbort({ "OK": false, "ERROR": "not_found", "MESSAGE": "Task not found." })>
  </cfif>

  <!--- Chat tasks (TaskTypeID = 2) can be closed without being claimed first --->
  <cfset isChatTask = (qTask.TaskTypeID EQ 2)>
  <cfset isCashTask = (len(trim(qTask.TaskTypeName)) GT 0 AND findNoCase("Cash", qTask.TaskTypeName) GT 0)>
  <!--- Manager (2) and Admin (3) collect cash on behalf of the restaurant; Staff (1) keeps cash as payout --->
  <cfset isAdminRole = (val(qTask.WorkerRoleID) GTE 2)>

  <cfif (NOT isChatTask) AND (qTask.ClaimedByUserID EQ 0)>
    <cfset apiAbort({ "OK": false, "ERROR": "not_claimed", "MESSAGE": "Task has not been claimed yet." })>
  </cfif>

  <cfif (NOT isChatTask) AND (UserID GT 0) AND (qTask.ClaimedByUserID NEQ UserID)>
    <cfset apiAbort({ "OK": false, "ERROR": "not_yours", "MESSAGE": "This task was claimed by someone else." })>
  </cfif>

  <!--- Check if already completed - use len() to handle both NULL and empty string --->
  <cfif len(trim(qTask.CompletedOn)) GT 0>
    <cfset apiAbort({ "OK": false, "ERROR": "already_completed", "MESSAGE": "Task has already been completed." })>
  </cfif>

  <!--- Check if this is a service point task (customer-facing) --->
  <cfset hasServicePoint = (val(qTask.ServicePointID) GT 0)>
  <cfset customerUserID = val(qTask.CustomerUserID)>
  <cfset businessOwnerUserID = val(qTask.BusinessOwnerUserID)>
  <cfset workerUserID = val(qTask.ClaimedByUserID)>
  <cfset ratingRequired = false>
  <cfset ratingsCreated = []>

  <!--- DISABLED: Worker rating of customer (10% sampling) --->
  <!--- TODO: Re-enable when rating UI is ready in the app --->
  <!---
  <cfif hasServicePoint AND customerUserID GT 0 AND workerUserID GT 0>
    <cfset ratingRequired = (TaskID MOD 10 EQ 0)>
    <cfif ratingRequired AND structIsEmpty(workerRating)>
      <cfset apiAbort({
        "OK": false,
        "ERROR": "rating_required",
        "MESSAGE": "Please rate the customer before completing this task.",
        "CustomerUserID": customerUserID,
        "Questions": {
          "prepared": "Was the customer prepared?",
          "completedScope": "Was the scope clear?",
          "respectful": "Was the customer respectful?",
          "wouldAutoAssign": "Would you serve this customer again?"
        }
      })>
    </cfif>
  </cfif>
  --->

  <!--- === CASH TASK VALIDATION === --->
  <cfset cashResult = {}>
  <cfset orderCancelled = false>
  <!--- Skip cash processing for orphaned tasks (no order linked) OR if cancelling --->
  <cfif isCashTask AND qTask.OrderID GT 0 AND NOT CancelOrder>
    <cfif CashReceivedCents LTE 0>
      <cfset apiAbort({ "OK": false, "ERROR": "cash_required", "MESSAGE": "Cash amount is required for cash tasks." })>
    </cfif>
    <cfif CashReceivedCents GT 50000>
      <cfset apiAbort({ "OK": false, "ERROR": "cash_limit", "MESSAGE": "Cash transactions cannot exceed $500." })>
    </cfif>

    <!--- Check 30-day rolling limit for customer --->
    <cfif customerUserID GT 0>
      <cfset q30Day = queryTimed("
        SELECT COALESCE(SUM(PaymentPaidInCash), 0) AS TotalCashDollars
        FROM Payments
        WHERE PaymentSentByUserID = ?
          AND PaymentAddedOn >= DATE_SUB(NOW(), INTERVAL 30 DAY)
      ", [{ value = customerUserID, cfsqltype = "cf_sql_integer" }], { datasource = "payfrit" })>
      <cfif (val(q30Day.TotalCashDollars) + (CashReceivedCents / 100)) GT 10000>
        <cfset apiAbort({ "OK": false, "ERROR": "cash_30day_limit", "MESSAGE": "Customer has exceeded the $10,000 rolling 30-day cash limit." })>
      </cfif>
    </cfif>

    <!--- Calculate order total from line items --->
    <cfif qTask.OrderID LTE 0>
      <cfset apiAbort({ "OK": false, "ERROR": "no_order", "MESSAGE": "Cash tasks must be linked to an order." })>
    </cfif>

    <cfset qOrderTotal = queryTimed("
      SELECT SUM(oli.Price * oli.Quantity) AS Subtotal, o.TipAmount, o.DeliveryFee, o.OrderTypeID,
             o.BalanceApplied, b.TaxRate, b.PayfritFee
      FROM Orders o
      INNER JOIN Businesses b ON b.ID = o.BusinessID
      LEFT JOIN OrderLineItems oli ON oli.OrderID = o.ID AND oli.IsDeleted = b'0'
      WHERE o.ID = ?
      GROUP BY o.ID
    ", [{ value = qTask.OrderID, cfsqltype = "cf_sql_integer" }], { datasource = "payfrit" })>

    <cfif qOrderTotal.recordCount EQ 0>
      <cfset apiAbort({ "OK": false, "ERROR": "no_order", "MESSAGE": "Order not found for this cash task." })>
    </cfif>

    <cfset cashSubtotal = val(qOrderTotal.Subtotal)>
    <cfset cashTax = cashSubtotal * val(qOrderTotal.TaxRate)>
    <cfset cashTip = val(qOrderTotal.TipAmount)>
    <cfset cashDeliveryFee = (val(qOrderTotal.OrderTypeID) EQ 3) ? val(qOrderTotal.DeliveryFee) : 0>
    <cfset cashPayfritFee = (isNumeric(qOrderTotal.PayfritFee) AND val(qOrderTotal.PayfritFee) GT 0) ? val(qOrderTotal.PayfritFee) : 0.05>

    <!--- Customer fee: added to their total (visible in cart) --->
    <cfset customerFeeDollars = cashSubtotal * cashPayfritFee>
    <!--- Business fee: deducted when cash is distributed --->
    <cfset businessFeeDollars = cashSubtotal * cashPayfritFee>
    <!--- Total Payfrit revenue = customer fee + business fee --->
    <cfset payfritRevenueDollars = customerFeeDollars + businessFeeDollars>

    <cfset orderTotalCents = round((cashSubtotal + cashTax + cashTip + cashDeliveryFee + customerFeeDollars) * 100)>

    <!--- Account for balance already applied in submitCash.cfm --->
    <cfset balanceAppliedCents = round(val(qOrderTotal.BalanceApplied) * 100)>
    <cfset cashOwedCents = orderTotalCents - balanceAppliedCents>
    <cfif cashOwedCents LT 0><cfset cashOwedCents = 0></cfif>

    <cfif CashReceivedCents LT cashOwedCents>
      <cfset apiAbort({ "OK": false, "ERROR": "insufficient_cash", "MESSAGE": "Cash received ($#numberFormat(CashReceivedCents/100, '0.00')#) is less than cash owed ($#numberFormat(cashOwedCents/100, '0.00')#)." })>
    </cfif>

    <cfset payfritRevenueCents = round(payfritRevenueDollars * 100)>
    <cfset changeCents = CashReceivedCents - cashOwedCents>
    <cfset businessReceivesCents = orderTotalCents - payfritRevenueCents>

    <cfset cashResult = {
      "orderTotalCents": orderTotalCents,
      "cashOwedCents": cashOwedCents,
      "balanceAppliedCents": balanceAppliedCents,
      "cashReceivedCents": CashReceivedCents,
      "changeCents": changeCents,
      "customerFeeCents": round(customerFeeDollars * 100),
      "businessFeeCents": round(businessFeeDollars * 100),
      "payfritRevenueCents": payfritRevenueCents,
      "businessReceivesCents": businessReceivesCents
    }>
  </cfif>

  <!--- Mark task as completed --->
  <cfset queryTimed("
    UPDATE Tasks
    SET CompletedOn = NOW()
    WHERE ID = ?
  ", [ { value = TaskID, cfsqltype = "cf_sql_integer" } ], { datasource = "payfrit" })>

  <!--- Update order status based on task type --->
  <cfset orderUpdated = false>
  <cfif qTask.OrderID GT 0>
    <cfif CancelOrder>
      <!--- Cancel task only: leave order untouched so customer can pay another way --->
      <cfset orderCancelled = false>
    <cfelseif isCashTask>
      <!--- Cash task: Set to status 1 (Submitted/Paid) to trigger kitchen flow --->
      <!--- Kitchen will then move to 2, then 3 (which creates delivery task) --->
      <cfset queryTimed("
        UPDATE Orders
        SET StatusID = CASE WHEN StatusID = 0 THEN 1 ELSE StatusID END,
            PaymentStatus = 'paid',
            PaymentCompletedOn = NOW(),
            SubmittedOn = CASE WHEN SubmittedOn IS NULL THEN NOW() ELSE SubmittedOn END,
            LastEditedOn = NOW()
        WHERE ID = ?
      ", [ { value = qTask.OrderID, cfsqltype = "cf_sql_integer" } ], { datasource = "payfrit" })>
    <cfelse>
      <!--- Regular task (delivery, pickup, etc.): Mark order as Delivered/Complete (status 5) --->
      <cfset queryTimed("
        UPDATE Orders
        SET StatusID = 5,
            LastEditedOn = NOW()
        WHERE ID = ?
      ", [ { value = qTask.OrderID, cfsqltype = "cf_sql_integer" } ], { datasource = "payfrit" })>
    </cfif>
    <cfset orderUpdated = true>
  </cfif>

  <!--- === PAYOUT LEDGER + ACTIVATION WITHHOLDING === --->
  <!--- Skip for admin/manager roles — they aren't earning personal task pay --->
  <cfset ledgerCreated = false>
  <cfset workerUserID_for_payout = val(qTask.ClaimedByUserID)>
  <cfif workerUserID_for_payout GT 0 AND NOT isAdminRole>
    <!--- Get PayCents from the task --->
    <cfset qTaskPay = queryTimed("
      SELECT PayCents FROM Tasks WHERE ID = ?
    ", [ { value = TaskID, cfsqltype = "cf_sql_integer" } ], { datasource = "payfrit" })>
    <cfset grossCents = val(qTaskPay.PayCents)>

    <cfif grossCents GT 0>
      <!--- Get worker's activation state --->
      <cfset qActivation = queryTimed("
        SELECT ActivationBalanceCents, ActivationCapCents
        FROM Users WHERE ID = ?
      ", [ { value = workerUserID_for_payout, cfsqltype = "cf_sql_integer" } ], { datasource = "payfrit" })>

      <cfset activationBalance = val(qActivation.ActivationBalanceCents)>
      <cfset activationCap = val(qActivation.ActivationCapCents)>
      <cfset remainingActivation = activationCap - activationBalance>

      <!--- Withholding: min($1, remaining, gross). Never negative. --->
      <cfset activationWithhold = 0>
      <cfif remainingActivation GT 0>
        <cfset activationWithhold = min(100, min(remainingActivation, grossCents))>
      </cfif>
      <cfset netCents = grossCents - activationWithhold>

      <!--- Insert ledger row --->
      <cfset queryTimed("
        INSERT INTO WorkPayoutLedgers
          (UserID, TaskID, GrossEarningsCents, ActivationWithheldCents, NetTransferCents, Status)
        VALUES
          (:userID, :taskID, :gross, :withheld, :net, 'pending_charge')
      ", {
        userID: workerUserID_for_payout,
        taskID: TaskID,
        gross: grossCents,
        withheld: activationWithhold,
        net: netCents
      }, { datasource = "payfrit" })>

      <!--- Increment activation balance --->
      <cfif activationWithhold GT 0>
        <cfset queryTimed("
          UPDATE Users
          SET ActivationBalanceCents = ActivationBalanceCents + :withhold
          WHERE ID = :userID
        ", {
          withhold: activationWithhold,
          userID: workerUserID_for_payout
        }, { datasource = "payfrit" })>
      </cfif>

      <cfset ledgerCreated = true>
    </cfif>
  </cfif>

  <!--- === CASH TRANSACTION PROCESSING === --->
  <cfset cashProcessed = false>
  <cfif isCashTask AND CashReceivedCents GT 0 AND qTask.OrderID GT 0 AND NOT CancelOrder>
    <!--- Look up worker's role for this business (1=Staff, 2=Manager, 3=Admin) --->
    <cfset workerRoleID = 1>
    <cfif workerUserID_for_payout GT 0>
      <cfset qWorkerRole = queryTimed("
        SELECT COALESCE(RoleID, 1) AS RoleID
        FROM Employees
        WHERE UserID = ? AND BusinessID = ? AND IsActive = b'1'
        ORDER BY RoleID DESC
        LIMIT 1
      ", [
        { value = workerUserID_for_payout, cfsqltype = "cf_sql_integer" },
        { value = qTask.BusinessID, cfsqltype = "cf_sql_integer" }
      ], { datasource = "payfrit" })>
      <cfif qWorkerRole.recordCount GT 0>
        <cfset workerRoleID = val(qWorkerRole.RoleID)>
      </cfif>
    </cfif>

    <cfset isAdmin = (workerRoleID GTE 2)>

    <!--- Credit customer change to their balance --->
    <cfif changeCents GT 0 AND customerUserID GT 0>
      <cfset queryTimed("
        UPDATE Users SET Balance = Balance + :change WHERE ID = :userID
      ", {
        change: changeCents / 100,
        userID: customerUserID
      }, { datasource = "payfrit" })>
    </cfif>

    <!--- Credit Payfrit revenue (customer fee + business fee) to User 0 (Payfrit Network) --->
    <cfif payfritRevenueCents GT 0>
      <cfset queryTimed("
        UPDATE Users SET Balance = Balance + :fee WHERE ID = 0
      ", {
        fee: payfritRevenueCents / 100
      }, { datasource = "payfrit" })>
    </cfif>

    <!--- Debit for physical cash received --->
    <!--- Staff: debit the worker (they pocketed the cash) --->
    <!--- Admin/Manager: cash goes to the business, delete worker's pending payout --->
    <cfif isAdmin>
      <!--- Admin/Manager: cash goes to the business, delete worker's pending payout --->
      <!--- Remove the task earning ledger entry (admin hands cash to register) --->
      <cfif workerUserID_for_payout GT 0>
        <cfset queryTimed("
          DELETE FROM WorkPayoutLedgers
          WHERE TaskID = :taskID AND UserID = :userID AND Status = 'pending_charge'
        ", {
          taskID: TaskID,
          userID: workerUserID_for_payout
        }, { datasource = "payfrit" })>

        <!--- Reverse activation withholding if any was applied --->
        <cfif ledgerCreated AND activationWithhold GT 0>
          <cfset queryTimed("
            UPDATE Users
            SET ActivationBalanceCents = GREATEST(0, ActivationBalanceCents - :withhold)
            WHERE ID = :userID
          ", {
            withhold: activationWithhold,
            userID: workerUserID_for_payout
          }, { datasource = "payfrit" })>
        </cfif>
      </cfif>
    <cfelse>
      <!--- Staff: cash stays in their pocket, debit their payout balance --->
      <cfif workerUserID_for_payout GT 0>
        <cfset queryTimed("
          INSERT INTO WorkPayoutLedgers
            (UserID, TaskID, GrossEarningsCents, ActivationWithheldCents, NetTransferCents, Status)
          VALUES
            (:userID, :taskID, :gross, 0, :net, 'cash_debit')
        ", {
          userID: workerUserID_for_payout,
          taskID: TaskID,
          gross: -CashReceivedCents,
          net: -CashReceivedCents
        }, { datasource = "payfrit" })>
      </cfif>
    </cfif>

    <!--- Log transaction in Payments table --->
    <cfset queryTimed("
      INSERT INTO Payments (
        PaymentSentByUserID, PaymentReceivedByUserID, PaymentOrderID,
        PaymentFromCreditCard, PaymentFromPayfritBalance, PaymentPaidInCash,
        PaymentPayfritsCut, PaymentCreditCardFees, PaymentPayfritNetworkFees,
        PaymentRemark, PaymentAddedOn
      ) VALUES (
        :sentBy, :receivedBy, :orderID,
        0, 0, :cashAmount,
        :payfritCut, 0, :bizFee,
        :remark, NOW()
      )
    ", {
      sentBy: customerUserID,
      receivedBy: businessOwnerUserID,
      orderID: qTask.OrderID,
      cashAmount: CashReceivedCents / 100,
      payfritCut: payfritRevenueCents / 100,
      bizFee: round(businessFeeDollars * 100) / 100,
      remark: isAdmin ? "Cash payment (collected by manager)" : "Cash payment"
    }, { datasource = "payfrit" })>

    <cfset cashProcessed = true>
  </cfif>

  <!--- Create rating records for service point tasks --->
  <cfif hasServicePoint AND customerUserID GT 0 AND workerUserID GT 0>
    <!--- 1. Customer rates Worker (always created, submitted via receipt link) --->
    <cfset customerToken = generateToken()>
    <cfset queryTimed("
      INSERT INTO TaskRatings (
        TaskID, ByUserID, ForUserID, Direction,
        AccessToken, ExpiresOn
      ) VALUES (
        ?, ?, ?, 'customer_rates_worker',
        ?, DATE_ADD(NOW(), INTERVAL 24 HOUR)
      )
    ", [
      { value = TaskID, cfsqltype = "cf_sql_integer" },
      { value = customerUserID, cfsqltype = "cf_sql_integer" },
      { value = workerUserID, cfsqltype = "cf_sql_integer" },
      { value = customerToken, cfsqltype = "cf_sql_varchar" }
    ], { datasource = "payfrit" })>
    <cfset arrayAppend(ratingsCreated, { "direction": "customer_rates_worker", "token": customerToken })>

    <!--- 2. Worker rates Customer (if provided or required) --->
    <cfif NOT structIsEmpty(workerRating)>
      <cfset workerToken = generateToken()>
      <cfset queryTimed("
        INSERT INTO TaskRatings (
          TaskID, ByUserID, ForUserID, Direction,
          Prepared, CompletedScope, Respectful, WouldAutoAssign,
          AccessToken, ExpiresOn, CompletedOn
        ) VALUES (
          ?, ?, ?, 'worker_rates_customer',
          ?, ?, ?, ?,
          ?, DATE_ADD(NOW(), INTERVAL 24 HOUR), NOW()
        )
      ", [
        { value = TaskID, cfsqltype = "cf_sql_integer" },
        { value = workerUserID, cfsqltype = "cf_sql_integer" },
        { value = customerUserID, cfsqltype = "cf_sql_integer" },
        { value = structKeyExists(workerRating,"prepared") ? (workerRating.prepared ? 1 : 0) : javaCast("null",""), cfsqltype = "cf_sql_tinyint", null = !structKeyExists(workerRating,"prepared") },
        { value = structKeyExists(workerRating,"completedScope") ? (workerRating.completedScope ? 1 : 0) : javaCast("null",""), cfsqltype = "cf_sql_tinyint", null = !structKeyExists(workerRating,"completedScope") },
        { value = structKeyExists(workerRating,"respectful") ? (workerRating.respectful ? 1 : 0) : javaCast("null",""), cfsqltype = "cf_sql_tinyint", null = !structKeyExists(workerRating,"respectful") },
        { value = structKeyExists(workerRating,"wouldAutoAssign") ? (workerRating.wouldAutoAssign ? 1 : 0) : javaCast("null",""), cfsqltype = "cf_sql_tinyint", null = !structKeyExists(workerRating,"wouldAutoAssign") },
        { value = workerToken, cfsqltype = "cf_sql_varchar" }
      ], { datasource = "payfrit" })>
      <cfset arrayAppend(ratingsCreated, { "direction": "worker_rates_customer", "submitted": true })>
    </cfif>
  </cfif>

  <cfset response = {
    "OK": true,
    "ERROR": "",
    "MESSAGE": orderCancelled ? "Order cancelled." : "Task completed successfully.",
    "TaskID": TaskID,
    "OrderUpdated": orderUpdated,
    "OrderCancelled": orderCancelled,
    "RatingsCreated": ratingsCreated,
    "LedgerCreated": ledgerCreated,
    "CashProcessed": cashProcessed
  }>

  <cfif cashProcessed>
    <cfset response["CashReceived"] = numberFormat(CashReceivedCents / 100, "0.00")>
    <cfset response["OrderTotal"] = numberFormat(orderTotalCents / 100, "0.00")>
    <cfset response["Change"] = numberFormat(changeCents / 100, "0.00")>
    <cfset response["CustomerFee"] = numberFormat(round(customerFeeDollars * 100) / 100, "0.00")>
    <cfset response["BusinessFee"] = numberFormat(round(businessFeeDollars * 100) / 100, "0.00")>
    <cfset response["PayfritRevenue"] = numberFormat(payfritRevenueCents / 100, "0.00")>
    <cfset response["BusinessReceives"] = numberFormat(businessReceivesCents / 100, "0.00")>
    <cfif balanceAppliedCents GT 0>
      <cfset response["BalanceApplied"] = numberFormat(balanceAppliedCents / 100, "0.00")>
      <cfset response["CashOwed"] = numberFormat(cashOwedCents / 100, "0.00")>
    </cfif>
    <cfset response["CashRoutedTo"] = isAdmin ? "business" : "worker">
    <cfset response["WorkerRoleID"] = workerRoleID>
  </cfif>

  <cfset apiAbort(response)>

  <cfcatch>
    <cfset apiAbort({
      "OK": false,
      "ERROR": "server_error",
      "MESSAGE": "Error completing task",
      "DETAIL": cfcatch.message
    })>
  </cfcatch>
</cftry>