> ## 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.

# Amend Tax Invoice - Correction of Error in Entries

> Pass the corrected tax invoice content, and the API issues two invoices together: a cancellation invoice that offsets the original and a corrected invoice. In the response, `issuanceKey` is the corrected invoice and `cancelIssuanceKey` is the cancellation invoice. Retrieve each invoice and receive its webhook by its own key. The API deducts points for each invoice.

The total item supply cost must not be zero. If the total tax is neither zero nor `null`, it must have the same sign as the total supply cost.

If you omit `supplier`, the API uses the original supplier. If you send `supplier`, `identificationNumber` and `taxRegistrationId` must match the original. Brokered tax invoices and tax invoices whose supplied party uses a foreign registration number are not supported.

See the [Amendment types guide](/en/docs/api-introduction/amendment-guide#correction-of-error-in-entries).

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




## OpenAPI

````yaml /openapi.en.yaml post /v1/taxInvoices/{issuanceKey}/amend/misspell
openapi: 3.1.0
info:
  title: Bolta API
  description: >
    The Bolta e-tax invoice API. [API
    Overview](/en/docs/api-introduction/overview) | [Authentication
    guide](/en/docs/api-introduction/authentication) | [Use
    cases](/en/docs/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/docs/api-introduction/issuance-guide) | [Amendment
      types](/en/docs/api-introduction/amendment-guide)
  - name: Tax Invoice Retrieval
    description: >
      Retrieve e-tax invoice results and request processing status, and download
      the PDF of an issued tax invoice. [Tax invoice PDF
      guide](/en/docs/api-introduction/tax-invoice-pdf)
  - name: Reverse Issuance
    description: >
      Request and manage reverse issuance of e-tax invoices. [Email-approval
      reverse issuance](/en/docs/api-introduction/usecase-reverse-email) |
      [Simple-approval reverse
      issuance](/en/docs/api-introduction/usecase-reverse-simple)
  - name: Cash Receipt
    description: >
      Issue, cancel, and check the status of cash receipts. [Cash receipt
      guide](/en/docs/api-introduction/cash-receipt-guide) | [Cash receipt
      webhooks](/en/docs/api-introduction/webhook-cash-receipt)
  - name: Business Registration Status
    description: >
      Check the registration status and tax type of a business registration
      number. Look up one number or up to 100 numbers at once. This API requires
      no issuer registration and no certificate. Each number whose status the
      API returns deducts 10 points. [Business registration status
      guide](/en/docs/api-introduction/business-registration-status)
  - name: Business Registration Certificate Extraction and Verification
    description: >
      Reads the business registration number, business name, representative
      names, opening date, address, and industries from a business registration
      certificate file, and returns the NTS verification result. This API
      requires no issuer registration and no certificate. Each document whose
      verification result is `MATCHED` or `NOT_MATCHED` deducts 100 points.
      [Business registration certificate extraction and verification
      guide](/en/docs/api-introduction/business-registration-certificate)
  - name: Business Profile
    description: >
      Search for businesses by business name, representative name, or business
      registration number, and retrieve the detailed profile of one business
      registration number. This API requires no issuer registration and no
      certificate. Search deducts 9 points for each result returned, and profile
      retrieval deducts 90 points for each successful retrieval. [Business
      profile guide](/en/docs/api-introduction/business-profile)
  - name: Revenue and Expense
    description: >
      Retrieve the revenue and expense tax invoices of your own business in
      Bolta in the order they changed, and request a collection. Responses
      include documents issued through Bolta and documents collected from
      Hometax. You need a Standard plan or higher, and the calls deduct no
      points. Connect Hometax in the Bolta dashboard first. [Revenue and expense
      guide](/en/docs/api-introduction/revenue-expense)
  - name: Bank Account Transactions
    description: >
      Retrieve the bank accounts and transactions connected to your own business
      in Bolta, and request a sync. You need a Standard plan or higher, and the
      calls deduct no points. Connect bank accounts in the Bolta dashboard
      first. [Bank account transactions
      guide](/en/docs/api-introduction/bank-account-transactions)
  - name: Bank Account Holder
    description: >
      Look up account holder names with a bank code and an account number. One
      path takes a single account and the other takes up to 100 accounts at
      once. Each account that returns a holder name deducts 50 points. [Bank
      account holder guide](/en/docs/api-introduction/bank-account-holder)
  - name: Document Issuance
    description: >
      Issue National Tax Service certificates from Hometax or a certified copy
      of corporate registry, and download the original PDF. Hometax documents
      are issued only for the business that owns the API key, and you must
      register a joint certificate in the Bolta dashboard. A corporate registry
      is issued for the corporation in `corporationNumber` and needs no joint
      certificate. Supported corporation types are stock company, limited
      company, general partnership company, limited partnership company, limited
      liability company, incorporated association, incorporated foundation,
      school foundation, social welfare foundation, medical corporation,
      accounting corporation, law firm, certified judicial scrivener
      corporation, cooperative (including social cooperative), agricultural
      cooperative, livestock cooperative, fisheries cooperative, credit union,
      business cooperative, industrial cooperative, small and medium business
      cooperative, community credit cooperative (MG Saemaul Geumgo),
      agricultural cooperative corporation, fishery cooperative corporation,
      special corporation (such as the Export-Import Bank of Korea), and other
      corporate entity (such as a patent corporation). The Korean branch of a
      foreign company is not supported. Each document deducts 500 points for
      Hometax documents, 2,000 points for a corporate registry view copy, and
      3,000 points for a submission copy. [Document issuance
      guide](/en/docs/api-introduction/document-issuance)
  - name: Issuer
    description: >
      Register and manage businesses that act as tax invoice issuers.
      Certificate requirements depend on the issuance type.
      [Glossary](/en/docs/api-introduction/glossary) | [Delegated
      issuance](/en/docs/api-introduction/usecase-delegated) | [Brokered Tax
      Invoice Issuance](/en/docs/api-introduction/usecase-brokered)
  - name: Certificate
    description: >
      Register and manage issuer certificates. [Certificate
      registration](/en/docs/api-introduction/certificate-registration)
paths:
  /v1/taxInvoices/{issuanceKey}/amend/misspell:
    post:
      tags:
        - Tax Invoice Issuance
      summary: Amend Tax Invoice - Correction of Error in Entries
      description: >
        Pass the corrected tax invoice content, and the API issues two invoices
        together: a cancellation invoice that offsets the original and a
        corrected invoice. In the response, `issuanceKey` is the corrected
        invoice and `cancelIssuanceKey` is the cancellation invoice. Retrieve
        each invoice and receive its webhook by its own key. The API deducts
        points for each invoice.


        The total item supply cost must not be zero. If the total tax is neither
        zero nor `null`, it must have the same sign as the total supply cost.


        If you omit `supplier`, the API uses the original supplier. If you send
        `supplier`, `identificationNumber` and `taxRegistrationId` must match
        the original. Brokered tax invoices and tax invoices whose supplied
        party uses a foreign registration number are not supported.


        See the [Amendment types
        guide](/en/docs/api-introduction/amendment-guide#correction-of-error-in-entries).


        The API removes invisible characters from the request text but keeps
        tabs, line feeds, and carriage returns. It rejects supplementary
        characters above U+FFFF, such as emoji, with `400`. See [Unsupported
        characters](/en/docs/api-introduction/issuance-guide#unsupported-characters).
      parameters:
        - name: issuanceKey
          in: path
          description: Issuance request identifier
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/TaxInvoiceClientReferenceId'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                date:
                  $ref: '#/components/schemas/DateString'
                  title: Write date
                  description: >-
                    Write date of the corrected invoice. Today or earlier, with
                    no lower date limit
                purpose:
                  $ref: '#/components/schemas/IssuancePurpose'
                  title: Receipt or claim
                taxType:
                  $ref: '#/components/schemas/TaxInvoiceTaxType'
                supplier:
                  title: Supplier
                  description: >-
                    If omitted, the API uses the original supplier. If sent,
                    `identificationNumber` and `taxRegistrationId` must match
                    the original.
                  anyOf:
                    - $ref: '#/components/schemas/TaxInvoiceSupplier'
                    - type: 'null'
                supplied:
                  $ref: '#/components/schemas/TaxInvoiceRecipient'
                  title: Supplied party
                  description: Supplied party
                items:
                  title: Items
                  description: Items of the corrected invoice
                  type: array
                  minItems: 1
                  maxItems: 16
                  items:
                    $ref: '#/components/schemas/TaxInvoiceAmendItem'
              required:
                - date
                - purpose
                - taxType
                - supplied
                - items
              allOf:
                - $ref: '#/components/schemas/TaxInvoiceItemsByTaxTypeConstraint'
            examples:
              Taxable correction:
                x-parity-id: taxableMisspell
                summary: Correction of Error in Entries for a taxable tax invoice
                value:
                  date: '2026-05-27'
                  purpose: CLAIM
                  taxType: TAXABLE
                  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: Corrected item
                      unitPrice: null
                      quantity: null
                      supplyCost: 100000
                      tax: 10000
                      specification: null
                      description: null
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  issuanceKey:
                    $ref: '#/components/schemas/IssuanceKey'
                    description: The IssuanceKey of the corrected invoice
                  cancelIssuanceKey:
                    $ref: '#/components/schemas/IssuanceKey'
                    description: The IssuanceKey of the cancellation invoice
                required:
                  - issuanceKey
                  - cancelIssuanceKey
          headers: {}
        '400':
          description: >-
            Request validation failed or the client reference ID was reused. An
            API key cannot reuse a `Bolta-Client-Reference-Id` it has already
            used, regardless of the request content. The response `code` is
            `INVALID_REQUEST`. If the original was not issued successfully, the
            API returns `ISSUANCE_MUST_BE_SUCCESS`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: >-
            The original was issued with a different API key. The response
            `code` is `FORBIDDEN`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: >-
            The `issuanceKey` does not exist. The response `code` is
            `NOT_FOUND`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      deprecated: false
components:
  parameters:
    TaxInvoiceClientReferenceId:
      name: Bolta-Client-Reference-Id
      in: header
      description: >-
        Client reference ID for a tax invoice request. This header is optional.
        Enter a non-blank value between 1 and 255 characters. After this value
        is used with a tax invoice issuance API, the same API key cannot reuse
        it, regardless of the request content or endpoint. A duplicate returns
        `400 Bad Request` with `INVALID_REQUEST`. If you do not receive a
        response, do not resend the request. Check the accepted request with the
        [request status
        API](/en/api-reference/tax-invoice-retrieval/retrieve-tax-invoice-by-client-reference).
      required: false
      example: your-unique-reference-id
      schema:
        type: string
        minLength: 1
        maxLength: 255
        pattern: \S
  schemas:
    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
    TaxInvoiceAmendItem:
      type: object
      properties:
        date:
          $ref: '#/components/schemas/DateString'
          title: Item supply date
          description: >-
            Item supply date. Use the month containing the request's `date` to
            determine the start date, then set the item supply date from that
            start date through `date`, inclusive. If `date` is on or before the
            issuance deadline for the previous month's invoices, the start date
            is the first day of the previous month; otherwise, it is the first
            day of the month containing `date`. See [How the deadline is
            set](/en/docs/api-introduction/tax-invoice-issue-due-date#how-the-deadline-is-set)
            for weekend and public holiday adjustments and NTS extensions.
        name:
          type: string
          title: Item name
          description: Item name
          maxLength: 100
          minLength: 1
        unitPrice:
          type:
            - number
            - 'null'
          title: Unit price
          description: Unit price
          examples:
            - 100
        quantity:
          type:
            - number
            - 'null'
          not:
            const: 0
          title: Quantity
          description: >-
            Quantity. Zero is not allowed. Change in Supply Cost accepts only
            positive values; Return of Goods and Correction of Error in Entries
            also accept negative values.
        supplyCost:
          type: integer
          title: Supply cost
          description: Supply cost
          examples:
            - 1000
            - -1000
        tax:
          type:
            - integer
            - 'null'
          title: Tax
          description: Tax
          examples:
            - 0
            - 100
            - -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'
    IssuanceKey:
      type: string
      description: >-
        Issuance request identifier. Its format and length may change, so store
        the entire string as is.
      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
    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 you provide it, Bolta sends a KakaoTalk
            notification (AlimTalk) 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'
    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: >-
        Append a colon to your API key, Base64-encode it, and put it in the
        header. Enter the API key as the username and leave the password empty.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.