계약 참조와 청구번호
계약의 식별자, 계약 사이의 관계, 발행된 청구서 번호, 청구 회차를 분리합니다.
상태 — 2026-10-13 KST
모든 계약의 참조 계약을 선택 항목으로 두고, Leyve의 최초 비용 부속 계약을 정규 계약과 연결하는 제품 방향을 기록합니다. 번호 체계와 연결 UI는 공식 문서를 근거로 한 채택 가이드입니다. 이 문서만으로 새 저장 스키마·자동 채번 기능·제품 배포가 완료된 것은 아닙니다.
식별과 관계
공통 레코드 식별 필드가 먼저 적용됩니다. 내부 연결은 화면에 노출하지 않는 id, 사람이 찾는 코드는 managementCode입니다. 아래의 ‘계약번호’는 계약 관리코드의 문서상 의미이며 새 식별 필드를 하나 더 만들라는 뜻이 아닙니다. 기존 화면 라벨·필드 이름은 공통 표준을 따릅니다. 외부 등록번호와 법령이 정한 세금계산서 번호는 별도이며, 기존 제품의 청구번호 저장 필드를 문서 개정만으로 자동 이관하지 않습니다.
| 항목 | 역할 | 예시 또는 표시 |
|---|---|---|
| 계약 내부 ID | 관계·권한·이력 연결의 안정된 키 | 화면 표시명을 바꿔도 유지 |
| 계약번호(계약 관리코드) | 사람이 찾고 대조하는 계약 고유번호 | 공통 관리코드 규칙, 제품이 정한 레코드 접두어 |
| 참조 계약 | 다른 계약과의 선택적 연결 | 계약명 + 계약번호로 검색·선택 |
| 청구서 내부 ID | 발행 문서·결제·정정의 안정된 키 | 계약 내부 ID와 별개 |
| 청구번호 | 발행된 청구서의 고유번호 | 승인된 번호 시리즈의 연속번호 |
| 청구 근거 계약 | 해당 청구가 속하는 계약 | 계약번호와 제목, 계약 상세 링크 |
| 청구 회차 | 그 계약의 청구 스케줄 순번 | 1 / 12회, 2 / 12회; 종료없음은 현재 회차 표시 |
청구서 한 장은 계약 하나에 속하고, 반복 계약 하나는 회차별 청구서를 여러 장 가집니다. 이는 Leyve의 문서 귀속 정책입니다. 여러 계약을 한 장으로 합산하는 다른 제품의 기능을 업계에서 불가능하다고 설명하지 않습니다.
참조 계약은 선택 항목
기본 계약과 부속 계약을 포함한 모든 계약에 참조 계약을 둘 수 있고, 비워 두어도 유효합니다. 시스템에 있는 계약은 이름·번호로 찾아 연결하고 양쪽 상세에서 관계를 찾을 수 있게 합니다. 번호 문자열만 저장해 실제 계약 링크를 잃지 않도록 합니다.
일반 관련 계약과 상위·부속 관계는 의미가 다릅니다. 참조만으로 가격·기간·청구·권한을 상속하지 않습니다. Leyve의 최초 비용 부속 계약은 정규 계약을 명시적으로 참조하되 독립된 계약과 한 번의 청구를 유지합니다.
외부 계약번호를 지원한다면 내부 연결과 구분해 출처·번호를 보존합니다. 외부 문자열이 내부 계약에 자동으로 일치한다고 추정하지 않습니다. 조회 권한이 없는 다른 조직의 계약은 검색 결과에 노출하지 않습니다. 상위·하위 관계를 채택할 때는 자기 참조와 순환을 검증합니다.
Oracle은 관련 계약과 역방향 연결을 제공하고, Salesforce는 상위 계약과 하위 계약 목록을 제공합니다. 관계를 관리하는 근거이며 특정 계약의 내용을 자동으로 상속하라는 근거는 아닙니다. Oracle 공식 문서 (새 탭), Salesforce 공식 문서 (새 탭)
청구번호와 회차를 섞지 않습니다
Stripe는 고객별 또는 발행 계정 전체의 연속번호를 지원합니다. Chargebee는 접두어, 날짜 접두어와 증가하는 숫자를 구성합니다. 이는 번호 시리즈이며 계약의 1회차·2회차와 같지 않습니다. Stripe 공식 문서 (새 탭), Chargebee 공식 문서 (새 탭)
Peppol BIS Billing은 청구서 고유번호와 선택적인 계약 참조를 별도 필드로 둡니다. 이는 문서 구조의 참고이며 Peppol 채택이나 특정 국가의 세금계산서 적합성을 선언하지 않습니다. 청구서 ID (새 탭), 계약 참조 (새 탭)
레이브에서 검토한 origin code의 뜻이 청구 근거라면 계약번호로 명확하게 이름 붙입니다. 정정 대상인 이전 청구서를 뜻한다면 원 청구번호이며 다른 필드입니다. Peppol도 이전 청구서 참조를 계약 참조와 분리합니다. 이전 청구서 참조 (새 탭)
번호에 계약번호·회차를 모두 이어 붙여야 한다는 국제 공통 규칙은 이 자료들에서 확인되지 않았습니다. 필요한 문맥은 청구번호 / 계약번호 / 회차 / 대상 기간으로 보여줍니다. 관리코드로 채택하는 번호는 공통 표준의 접두어-일련번호, 저장 시 확정, 수정 불가, 삭제한 번호 재사용 금지와 소유 범위 내 고유성을 따릅니다. 외부 업체의 날짜별 초기화 기능을 그대로 기본값으로 도입하지 않습니다. 법정 문서의 발행번호와 외부 연동 번호는 해당 번호 정책을 따릅니다. 예시 코드가 국제 표준이라고 설명하거나 기존 기록을 새 형식으로 재채번하지 않습니다.
계약 당사자·청구 수취 당사자·납부 당사자는 계정 관계 표준의 명시적 참조를 유지합니다. 참조 계약을 연결하거나 제3자가 납부해도 당사자나 권한이 바뀌지 않습니다.
재시도·변경
- 발행 주체·번호 시리즈 범위의 고유성을 저장 단계에서 보장합니다. 취소된 문서의 번호도 재사용하지 않습니다.
- 같은 청구 의도의 재시도는 같은 내부 발행 요청 키와 멱등 키를 유지합니다. 결제 시도 실패나 재전송만으로 청구번호·회차를 새로 만들지 않습니다.
- 계약명이나 참조 계약을 바꿔도 발행 당시 계약 근거와 청구서를 소급 변경하지 않습니다.
- 청구 정정에는 원 청구서와의 관계·사유·변경 근거를 보존합니다.
청구 회차의 수는 청구 기간 정책의 실제 스케줄에서 나옵니다. 일반 B의 12개월 약정은 13회가 될 수 있으므로 계약 개월 수를 회차 수에 그대로 복사하지 않습니다.