# 세금계산서 (Tax Invoices)

> **최종 갱신**: 2026-02-27

---

## 1. 개요

세금계산서 발행·취소·국세청 전송 상태 관리. 바로빌(Barobill) API를 통해 전자세금계산서를 발행하며, 수동 관리도 가능하다.

**세금계산서 유형:** tax_invoice (세금계산서), invoice (계산서-면세), modified (수정세금계산서)

**발행 유형:** normal (정발행), reverse (역발행), trustee (위수탁)

**방향:** sales (매출), purchases (매입)

---

## 2. API 엔드포인트

| HTTP | URI | 설명 |
|------|-----|------|
| GET | `/v1/tax-invoices` | 세금계산서 목록 |
| POST | `/v1/tax-invoices` | 세금계산서 생성 |
| GET | `/v1/tax-invoices/summary` | 요약 |
| GET | `/v1/tax-invoices/{id}` | 세금계산서 상세 |
| PUT | `/v1/tax-invoices/{id}` | 세금계산서 수정 |
| DELETE | `/v1/tax-invoices/{id}` | 세금계산서 삭제 |
| POST | `/v1/tax-invoices/{id}/issue` | 발행 (바로빌 API 연동) |
| POST | `/v1/tax-invoices/{id}/cancel` | 취소 |
| GET | `/v1/tax-invoices/{id}/check-status` | 국세청 전송 상태 확인 |
| POST | `/v1/tax-invoices/bulk-issue` | 일괄 발행 |

---

## 관련 문서

- [재무관리 개요](README.md)
- [바로빌 연동](../barobill-kakaotalk/README.md) — 전자세금계산서 발행 API
- Swagger: `/api-docs` → TaxInvoices 섹션