> ## 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 - Return of Goods

> Pass the returned amount as negative items, and Bolta amends the invoice with the original tax type. The item supply costs must add up to a negative total. The API reuses the original's tax type, receipt or claim purpose, supplier, supplied party, and trustee, so set each item's tax (`tax`) to match the original tax type.

Item taxes must either all be integers or all be `null` or omitted. If the total tax is neither zero nor `null`, it must be negative.

See the [Amendment types guide](/en/docs/api-introduction/amendment-guide#return-of-goods).

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/return
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/return:
    post:
      tags:
        - Tax Invoice Issuance
      summary: Amend Tax Invoice - Return of Goods
      description: >
        Pass the returned amount as negative items, and Bolta amends the invoice
        with the original tax type. The item supply costs must add up to a
        negative total. The API reuses the original's tax type, receipt or claim
        purpose, supplier, supplied party, and trustee, so set each item's tax
        (`tax`) to match the original tax type.


        Item taxes must either all be integers or all be `null` or omitted. If
        the total tax is neither zero nor `null`, it must be negative.


        See the [Amendment types
        guide](/en/docs/api-introduction/amendment-guide#return-of-goods).


        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: Return date. Today or earlier, with no lower date limit
                items:
                  title: Items
                  description: >-
                    Returned items. The supply costs must add up to a negative
                    total.
                  type: array
                  minItems: 1
                  maxItems: 16
                  items:
                    $ref: '#/components/schemas/TaxInvoiceAmendItem'
              required:
                - date
                - items
              anyOf:
                - properties:
                    items:
                      items:
                        properties:
                          tax:
                            type: 'null'
                - properties:
                    items:
                      items:
                        properties:
                          tax:
                            type: integer
                        required:
                          - tax
            examples:
              Taxable return:
                x-parity-id: taxableReturn
                summary: Return of Goods amendment for a taxable tax invoice
                value:
                  date: '2026-05-27'
                  items:
                    - date: '2026-05-27'
                      name: Returned item
                      unitPrice: null
                      quantity: null
                      supplyCost: -30000
                      tax: -3000
                      specification: null
                      description: null
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  issuanceKey:
                    $ref: '#/components/schemas/IssuanceKey'
                    description: The IssuanceKey of the amended tax invoice
                required:
                  - issuanceKey
          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'
    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
    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
  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.