인보이스 수동 확정

​

확정의 범위

• 달 전체를 한 번에 확정합니다. 그 달 청구 예정액이 0원이 아닌 고객을 모두 확정합니다. 고객 하나만 골라 확정하는 방법은 없습니다. 콘솔에서 검색 조건으로 고객을 좁혀 놓아도 그 달 전체가 확정됩니다.
• 업무 환경마다 따로 확정합니다. 지금 쓰는 업무 환경의 고객만 확정하며, 테스트 환경을 확정해도 실제 환경은 그대로입니다. 업무 환경은 업무 환경을 보세요.
• 0원 고객은 인보이스를 만들지 않습니다. 청구 예정액이 0원인 고객은 확정에서 건너뜁니다. 그 달 이벤트가 없는 고객이 여기에 해당하고, 단가 없는 사용량만 있는 고객도 요금제의 기본료나 최소 사용료가 붙지 않으면 0원입니다. 집계 마감 전에 확정했다면, 그 뒤 마감 전까지 금액이 생긴 고객을 같은 달로 다시 확정할 수 있습니다.
• 세액은 공급가액의 10%입니다. 인보이스에는 공급가액(supply_amount), 세액(tax_amount), 합계(total_amount)가 찍힙니다. 금액 용어는 예정액, 확정액, 수납액을 보세요.
• 필요 권한: 확정은 admin(전체 관리), 청구 예정액과 인보이스 조회는 read(조회) 권한이 필요합니다. 권한은 화면과 API, 권한을 보세요.

​

언제 확정하나

​

콘솔에서 확정하기

​

API로 확정하기

curl "https://meterengine.com/v1/invoices/draft?month=2026-10" \
  -H "Authorization: Bearer me_test_xxxxxxxx"

curl -X POST "https://meterengine.com/v1/invoices?month=2026-10" \
  -H "Authorization: Bearer me_test_xxxxxxxx"

const response = await fetch("https://meterengine.com/v1/invoices?month=2026-10", {
  method: "POST",
  headers: { Authorization: "Bearer me_test_xxxxxxxx" },
});
const body = await response.json();
if (!response.ok) throw new Error(`확정 실패: ${body.code}`);
if (body.failed_count > 0) {
  // 같은 달로 다시 부르면 확정하지 못한 고객만 다시 시도합니다.
}

{
  "month": "2026-10",
  "finalized_count": 1,
  "failed_count": 0,
  "invoices": [
    {
      "id": "6f1c2b9e-3d4a-4c8b-9e2f-1a7b5c3d9e01",
      "invoice_number": "ME-202610-00000012",
      "customer_id": "0b8e4f2a-7c1d-4e5b-a9f3-2d6c8e1b4a70",
      "customer_name": "에이컴퍼니",
      "month": "2026-10",
      "cutoff_at": "2026-11-01T13:00:00+09:00",
      "finalized_at": "2026-11-02T10:15:30+09:00",
      "supply_amount": 12000,
      "tax_amount": 1200,
      "total_amount": 13200,
      "lines": [
        {
          "billable_metric_code": "llm_tokens",
          "billable_metric_name": "LLM 토큰",
          "target_property": "tokens",
          "dimension_values": { "model": "small" },
          "quantity": 1200,
          "unit_price": 10,
          "amount": 12000,
          "line_type": "per_unit",
          "tier_index": 0,
          "quantity_numerator": 1200,
          "quantity_denominator": 1
        }
      ]
    }
  ],
  "supply_amount": 12000,
  "tax_amount": 1200,
  "total_amount": 13200
}

curl "https://meterengine.com/v1/invoices?month=2026-10" \
  -H "Authorization: Bearer me_test_xxxxxxxx"

​

확정 응답 필드

​

오류

​

다시 부르기와 실패한 고객

• 같은 달로 다시 부르거나 동시에 불러도 인보이스가 겹치지 않습니다. 그 달이 이미 확정된 고객은 건너뜁니다. 응답을 받지 못했으면 같은 요청을 다시 보내도 됩니다.
• 고객마다 따로 확정합니다. 한 고객이 실패해도 다른 고객의 확정은 남고, 실패한 고객은 failed_count에 셉니다.
• 응답에는 실패한 고객의 수만 실리고 어느 고객이 왜 실패했는지는 실리지 않습니다. 확정되지 않고 남은 고객은 GET /v1/invoices/draft?month=YYYY-MM에 그대로 나오므로, 금액이 0원이 아닌데 남아 있는 고객이 확정하지 못한 고객입니다.

​

확정한 뒤

• 확정해도 결제는 자동으로 시작되지 않습니다. 확정한 뒤 인보이스마다 결제를 요청해야 합니다. 첫 결제 요청과 결과 확인을 보세요.
• MeterEngine은 메일을 보내지 않으니 인보이스 안내는 도입사가 직접 전달합니다. API 참조의 확정 설명에는 청구 메일을 남긴다는 문장이 있지만, 그 메일은 고객에게 발송되지 않습니다. 고객에게 인보이스를 보여 주려면 고객에게 인보이스 보여 주기를 만듭니다.
• 인보이스 확정을 알리는 통보는 없습니다. 확정 결과는 통보가 아니라 인보이스 목록 API로 확인합니다. 웹훅 이벤트 유형과 data를 보세요.
• 확정한 인보이스는 되돌릴 수 없습니다. 확정 뒤 고정되는 값은 확정 뒤 바뀌는 것과 안 바뀌는 것을 보세요.