메인 콘텐츠로 건너뛰기
MeterEngine 응답의 금액 필드는 원 단위 정수입니다(단가 unit_price는 소수일 수 있습니다). 같은 고객의 같은 달 금액이라도 청구 예정액, 확정 청구액, 수납액은 세금 포함 여부와 계산 시점이 달라 서로 다른 숫자로 보입니다.

청구 예정액

아직 확정하지 않은 고객의 금액입니다. 세금을 뺀 공급가액이고 조회할 때마다 다시 계산합니다.

확정 청구액

인보이스를 확정할 때 저장한 금액입니다. 공급가액, 세액, 합계(세금 포함)가 고정됩니다.

수납액

결제로 받은 금액입니다. 세금을 포함한 합계로 결제하고, 취소한 금액은 따로 셉니다.

어디에 어떤 금액이 나오나

청구 예정액은 세금을 뺀 공급가액이고, 결제는 세금을 포함한 확정 금액(total_amount)으로 합니다. 같은 고객인데 ‘청구 검토’ 화면과 ‘수납과 취소’ 화면의 금액이 다르면 세액만큼 차이 나는 것이 정상입니다.

청구 예정액

  • 아직 확정하지 않은 고객만 나옵니다. 그 달을 확정한 고객은 청구 예정액에서 빠지고 확정 인보이스로 옮겨 갑니다.
  • 조회할 때마다 그 순간의 이벤트, 미터, 단가로 계산하며 저장하지 않습니다. 이번 달 금액은 이벤트가 들어올수록 늘어납니다.
  • 그 달에 생겼고 집계 마감(다음 달 1일 13:00 KST) 전에 받은 이벤트만 셉니다. 시간 규칙
  • 세액 필드가 없습니다. 확정하면 붙을 세액은 아래 세액 규칙으로 직접 계산합니다.
integer
남은 고객의 청구 예정액 합. 원 단위, 세금 제외.
object[]
고객별 청구 예정액.

라인마다 10원 미만을 버립니다

금액은 인보이스 라인마다 10원 미만을 버린 뒤 더합니다. 라인은 고객, 미터, 속성 조합마다 하나이고, 구간 단가(graduated)는 구간마다 라인이 따로 생깁니다. 기본료와 최소 사용료 조정도 10원 미만을 버린 금액으로 라인이 됩니다. C와 D가 같은 고객의 라인이면 그 고객의 합계는 30원이 아니라 20원입니다. 버림은 합친 뒤가 아니라 라인마다 일어납니다.
단가가 작은 미터는 라인 금액이 10원이 안 되어 0원이 되기 쉽습니다. 사용량이 적은 고객에게 금액이 생기지 않으면 단가와 과금 단위 크기를 함께 보세요. 미터 설계, 단가 모델과 버전
구간 단가, 기본료, 최소 사용료이 섞인 숫자 예시는 금액 계산 따라가기에 있습니다.

세액

세액은 공급가액의 10%입니다. 확정할 때 tax_amount = supply_amount x 10 / 100으로 계산하고 total_amount = supply_amount + tax_amount입니다. 라인마다 10원 미만을 버리므로 공급가액은 늘 10원 단위이고, 세액은 공급가액의 정확히 10%가 됩니다. ‘청구 검토’ 화면에서 고객 금액이 12,340원이고 그대로 확정하면, 그 인보이스의 결제 금액은 13,574원입니다.

예정액과 확정액이 달라지는 경우

집계 마감(다음 달 1일 13:00 KST)이 지난 달은 확정 금액과 라인이 확정하는 순간의 청구 예정액과 같습니다. 세액이 더해지고 수량이 0인 라인이 빠지는 것만 다릅니다. 지난달 단가와 요금제는 바꿀 수 없고, 마감 뒤 받은 이벤트는 집계에 들지 않으므로 마감 뒤에는 예정액이 더 움직이지 않습니다. 아래 경우에는 앞서 본 예정액과 확정 금액이 다를 수 있습니다.
  • 마감 전에 확정한 경우: 확정하는 순간까지 받은 이벤트로 확정합니다. 확정 뒤 마감 전까지 들어온 그 고객의 그 달 이벤트는 청구되지 않습니다.
  • 예정액을 본 뒤 이벤트가 더 들어온 경우: 마감 전이면 예정액은 조회할 때마다 늘어나고, 확정은 확정하는 순간의 값으로 합니다.
  • 이번 달 단가나 요금제를 바꾼 경우: 이번 달에 시작하는 단가 버전은 덮어쓸 수 있고, 예정액은 바뀐 단가로 다시 계산됩니다.
수량이 0인 라인은 인보이스에 싣지 않습니다. 금액에는 영향이 없습니다.

수납액

결제는 인보이스의 total_amount(세금 포함)로 요청합니다. 결제를 취소해도 인보이스 금액은 바뀌지 않습니다. 취소한 금액은 canceled_amount로 따로 쌓이고, ‘순수납액’은 결제가 끝난 인보이스의 청구액에서 취소액을 뺀 값입니다. 취소한 금액은 ‘결제 대기액’으로 다시 잡히지 않습니다. 결제 취소

금액에 들지 않는 사용량

아래 사용량은 청구 예정액과 인보이스의 금액에 들지 않습니다. 각각 원인과 확인 방법은 이벤트가 청구에 안 보일 때를 보세요.
  • 단가가 없는 조합의 사용량(unpriced_usages). 단가가 없는 조합의 사용량은 청구되지 않습니다. 차원과 속성 조합
  • 한 조합의 합계가 음수인 사용량(negative_usages). 그 조합은 0원으로 보고 라인에서 뺍니다.
  • 집계 마감 뒤에 받은 그 달 이벤트.
  • 아직 시각이 지나지 않은 미래 시각 이벤트.

0원 고객과 인보이스 번호

  • 0원 고객은 확정해도 인보이스가 생기지 않습니다. 인보이스 수동 확정
  • 인보이스의 invoice_number는 고객에게 보여 주는 인보이스 번호이고 세금계산서나 영수증 번호가 아닙니다. MeterEngine은 전자세금계산서를 발행하지 않습니다. 공급자 정보