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>
125 lines
4.5 KiB
Text
125 lines
4.5 KiB
Text
/* @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 "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);
|
|
tx_return(ctx, TX_OK, ctx->out);
|
|
}
|