메인 콘텐츠로 건너뛰기
POST
/
v1
/
taxInvoices
/
issueRequest
전자(세금)계산서 역발행
curl --request POST \
  --url https://xapi.bolta.io/v1/taxInvoices/issueRequest \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Customer-Key: <customer-key>' \
  --data '
{
  "date": "2024-08-24",
  "purpose": "RECEIPT",
  "supplier": {
    "identificationNumber": "<string>",
    "organizationName": "<string>",
    "representativeName": "<string>",
    "manager": {
      "email": "[email protected]",
      "name": "<string>",
      "telephone": "<string>"
    },
    "taxRegistrationId": "<string>",
    "address": "<string>",
    "businessItem": "<string>",
    "businessType": "<string>"
  },
  "supplied": {
    "identificationNumber": "<string>",
    "organizationName": "<string>",
    "representativeName": "<string>",
    "managers": [
      {
        "email": "[email protected]",
        "name": "<string>",
        "telephone": "<string>"
      }
    ],
    "taxRegistrationId": "<string>",
    "address": "<string>",
    "businessItem": "<string>",
    "businessType": "<string>"
  },
  "items": [
    {
      "date": "2023-12-25",
      "name": "<string>",
      "supplyCost": 2,
      "unitPrice": 1,
      "quantity": 123,
      "tax": 2,
      "specification": "<string>",
      "description": "<string>"
    }
  ],
  "description": "<string>"
}
'
{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}

인증

Authorization
string
header
필수

API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요.

헤더

Customer-Key
string
필수

고객 식별 키. 고객 생성 API로 발급받은 customerKey를 사용합니다. API 키 단위로 독립 관리됩니다. 인증 가이드

본문

application/json
date
string<date>
필수

작성일자

예시:

"2024-08-24"

purpose
enum<string>
필수

RECEIPT: 영수, CLAIM: 청구

사용 가능한 옵션:
RECEIPT,
CLAIM
supplier
공급자 · object
필수

공급자

supplied
공급받는자 · object
필수

공급받는자

items
품목 · object[]
필수

품목

Required array length: 1 - 5 elements
description
string

세금계산서 비고

Required string length: 1 - 200

응답

issuanceKey
string
필수

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

예시:

"8D529FAD3EBAE050B79CE943CCC7CEDE"