전자(세금)계산서 정발행

POST

https://xapi.bolta.io/v1/taxInvoices/issue

전체 품목의 금액 합이 발행 금액이 됩니다.
면세(전자계산서) 발행 시 품목의 세액을 null로 호출해주세요.

세금계산서 발행 금액	세금계산서 공급가액	세금계산서 세액
220,000	200,000	20,000

품목명	단가(unitPrice)	수량(quantity)	공급가액(supplyCost)	최종 세액(tax)	최종 금액(supplyCost + tax)
첫 번째 품목	5,000	10	50,000	5,000	55,000
두 번째 품목	3,000	50	150,000	15,000	165,000

Request

Header Params

Content-Type

string

required

Example:

application/json

Authorization

string

required

Example:

Basic {Base64_Encoded_API_KEY}

Customer-Key

string

required

Example:

customer_bf8paz

Body Params application/json

date

string <date>

작성일자

required

Example:

2024-08-24

purpose

enum<string>

발행목적

required

Allowed values:

RECEIPTCLAIM

supplier

object (전자세금계산서 공급자)

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

address

string

주소

optional

>= 1 characters<= 200 characters

businessItem

string

종목

optional

>= 1 characters<= 100 characters

Example:

소프트웨어 개발 및 공급업

businessType

string

업태

optional

>= 1 characters<= 100 characters

Example:

정보통신업

manager

object (전자세금계산서 담당자)

담당자

required

supplied

object (전자세금계산서 공급받는자)

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

address

string

주소

optional

>= 1 characters<= 200 characters

businessItem

string

종목

optional

>= 1 characters<= 100 characters

Example:

소프트웨어 개발 및 공급업

businessType

string

업태

optional

>= 1 characters<= 100 characters

Example:

정보통신업

managers

array[object (전자세금계산서 담당자) {3}]

담당자

required

>= 1 items<= 2 items

items

array[object (전자세금계산서 품목) {8}]

required

>= 1 items<= 5 items

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

description

string

세금계산서 비고

optional

>= 1 characters<= 200 characters

Example

{
  "date": "2024-08-24",
  "purpose": "RECEIPT",
  "supplier": {
    "identificationNumber": "1234567890",
    "taxRegistrationId": "0001",
    "organizationName": "string",
    "representativeName": "string",
    "address": "string",
    "businessItem": "소프트웨어 개발 및 공급업",
    "businessType": "정보통신업",
    "manager": {
      "email": "user@example.com",
      "name": "string",
      "telephone": "010-1234-5678"
    }
  },
  "supplied": {
    "identificationNumber": "1234567890",
    "taxRegistrationId": "0001",
    "organizationName": "string",
    "representativeName": "string",
    "address": "string",
    "businessItem": "소프트웨어 개발 및 공급업",
    "businessType": "정보통신업",
    "managers": [
      {
        "email": "user@example.com",
        "name": "string",
        "telephone": "010-1234-5678"
      }
    ]
  },
  "items": [
    {
      "date": "2024-08-24",
      "name": "string",
      "unitPrice": 100,
      "quantity": 0,
      "supplyCost": 1000,
      "tax": 100,
      "specification": "string",
      "description": "string"
    }
  ],
  "description": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://xapi.bolta.io/v1/taxInvoices/issue' \
--header 'Authorization: Basic {Base64_Encoded_API_KEY}' \
--header 'Customer-Key: customer_bf8paz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "date": "2024-08-24",
    "purpose": "RECEIPT",
    "supplier": {
        "identificationNumber": "1234567890",
        "taxRegistrationId": "0001",
        "organizationName": "string",
        "representativeName": "string",
        "address": "string",
        "businessItem": "소프트웨어 개발 및 공급업",
        "businessType": "정보통신업",
        "manager": {
            "email": "user@example.com",
            "name": "string",
            "telephone": "010-1234-5678"
        }
    },
    "supplied": {
        "identificationNumber": "1234567890",
        "taxRegistrationId": "0001",
        "organizationName": "string",
        "representativeName": "string",
        "address": "string",
        "businessItem": "소프트웨어 개발 및 공급업",
        "businessType": "정보통신업",
        "managers": [
            {
                "email": "user@example.com",
                "name": "string",
                "telephone": "010-1234-5678"
            }
        ]
    },
    "items": [
        {
            "date": "2024-08-24",
            "name": "string",
            "unitPrice": 100,
            "quantity": 0,
            "supplyCost": 1000,
            "tax": 100,
            "specification": "string",
            "description": "string"
        }
    ],
    "description": "string"
}'

Responses

🟢200OK

application/json

Body

issuanceKey

string

required

발행 요청에 대한 식별번호. 포맷과 길이는 바뀔 수 있으므로 유의하시기 바랍니다.

Example:

8D529FAD3EBAE050B79CE943CCC7CEDE

Example

{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}

연동 사례 2: 우리 회사의 전자(세금)계산서만 발행하는 경우

전자(세금)계산서 수정발행 - 계약의 해제