acquire-core-full/app/online/cl_ol_0007.pgc

/* @tier medium @module cl @transform closing-online */
/*
 * cl_ol_0007.pgc - 마감 온라인 서비스 (CL_OL_0007)  [tier=medium]
 *
 * 마감 잔액검증. 요청 영업일(BIZDATE)의 정산완료(S) 건에 대해 거래금액
 * 합계(Σamount), 수수료 합계(Σfee), 순액(Σamount-Σfee)을 singleton
 * SELECT 로 산출하고, 요청 기대순액(EXPECTNET)과 비교하여 잔액 일치여부를
 * 판정한다. 불일치 시 RESP_INVALID. (read-only 검증)
 *
 * ── 서비스 계약(Contract) ────────────────────────────────────────────
 *  입력 필드:
 *    BIZDATE    (필수) 영업일(YYYYMMDD)
 *    EXPECTNET  (선택) 기대 순액(원, 미제출 시 0 으로 비교)
 *  출력 필드:
 *    RESPCODE   0000=잔액일치 / 9001=불일치·입력오류 / 9999=시스템오류
 *    BIZDATE    검증 대상 영업일
 *    SETTLECNT  정산완료(S) 건수
 *    AMTSUM     거래금액 합계(Σamount)
 *    FEESUM     수수료 합계(Σfee)
 *    NETAMT     순액(= AMTSUM - FEESUM) / NETWON 한글 표기
 *    EXPECTNET  기대 순액
 *    DIFFNET    순액 차이(실제-기대)
 *    BALANCED   잔액 일치여부(Y/N)
 *
 * ── 잔액검증 규칙 ────────────────────────────────────────────────────
 *    · 마감완료(S) 건의 거래금액과 수수료를 각각 합산한다.
 *    · 순액 = Σamount - Σfee 로, 가맹점 실지급 예정액을 의미한다.
 *    · 순액이 기대순액과 정확히 일치할 때만 잔액일치(RESP_OK)로 본다.
 */
#include <stdio.h>
#include <string.h>

#include "txcore.h"
#include "txcore_dbio.h"
#include "acq_util.h"
#include "cl_core.h"

EXEC SQL INCLUDE sqlca;

TX_SERVICE(CL_OL_0007, ctx)
{
    EXEC SQL BEGIN DECLARE SECTION;
    char h_biz_date[9];
    int  h_cnt;
    long h_amt_sum;
    long h_fee_sum;
    EXEC SQL END DECLARE SECTION;

    char bizdate[16];
    long expect_net = 0;
    long net_amt = 0, diff_net = 0;
    int  balanced;
    char won[40];

    tx_log(TX_LOG_INFO, "[CL_OL_0007] 마감 잔액검증 서비스 진입");

    /* 1. 요청 검증 */
    if (tx_buf_get(ctx->in, "BIZDATE", bizdate, sizeof(bizdate)) != TX_OK) {
        tx_log(TX_LOG_ERROR, "[CL_OL_0007] BIZDATE 누락");
        tx_buf_reset(ctx->out);
        tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID);
        tx_return(ctx, TX_EINVAL, ctx->out);
        return;
    }
    if (!date_is_valid(bizdate)) {
        tx_log(TX_LOG_WARN, "[CL_OL_0007] 영업일 형식 오류 date=%s", bizdate);
        tx_buf_reset(ctx->out);
        tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID);
        tx_return(ctx, TX_EINVAL, ctx->out);
        return;
    }
    /* 기대순액 (미제출 시 0) */
    tx_buf_getlong(ctx->in, "EXPECTNET", &expect_net);

    strncpy(h_biz_date, bizdate, sizeof(h_biz_date) - 1);
    h_biz_date[sizeof(h_biz_date) - 1] = '\0';

    /* 2. 잔액 집계 : 건수 / Σamount / Σfee (S 확정분) */
    EXEC SQL SELECT count(*),
                    coalesce(sum(amount), 0),
                    coalesce(sum(fee), 0)
        INTO :h_cnt, :h_amt_sum, :h_fee_sum
        FROM cl_ledger
        WHERE biz_date = :h_biz_date
          AND status   = 'S';
    if (sqlca.sqlcode != TX_SQL_OK) {
        TX_DBIO_LOG_ERR("CL_OL_0007 balance aggregate");
        tx_buf_reset(ctx->out);
        tx_buf_sets(ctx->out, "RESPCODE", RESP_SYSERR);
        tx_return(ctx, TX_EDB, ctx->out);
        return;
    }

    /* 3. 순액 산출 및 기대순액 대비 검증 */
    net_amt  = h_amt_sum - h_fee_sum;
    diff_net = net_amt - expect_net;
    balanced = (diff_net == 0);

    /* 4. 응답 구성 */
    amount_format_won(net_amt, won, sizeof(won));
    tx_buf_reset(ctx->out);
    tx_buf_sets(ctx->out, "BIZDATE", bizdate);
    tx_buf_setlong(ctx->out, "SETTLECNT", (long)h_cnt);
    tx_buf_setlong(ctx->out, "AMTSUM", h_amt_sum);
    tx_buf_setlong(ctx->out, "FEESUM", h_fee_sum);
    tx_buf_setlong(ctx->out, "NETAMT", net_amt);
    tx_buf_sets(ctx->out, "NETWON", won);
    tx_buf_setlong(ctx->out, "EXPECTNET", expect_net);
    tx_buf_setlong(ctx->out, "DIFFNET", diff_net);

    if (balanced) {
        tx_buf_sets(ctx->out, "RESPCODE", RESP_OK);
        tx_buf_sets(ctx->out, "BALANCED", "Y");
        tx_log(TX_LOG_INFO, "[CL_OL_0007] 잔액일치 date=%s 순액=%ld", bizdate, net_amt);
        tx_return(ctx, TX_OK, ctx->out);
        return;
    }

    tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID);
    tx_buf_sets(ctx->out, "BALANCED", "N");
    tx_log(TX_LOG_WARN, "[CL_OL_0007] 잔액불일치 date=%s 순액차이=%ld", bizdate, diff_net);
    tx_return(ctx, TX_FAIL, ctx->out);
}