공과금 공급계약

정의

공급계약은 공과금 납부자를 식별하는 고유 번호와 각종 계약 정보를 정의합니다.

구성 요소

TypeScript

TypeScript로 보여주는 고객번호의 인터페이스입니다.

interface SupplyContract {
  customer_number: string; // 고객번호
  type: "WATER" | "ELECTRICITY" | "GAS"; // 공과금 종류
  supplier: string; // 공급자 이름
  meter_number: string; // 계량기 번호
  alias?: string; // 별칭
  memo?: string; // 메모
  charge_common?: boolean; // 공통 요금
  charge_individual?: boolean; // 개별 요금
}

Kotlin

Kotlin으로 보여주는 고객번호의 데이터 클래스입니다.

data class SupplyContract(
  val customerNumber: String, // 고객번호
  val type: String, // 공과금 종류
  val supplier: String, // 공급자 이름
  val meterNumber: String, // 계량기 번호
  val alias: String? = null, // 별칭
  val memo: String? = null, // 메모
  val chargeCommon: Boolean = false, // 공통 요금
  val chargeIndividual: Boolean = false // 개별 요금
)

고객번호 (customerNumber)

타입: string

설명: 공과금 납부자를 식별하는 고유 번호입니다.

목적: 고객 정보를 관리하고 조회하기 위해 필요합니다.

공과금 종류 (type)

타입: "WATER" | "ELECTRICITY" | "GAS"

설명: 고객이 사용하는 공과금의 종류입니다.

목적: 공과금 종류에 따라 다른 관리 및 요금 체계를 적용하기 위해 필요합니다.

공급자 (supplier)

타입: string

설명: 고객이 사용하는 공과금을 공급하는 업체의 이름입니다.

목적: 공급 업체 정보를 관리하고, 고객과의 계약을 추적하기 위해 필요합니다.

별칭 (alias)

타입: string?

설명: 고객의 별칭이나 추가 식별 정보를 저장하는 공간입니다.

목적: 고객을 더 쉽게 식별하고 관리하기 위해 필요합니다.

공통 요금 (chargeCommon)

타입: boolean

설명: 공용 요금을 계산하고, 해당 금액을 QIRO 고지서에 포함할지 여부입니다. true로 설정하면, 공과금에서 호실별 사용량을 제외한 공용 사용량을 기준으로 공용 요금을 산정합니다.

목적: 공통 요금이 적용되는 고객을 구분하고 관리하기 위해 필요합니다.

개별 요금 (chargeIndividual)

타입: boolean

설명: 개별 요금을 계산하고, 해당 금액을 QIRO 고지서에 포함할지 여부입니다. true로 설정하면, 공과금의 총 사용량 중 각 호실의 사용량 비율을 기준으로 개별 요금을 산정합니다.

목적: 개별 요금이 적용되는 고객을 구분하고 관리하기 위해 필요합니다.