/* @tier medium @module rc @transform reconciliation-online */ /* * rc_ol_0007.pgc - 대사 불일치 예외처리 온라인 서비스 (RC_OL_0007) * * 요청 KEY 의 원장 1건을 읽어 대사 불일치('U') 건에 대한 예외처리를 * 수행한다. 불일치 건만 재대사 대기 상태로 되돌린다. * * 업무규칙: * - 원장 상태가 불일치('U') 가 아니면 예외처리 대상이 아니므로 상태를 * 변경하지 않고 RESULT=SKIP 으로 TX_OK 응답한다. * - 불일치('U') 인 경우 예외처리 → 접수('R') 로 되돌려 재대사 대기로 * 전환한다(ACTION=REQUEUE). 사유(REASON)는 금액 부호로 결정한다: * amount <= 0 → "금액오류" * amount > 0 → "차액검토" * * 응답: KEY, OLDSTATUS, NEWSTATUS, REASON, ACTION * * 동작 요약: * [원장 상태] [ACTION] [NEWSTATUS] [비고] * U (불일치) REQUEUE R 재대사 대기로 복귀 * 그 외(R/M/S) SKIP (원상태) 변경 없음, TX_OK * * 사유(REASON) 결정: 불일치 건의 원장 금액 부호로 구분한다. * amount <= 0 → "금액오류" (금액 자체가 비정상 → 원천 데이터 점검) * amount > 0 → "차액검토" (금액은 정상, 승인/매입 차액 재확인 필요) * * 본 서비스는 단건 상태전이 1회만 수행하므로 커서/명시적 트랜잭션 경계가 * 필요 없다. 재대사는 후속 승인-매입 대사 서비스에서 수행된다. */ #include #include #include "txcore.h" #include "txcore_dbio.h" #include "acq_util.h" #include "rc_core.h" EXEC SQL INCLUDE sqlca; TX_SERVICE(RC_OL_0007, ctx) { rc_rec_t rec; char key[16]; char old_status[2]; int rc; const char *reason; tx_log(TX_LOG_INFO, "[RC_OL_0007] 대사 불일치 예외처리 서비스 진입"); /* --- 요청 필드 추출 --- */ if (tx_buf_get(ctx->in, "KEY", key, sizeof(key)) != TX_OK) { tx_log(TX_LOG_ERROR, "[RC_OL_0007] KEY 누락"); 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_0007] 원장 조회 실패 key=%s rc=%d(%s)", key, rc, tx_strerror(rc)); tx_return(ctx, rc, ctx->out); return; } strncpy(old_status, rec.status, sizeof(old_status) - 1); old_status[sizeof(old_status) - 1] = '\0'; tx_log(TX_LOG_INFO, "[RC_OL_0007] 예외처리 검토 key=%s 가맹점=%s 금액=%ld 현상태=%s", key, rec.merch_id, rec.amount, old_status); /* --- 예외처리 대상 판별: 불일치('U') 만 --- */ if (strcmp(rec.status, RC_ST_FAIL) != 0) { tx_log(TX_LOG_INFO, "[RC_OL_0007] 예외처리 대상 아님 key=%s status=%s → SKIP", key, rec.status); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "KEY", rec.key); tx_buf_sets(ctx->out, "OLDSTATUS", old_status); tx_buf_sets(ctx->out, "NEWSTATUS", old_status); tx_buf_sets(ctx->out, "REASON", "대상아님"); tx_buf_sets(ctx->out, "ACTION", "SKIP"); tx_return(ctx, TX_OK, ctx->out); return; } /* --- 사유 결정: 금액 부호 --- */ if (rec.amount <= 0) { reason = "금액오류"; tx_log(TX_LOG_WARN, "[RC_OL_0007] 비정상 금액 감지 key=%s amount=%ld → 금액오류", key, rec.amount); } else { reason = "차액검토"; tx_log(TX_LOG_INFO, "[RC_OL_0007] 정상 금액, 차액 재검토 지정 key=%s amount=%ld", key, rec.amount); } /* --- 재대사 대기(접수) 로 전이 --- */ rc = rc_rec_update_status(key, RC_ST_RECV); if (rc != TX_OK) { tx_log(TX_LOG_ERROR, "[RC_OL_0007] 재대사 전이 실패 key=%s rc=%d", key, rc); tx_return(ctx, rc, ctx->out); return; } tx_log(TX_LOG_INFO, "[RC_OL_0007] 예외처리 완료 key=%s %s→R 사유=%s", key, old_status, reason); /* --- 응답 구성 --- */ tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "KEY", rec.key); tx_buf_sets(ctx->out, "OLDSTATUS", old_status); tx_buf_sets(ctx->out, "NEWSTATUS", RC_ST_RECV); tx_buf_sets(ctx->out, "REASON", reason); tx_buf_sets(ctx->out, "ACTION", "REQUEUE"); /* 예외처리(재대사 요청) 이력을 rc_exception_log 에 임베디드 SQL 로 적재 */ { EXEC SQL BEGIN DECLARE SECTION; char h_ex_key[16]; char h_ex_old[2]; char h_ex_reason[64]; EXEC SQL END DECLARE SECTION; strncpy(h_ex_key, key, sizeof(h_ex_key) - 1); h_ex_key[sizeof(h_ex_key) - 1] = '\0'; strncpy(h_ex_old, old_status, sizeof(h_ex_old) - 1); h_ex_old[sizeof(h_ex_old) - 1] = '\0'; strncpy(h_ex_reason, reason, sizeof(h_ex_reason) - 1); h_ex_reason[sizeof(h_ex_reason) - 1] = '\0'; if (tx_begin() == TX_OK) { EXEC SQL INSERT INTO rc_exception_log (rec_key, old_status, reason, action) VALUES (:h_ex_key, :h_ex_old, :h_ex_reason, 'REQUEUE'); if (sqlca.sqlcode != TX_SQL_OK) { TX_DBIO_LOG_ERR("INSERT rc_exception_log"); tx_abort(); } else { tx_commit(); } } } tx_return(ctx, TX_OK, ctx->out); }