메인 콘텐츠로 건너뛰기
POST
/
v1
/
taxInvoices
/
issue
전자(세금)계산서 정발행
curl --request POST \
  --url https://xapi.bolta.io/v1/taxInvoices/issue \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Customer-Key: <customer-key>' \
  --data '
{
  "date": "2026-05-27",
  "purpose": "CLAIM",
  "supplier": {
    "identificationNumber": "5648102684",
    "taxRegistrationId": null,
    "organizationName": "(주) 볼타코퍼레이션",
    "representativeName": "이문혁",
    "address": null,
    "businessItem": "소프트웨어",
    "businessType": "서비스업",
    "manager": {
      "email": "supplier@example.com",
      "name": "공급자담당자",
      "telephone": null
    }
  },
  "supplied": {
    "identificationNumber": "9001015234567",
    "taxRegistrationId": null,
    "organizationName": "외국인 공급받는자",
    "representativeName": "외국인대표",
    "address": null,
    "businessItem": null,
    "businessType": null,
    "managers": [
      {
        "email": "foreign@example.com",
        "name": "공급받는자담당자",
        "telephone": null
      }
    ]
  },
  "items": [
    {
      "date": "2026-05-27",
      "name": "전자세금계산서 서비스",
      "unitPrice": null,
      "quantity": null,
      "supplyCost": 100,
      "tax": 10,
      "specification": null,
      "description": "외국인등록번호 정발행 테스트"
    }
  ],
  "description": null
}
'
{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}

인증

Authorization
string
header
필수

API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요.

헤더

Customer-Key
string
필수

공급자(발행자) 식별 키. 고객 생성 API로 발급받은 공급자 본인의 customerKey를 사용합니다. 공급받는자 정보는 요청 본문의 supplied 필드에 포함합니다. API 키 단위로 독립 관리됩니다. 인증 가이드

본문

application/json
date
string<date>
필수

작성일자

예시:

"2024-08-24"

purpose
enum<string>
필수

RECEIPT: 영수, CLAIM: 청구

사용 가능한 옵션:
RECEIPT,
CLAIM
supplier
공급자 · object
필수

공급자

supplied
공급받는자 · object
필수

공급받는자

items
품목 · object[]
필수

품목

Required array length: 1 - 5 elements
description
string | null

세금계산서 비고. 공급받는자 식별번호가 외국인등록번호인 경우 null로 전달하거나 필드를 생략해야 합니다.

Required string length: 1 - 200

응답

issuanceKey
string
필수

발행 요청에 대한 식별번호. 포맷과 길이는 바뀔 수 있으므로 유의하시기 바랍니다.

예시:

"8D529FAD3EBAE050B79CE943CCC7CEDE"