v1

latestOpenAPI 3.1.02026-07-22142337.1 KB
세금계산서 역발행

전자(세금)계산서 역발행

전체 품목의 금액 합이 발행 금액이 됩니다. taxType에 따라 품목의 세액(tax)을 전달해주세요.

금액 계산 방식은 정발행과 동일합니다. 발행 금액 계산 가이드이메일 승인 역발행 | 간편 승인 역발행을 참고하세요.

post/v1/taxInvoices/issueRequest

Headers

Supplier-Keystring required

공급자(발행자) 식별 키입니다. 공급받는자(거래처)가 아니라 발행 주체 본인의 키입니다. 공급자 등록 API(POST /v1/suppliers)로 발급받은 supplierKey를 사용하며, 공급받는자 정보는 요청 본문의 supplied 필드에 넣습니다. API 키 단위로 독립 관리됩니다. 용어 정리 | 인증 가이드

Request body

datestring date required
purpose'RECEIPT' | 'CLAIM' required

RECEIPT: 영수, CLAIM: 청구

taxType'TAXABLE' | 'ZERO_RATE' | 'TAX_FREE' required

TAXABLE: 과세(전자세금계산서), ZERO_RATE: 영세율(전자세금계산서), TAX_FREE: 면세(계산서). TAXABLE은 품목의 세액이 null일 수 없고, ZERO_RATE은 모든 품목의 세액이 0이어야 하며, TAX_FREE는 모든 품목의 세액이 null이어야 합니다.

descriptionstring nullable

세금계산서 비고

Example request

{
  "date": "2024-08-24",
  "taxType": "TAXABLE",
  "supplier": {
    "identificationNumber": "1234567890",
    "taxRegistrationId": "0001",
    "businessItem": "소프트웨어 개발 및 공급업",
    "businessType": "정보통신업",
    "manager": {
      "telephone": "010-1234-5678"
    }
  },
  "supplied": {
    "identificationNumber": "1234567890",
    "taxRegistrationId": "0001",
    "businessItem": "소프트웨어 개발 및 공급업",
    "businessType": "정보통신업",
    "managers": [
      {
        "telephone": "010-1234-5678"
      }
    ]
  },
  "items": [
    {
      "date": "2024-08-24",
      "unitPrice": 100,
      "supplyCost": 1000
    }
  ]
}

Response

issuanceKeystring required

발행 요청에 대한 식별번호. 포맷과 길이는 바뀔 수 있으므로 유의하시기 바랍니다.

Example response

{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}