Issue Tax Invoice

POST

taxInvoices

issue

curl --request POST \
  --url https://xapi.bolta.io/v1/taxInvoices/issue \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Supplier-Key: <supplier-key>' \
  --data '
{
  "date": "2026-05-27",
  "purpose": "CLAIM",
  "taxType": "TAXABLE",
  "supplier": {
    "identificationNumber": "5648102684",
    "taxRegistrationId": null,
    "organizationName": "Bolta Corporation",
    "representativeName": "Munhyeok Lee",
    "address": null,
    "businessItem": "Software",
    "businessType": "Service",
    "manager": {
      "email": "supplier@example.com",
      "name": "Supplier Manager",
      "telephone": null
    }
  },
  "supplied": {
    "identificationNumber": "9001015234567",
    "taxRegistrationId": null,
    "organizationName": "Foreign Recipient",
    "representativeName": "Foreign Representative",
    "address": null,
    "businessItem": null,
    "businessType": null,
    "managers": [
      {
        "email": "foreign@example.com",
        "name": "Recipient Manager",
        "telephone": null
      }
    ]
  },
  "items": [
    {
      "date": "2026-05-27",
      "name": "E-Tax Invoice Service",
      "unitPrice": null,
      "quantity": null,
      "supplyCost": 100,
      "tax": 10,
      "specification": null,
      "description": "Foreign registration number standard issuance test"
    }
  ],
  "description": null
}
'

{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Base64-encode your API key and pass it. Enter the API key as the username and leave the password empty.

Headers

Supplier-Key

string

required

The identification key of the supplier (issuer). This is the key of the issuing party itself, not the supplied party (recipient). Use the supplierKey obtained from the Register Supplier API (POST /v1/suppliers); the supplied party information goes in the supplied field of the request body. It is managed independently per API key. Glossary | Authentication guide

Body

application/json

date

string<date>

required

Write date

Example:

"2024-08-24"

purpose

enum<string>

required

RECEIPT: receipt, CLAIM: claim

Available options:

RECEIPT,

CLAIM

taxType

enum<string>

required

TAXABLE: taxable (e-tax invoice), ZERO_RATE: zero-rate (e-tax invoice), TAX_FREE: tax-exempt (invoice). For TAXABLE the item tax cannot be null; for ZERO_RATE every item's tax must be 0; for TAX_FREE every item's tax must be null.

Available options:

TAXABLE,

ZERO_RATE,

TAX_FREE

Examples:

"TAXABLE"

"ZERO_RATE"

"TAX_FREE"

supplier

Supplier · object

required

Supplier

Show child attributes

supplied

Supplied party · object

required

Supplied party

Show child attributes

items

Items · object[]

required

Items

Required array length: 1 - 16 elements

Show child attributes

description

string | null

Tax invoice note. If the recipient's identification number is a foreign registration number, pass null or omit the field.

Required string length: 1 - 150

Response

issuanceKey

string

required

An identifier for the issuance request. Note that the format and length may change.

Example:

"8D529FAD3EBAE050B79CE943CCC7CEDE"

Amend Tax Invoice - Cancellation of Contract

curl --request POST \
  --url https://xapi.bolta.io/v1/taxInvoices/issue \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Supplier-Key: <supplier-key>' \
  --data '
{
  "date": "2026-05-27",
  "purpose": "CLAIM",
  "taxType": "TAXABLE",
  "supplier": {
    "identificationNumber": "5648102684",
    "taxRegistrationId": null,
    "organizationName": "Bolta Corporation",
    "representativeName": "Munhyeok Lee",
    "address": null,
    "businessItem": "Software",
    "businessType": "Service",
    "manager": {
      "email": "supplier@example.com",
      "name": "Supplier Manager",
      "telephone": null
    }
  },
  "supplied": {
    "identificationNumber": "9001015234567",
    "taxRegistrationId": null,
    "organizationName": "Foreign Recipient",
    "representativeName": "Foreign Representative",
    "address": null,
    "businessItem": null,
    "businessType": null,
    "managers": [
      {
        "email": "foreign@example.com",
        "name": "Recipient Manager",
        "telephone": null
      }
    ]
  },
  "items": [
    {
      "date": "2026-05-27",
      "name": "E-Tax Invoice Service",
      "unitPrice": null,
      "quantity": null,
      "supplyCost": 100,
      "tax": 10,
      "specification": null,
      "description": "Foreign registration number standard issuance test"
    }
  ],
  "description": null
}
'

{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "<string>",
  "message": "<string>"
}

Tax Invoice

Reverse Issuance

Supplier

Certificate

Cash Receipt

Authorizations

Headers

Body

Response