c3a0259e95
- 템플릿 클론(정규화 후 0줄 상이) → 전 코퍼스 530/530 고유 바디 - 11개 모듈(mg/au/ac/rc/vl/st/py/lg/mm/cm/cl) 각 파일이 distinct한 매입·대사·정산·수수료·지급·원장·마감·마스터·정합성·전문게이트웨이·공통 업무 - TxCore(ATMI 유사) + ECPG(EXEC SQL) 관용구, 프레임워크/헤더/DBIO API/파일ID·경로 유지 - 전체 docker make -j4 = EXIT 0, 958 오브젝트, 데모 바이너리 링크 - inventory.json loc 실측 갱신 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
123 lines
4.6 KiB
Text
123 lines
4.6 KiB
Text
/* @tier hard @module lg @transform ledger-online */
|
|
/*
|
|
* lg_ol_0022.pgc - 원장 온라인 서비스 (LG_OL_0022) [tier=hard]
|
|
*
|
|
* 가맹점 잔액 조회: 특정 가맹점의 원장 순액(Σamount)과 수수료 합(Σfee),
|
|
* 전표 건수를 단일 집계 SELECT 로 조회하여 잔액을 응답한다. (조회 전용)
|
|
*/
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
|
|
#include "txcore.h"
|
|
#include "txcore_dbio.h"
|
|
#include "acq_util.h"
|
|
#include "lg_core.h"
|
|
|
|
EXEC SQL INCLUDE sqlca;
|
|
|
|
/*
|
|
* [업무 개요]
|
|
* 가맹점 정산 담당자가 특정 가맹점의 현재 원장 잔액을 실시간으로 확인할 때
|
|
* 호출한다. 원장(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;
|
|
char h_merch_id[16];
|
|
long h_net;
|
|
long h_fee_sum;
|
|
long h_cnt;
|
|
EXEC SQL END DECLARE SECTION;
|
|
|
|
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) */
|
|
EXEC SQL SELECT coalesce(sum(amount), 0),
|
|
coalesce(sum(fee), 0),
|
|
count(*)
|
|
INTO :h_net, :h_fee_sum, :h_cnt
|
|
FROM lg_ledger
|
|
WHERE merch_id = :h_merch_id;
|
|
|
|
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);
|
|
}
|