> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meterengine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 예정액, 확정액, 수납액

> 화면과 API에 나오는 금액의 뜻과 세액, 절사 규칙을 설명합니다.

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

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

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

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

## 어디에 어떤 금액이 나오나

| 콘솔 표기 | 세금 | 뜻 | API |
| - | - | - | - |
| '개요' 화면의 '청구 예정액' | 빼고 | 선택한 달의 미확정 고객 공급가액 합 | `GET /v1/dashboard`의 `draft_supply_amount` |
| '청구 검토' 화면의 금액 | 빼고 | 미확정 고객별 공급가액과 라인 금액 | `GET /v1/invoices/draft`의 `total_amount`, `customers[].amount`, `lines[].amount` |
| '개요' 화면의 '확정 청구액' | 포함 | 선택한 달에 확정한 인보이스 합계의 합 | `GET /v1/dashboard`의 `finalized_total_amount` |
| '확정 인보이스' 화면의 고객별 '금액'과 그 아래 '공급가액', '세액' | 나눠서 | 고객 줄의 '금액'은 합계(세금 포함), 아래 줄은 확정할 때 저장한 공급가액과 세액 | `GET /v1/invoices`의 `supply_amount`, `tax_amount`, `total_amount` |
| '수납과 취소' 화면의 '청구액', '취소액' | 포함 | 인보이스 합계와 그중 결제를 취소한 금액 | `GET /v1/invoice-payments`의 `amount`, `canceled_amount` |
| '개요' 화면의 '결제 대기액' | 포함 | 결제 전, 결과 확인 중, 실패인 인보이스의 청구액 합 | `GET /v1/dashboard`의 `outstanding_amount` |
| '개요' 화면의 '순수납액' | 포함 | 결제가 끝난 인보이스의 청구액에서 취소액을 뺀 합 | `GET /v1/dashboard`의 `collected_amount` |

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

## 청구 예정액

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

**total\_amount** `integer`

남은 고객의 청구 예정액 합. 원 단위, 세금 제외.

**customers** `object[]`

고객별 청구 예정액.

**customers 항목**

**amount** `integer`

그 고객의 라인 금액 합. 원 단위, 세금 제외.

**lines** `object[]`

금액 라인. 미터와 조합, 구간마다 생기는 라인과 기본료, 최소 사용료 조정 라인이 있고 `line_type`으로 구분합니다. 라인마다 `amount`는 10원 미만을 버린 금액입니다. `quantity`는 표시용이고, 금액은 `quantity_numerator`를 `quantity_denominator`로 나눈 정확한 수량에 `unit_price`를 곱해 계산합니다.

**unpriced\_usages** `object[]`

단가가 없어 금액에 들지 않은 조합의 사용량.

**negative\_usages** `object[]`

합계가 음수라 0원으로 보고 라인에서 뺀 조합의 사용량.

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

금액은 인보이스 라인마다 10원 미만을 버린 뒤 더합니다. 라인은 고객, 미터, 속성 조합마다 하나이고, 구간 단가(`graduated`)는 구간마다 라인이 따로 생깁니다. 기본료와 최소 사용료 조정도 10원 미만을 버린 금액으로 라인이 됩니다.

| 라인 | 수량 x 단가 | 라인 금액 |
| - | - | - |
| A | 7 x 3원 = 21원 | 20원 |
| B | 15 x 0.5원 = 7.5원 | 0원 |
| C | 5 x 3원 = 15원 | 10원 |
| D | 5 x 3원 = 15원 | 10원 |

C와 D가 같은 고객의 라인이면 그 고객의 합계는 30원이 아니라 20원입니다. 버림은 합친 뒤가 아니라 라인마다 일어납니다.

