전자(세금)계산서 정발행
전체 품목의 금액 합이 발행 금액이 됩니다. taxType에 따라 품목의 세액(tax)을 전달하세요.
품목 공급가액 합계는 0이 아니어야 합니다. 세액 합계가 0이나 null이 아니면 공급가액 합계와 부호가 같아야 합니다.
자세한 금액 계산 방식은 발행 금액 계산 가이드, 위수탁 발행 절차는 위수탁 발행 가이드를 참고하세요.
API가 요청 텍스트의 보이지 않는 문자를 자동으로 지웁니다. 탭, 줄바꿈, 캐리지리턴은 유지합니다. 이모지처럼 U+FFFF를 넘는 보충 문자는 400으로 거부합니다. 지원하지 않는 문자를 참고하세요.
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' \
--data '
{
"date": "2026-07-28",
"purpose": "CLAIM",
"taxType": "TAXABLE",
"supplier": {
"identificationNumber": "1234567890",
"organizationName": "공급자 상호",
"representativeName": "공급자대표",
"manager": {
"email": "supplier@example.com"
}
},
"supplied": {
"identificationNumber": "0987654321",
"organizationName": "공급받는자 상호",
"representativeName": "공급받는자대표",
"managers": [
{
"email": "recipient@example.com"
}
]
},
"items": [
{
"date": "2026-07-28",
"name": "과세 품목",
"supplyCost": 100000,
"tax": 10000
}
]
}
'{
"issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}인증
헤더
세금계산서 요청자 관리번호입니다. 선택 사항이며 1~255자의 비어 있지 않은 값을 입력하세요. 같은 API 키에서 세금계산서 발행 계열 API에 이미 사용한 값은 요청 내용이나 API 경로가 같든 다르든 재사용할 수 없습니다. 중복이면 API가 400 Bad Request와 INVALID_REQUEST를 반환합니다. 응답을 받지 못했다면 같은 요청을 다시 보내지 말고 요청 상태 조회 API로 접수 결과를 확인하세요.
Required string length:
1 - 255Pattern:
\S본문
application/json
curl --request POST \
--url https://xapi.bolta.io/v1/taxInvoices/issue \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"date": "2026-07-28",
"purpose": "CLAIM",
"taxType": "TAXABLE",
"supplier": {
"identificationNumber": "1234567890",
"organizationName": "공급자 상호",
"representativeName": "공급자대표",
"manager": {
"email": "supplier@example.com"
}
},
"supplied": {
"identificationNumber": "0987654321",
"organizationName": "공급받는자 상호",
"representativeName": "공급받는자대표",
"managers": [
{
"email": "recipient@example.com"
}
]
},
"items": [
{
"date": "2026-07-28",
"name": "과세 품목",
"supplyCost": 100000,
"tax": 10000
}
]
}
'{
"issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}