Ledger / Journal
와이어바알리 다니면서 국내, 해외 은행 / 파트너사에서 원장 받아서
원장 대사 하던 기억이 나서 정리해놓는다.
어디는 계좌 내역이고,
어디는 원장을 주고,
어디는 전표를 주고,
어디는 API사용 내역을 주고
한국의 은행은 계좌 내역을 줬는데
해외은행 대부분은 Journal을 준거였구나.
태국의 어디는 일단뒤 Ledger를 ftp에 올려두고 알아서 봐라 했었군..
csv로 준거 cat 돌려서 한달치를 하나로 합친 기억이….
REVERSED….
| English | 한글 | 설명 |
|---|---|---|
| Ledger | 원장 | 거래를 누적 기록하는 장부. 잔액/내역 산출의 근거 데이터. |
| General Ledger (GL) | 총계정원장 | 회사 회계 기준의 “공식 원장”. 계정과목 단위로 집계되는 최종 장부. |
| Subledger | 보조원장 | GL의 보조 상세 원장. 고객/계좌/상품 등 상세 차원으로 GL을 뒷받침. |
| Customer Subledger | 고객 보조원장 | 고객별 예수금/포지션 등 잔액을 상세 추적하는 보조원장. |
| Ledger Account | 원장 계정(계정과목) | 엔트리가 귀속되는 계정. 예: 고객예수금, 수수료수익, 미수금, 미지급금. |
| Chart of Accounts (CoA) | 계정과목 체계 | 계정 코드/계층/분류 체계. 시스템에서 account_code로 관리. |
| Journal | 전표(분개) | “거래 사건 1건”을 묶는 컨테이너. 여러 원장 라인(Entries)로 구성. |
| Journal Entry | 전표(분개) | 문맥에 따라 Journal과 동일 의미로 쓰이거나, 전표 기록 행을 의미. (용어 혼용 많음) |
| Ledger Entry | 원장 엔트리(원장 라인) | 전표를 구성하는 개별 라인. 계정, 금액, 차/대 방향, 대상(고객/계좌) 등을 가짐. |
| Posting | 전기 | 전표/엔트리를 원장에 “확정 반영”하는 행위. (PENDING → POSTED) |
| Posted | 전기됨(확정) | 원장에 확정 반영된 상태. 일반적으로 변경(UPDATE)하지 않음. |
| Pending | 대기(미확정) | 외부확인/결제 전 임시 상태. 이후 POSTED 또는 REVERSED. |
| Reversal Entry | 역분개(반대 분개) | 기존 엔트리를 취소하기 위해 동일 금액 반대 방향으로 추가 기록하는 방식. |
| Adjustment Entry | 조정분개 | 오류/차이 조정을 위해 추가로 기록하는 엔트리(원본 수정 대신). |
| Correction | 정정 | 회계적으로는 보통 “정정 전표/역분개+재기장” 형태로 구현. |
| Debit (DR) | 차변 | 회계의 한쪽 방향. 자산/비용 증가 또는 부채/자본 감소 등(계정 유형에 따라 해석). |
| Credit (CR) | 대변 | 회계의 반대쪽 방향. 자산/비용 감소 또는 부채/자본 증가 등. |
| Double-entry Accounting | 복식부기 | 모든 거래를 차변/대변 라인으로 기록하여 합계가 일치(0-sum)하도록 하는 원칙. |
| Balance | 잔액 | 특정 계정/고객/통화/상품의 누적 결과. 원장 엔트리 합으로 산출. |
| Running Balance | 누적잔액 | 시간순으로 누적한 잔액(명세서/statement에서 자주 필요). |
| Opening Balance | 기초잔액 | 기간 시작 시점의 잔액. |
| Closing Balance | 기말잔액 | 기간 종료 시점의 잔액. |
| Effective Date/Time | 효력일시 | 경제적 효력이 발생한 시각(체결시각 등). |
| Posting Date/Time | 전기일시 | 시스템 원장에 반영(전기)된 시각. 발생시각과 다를 수 있음. |
| Event | 이벤트 | 비즈니스에서 “무슨 일이 발생했는지” (입금, 체결, 정산 등). |
| Transaction | 트랜잭션(거래) | 문맥에 따라 이벤트/전표와 혼용. DB 트랜잭션과 혼동 주의. |
| Idempotency Key | 멱등키 | 중복 요청/재처리 시 엔트리 중복 기록을 방지하는 키(external_ref 등). |
| Reference / External Ref | 외부참조키 | 은행거래ID, 주문ID, 체결ID 등 외부/상위 시스템과 연결되는 식별자. |
| Reconciliation | 대사 | 외부기관(은행/거래소/예탁원) 데이터와 원장 기록을 비교해 정합성 확인. |
| Settlement | 결제/정산 | 체결 이후 실제 현금/증권이 이동하며 확정되는 단계(D+2 등). |
| Cleared | 클리어(정산 완료) | 결제/정산이 완료되어 불확실성이 제거된 상태. |
| Hold / Reserve | 홀드/보류 | 가용 잔액에서 잠그는 처리(주문 증거금, 출금 대기 등). |
| Available Balance | 가용잔액 | 즉시 사용할 수 있는 잔액(총잔액 - 보류/대기). |
| Ledger vs Balance Table | 원장 vs 잔액 테이블 | 원장은 불변 로그, 잔액 테이블은 조회 성능을 위한 스냅샷/집계(정합성 필요). |