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

/* @tier medium @module rc @transform reconciliation-online */
/*
 * rc_ol_0004.pgc - 반송(return) 대사 (단건) 온라인 서비스 (RC_OL_0004)
 *
 * 요청 KEY 의 원장 1건을 읽어 매입사에서 통지된 "반송금액(입력 RTNAMT)"
 * 을 원거래금액(원장 amount)과 대사한다.
 *
 * 업무규칙:
 *   - 반송금액은 0 보다 커야 하며 원거래금액을 초과할 수 없다(TX_EINVAL).
 *   - 반송금액 == 원거래금액  → 전액반송(매입취소). 상태를 불일치/보류
 *     ('U') 로 전이하고 RESULT=FULLRETURN.
 *   - 0 < 반송금액 < 원거래금액 → 부분반송. 잔액이 남아 있으므로 접수
 *     ('R') 상태를 유지하고 RESULT=PARTIAL.
 *
 * 응답: KEY, RTNAMT, REMAIN(=amount-RTNAMT), STATUS, RESULT
 *
 * 상태전이 요약:
 *   [입력 RTNAMT]                 [원장 상태]      [RESULT]
 *   RTNAMT <= 0                    (거부)          TX_EINVAL
 *   RTNAMT >  amount               (거부)          TX_EINVAL
 *   RTNAMT == amount               R/… → U         FULLRETURN
 *   0 < RTNAMT < amount            R  유지         PARTIAL
 *
 * 주의: 본 서비스는 원장 금액(amount) 자체를 갱신하지 않는다. 부분반송의
 *       잔액(REMAIN)은 응답으로만 통지하며, 실제 금액 조정은 후속 정산
 *       배치에서 반영한다. 따라서 커서/트랜잭션 경계가 필요 없다.
 */
#include <stdio.h>
#include <string.h>

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

EXEC SQL INCLUDE sqlca;

TX_SERVICE(RC_OL_0004, ctx)
{
    rc_rec_t rec;
    char key[16];
    long rtn_amt = 0;      /* 반송금액 */
    long remain;           /* 반송 후 잔액 */
    int  rc;
    const char *result;
    const char *final_st;

    tx_log(TX_LOG_INFO, "[RC_OL_0004] 반송 대사(단건) 서비스 진입");

    /* --- 요청 필드 추출 --- */
    if (tx_buf_get(ctx->in, "KEY", key, sizeof(key)) != TX_OK) {
        tx_log(TX_LOG_ERROR, "[RC_OL_0004] KEY 누락");
        tx_return(ctx, TX_EINVAL, ctx->out);
        return;
    }
    if (tx_buf_getlong(ctx->in, "RTNAMT", &rtn_amt) != TX_OK) {
        tx_log(TX_LOG_ERROR, "[RC_OL_0004] RTNAMT(반송금액) 누락 key=%s", key);
        tx_return(ctx, TX_EINVAL, ctx->out);
        return;
    }

    /* --- 반송금액 유효성: 0 초과 --- */
    if (rtn_amt <= 0) {
        tx_log(TX_LOG_WARN, "[RC_OL_0004] 반송금액 오류 key=%s rtn=%ld",
               key, rtn_amt);
        tx_return(ctx, TX_EINVAL, ctx->out);
        return;
    }

    /* --- 원장 조회 --- */
    memset(&rec, 0, sizeof(rec));
    rc = rc_rec_select(key, &rec);
    if (rc != TX_OK) {
        tx_log(TX_LOG_WARN, "[RC_OL_0004] 원장 조회 실패 key=%s rc=%d(%s)",
               key, rc, tx_strerror(rc));
        tx_return(ctx, rc, ctx->out);
        return;
    }

    /* --- 반송금액이 원거래금액 초과 → 처리 불가 --- */
    if (rtn_amt > rec.amount) {
        tx_log(TX_LOG_WARN,
               "[RC_OL_0004] 반송금액 초과 key=%s rtn=%ld amount=%ld",
               key, rtn_amt, rec.amount);
        tx_return(ctx, TX_EINVAL, ctx->out);
        return;
    }

    remain = rec.amount - rtn_amt;

    tx_log(TX_LOG_INFO,
           "[RC_OL_0004] 반송 대사 판정 key=%s 가맹점=%s 원거래=%ld 반송=%ld",
           key, rec.merch_id, rec.amount, rtn_amt);

    if (rtn_amt == rec.amount) {
        /* 전액반송 → 매입취소, 불일치/보류 전이 */
        rc = rc_rec_update_status(key, RC_ST_FAIL);
        if (rc != TX_OK) {
            tx_log(TX_LOG_ERROR, "[RC_OL_0004] 전액반송 전이 실패 key=%s rc=%d",
                   key, rc);
            tx_return(ctx, rc, ctx->out);
            return;
        }
        final_st = RC_ST_FAIL;
        result   = "FULLRETURN";
        tx_log(TX_LOG_INFO,
               "[RC_OL_0004] 전액반송 key=%s amount=%ld → 매입취소",
               key, rec.amount);
    } else {
        /* 부분반송 → 잔액 존재, 접수상태 유지 */
        final_st = RC_ST_RECV;
        result   = "PARTIAL";
        tx_log(TX_LOG_INFO,
               "[RC_OL_0004] 부분반송 key=%s rtn=%ld 잔액=%ld → 접수유지",
               key, rtn_amt, remain);
    }

    /* --- 응답 구성 --- */
    tx_buf_reset(ctx->out);
    tx_buf_sets(ctx->out, "KEY", rec.key);
    tx_buf_setlong(ctx->out, "RTNAMT", rtn_amt);
    tx_buf_setlong(ctx->out, "REMAIN", remain);
    tx_buf_sets(ctx->out, "STATUS", final_st);
    tx_buf_sets(ctx->out, "RESULT", result);

    /* 반송 대사 결과를 반송이력(rc_return_log)에 임베디드 SQL 로 적재 */
    {
        EXEC SQL BEGIN DECLARE SECTION;
        char h_rl_key[16];
        long h_rl_rtn;
        long h_rl_remain;
        char h_rl_result[12];
        EXEC SQL END DECLARE SECTION;

        strncpy(h_rl_key, key, sizeof(h_rl_key) - 1);
        h_rl_key[sizeof(h_rl_key) - 1] = '\0';
        h_rl_rtn    = rtn_amt;
        h_rl_remain = remain;
        strncpy(h_rl_result, result, sizeof(h_rl_result) - 1);
        h_rl_result[sizeof(h_rl_result) - 1] = '\0';

        if (tx_begin() == TX_OK) {
            EXEC SQL INSERT INTO rc_return_log
                (rec_key, rtn_amt, remain_amt, return_result)
                VALUES (:h_rl_key, :h_rl_rtn, :h_rl_remain, :h_rl_result);
            if (sqlca.sqlcode != TX_SQL_OK) {
                TX_DBIO_LOG_ERR("INSERT rc_return_log");
                tx_abort();
            } else {
                tx_commit();
            }
        }
    }

    tx_return(ctx, TX_OK, ctx->out);
}