bolta-open-api
  1. 전자(세금)계산서 정발행
bolta-open-api
  • 볼타 전자(세금)계산서 API 문서
  • 가이드
    • API 키
    • 요청·응답 본문
    • 방화벽 및 보안 프로토콜
    • 웹훅(Webhook) 연결하기
    • 공동인증서 등록 Redirect 정책
    • 전자(세금)계산서 발행마감일 정책
  • 전자(세금)계산서 발행 API 연동 사례
    • 연동 사례 1: 플랫폼 고객이 전자(세금)계산서를 발행하는 경우
    • 연동 사례 2: 우리 회사의 전자(세금)계산서만 발행하는 경우
  • API 문서
    • 전자(세금)계산서 정발행
      • 전자(세금)계산서 정발행
        POST
      • 전자(세금)계산서 수정발행 - 계약의 해제
        POST
      • 전자(세금)계산서 수정발행 - 공급가액 변동
        POST
    • 전자(세금)계산서 역발행
      • 전자(세금)계산서 역발행
    • 전자(세금)계산서 조회
      • 전자(세금)계산서 국세청승인번호 조회
    • 고객
      • 고객 생성
      • 고객 공동인증서 등록 URL 조회
      • 고객 조회
  • SDK
    • SDK: Zapier
    • SDK: Make
  • 에러 코드
    • 전자(세금)계산서 발행 API
    • 전자(세금)계산서 발행 웹훅
    • 고객 생성 API
    • 공통 에러
  1. 전자(세금)계산서 정발행

전자(세금)계산서 수정발행 - 공급가액 변동

POST
https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/amend/changeSupplyCost
공급가액 변동 사유 수정발행은 기존 대비 얼마나 (+) 또는 (-)되었는지를 품목으로 전달해주시기 바랍니다.
품목의 단가를 1,000원씩 초과하여 작성했다면, -1,000원으로 발행해주시면 되는 구조입니다.
원본 세금계산서
품목명단가(unitPrice)수량(quantity)공급가액(supplyCost)최종 세액(tax)최종 금액(supplyCost + tax)
첫 번째 품목5,0001050,0005,00055,000
두 번째 품목3,00050150,00015,000165,000
공급가액 변동 사유 수정 세금계산서
품목명단가(unitPrice)수량(quantity)공급가액(supplyCost)최종 세액(tax)최종 금액(supplyCost + tax)
첫 번째 품목-1,00010-10,000-1,000-11,000
두 번째 품목-1,00050-50,000-5,000-55,000
최종 거래 금액
품목명단가(unitPrice)수량(quantity)공급가액(supplyCost)최종 세액(tax)최종 금액(supplyCost + tax)
첫 번째 품목4,0001040,0004,00044,000
두 번째 품목2,00050100,00010,000110,000

Request

Path Params
issuanceKey
string 
required
Header Params
Content-Type
string 
optional
Example:
application/json
Authorization
string 
optional
Example:
Basic {Base64_Encoded_API_KEY}
Customer-Key
string 
optional
Example:
customer_bf8paz
Body Params application/json
date
string <date>
required
공급가액 변동 날짜
Example:
2024-08-24
items
array[object (전자세금계산서 품목) {8}] 
required
date
string <date>
공급일자
required
Example:
2024-08-24
name
string 
품목명
required
>= 1 characters<= 80 characters
unitPrice
integer 
단가
optional
> 0
Example:
100
quantity
integer 
수량
optional
supplyCost
integer 
required
>= 1
Example:
1000
tax
integer 
optional
>= 1
Example:
100
specification
string 
규격
optional
description
string 
품목 비고
optional
Example
{
  "date": "2024-08-24",
  "items": [
    {
      "date": "2024-08-24",
      "name": "string",
      "unitPrice": 100,
      "quantity": 0,
      "supplyCost": 1000,
      "tax": 100,
      "specification": "string",
      "description": "string"
    }
  ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://xapi.bolta.io/v1/taxInvoices//amend/changeSupplyCost' \
--header 'Authorization: Basic {Base64_Encoded_API_KEY}' \
--header 'Customer-Key: customer_bf8paz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "date": "2024-08-24",
    "items": [
        {
            "date": "2024-08-24",
            "name": "string",
            "unitPrice": 100,
            "quantity": 0,
            "supplyCost": 1000,
            "tax": 100,
            "specification": "string",
            "description": "string"
        }
    ]
}'

Responses

🟢200Success
application/json
Body
issuanceKey
string 
required
수정발행 세금계산서의 IssuanceKey
Example:
8D529FAD3EBAE050B79CE943CCC7CEDE
Example
{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}
Previous
전자(세금)계산서 수정발행 - 계약의 해제
Next
전자(세금)계산서 역발행
Built with