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

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

샘플 Http Request를 그대로 사용하시면 에러가 발생 할 수 있습니다.

발행 마감일이 지난 경우, 400 에러가 응답됩니다. 아래 정책을 참고하시어 작성일자와 품목 공급일자를 적절히 변경해주세요.
전자(세금)계산서 발행마감일 정책

Request

Header Params

Body Params application/json

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 Code 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

Example

{
    "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}

Modified at 2025-07-10 12:04:29

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

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