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

고객 생성

POST
https://xapi.bolta.io/v1/customers

Request

Header Params
Content-Type
string 
required
Example:
application/json
Authorization
string 
required
Example:
Basic {Base64_Encoded_API_KEY}
Body Params application/json
identificationNumber
string 
required
사업자등록번호
Example:
1234567890
Match pattern:
^\d{3}\d{2}\d{5}$
taxRegistrationId
string 
optional
종사업장번호
>= 4 characters<= 4 characters
Examples:
00010002
Match pattern:
^(?!0{4})\d{4}$
organizationName
string 
required
상호명
>= 1 characters<= 100 characters
representativeName
string 
required
대표자명
>= 1 characters<= 50 characters
Example
{
    "identificationNumber": "1234567890",
    "taxRegistrationId": "0001",
    "organizationName": "string",
    "representativeName": "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/customers' \
--header 'Authorization: Basic {Base64_Encoded_API_KEY}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "identificationNumber": "1234567890",
    "taxRegistrationId": "0001",
    "organizationName": "string",
    "representativeName": "string"
}'

Responses

🟢200Success
application/json
Body
customerKey
string 
required
identificationNumber
string 
required
사업자등록번호
Example:
1234567890
Match pattern:
^\d{3}\d{2}\d{5}$
taxRegistrationId
string 
optional
종사업장번호
>= 4 characters<= 4 characters
Examples:
00010002
Match pattern:
^(?!0{4})\d{4}$
organizationName
string 
required
상호명
>= 1 characters<= 100 characters
representativeName
string 
required
대표자명
>= 1 characters<= 50 characters
certificate
object 
optional
issuedAt
string 
required
인증서 발행일시 (ISO 8601)
expiresAt
string 
required
인증서 만료일시 (ISO 8601)
Example
{
    "customerKey": "string",
    "identificationNumber": "1234567890",
    "taxRegistrationId": "0001",
    "organizationName": "string",
    "representativeName": "string",
    "certificate": {
        "issuedAt": "string",
        "expiresAt": "string"
    }
}
Modified at 2025-04-17 08:15:02
Previous
전자(세금)계산서 국세청승인번호 조회
Next
고객 공동인증서 등록 URL 조회
Built with