---
title: "전자(세금)계산서 내용 조회"
method: GET
path: "/v1/taxInvoices/{issuanceKey}"
tags: ["세금계산서"]
---

# 전자(세금)계산서 내용 조회

`GET /v1/taxInvoices/{issuanceKey}`

`발행 완료`된 전자(세금)계산서의 내용(국세청승인번호 포함)을 조회합니다. 발행 완료 전에는 조회되지 않습니다.

활용 예시: [B2B 거래](/docs/api-introduction/usecase-b2b) | [정기 결제](/docs/api-introduction/usecase-recurring)

## Path parameters

- `issuanceKey` string, required

## Response `200`

- object
  - `issuanceKey` string, required — 발행 식별 키
  - `ntsTransactionId` string, required — 국세청승인번호
  - `issuedAt` string, required — 발행일시(포맷: ISO8601)
  - `invoice` object, required
    - `date` string, date, required
    - `purpose` 'RECEIPT' | 'CLAIM', required — RECEIPT: 영수, CLAIM: 청구
    - `supplier` TaxInvoiceSupplier, required
      - `identificationNumber` string, required — 하이픈(-) 없는 10자리 숫자. 패턴: `^\d{10}$`
      - `taxRegistrationId` string — 4자리 숫자, `0000` 제외. 패턴: `^(?!0{4})\d{4}$`
      - `organizationName` string, required — 상호명
      - `representativeName` string, required — 대표자명
      - `address` string — 주소
      - `businessItem` string — 종목
      - `businessType` string — 업태
      - `manager` TaxInvoiceManager, required
        - `email` string, email, required — 패턴: `^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$`
        - `name` string, nullable — 이름
        - `telephone` string, nullable — 휴대전화번호. 입력하면 담당자에게 알림톡이 발송됩니다. 패턴: `^010-\d{3,4}-\d{4}$`
    - `supplied` TaxInvoiceRecipient, required
      - `identificationNumber` string, required — 사업자등록번호 10자리, 주민등록번호 형식 13자리, 외국인등록번호 형식 13자리. 하이픈(-) 없는 숫자.
      - `taxRegistrationId` string — 4자리 숫자, `0000` 제외. 패턴: `^(?!0{4})\d{4}$`
      - `organizationName` string, required — 상호명
      - `representativeName` string, required — 대표자명
      - `address` string — 주소
      - `businessItem` string — 종목
      - `businessType` string — 업태
      - `managers` TaxInvoiceManager[], required — 담당자
        - `email` string, email, required — 패턴: `^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$`
        - `name` string, nullable — 이름
        - `telephone` string, nullable — 휴대전화번호. 입력하면 담당자에게 알림톡이 발송됩니다. 패턴: `^010-\d{3,4}-\d{4}$`
    - `items` TaxInvoiceItem[], required
      - `date` string, date, required
      - `name` string, required — 품목명
      - `unitPrice` integer, nullable — 단가
      - `quantity` integer, nullable — 수량
      - `supplyCost` integer, required — 공급가액
      - `tax` integer, nullable — 세액. `taxType`이 `TAXABLE`이면 `null`이 아닌 값을, `ZERO_RATE`이면 `0`을, `TAX_FREE`이면 `null`을 전달합니다.
      - `specification` string, nullable — 규격
      - `description` string, nullable — 품목 비고
    - `description` string — 세금계산서 비고

---

[API](https://skmtc.net/bolta/apis/api.md) · [All operations](https://skmtc.net/bolta/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bolta/api/revisions/a9bfc7aad470/schema)
