> ## 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. # 전자(세금)계산서 역발행 > 전체 품목의 금액 합이 발행 금액이 됩니다. 면세(전자계산서) 발행 시 품목의 세액을 `null`로 호출해주세요. 금액 계산 방식은 정발행과 동일합니다. [발행 금액 계산 가이드](/docs/api-introduction/issuance-guide)와 [이메일 승인 역발행](/docs/api-introduction/usecase-reverse-email) | [간편 승인 역발행](/docs/api-introduction/usecase-reverse-simple)을 참고하세요. ## OpenAPI ````yaml /openapi.yaml post /v1/taxInvoices/issueRequest 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: > 전자(세금)계산서 역발행 요청 및 관리. [이메일 승인 역발행](/docs/api-introduction/usecase-reverse-email) | [간편 승인 역발행](/docs/api-introduction/usecase-reverse-simple) - name: 공급자 description: > 세금계산서를 발행하는 공급자(발행자)를 등록·관리합니다. [용어 정리](/docs/api-introduction/glossary) | [대리 정발행](/docs/api-introduction/usecase-delegated) - name: 인증서 description: | 공급자 공동인증서 등록 및 관리. [인증 가이드](/docs/api-introduction/authentication) paths: /v1/taxInvoices/issueRequest: post: tags: - 세금계산서 역발행 summary: 전자(세금)계산서 역발행 description: > 전체 품목의 금액 합이 발행 금액이 됩니다. 면세(전자계산서) 발행 시 품목의 세액을 `null`로 호출해주세요. 금액 계산 방식은 정발행과 동일합니다. [발행 금액 계산 가이드](/docs/api-introduction/issuance-guide)와 [이메일 승인 역발행](/docs/api-introduction/usecase-reverse-email) | [간편 승인 역발행](/docs/api-introduction/usecase-reverse-simple)을 참고하세요. parameters: - name: Supplier-Key in: header description: >- 공급자(발행자) 식별 키입니다. 공급받는자(거래처)가 아니라 발행 주체 본인의 키입니다. 공급자 등록 API(POST /v1/suppliers)로 발급받은 supplierKey를 사용하며, 공급받는자 정보는 요청 본문의 supplied 필드에 넣습니다. API 키 단위로 독립 관리됩니다. [용어 정리](/docs/api-introduction/glossary) | [인증 가이드](/docs/api-introduction/authentication) required: true example: SupplierKey_bf8paz schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ReverseIssueRequest' responses: '200': description: '' content: application/json: schema: type: object properties: issuanceKey: $ref: '#/components/schemas/IssuanceKey' required: - issuanceKey example: issuanceKey: 8D529FAD3EBAE050B79CE943CCC7CEDE headers: {} '400': description: 잘못된 요청 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: 서버 내부 오류 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: ReverseIssueRequest: type: object properties: date: title: 작성일자 description: 작성일자 allOf: - $ref: '#/components/schemas/DateString' purpose: $ref: '#/components/schemas/IssuancePurpose' title: 영수/청구 구분 description: 'RECEIPT: 영수, CLAIM: 청구' supplier: $ref: '#/components/schemas/TaxInvoiceSupplier' title: 공급자 description: 공급자 supplied: $ref: '#/components/schemas/ReverseIssueRecipient' title: 공급받는자 description: 공급받는자 items: title: 품목 description: 품목 type: array items: $ref: '#/components/schemas/TaxInvoiceItem' minItems: 1 maxItems: 16 description: type: - string - 'null' title: 세금계산서 비고 description: 세금계산서 비고 minLength: 1 maxLength: 150 required: - purpose - supplied - supplier - items - date IssuanceKey: type: string description: 발행 요청에 대한 식별번호. 포맷과 길이는 바뀔 수 있으므로 유의하시기 바랍니다. examples: - 8D529FAD3EBAE050B79CE943CCC7CEDE ErrorResponse: type: object description: API 요청 실패 시 반환되는 에러 응답 properties: code: type: string description: 에러 타입 식별자 message: type: string description: 에러 설명 required: - code - message DateString: type: string format: date examples: - '2024-08-24' IssuancePurpose: type: string description: 'RECEIPT: 영수, CLAIM: 청구' enum: - RECEIPT - CLAIM 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 ReverseIssueRecipient: 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' managers: type: array items: $ref: '#/components/schemas/TaxInvoiceManager' title: 담당자 description: 담당자 minItems: 1 maxItems: 2 required: - representativeName - managers - identificationNumber - organizationName TaxInvoiceItem: type: object properties: date: $ref: '#/components/schemas/DateString' title: 공급일자 description: 공급일자 name: type: string title: 품목명 description: 품목명 maxLength: 100 minLength: 1 unitPrice: type: - integer - 'null' title: 단가 description: 단가 minimum: 0 exclusiveMinimum: 0 examples: - 100 quantity: type: - integer - 'null' title: 수량 description: 수량 supplyCost: type: integer title: 공급가액 description: 공급가액 minimum: 1 examples: - 1000 tax: type: - integer - 'null' title: 세액 description: 세액 minimum: 1 examples: - 100 specification: type: - string - 'null' title: 규격 description: 규격 maxLength: 60 description: type: - string - 'null' title: 품목 비고 description: 품목 비고 maxLength: 100 required: - date - name - supplyCost BusinessRegistrationNumber: type: string title: 사업자등록번호 description: '하이픈(-) 없는 10자리 숫자. 패턴: `^\d{10}$`' pattern: ^\d{3}\d{2}\d{5}$ 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{3,4}-\d{4}$`' maxLength: 20 examples: - 010-1234-5678 - 010-123-4567 pattern: ^010-\d{3,4}-\d{4}$ required: - email 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는 비워두세요. ````