> [!WARNING]
>
> 단가가 작은 미터는 라인 금액이 10원이 안 되어 0원이 되기 쉽습니다. 사용량이 적은 고객에게 금액이 생기지 않으면 단가와 과금 단위 크기를 함께 보세요. [미터 설계](https://docs.meterengine.com/pricing/meters.md), [단가 모델과 버전](https://docs.meterengine.com/pricing/price-models.md)

구간 단가, 기본료, 최소 사용료이 섞인 숫자 예시는 [금액 계산 따라가기](https://docs.meterengine.com/pricing/calculation-example.md)에 있습니다.

## 세액

세액은 공급가액의 10%입니다. 확정할 때 `tax_amount = supply_amount x 10 / 100`으로 계산하고 `total_amount = supply_amount + tax_amount`입니다. 라인마다 10원 미만을 버리므로 공급가액은 늘 10원 단위이고, 세액은 공급가액의 정확히 10%가 됩니다.

| `supply_amount` | `tax_amount` | `total_amount` |
| - | - | - |
| 12,340 | 1,234 | 13,574 |
| 2,000 | 200 | 2,200 |

'청구 검토' 화면에서 고객 금액이 12,340원이고 그대로 확정하면, 그 인보이스의 결제 금액은 13,574원입니다.

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

집계 마감(다음 달 1일 13:00 KST)이 지난 달은 확정 금액과 라인이 확정하는 순간의 청구 예정액과 같습니다. 세액이 더해지고 수량이 0인 라인이 빠지는 것만 다릅니다. 지난달 단가와 요금제는 바꿀 수 없고, 마감 뒤 받은 이벤트는 집계에 들지 않으므로 마감 뒤에는 예정액이 더 움직이지 않습니다.

아래 경우에는 앞서 본 예정액과 확정 금액이 다를 수 있습니다.

* **마감 전에 확정한 경우**: 확정하는 순간까지 받은 이벤트로 확정합니다. 확정 뒤 마감 전까지 들어온 그 고객의 그 달 이벤트는 청구되지 않습니다.
* **예정액을 본 뒤 이벤트가 더 들어온 경우**: 마감 전이면 예정액은 조회할 때마다 늘어나고, 확정은 확정하는 순간의 값으로 합니다.
* **이번 달 단가나 요금제를 바꾼 경우**: 이번 달에 시작하는 단가 버전은 덮어쓸 수 있고, 예정액은 바뀐 단가로 다시 계산됩니다.

수량이 0인 라인은 인보이스에 싣지 않습니다. 금액에는 영향이 없습니다.

## 수납액

결제는 인보이스의 `total_amount`(세금 포함)로 요청합니다. 결제를 취소해도 인보이스 금액은 바뀌지 않습니다. 취소한 금액은 `canceled_amount`로 따로 쌓이고, '순수납액'은 결제가 끝난 인보이스의 청구액에서 취소액을 뺀 값입니다. 취소한 금액은 '결제 대기액'으로 다시 잡히지 않습니다. [결제 취소](https://docs.meterengine.com/payments/cancellations.md)

## 금액에 들지 않는 사용량

아래 사용량은 청구 예정액과 인보이스의 금액에 들지 않습니다. 각각 원인과 확인 방법은 [이벤트가 청구에 안 보일 때](https://docs.meterengine.com/troubleshooting/events-not-billed.md)를 보세요.

* 단가가 없는 조합의 사용량(`unpriced_usages`). 단가가 없는 조합의 사용량은 청구되지 않습니다. [차원과 속성 조합](https://docs.meterengine.com/pricing/dimensions.md)
* 한 조합의 합계가 음수인 사용량(`negative_usages`). 그 조합은 0원으로 보고 라인에서 뺍니다.
* 집계 마감 뒤에 받은 그 달 이벤트.
* 아직 시각이 지나지 않은 미래 시각 이벤트.

## 0원 고객과 인보이스 번호

* 0원 고객은 확정해도 인보이스가 생기지 않습니다. [인보이스 수동 확정](https://docs.meterengine.com/billing/finalize-invoices.md)
* 인보이스의 `invoice_number`는 고객에게 보여 주는 인보이스 번호이고 세금계산서나 영수증 번호가 아닙니다. MeterEngine은 전자세금계산서를 발행하지 않습니다. [공급자 정보](https://docs.meterengine.com/account/supplier.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.