> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bolta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Issue Tax Invoice

> The sum of all item amounts becomes the issuance amount. Provide each item's tax (`tax`) according to `taxType`.

See the [Issuance amount guide](/en/api-introduction/issuance-guide) for calculation details and the [Brokered Tax Invoice Issuance guide](/en/api-introduction/usecase-brokered) for the brokered workflow.

Bolta removes invisible characters from the request text but keeps tabs, line feeds, and carriage returns. Bolta rejects supplementary characters above U+FFFF, such as emoji, with `400`. See [Unsupported characters](/en/api-introduction/issuance-guide#unsupported-characters).




## OpenAPI

````yaml /openapi.en.yaml post /v1/taxInvoices/issue
openapi: 3.1.0
info:
  title: Bolta API
  description: >
    The Bolta e-tax invoice API. [API Overview](/en/api-introduction/overview) |
    [Authentication guide](/en/api-introduction/authentication) | [Use
    cases](/en/api-introduction/usecase-b2b)
  version: 1.0.0
servers:
  - url: https://xapi.bolta.io
    description: Bolta API server
security:
  - basicAuth: []
tags:
  - name: Tax Invoice Issuance
    description: >
      Issue and amend e-tax invoices. [Calculating the issuance
      amount](/en/api-introduction/issuance-guide) | [Amendment
      types](/en/api-introduction/amendment-guide)
  - name: Tax Invoice Retrieval
    description: Retrieve e-tax invoice results and request processing status.
  - name: Reverse Issuance
    description: >
      Request and manage reverse issuance of e-tax invoices. [Email-approval
      reverse issuance](/en/api-introduction/usecase-reverse-email) |
      [Simple-approval reverse
      issuance](/en/api-introduction/usecase-reverse-simple)
  - name: Cash Receipt
    description: >
      Issue, cancel, and check the status of cash receipts. Issuance and
      cancellation are asynchronous. Check the final result via webhook or the
      status API. [Cash receipt guide](/en/api-introduction/cash-receipt-guide)
      | [Cash receipt webhooks](/en/api-introduction/webhook-cash-receipt)
  - name: Issuer
    description: >
      Register and manage businesses that act as tax invoice issuers.
      Certificate requirements depend on the issuance type.
      [Glossary](/en/api-introduction/glossary) | [Delegated
      issuance](/en/api-introduction/usecase-delegated) | [Brokered Tax Invoice
      Issuance](/en/api-introduction/usecase-brokered)
  - name: Certificate
    description: >
      Register and manage issuer certificates. [Certificate
      registration](/en/api-introduction/certificate-registration)
paths:
  /v1/taxInvoices/issue:
    post:
      tags:
        - Tax Invoice Issuance
      summary: Issue Tax Invoice
      description: >
        The sum of all item amounts becomes the issuance amount. Provide each
        item's tax (`tax`) according to `taxType`.


        See the [Issuance amount guide](/en/api-introduction/issuance-guide) for
        calculation details and the [Brokered Tax Invoice Issuance
        guide](/en/api-introduction/usecase-brokered) for the brokered workflow.


        Bolta removes invisible characters from the request text but keeps tabs,
        line feeds, and carriage returns. Bolta rejects supplementary characters
        above U+FFFF, such as emoji, with `400`. See [Unsupported
        characters](/en/api-introduction/issuance-guide#unsupported-characters).
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TaxInvoiceIssueRequest'
            examples:
              Standard taxable:
                x-parity-id: standardTaxable
                summary: Standard taxable tax invoice issuance
                value:
                  date: '2026-07-28'
                  purpose: CLAIM
                  taxType: TAXABLE
                  supplier:
                    identificationNumber: '1234567890'
                    organizationName: Supplier Company
                    representativeName: Supplier Representative
                    manager:
                      email: supplier@example.com
                  supplied:
                    identificationNumber: '0987654321'
                    organizationName: Recipient Company
                    representativeName: Recipient Representative
                    managers:
                      - email: recipient@example.com
                  items:
                    - date: '2026-07-28'
                      name: Taxable item
                      supplyCost: 100000
                      tax: 10000
              Foreign registration number:
                x-parity-id: foreignSupplied
                summary: Standard issuance to a foreign-registration-number recipient
                value:
                  date: '2026-05-27'
                  purpose: CLAIM
                  taxType: TAXABLE
                  supplier:
                    identificationNumber: '1234567890'
                    taxRegistrationId: null
                    organizationName: Supplier Company
                    representativeName: Supplier Representative
                    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
              Zero-rate issuance:
                x-parity-id: zeroRate
                summary: Zero-rate standard issuance
                value:
                  date: '2026-05-27'
                  purpose: CLAIM
                  taxType: ZERO_RATE
                  supplier:
                    identificationNumber: '1234567890'
                    taxRegistrationId: null
                    organizationName: Supplier Company
                    representativeName: Supplier Representative
                    address: null
                    businessItem: Software
                    businessType: Service
                    manager:
                      email: supplier@example.com
                      name: Supplier Manager
                      telephone: null
                  supplied:
                    identificationNumber: '0987654321'
                    taxRegistrationId: null
                    organizationName: Recipient Company
                    representativeName: Recipient Representative
                    address: null
                    businessItem: null
                    businessType: null
                    managers:
                      - email: recipient@example.com
                        name: Recipient Manager
                        telephone: null
                  items:
                    - date: '2026-05-27'
                      name: Zero-rate item
                      unitPrice: null
                      quantity: null
                      supplyCost: 100000
                      tax: 0
                      specification: null
                      description: null
                  description: null
              Brokered taxable:
                x-parity-id: brokeredTaxable
                summary: Taxable brokered tax invoice issuance
                value:
                  date: '2026-07-28'
                  purpose: CLAIM
                  taxType: TAXABLE
                  supplier:
                    identificationNumber: '1234567890'
                    organizationName: Principal Company
                    representativeName: Principal Representative
                    manager:
                      email: supplier@example.com
                      name: Principal Manager
                  supplied:
                    identificationNumber: '0987654321'
                    organizationName: Recipient Company
                    representativeName: Recipient Representative
                    managers:
                      - email: recipient@example.com
                        name: Recipient Manager
                  trustee:
                    identificationNumber: '1111111111'
                    organizationName: Trustee Company
                    representativeName: Trustee Representative
                    manager:
                      email: trustee@example.com
                      name: Trustee Manager
                      telephone: 010-1234-5678
                  items:
                    - date: '2026-07-28'
                      name: Taxable brokered item
                      supplyCost: 100000
                      tax: 10000
              Brokered zero-rate:
                x-parity-id: brokeredZeroRate
                summary: Zero-rate brokered tax invoice issuance
                value:
                  date: '2026-07-28'
                  purpose: CLAIM
                  taxType: ZERO_RATE
                  supplier:
                    identificationNumber: '1234567890'
                    organizationName: Principal Company
                    representativeName: Principal Representative
                    manager:
                      email: supplier@example.com
                      name: Principal Manager
                  supplied:
                    identificationNumber: '0987654321'
                    organizationName: Recipient Company
                    representativeName: Recipient Representative
                    managers:
                      - email: recipient@example.com
                        name: Recipient Manager
                  trustee:
                    identificationNumber: '1111111111'
                    organizationName: Trustee Company
                    representativeName: Trustee Representative
                  items:
                    - date: '2026-07-28'
                      name: Zero-rate brokered item
                      supplyCost: 100000
                      tax: 0
              Brokered tax-free:
                x-parity-id: brokeredTaxFree
                summary: Tax-free brokered invoice issuance
                value:
                  date: '2026-07-28'
                  purpose: CLAIM
                  taxType: TAX_FREE
                  supplier:
                    identificationNumber: '1234567890'
                    organizationName: Principal Company
                    representativeName: Principal Representative
                    manager:
                      email: supplier@example.com
                      name: Principal Manager
                  supplied:
                    identificationNumber: '0987654321'
                    organizationName: Recipient Company
                    representativeName: Recipient Representative
                    managers:
                      - email: recipient@example.com
                        name: Recipient Manager
                  trustee:
                    identificationNumber: '1111111111'
                    organizationName: Trustee Company
                    representativeName: Trustee Representative
                  items:
                    - date: '2026-07-28'
                      name: Tax-free brokered item
                      supplyCost: 100000
                      tax: null
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  issuanceKey:
                    $ref: '#/components/schemas/IssuanceKey'
                required:
                  - issuanceKey
              example:
                issuanceKey: 8D529FAD3EBAE050B79CE943CCC7CEDE
          headers: {}
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      deprecated: false
components:
  schemas:
    TaxInvoiceIssueRequest:
      type: object
      properties:
        date:
          title: Write date
          description: Write date
          allOf:
            - $ref: '#/components/schemas/DateString'
        purpose:
          $ref: '#/components/schemas/IssuancePurpose'
          title: Receipt/Claim type
          description: 'RECEIPT: receipt, CLAIM: claim'
        taxType:
          $ref: '#/components/schemas/TaxInvoiceTaxType'
        supplier:
          $ref: '#/components/schemas/TaxInvoiceSupplier'
          title: Supplier
          description: Supplier
        supplied:
          $ref: '#/components/schemas/TaxInvoiceRecipient'
          title: Supplied party
          description: Supplied party
        trustee:
          title: Trustee
          description: For brokered issuance, set the trustee information.
          anyOf:
            - $ref: '#/components/schemas/TaxInvoiceTrustee'
            - type: 'null'
        items:
          title: Items
          description: Items
          type: array
          items:
            $ref: '#/components/schemas/TaxInvoiceItem'
          minItems: 1
          maxItems: 16
        description:
          type:
            - string
            - 'null'
          title: Tax invoice note
          description: >-
            Tax invoice note. If the recipient's identification number is a
            foreign registration number, pass `null` or omit the field.
          minLength: 1
          maxLength: 150
      required:
        - purpose
        - taxType
        - supplied
        - supplier
        - items
        - date
      allOf:
        - $ref: '#/components/schemas/TaxInvoiceItemsByTaxTypeConstraint'
    IssuanceKey:
      type: string
      description: >-
        An identifier for the issuance request. Note that the format and length
        may change.
      examples:
        - 8D529FAD3EBAE050B79CE943CCC7CEDE
    ErrorResponse:
      type: object
      description: The error response returned when an API request fails
      properties:
        code:
          type: string
          description: Error type identifier
        message:
          type: string
          description: Error description
        traceId:
          type: string
          description: Request trace identifier
      required:
        - code
        - message
        - traceId
    DateString:
      type: string
      format: date
      examples:
        - '2024-08-24'
    IssuancePurpose:
      type: string
      description: 'RECEIPT: receipt, CLAIM: claim'
      enum:
        - RECEIPT
        - CLAIM
    TaxInvoiceTaxType:
      type: string
      title: Tax type
      description: >-
        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 or omitted.
      enum:
        - TAXABLE
        - ZERO_RATE
        - TAX_FREE
      examples:
        - TAXABLE
        - ZERO_RATE
        - TAX_FREE
    TaxInvoiceSupplier:
      type: object
      properties:
        identificationNumber:
          $ref: '#/components/schemas/BusinessRegistrationNumber'
          title: Business registration number
          description: Business registration number
        taxRegistrationId:
          title: Sub-business place code
          description: Sub-business place code
          anyOf:
            - $ref: '#/components/schemas/TaxRegistrationId'
            - type: 'null'
        organizationName:
          $ref: '#/components/schemas/OrganizationName'
          title: Organization name
          description: Organization name
        representativeName:
          $ref: '#/components/schemas/RepresentativeName'
          title: Representative name
          description: Representative name
        address:
          title: Address
          description: Address
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
        businessItem:
          title: Business item
          description: Business item
          anyOf:
            - $ref: '#/components/schemas/BusinessItem'
            - type: 'null'
        businessType:
          title: Business type
          description: Business type
          anyOf:
            - $ref: '#/components/schemas/BusinessType'
            - type: 'null'
        manager:
          $ref: '#/components/schemas/TaxInvoiceManager'
          title: Manager
          description: Manager
      required:
        - identificationNumber
        - manager
        - organizationName
        - representativeName
    TaxInvoiceRecipient:
      type: object
      properties:
        identificationNumber:
          $ref: '#/components/schemas/RecipientIdentificationNumber'
          title: >-
            Identification number (business registration number, resident
            registration number, foreign registration number)
          description: >-
            Identification number (business registration number,
            resident-registration-number format, foreign-registration-number
            format)
        taxRegistrationId:
          title: Sub-business place code
          description: >-
            If the recipient's identification number is not a business
            registration number, pass `null` or omit the field.
          anyOf:
            - $ref: '#/components/schemas/TaxRegistrationId'
            - type: 'null'
        organizationName:
          $ref: '#/components/schemas/OrganizationName'
          title: Organization name
          description: Organization name
        representativeName:
          $ref: '#/components/schemas/RepresentativeName'
          title: Representative name
          description: Representative name
        address:
          title: Address
          description: Address
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
        businessItem:
          title: Business item
          description: Business item
          anyOf:
            - $ref: '#/components/schemas/BusinessItem'
            - type: 'null'
        businessType:
          title: Business type
          description: Business type
          anyOf:
            - $ref: '#/components/schemas/BusinessType'
            - type: 'null'
        managers:
          type: array
          items:
            $ref: '#/components/schemas/TaxInvoiceManager'
          title: Manager
          description: Manager
          minItems: 1
          maxItems: 2
      required:
        - representativeName
        - managers
        - identificationNumber
        - organizationName
    TaxInvoiceTrustee:
      type: object
      description: Trustee information for brokered tax invoice issuance.
      properties:
        identificationNumber:
          $ref: '#/components/schemas/BusinessRegistrationNumber'
          title: Trustee business registration number
        taxRegistrationId:
          title: Sub-business place code
          anyOf:
            - $ref: '#/components/schemas/TaxRegistrationId'
            - type: 'null'
        organizationName:
          $ref: '#/components/schemas/OrganizationName'
          title: Organization name
        representativeName:
          $ref: '#/components/schemas/RepresentativeName'
          title: Representative name
        address:
          title: Address
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
        businessItem:
          title: Business item
          anyOf:
            - $ref: '#/components/schemas/BusinessItem'
            - type: 'null'
        businessType:
          title: Business type
          anyOf:
            - $ref: '#/components/schemas/BusinessType'
            - type: 'null'
        manager:
          title: Trustee manager
          anyOf:
            - $ref: '#/components/schemas/TaxInvoiceTrusteeManager'
            - type: 'null'
      required:
        - identificationNumber
        - organizationName
        - representativeName
    TaxInvoiceItem:
      type: object
      properties:
        date:
          $ref: '#/components/schemas/DateString'
          title: Item supply date
          description: Item supply date
        name:
          type: string
          title: Item name
          description: Item name
          maxLength: 100
          minLength: 1
        unitPrice:
          type:
            - integer
            - 'null'
          title: Unit price
          description: Unit price
          minimum: 0
          exclusiveMinimum: 0
          examples:
            - 100
        quantity:
          type:
            - integer
            - 'null'
          title: Quantity
          description: Quantity
        supplyCost:
          type: integer
          title: Supply cost
          description: Supply cost
          minimum: 1
          examples:
            - 1000
        tax:
          type:
            - integer
            - 'null'
          title: Tax
          description: >-
            Tax. Pass a non-`null` value when `taxType` is `TAXABLE` and `0`
            when `ZERO_RATE`. When `TAX_FREE`, pass `null` or omit the field.
          minimum: 0
          examples:
            - 0
            - 100
        specification:
          type:
            - string
            - 'null'
          title: Specification
          description: Specification
          maxLength: 60
        description:
          type:
            - string
            - 'null'
          title: Item note
          description: Item note
          maxLength: 100
      required:
        - date
        - name
        - supplyCost
    TaxInvoiceItemsByTaxTypeConstraint:
      type: object
      allOf:
        - if:
            properties:
              taxType:
                const: TAXABLE
          then:
            additionalProperties: true
            properties:
              items:
                items:
                  additionalProperties: true
                  properties:
                    tax:
                      type: integer
                  required:
                    - tax
        - if:
            properties:
              taxType:
                const: ZERO_RATE
          then:
            additionalProperties: true
            properties:
              items:
                items:
                  additionalProperties: true
                  properties:
                    tax:
                      const: 0
                  required:
                    - tax
        - if:
            properties:
              taxType:
                const: TAX_FREE
          then:
            additionalProperties: true
            properties:
              items:
                items:
                  additionalProperties: true
                  properties:
                    tax:
                      type: 'null'
    BusinessRegistrationNumber:
      type: string
      title: Business registration number
      description: >-
        A checksum-valid 10-digit number without hyphens (-). Pattern:
        `^\d{10}$`. Example numbers in the docs are placeholders that fail the
        checksum. Set a real business registration number.
      pattern: ^\d{10}$
      examples:
        - '1234567890'
    TaxRegistrationId:
      type: string
      title: Sub-business place code
      description: '4 digits, excluding `0000`. Pattern: `^(?!0{4})\d{4}$`'
      pattern: ^(?!0{4})\d{4}$
      examples:
        - '0001'
        - '0002'
      minLength: 4
      maxLength: 4
    OrganizationName:
      type: string
      title: Organization name
      description: Organization name
      maxLength: 70
      minLength: 1
    RepresentativeName:
      type: string
      title: Representative name
      description: Representative name
      minLength: 1
      maxLength: 30
    Address:
      type: string
      title: Address
      description: Address
      maxLength: 150
      minLength: 1
    BusinessItem:
      type: string
      title: Business item
      description: Business item
      maxLength: 100
      examples:
        - Software development and supply
      minLength: 1
    BusinessType:
      type: string
      title: Business type
      description: Business type
      maxLength: 100
      examples:
        - Information and communications
      minLength: 1
    TaxInvoiceManager:
      type: object
      properties:
        email:
          $ref: '#/components/schemas/Email'
          title: Email
          description: Email
        name:
          type:
            - string
            - 'null'
          title: Name
          description: Name
          maxLength: 30
          minLength: 1
        telephone:
          type:
            - string
            - 'null'
          title: Mobile phone number
          description: >-
            Mobile phone number. If provided, a KakaoTalk notification
            (AlimTalk) is sent to the manager. Pattern: `^010-\d{4}-\d{4}$`
          maxLength: 20
          examples:
            - 010-1234-5678
          pattern: ^010-\d{4}-\d{4}$
      required:
        - email
    RecipientIdentificationNumber:
      type: string
      title: Identification number
      description: >-
        10-digit business registration number, 13-digit
        resident-registration-number format, or 13-digit
        foreign-registration-number format. Digits without hyphens (-). The
        example numbers are placeholders. Set the recipient's real
        identification number.
      pattern: ^\d{10}(\d{3})?$
      examples:
        - '1234567890'
        - '9001011234567'
        - '9001015234567'
    TaxInvoiceTrusteeManager:
      type: object
      description: Set at least one of `email`, `name`, or `telephone`.
      properties:
        email:
          anyOf:
            - $ref: '#/components/schemas/Email'
            - type: 'null'
        name:
          type:
            - string
            - 'null'
          maxLength: 30
          minLength: 1
        telephone:
          type:
            - string
            - 'null'
          maxLength: 20
          pattern: ^010-\d{4}-\d{4}$
      anyOf:
        - properties:
            email:
              $ref: '#/components/schemas/Email'
          required:
            - email
        - properties:
            name:
              type: string
              minLength: 1
              maxLength: 30
          required:
            - name
        - properties:
            telephone:
              type: string
              pattern: ^010-\d{4}-\d{4}$
              maxLength: 20
          required:
            - telephone
    Email:
      type: string
      title: Email
      description: >-
        Pattern:
        `^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$`
      format: email
      pattern: ^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
      maxLength: 40
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Base64-encode your API key and pass it. Enter the API key as the
        username and leave the password empty.

````