acquire-core-full/app/online/lg_ol_0022.c

/* Processed by ecpg (15.18 (Debian 15.18-0+deb12u1)) */
/* These include files are added by the preprocessor */
#include <ecpglib.h>
#include <ecpgerrno.h>
#include <sqlca.h>
/* 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 <stdio.h>
#include <string.h>

#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);
}