전자(세금)계산서 역발행 - 요청 상태 조회

역발행 요청의 현재 상태를 조회합니다. 공급자 승인 대기, 승인, 발행 완료, 거절, 취소, 만료, 실패를 status 하나로 구분합니다. 웹훅을 받지 못했거나 공급자가 아직 승인하지 않은 요청을 확인할 때 쓰세요.

승인 기한(approvalDueDate)이 지난 승인 대기 요청은 EXPIRED로 반환합니다. status가 FAILED이면 failure.stage로 실패 단계를 확인하세요. SUBMISSION은 요청이 공급자에게 전달되지 않은 경우이고, ISSUANCE는 공급자가 승인했지만 발행에 실패한 경우입니다.

테스트 키 요청은 공급자 승인 단계를 거치지 않습니다. 요청 취소 API로 취소한 테스트 요청은 CANCELED를 반환합니다.

자세한 내용은 이메일 승인 역발행 | 간편 승인 역발행을 참고하세요.

GET

taxInvoices

{issuanceKey}

issueRequest

전자(세금)계산서 역발행 - 요청 상태 조회

curl --request GET \
  --url https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE",
  "status": "REQUESTED",
  "approvalDueDate": "2026-10-12",
  "failure": null
}

인증

Authorization

string

header

필수

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

경로 매개변수

issuanceKey

string

필수

역발행 요청 응답으로 받은 발행 요청 식별번호

응답

조회 성공

역발행 요청 상태 조회 결과

issuanceKey

string

필수

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

예시:

"8D529FAD3EBAE050B79CE943CCC7CEDE"

status

enum<string>

필수

역발행 요청 상태. REQUESTED: 접수 완료, 공급자 승인 대기. 볼타가 요청을 공급자에게 전달하기 전 구간도 포함합니다. APPROVED: 공급자 승인 완료, 국세청 전송 중. ISSUED: 발행 완료. REJECTED: 공급자 거절. CANCELED: 요청 취소. EXPIRED: 승인 기한 만료. FAILED: 접수 또는 발행 실패. failure.stage로 단계를 구분합니다.

사용 가능한 옵션:

REQUESTED,

APPROVED,

ISSUED,

REJECTED,

CANCELED,

EXPIRED,

FAILED

approvalDueDate

string<date> | null

필수

공급자 승인 기한. 볼타가 요청을 공급자에게 전달하기 전이거나 전달하지 못하고 끝난 요청은 null입니다.

failure

object | null

필수

실패 사유. status가 FAILED일 때만 값이 있고, 그 밖에는 null입니다.

Show child attributes

전자(세금)계산서 역발행 - 요청 상태 조회

curl --request GET \
  --url https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://xapi.bolta.io/v1/taxInvoices/{issuanceKey}/issueRequest")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE",
  "status": "REQUESTED",
  "approvalDueDate": "2026-10-12",
  "failure": null
}

세금계산서 발행

세금계산서 역발행

발급자

인증서

세금계산서 조회

현금영수증

사업자등록 상태 조회

전자(세금)계산서 역발행 - 요청 상태 조회

인증

경로 매개변수

응답