/* Processed by ecpg (15.18 (Debian 15.18-0+deb12u1)) */ /* These include files are added by the preprocessor */ #include #include #include /* End of automatic include section */ #line 1 "app/online/lg_ol_0022.pgc" /* @tier hard @module lg @transform ledger-online */ /* * lg_ol_0022.pgc - 원장 온라인 서비스 (LG_OL_0022) [tier=hard] * * 가맹점 잔액 조회: 특정 가맹점의 원장 순액(Σamount)과 수수료 합(Σfee), * 전표 건수를 단일 집계 SELECT 로 조회하여 잔액을 응답한다. (조회 전용) */ #include #include #include "txcore.h" #include "txcore_dbio.h" #include "acq_util.h" #include "lg_core.h" #line 1 "/usr/include/postgresql/sqlca.h" #ifndef POSTGRES_SQLCA_H #define POSTGRES_SQLCA_H #ifndef PGDLLIMPORT #if defined(WIN32) || defined(__CYGWIN__) #define PGDLLIMPORT __declspec (dllimport) #else #define PGDLLIMPORT #endif /* __CYGWIN__ */ #endif /* PGDLLIMPORT */ #define SQLERRMC_LEN 150 #ifdef __cplusplus extern "C" { #endif struct sqlca_t { char sqlcaid[8]; long sqlabc; long sqlcode; struct { int sqlerrml; char sqlerrmc[SQLERRMC_LEN]; } sqlerrm; char sqlerrp[8]; long sqlerrd[6]; /* Element 0: empty */ /* 1: OID of processed tuple if applicable */ /* 2: number of rows processed */ /* after an INSERT, UPDATE or */ /* DELETE statement */ /* 3: empty */ /* 4: empty */ /* 5: empty */ char sqlwarn[8]; /* Element 0: set to 'W' if at least one other is 'W' */ /* 1: if 'W' at least one character string */ /* value was truncated when it was */ /* stored into a host variable. */ /* * 2: if 'W' a (hopefully) non-fatal notice occurred */ /* 3: empty */ /* 4: empty */ /* 5: empty */ /* 6: empty */ /* 7: empty */ char sqlstate[5]; }; struct sqlca_t *ECPGget_sqlca(void); #ifndef POSTGRES_ECPG_INTERNAL #define sqlca (*ECPGget_sqlca()) #endif #ifdef __cplusplus } #endif #endif #line 16 "app/online/lg_ol_0022.pgc" /* * [업무 개요] * 가맹점 정산 담당자가 특정 가맹점의 현재 원장 잔액을 실시간으로 확인할 때 * 호출한다. 원장(lg_ledger) 은 매출/취소/이월/정산 전표가 상태코드와 금액 * 부호로 누적되므로, 단순 Σamount 는 "가맹점에 귀속되는 순거래액" 을 뜻한다. * * [잔액 산식] * 순거래액(NETAMT) = Σ amount (취소·역분개는 음수로 이미 반영) * 누적수수료(FEESUM) = Σ fee * 지급가능잔액(BALANCE) = NETAMT - FEESUM (가맹점 실지급 기준액) * * [처리 절차] * 1) 요청 TXBUF 에서 MERCHID 를 추출/검증한다. * 2) lg_ledger 를 가맹점 단위로 단일 집계(SELECT) 하여 순액/수수료/건수를 * 한 번에 조회한다. (singleton — 집계는 항상 1행) * 3) 건수가 0 이면 미등록 가맹점으로 보아 RESP_NOMERCH 로 응답한다. * 4) 지급가능잔액을 산출하고 원화 표기 문자열을 함께 구성한다. * * [응답 필드] * RESPCODE 처리결과코드 * MERCHID 가맹점번호(에코) * NETAMT 순거래액 합계 * FEESUM 누적 수수료 합계 * BALANCE 지급가능 잔액(순액-수수료) * CNT 원장 전표 건수 * BALANCEWON 잔액 원화표기(예: 1,234,000원) * * [주의] * 본 서비스는 조회 전용이므로 tx_begin/tx_commit 을 사용하지 않는다. * 집계 결과가 없어도(NOTFOUND) coalesce 로 0 이 보장된다. * * [연계] * 가맹점 지급 배치(정산) 는 본 잔액을 사전 검증값으로 참조하며, 잔액이 * 음수이면 미수(未收) 발생 가맹점으로 분류되어 별도 리스크 리포트에 * 집계된다. 따라서 순액/수수료를 각각 분리 반환하여 상위 화면이 지급가능 * 잔액과 수수료 부담을 구분 표기할 수 있도록 한다. */ TX_SERVICE(LG_OL_0022, ctx) { /* exec sql begin declare section */ #line 58 "app/online/lg_ol_0022.pgc" char h_merch_id [ 16 ] ; #line 59 "app/online/lg_ol_0022.pgc" long h_net ; #line 60 "app/online/lg_ol_0022.pgc" long h_fee_sum ; #line 61 "app/online/lg_ol_0022.pgc" long h_cnt ; /* exec sql end declare section */ #line 62 "app/online/lg_ol_0022.pgc" char merch[16]; char wonbuf[32]; long net_balance; tx_log(TX_LOG_INFO, "[LG_OL_0022] 가맹점 잔액 조회 진입"); if (tx_buf_get(ctx->in, "MERCHID", merch, sizeof(merch)) != TX_OK || merch[0] == '\0') { tx_log(TX_LOG_ERROR, "[LG_OL_0022] MERCHID 누락"); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID); tx_return(ctx, TX_EINVAL, ctx->out); return; } strncpy(h_merch_id, merch, sizeof(h_merch_id) - 1); h_merch_id[sizeof(h_merch_id) - 1] = '\0'; /* 순액/수수료/건수 단일 집계 (singleton) */ { ECPGdo(__LINE__, 0, 1, NULL, 0, ECPGst_normal, "select coalesce ( sum ( amount ) , 0 ) , coalesce ( sum ( fee ) , 0 ) , count ( * ) from lg_ledger where merch_id = $1 ", ECPGt_char,(h_merch_id),(long)16,(long)1,(16)*sizeof(char), ECPGt_NO_INDICATOR, NULL , 0L, 0L, 0L, ECPGt_EOIT, ECPGt_long,&(h_net),(long)1,(long)1,sizeof(long), ECPGt_NO_INDICATOR, NULL , 0L, 0L, 0L, ECPGt_long,&(h_fee_sum),(long)1,(long)1,sizeof(long), ECPGt_NO_INDICATOR, NULL , 0L, 0L, 0L, ECPGt_long,&(h_cnt),(long)1,(long)1,sizeof(long), ECPGt_NO_INDICATOR, NULL , 0L, 0L, 0L, ECPGt_EORT);} #line 88 "app/online/lg_ol_0022.pgc" if (sqlca.sqlcode != TX_SQL_OK && sqlca.sqlcode != TX_SQL_NOTFOUND) { TX_DBIO_LOG_ERR("lg_ol_0022 balance"); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_SYSERR); tx_return(ctx, TX_EDB, ctx->out); return; } if (h_cnt == 0) { tx_log(TX_LOG_WARN, "[LG_OL_0022] 가맹점 원장 없음 merch=%s", merch); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_NOMERCH); tx_buf_sets(ctx->out, "MERCHID", merch); tx_buf_setlong(ctx->out, "BALANCE", 0); tx_return(ctx, TX_ENOENT, ctx->out); return; } /* 잔액 = 순거래액 - 누적 수수료 */ net_balance = h_net - h_fee_sum; amount_format_won(net_balance, wonbuf, sizeof(wonbuf)); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_OK); tx_buf_sets(ctx->out, "MERCHID", merch); tx_buf_setlong(ctx->out, "NETAMT", h_net); tx_buf_setlong(ctx->out, "FEESUM", h_fee_sum); tx_buf_setlong(ctx->out, "BALANCE", net_balance); tx_buf_setlong(ctx->out, "CNT", h_cnt); tx_buf_sets(ctx->out, "BALANCEWON", wonbuf); tx_log(TX_LOG_INFO, "[LG_OL_0022] 잔액조회 완료 merch=%s 잔액=%ld 건수=%ld", merch, net_balance, h_cnt); tx_return(ctx, TX_OK, ctx->out); }