/* @tier easy @module cl @transform closing-online */ /* * cl_ol_0004.pgc - 마감 온라인 서비스 (CL_OL_0004) [tier=easy] * * 마감후 집계 조회. 요청 영업일(BIZDATE)의 정산완료(S) 건에 대해 * 건수 / 거래금액 합계 / 수수료 합계 / 순액(합계-수수료)을 singleton * SELECT 로 산출하여 응답한다. read-only 조회 서비스이다. * * ── 서비스 계약(Contract) ──────────────────────────────────────────── * 입력 필드: * BIZDATE (필수) 영업일(YYYYMMDD) * 출력 필드: * RESPCODE 0000=정상 / 9001=입력오류 / 9999=시스템오류 * BIZDATE 집계 대상 영업일 * SETTLECNT 정산완료(S) 건수 * AMTSUM 거래금액 합계(Σamount, 원) * FEESUM 수수료 합계(Σfee, 원) * NETAMT 순액(= AMTSUM - FEESUM, 원) * NETWON 순액 한글 표기 * * ── 집계 규칙 ──────────────────────────────────────────────────────── * · 마감완료(status='S') 건만 집계 대상으로 삼는다. * · 순액(NETAMT)은 가맹점 지급 기준액으로, 거래금액에서 매입 * 수수료(fee)를 차감하여 산출한다. * · 집계 대상이 0건이면 모든 합계를 0 으로 응답하고 경고 로그를 남긴다. * * ── 처리 흐름 ──────────────────────────────────────────────────────── * 1) BIZDATE 추출/형식검증 * 2) status='S' 대상 count/Σamount/Σfee singleton SELECT * 3) 순액 산출 및 응답 TXBUF 구성 */ #include #include #include "txcore.h" #include "txcore_dbio.h" #include "acq_util.h" #include "cl_core.h" EXEC SQL INCLUDE sqlca; TX_SERVICE(CL_OL_0004, 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 net_amt = 0; long avg_amt = 0; char won[40]; char avgwon[40]; tx_log(TX_LOG_INFO, "[CL_OL_0004] 마감후 집계조회 서비스 진입"); /* 1. 요청 검증 */ if (tx_buf_get(ctx->in, "BIZDATE", bizdate, sizeof(bizdate)) != TX_OK) { tx_log(TX_LOG_ERROR, "[CL_OL_0004] 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_0004] 영업일 형식 오류 date=%s", bizdate); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID); tx_return(ctx, TX_EINVAL, ctx->out); return; } strncpy(h_biz_date, bizdate, sizeof(h_biz_date) - 1); h_biz_date[sizeof(h_biz_date) - 1] = '\0'; /* 2. 마감완료(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_0004 settled 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; avg_amt = (h_cnt > 0) ? (h_amt_sum / (long)h_cnt) : 0; /* 4. 응답 구성 */ amount_format_won(net_amt, won, sizeof(won)); amount_format_won(avg_amt, avgwon, sizeof(avgwon)); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_OK); 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, "AVGAMT", avg_amt); tx_buf_sets(ctx->out, "AVGWON", avgwon); /* 5. 처리 결과 로깅 (건당 평균거래금액 포함 상세) */ tx_log(TX_LOG_DEBUG, "[CL_OL_0004] 집계상세 date=%s Σamount=%ld Σfee=%ld avg=%ld", bizdate, h_amt_sum, h_fee_sum, avg_amt); if (h_cnt == 0) tx_log(TX_LOG_WARN, "[CL_OL_0004] 마감완료 건 없음 date=%s", bizdate); else tx_log(TX_LOG_INFO, "[CL_OL_0004] 집계완료 date=%s 건수=%d 순액=%ld", bizdate, h_cnt, net_amt); tx_return(ctx, TX_OK, ctx->out); }