- 볼타 전자(세금)계산서 API 문서
- 가이드
- 전자(세금)계산서 발행 API 연동 사례
- API 문서
- 전자(세금)계산서 정발행
- 전자(세금)계산서 역발행
- 전자(세금)계산서 조회
- 고객
- SDK
- 에러 코드
고객 생성
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
expiresAt
string
required
Example
{
"customerKey": "string",
"identificationNumber": "1234567890",
"taxRegistrationId": "0001",
"organizationName": "string",
"representativeName": "string",
"certificate": {
"issuedAt": "string",
"expiresAt": "string"
}
}
Modified at 2025-04-17 08:15:02