고객 생성

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

전자(세금)계산서 국세청승인번호 조회

고객 공동인증서 등록 URL 조회