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

# 전자(세금)계산서 수정발행 - 기재사항 착오정정

> 고친 세금계산서 내용을 전달하면 API가 원본을 상계하는 취소분과 고친 내용의 수정분을 함께 발행합니다. 응답의 `issuanceKey`는 수정분, `cancelIssuanceKey`는 취소분입니다. 두 장은 각 키로 따로 조회하고 웹훅도 따로 받으며, 장마다 포인트를 차감합니다.

품목 공급가액 합계는 0이 아니어야 합니다. 세액 합계가 0이나 `null`이 아니면 공급가액 합계와 부호가 같아야 합니다.

`supplier`를 생략하면 원본 공급자를 사용합니다. `supplier`를 보낼 때 `identificationNumber`와 `taxRegistrationId`는 원본과 같아야 합니다. 위수탁 세금계산서와 공급받는자 식별번호가 외국인등록번호인 세금계산서는 지원하지 않습니다.

[수정발행 유형 가이드](/docs/api-introduction/amendment-guide#기재사항-착오정정)를 참고하세요.

API가 요청 텍스트의 보이지 않는 문자를 자동으로 지웁니다. 탭, 줄바꿈, 캐리지리턴은 유지합니다. 이모지처럼 U+FFFF를 넘는 보충 문자는 `400`으로 거부합니다. [지원하지 않는 문자](/docs/api-introduction/issuance-guide#지원하지-않는-문자)를 참고하세요.




## OpenAPI

````yaml /openapi.yaml post /v1/taxInvoices/{issuanceKey}/amend/misspell
openapi: 3.1.0
info:
  title: 볼타 API
  description: >
    볼타 전자세금계산서 API입니다. [API 소개](/docs/api-introduction/overview) | [인증
    가이드](/docs/api-introduction/authentication) | [사용
    사례](/docs/api-introduction/usecase-b2b)
  version: 1.0.0
servers:
  - url: https://xapi.bolta.io
    description: 볼타 API 서버
security:
  - basicAuth: []
tags:
  - name: 세금계산서 발행
    description: >
      전자(세금)계산서를 정발행하거나 수정발행합니다. [발행 금액
      계산](/docs/api-introduction/issuance-guide) | [수정발행
      유형](/docs/api-introduction/amendment-guide)
  - name: 세금계산서 조회
    description: >
      전자(세금)계산서의 발행 결과와 요청 처리 상태를 조회하고, 발행 완료한 세금계산서의 PDF를 내려받습니다. [세금계산서 PDF 조회
      가이드](/docs/api-introduction/tax-invoice-pdf)
  - name: 세금계산서 역발행
    description: >
      전자(세금)계산서 역발행 요청 및 관리. [이메일 승인
      역발행](/docs/api-introduction/usecase-reverse-email) | [간편 승인
      역발행](/docs/api-introduction/usecase-reverse-simple)
  - name: 현금영수증
    description: >
      현금영수증을 발행하거나 취소하고 처리 상태를 조회합니다. [현금영수증 발행
      가이드](/docs/api-introduction/cash-receipt-guide) | [현금영수증
      웹훅](/docs/api-introduction/webhook-cash-receipt)
  - name: 사업자등록 상태 조회
    description: >
      사업자등록번호의 등록 상태와 과세유형을 단건 또는 최대 100건 일괄로 조회합니다. 발급자 등록과 공동인증서가 필요 없습니다. 상태를
      확인한 번호마다 10포인트를 차감합니다. [사업자등록 상태 조회
      가이드](/docs/api-introduction/business-registration-status)
  - name: 사업자등록증 인식과 진위확인
    description: >
      사업자등록증 파일에서 사업자등록번호, 상호, 대표자명, 개업일, 주소, 업종을 읽고 국세청 진위확인 결과를 함께 돌려줍니다. 발급자
      등록과 공동인증서가 필요 없습니다. 진위확인 결과가 `MATCHED`나 `NOT_MATCHED`인 문서마다 100포인트를 차감합니다.
      [사업자등록증 인식과 진위확인
      가이드](/docs/api-introduction/business-registration-certificate)
  - name: 사업자 정보 조회
    description: >
      상호, 대표자명, 사업자등록번호로 사업자를 검색하고 사업자등록번호 한 건의 상세 정보를 조회합니다. 발급자 등록과 공동인증서가 필요
      없습니다. 검색은 돌려준 결과 한 건마다 9포인트, 상세 조회는 조회 성공마다 90포인트를 차감합니다. [사업자 정보 조회
      가이드](/docs/api-introduction/business-profile)
  - name: 매출/매입 내역 조회
    description: >
      볼타에 쌓인 내 사업자의 매출과 매입 세금계산서를 바뀐 순서로 조회하고 수집을 요청합니다. 볼타에서 발행한 문서와 홈택스에서 수집한
      문서가 모두 실립니다. 스탠다드 플랜 이상을 구독해야 하며 포인트는 차감하지 않습니다. 홈택스 연동은 볼타 대시보드에서 먼저 하세요.
      [매출/매입 내역 조회 가이드](/docs/api-introduction/revenue-expense)
  - name: 입출금 내역 조회
    description: >
      볼타에 연결한 내 사업자의 입출금 계좌와 입출금 내역을 조회하고 동기화를 요청합니다. 스탠다드 플랜 이상을 구독해야 하며 포인트는
      차감하지 않습니다. 계좌는 볼타 대시보드에서 먼저 연결하세요. [입출금 내역 조회
      가이드](/docs/api-introduction/bank-account-transactions)
  - name: 예금주 조회
    description: >
      은행코드와 계좌번호로 예금주명을 조회합니다. 한 계좌씩 묻는 경로와 최대 100개를 한 번에 묻는 경로가 있습니다. 예금주를 돌려준
      계좌마다 50포인트를 차감합니다. [예금주 조회
      가이드](/docs/api-introduction/bank-account-holder)
  - name: 서류 발급
    description: >
      홈택스 국세 증명 서류와 법인등기사항전부증명서를 발급하고 원본 PDF를 내려받습니다. 홈택스 서류는 API 키가 속한 사업자의 서류만
      발급하며, 볼타 대시보드에 공동인증서를 등록해야 합니다. 법인등기는 `corporationNumber`의 법인 등기부를 발급하고
      공동인증서가 필요 없습니다. 지원하는 법인 종류는 주식회사, 유한회사, 합명회사, 합자회사, 유한책임회사, 사단법인, 재단법인,
      학교법인, 사회복지법인, 의료법인, 회계법인, 법무법인, 법무사법인, 협동조합(사회적협동조합 포함), 농업협동조합, 축산업협동조합,
      수산업협동조합, 신용협동조합, 사업협동조합, 공업협동조합, 중소기업협동조합, 새마을금고, 영농조합법인, 영어조합법인,
      특수법인(한국수출입은행 등), 기타법인(특허법인 등)입니다. 외국회사의 국내 영업소는 지원하지 않습니다. 한 건에 홈택스 서류
      500포인트, 법인등기 열람용 2,000포인트, 제출용 3,000포인트를 차감합니다. [서류 발급
      가이드](/docs/api-introduction/document-issuance)
  - name: 발급자
    description: >
      세금계산서 발행 주체인 발급자를 등록하고 관리합니다. 발행 방식에 따라 공동인증서 필요 여부가 다릅니다. [용어
      정리](/docs/api-introduction/glossary) | [대리
      정발행](/docs/api-introduction/usecase-delegated) | [위수탁
      발행](/docs/api-introduction/usecase-brokered)
  - name: 인증서
    description: >
      발급자 공동인증서 등록 및 관리. [인증서
      등록](/docs/api-introduction/certificate-registration)
paths:
  /v1/taxInvoices/{issuanceKey}/amend/misspell:
    post:
      tags:
        - 세금계산서 발행
      summary: 전자(세금)계산서 수정발행 - 기재사항 착오정정
      description: >
        고친 세금계산서 내용을 전달하면 API가 원본을 상계하는 취소분과 고친 내용의 수정분을 함께 발행합니다. 응답의
        `issuanceKey`는 수정분, `cancelIssuanceKey`는 취소분입니다. 두 장은 각 키로 따로 조회하고 웹훅도
        따로 받으며, 장마다 포인트를 차감합니다.


        품목 공급가액 합계는 0이 아니어야 합니다. 세액 합계가 0이나 `null`이 아니면 공급가액 합계와 부호가 같아야 합니다.


        `supplier`를 생략하면 원본 공급자를 사용합니다. `supplier`를 보낼 때 `identificationNumber`와
        `taxRegistrationId`는 원본과 같아야 합니다. 위수탁 세금계산서와 공급받는자 식별번호가 외국인등록번호인 세금계산서는
        지원하지 않습니다.


        [수정발행 유형 가이드](/docs/api-introduction/amendment-guide#기재사항-착오정정)를 참고하세요.


        API가 요청 텍스트의 보이지 않는 문자를 자동으로 지웁니다. 탭, 줄바꿈, 캐리지리턴은 유지합니다. 이모지처럼 U+FFFF를
        넘는 보충 문자는 `400`으로 거부합니다. [지원하지 않는
        문자](/docs/api-introduction/issuance-guide#지원하지-않는-문자)를 참고하세요.
      parameters:
        - name: issuanceKey
          in: path
          description: 발행 요청 식별번호
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/TaxInvoiceClientReferenceId'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                date:
                  $ref: '#/components/schemas/DateString'
                  title: 작성일자
                  description: 수정분 작성일자. 오늘 또는 이전 날짜. 과거 하한 없음
                purpose:
                  $ref: '#/components/schemas/IssuancePurpose'
                  title: 영수/청구 구분
                taxType:
                  $ref: '#/components/schemas/TaxInvoiceTaxType'
                supplier:
                  title: 공급자
                  description: >-
                    생략하면 원본 공급자를 사용합니다. 보낼 때 `identificationNumber`와
                    `taxRegistrationId`는 원본과 같아야 합니다.
                  anyOf:
                    - $ref: '#/components/schemas/TaxInvoiceSupplier'
                    - type: 'null'
                supplied:
                  $ref: '#/components/schemas/TaxInvoiceRecipient'
                  title: 공급받는자
                  description: 공급받는자
                items:
                  title: 품목
                  description: 수정분 품목
                  type: array
                  minItems: 1
                  maxItems: 16
                  items:
                    $ref: '#/components/schemas/TaxInvoiceAmendItem'
              required:
                - date
                - purpose
                - taxType
                - supplied
                - items
              allOf:
                - $ref: '#/components/schemas/TaxInvoiceItemsByTaxTypeConstraint'
            examples:
              과세 착오정정:
                x-parity-id: taxableMisspell
                summary: 과세 세금계산서 기재사항 착오정정
                value:
                  date: '2026-05-27'
                  purpose: CLAIM
                  taxType: TAXABLE
                  supplied:
                    identificationNumber: '0987654321'
                    taxRegistrationId: null
                    organizationName: 공급받는자 상호
                    representativeName: 공급받는자대표
                    address: null
                    businessItem: null
                    businessType: null
                    managers:
                      - email: recipient@example.com
                        name: 공급받는자담당자
                        telephone: null
                  items:
                    - date: '2026-05-27'
                      name: 정정 품목
                      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: 수정분 세금계산서의 IssuanceKey
                  cancelIssuanceKey:
                    $ref: '#/components/schemas/IssuanceKey'
                    description: 취소분 세금계산서의 IssuanceKey
                required:
                  - issuanceKey
                  - cancelIssuanceKey
          headers: {}
        '400':
          description: >-
            요청 검증 실패 또는 요청자 관리번호 중복입니다. 같은 API 키로 이미 사용한
            `Bolta-Client-Reference-Id`는 요청 내용과 관계없이 다시 쓸 수 없습니다. 응답의 `code`는
            `INVALID_REQUEST`입니다. 원본이 발행 성공 상태가 아니면 `ISSUANCE_MUST_BE_SUCCESS`를
            반환합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: 다른 API 키로 발행한 원본입니다. 응답의 `code`는 `FORBIDDEN`입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: 존재하지 않는 `issuanceKey`입니다. 응답의 `code`는 `NOT_FOUND`입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: 서버 내부 오류
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      deprecated: false
components:
  parameters:
    TaxInvoiceClientReferenceId:
      name: Bolta-Client-Reference-Id
      in: header
      description: >-
        세금계산서 요청자 관리번호입니다. 선택 사항이며 1~255자의 비어 있지 않은 값을 입력하세요. 같은 API 키에서 세금계산서
        발행 계열 API에 이미 사용한 값은 요청 내용이나 API 경로가 같든 다르든 재사용할 수 없습니다. 중복이면 API가 `400
        Bad Request`와 `INVALID_REQUEST`를 반환합니다. 응답을 받지 못했다면 같은 요청을 다시 보내지 말고 [요청
        상태 조회
        API](/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: 영수, CLAIM: 청구'
      enum:
        - RECEIPT
        - CLAIM
    TaxInvoiceTaxType:
      type: string
      title: 과세유형
      description: >-
        TAXABLE: 과세(전자세금계산서), ZERO_RATE: 영세율(전자세금계산서), TAX_FREE: 면세(계산서).
        TAXABLE은 품목의 세액이 null일 수 없고, ZERO_RATE은 모든 품목의 세액이 0이어야 합니다. TAX_FREE는
        모든 품목의 세액이 null이거나 생략되어야 합니다.
      enum:
        - TAXABLE
        - ZERO_RATE
        - TAX_FREE
      examples:
        - TAXABLE
        - ZERO_RATE
        - TAX_FREE
    TaxInvoiceSupplier:
      type: object
      properties:
        identificationNumber:
          $ref: '#/components/schemas/BusinessRegistrationNumber'
          title: 사업자등록번호
          description: 사업자등록번호
        taxRegistrationId:
          title: 종사업장번호
          description: 종사업장번호
          anyOf:
            - $ref: '#/components/schemas/TaxRegistrationId'
            - type: 'null'
        organizationName:
          $ref: '#/components/schemas/OrganizationName'
          title: 상호명
          description: 상호명
        representativeName:
          $ref: '#/components/schemas/RepresentativeName'
          title: 대표자명
          description: 대표자명
        address:
          title: 주소
          description: 주소
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
        businessItem:
          title: 종목
          description: 종목
          anyOf:
            - $ref: '#/components/schemas/BusinessItem'
            - type: 'null'
        businessType:
          title: 업태
          description: 업태
          anyOf:
            - $ref: '#/components/schemas/BusinessType'
            - type: 'null'
        manager:
          $ref: '#/components/schemas/TaxInvoiceManager'
          title: 담당자
          description: 담당자
      required:
        - identificationNumber
        - manager
        - organizationName
        - representativeName
    TaxInvoiceRecipient:
      type: object
      properties:
        identificationNumber:
          $ref: '#/components/schemas/RecipientIdentificationNumber'
          title: 식별번호(사업자등록번호, 주민등록번호, 외국인등록번호)
          description: 식별번호(사업자등록번호, 주민등록번호 형식, 외국인등록번호 형식)
        taxRegistrationId:
          title: 종사업장번호
          description: 공급받는자 식별번호가 사업자등록번호가 아니면 `null`로 전달하거나 필드를 생략하세요.
          anyOf:
            - $ref: '#/components/schemas/TaxRegistrationId'
            - type: 'null'
        organizationName:
          $ref: '#/components/schemas/OrganizationName'
          title: 상호명
          description: 상호명
        representativeName:
          $ref: '#/components/schemas/RepresentativeName'
          title: 대표자명
          description: 대표자명
        address:
          title: 주소
          description: 주소
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
        businessItem:
          title: 종목
          description: 종목
          anyOf:
            - $ref: '#/components/schemas/BusinessItem'
            - type: 'null'
        businessType:
          title: 업태
          description: 업태
          anyOf:
            - $ref: '#/components/schemas/BusinessType'
            - type: 'null'
        managers:
          type: array
          items:
            $ref: '#/components/schemas/TaxInvoiceManager'
          title: 담당자
          description: 담당자
          minItems: 1
          maxItems: 2
      required:
        - representativeName
        - managers
        - identificationNumber
        - organizationName
    TaxInvoiceAmendItem:
      type: object
      properties:
        date:
          $ref: '#/components/schemas/DateString'
          title: 공급일자
          description: >-
            품목 공급일자. 요청의 `date`가 속한 달을 기준으로 시작일을 정하고, 시작일부터 `date`까지 입력하세요(양쪽 경계
            포함). `date`가 전월 작성분의 발행 마감일 당일 또는 이전이면 전월 1일, 이후이면 당월 1일이 시작일입니다.
            주말, 공휴일과 국세청 기한 연장은 [발행 마감일
            기준](/docs/api-introduction/tax-invoice-issue-due-date#마감일-기준)을 따릅니다.
        name:
          type: string
          title: 품목명
          description: 품목명
          maxLength: 100
          minLength: 1
        unitPrice:
          type:
            - number
            - 'null'
          title: 단가
          description: 단가
          examples:
            - 100
        quantity:
          type:
            - number
            - 'null'
          not:
            const: 0
          title: 수량
          description: 수량. 0은 넣을 수 없습니다. 공급가액 변동은 양수만, 환입과 기재사항 착오정정은 음수도 받습니다.
        supplyCost:
          type: integer
          title: 공급가액
          description: 공급가액
          examples:
            - 1000
            - -1000
        tax:
          type:
            - integer
            - 'null'
          title: 세액
          description: 세액
          examples:
            - 0
            - 100
            - -100
        specification:
          type:
            - string
            - 'null'
          title: 규격
          description: 규격
          maxLength: 60
        description:
          type:
            - string
            - 'null'
          title: 품목 비고
          description: 품목 비고
          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: 발행 요청 식별번호. 형식과 길이가 바뀔 수 있으니 문자열 전체를 그대로 저장하세요.
      examples:
        - 8D529FAD3EBAE050B79CE943CCC7CEDE
    ErrorResponse:
      type: object
      description: API 요청 실패 시 반환되는 에러 응답
      properties:
        code:
          type: string
          description: 에러 타입 식별자
        message:
          type: string
          description: 에러 설명
        traceId:
          type: string
          description: 요청 추적 식별자
      required:
        - code
        - message
        - traceId
    BusinessRegistrationNumber:
      type: string
      title: 사업자등록번호
      description: >-
        체크섬이 유효한 하이픈(-) 없는 10자리 숫자. 패턴: `^\d{10}$`. 문서의 예시 번호는 체크섬을 통과하지 않는
        자리표시자입니다. 실제 사업자등록번호를 입력하세요.
      pattern: ^\d{10}$
      examples:
        - '1234567890'
    TaxRegistrationId:
      type: string
      title: 종사업장번호
      description: '4자리 숫자, `0000` 제외. 패턴: `^(?!0{4})\d{4}$`'
      pattern: ^(?!0{4})\d{4}$
      examples:
        - '0001'
        - '0002'
      minLength: 4
      maxLength: 4
    OrganizationName:
      type: string
      title: 상호명
      description: 상호명
      maxLength: 70
      minLength: 1
    RepresentativeName:
      type: string
      title: 대표자명
      description: 대표자명
      minLength: 1
      maxLength: 30
    Address:
      type: string
      title: 주소
      description: 주소
      maxLength: 150
      minLength: 1
    BusinessItem:
      type: string
      title: 종목
      description: 종목
      maxLength: 100
      examples:
        - 소프트웨어 개발 및 공급업
      minLength: 1
    BusinessType:
      type: string
      title: 업태
      description: 업태
      maxLength: 100
      examples:
        - 정보통신업
      minLength: 1
    TaxInvoiceManager:
      type: object
      properties:
        email:
          $ref: '#/components/schemas/Email'
          title: 이메일
          description: 이메일
        name:
          type:
            - string
            - 'null'
          title: 이름
          description: 이름
          maxLength: 30
          minLength: 1
        telephone:
          type:
            - string
            - 'null'
          title: 휴대전화번호
          description: '휴대전화번호. 입력하면 볼타가 담당자에게 알림톡을 보냅니다. 패턴: `^010-\d{4}-\d{4}$`'
          maxLength: 20
          examples:
            - 010-1234-5678
          pattern: ^010-\d{4}-\d{4}$
      required:
        - email
    RecipientIdentificationNumber:
      type: string
      title: 식별번호
      description: >-
        사업자등록번호 10자리, 주민등록번호 형식 13자리, 외국인등록번호 형식 13자리. 하이픈(-) 없는 숫자. 예시 번호는
        자리표시자입니다. 실제 공급받는자의 식별번호를 입력하세요.
      pattern: ^\d{10}(\d{3})?$
      examples:
        - '1234567890'
        - '9001011234567'
        - '9001015234567'
    Email:
      type: string
      title: 이메일
      description: '패턴: `^[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: >-
        API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는
        비워두세요.

````

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