본문으로 이동

서비스에 필요한 업무 기능을 API로 연결하세요.

세금계산서 발행, 거래처 확인, 금융 데이터 조회. 필요한 API를 선택하고 연동을 시작하세요.

필요한 기능부터 연결하세요.

발행, 확인, 조회. 서비스에 필요한 API를 골라 살펴보세요.

업무에 맞춰 연결하세요.

우리 회사 매출 발행

우리 회사의 매출 세금계산서를 자동으로 발행합니다

사내 ERP나 백오피스에서 매출을 확정하거나 SaaS 이용료를 청구할 때 연결하세요. 우리 회사가 공급자로서 구매 거래처에 세금계산서를 발행합니다.

자세히 보기
  1. 거래나 청구 금액 확정

  2. 자사 시스템에서 정발행 요청

  3. 발행 결과 반영

첫 API 요청을 보내세요.

실제 국세청 전송도, 포인트 차감도 없습니다. 테스트 키로 필요한 흐름을 검증하고, 인증서가 필요한 방식에는 테스트 인증서를 사용하세요.

  1. 테스트 키 발급

    볼타 가입과 워크스페이스 생성 후 개발자센터에서 test_ 키를 발급합니다.

  2. 유형에 맞는 발행 준비

    자사 발행은 우리 회사, 대리 발행은 고객사의 인증서를 등록합니다. 역발행은 이메일과 간편 승인 방식에 맞춰 준비하세요. 인증서가 필요한 테스트에는 테스트 인증서를 사용합니다.

  3. 요청 보내고 결과 받기

    거래 정보를 보내면 API가 요청 접수 응답을 반환합니다. 이후 발행 결과는 웹훅이나 조회 API로 확인하세요.

요청 / cURL
curl -X POST https://xapi.bolta.io/v1/taxInvoices/issue \
  --user 'test_YOUR_API_KEY:' \
  -H 'Bolta-Client-Reference-Id: YOUR_UNIQUE_REFERENCE_ID' \
  -H 'Content-Type: application/json' \
  -d '{
  "date": "YYYY-MM-DD",
  "purpose": "RECEIPT",
  "taxType": "TAXABLE",
  "supplier": {
    "identificationNumber": "SUPPLIER_BUSINESS_NUMBER",
    "organizationName": "공급자 상호",
    "representativeName": "홍길동",
    "manager": {
      "email": "supplier@example.com"
    }
  },
  "supplied": {
    "identificationNumber": "RECIPIENT_BUSINESS_NUMBER",
    "organizationName": "공급받는자 상호",
    "representativeName": "김철수",
    "managers": [
      {
        "email": "recipient@example.com"
      }
    ]
  },
  "items": [
    {
      "date": "YYYY-MM-DD",
      "name": "테스트 품목",
      "unitPrice": 10000,
      "quantity": 1,
      "supplyCost": 10000,
      "tax": 1000
    }
  ]
}'

issuanceKey는 요청 접수 응답입니다. 발행 완료나 실패 웹훅을 받거나 조회 API로 결과를 확인하세요.

강조한 API 키, 날짜, 사업자등록번호와 요청자 관리번호를 실제 값으로 바꾸세요. 날짜는 YYYY-MM-DD 형식이며 발행 마감일 이내여야 합니다. 각 탭의 복사 버튼은 해당 코드만 복사합니다.

세금계산서 API 가이드 (새 창)

요청 이후의 결과도 확인하세요.

웹훅으로 결과 받기

등록한 HTTPS URL로 발행 결과를 받습니다. 테스트와 라이브 웹훅은 각각 설정하며, 발송 시점은 제품마다 다릅니다.

웹훅 연결과 이벤트 보기 (새 창)

API별 요금과 이용 조건

API마다 과금 단위와 이용 조건이 다릅니다. 연결하려는 기능의 조건을 확인하세요.

정발행

1건당 90원

공급자가 직접 작성해 발행하는 일반 세금계산서

수정발행

1건당 90원

이미 발행한 건을 사유 코드와 함께 정정

역발행

1건당 200원

공급받는자가 작성해 요청하고 공급자가 승인

현금영수증

무료

소득공제, 지출증빙, 자진발급을 모두 발행

예금주 조회

성공 조회 계좌당 50포인트

예금주를 돌려준 계좌만 차감합니다. 못 찾았거나 실패했거나 한도를 넘으면 차감하지 않고 테스트 키는 언제나 무료입니다.

입출금내역 조회

스탠다드 플랜 이상

포인트를 차감하지 않습니다. 대신 스탠다드 플랜 이상을 구독해야 합니다.

서류 발급

서류 1건당 500포인트

발급에 성공한 건만 차감합니다. 실패하면 차감하지 않고 테스트 키는 차감이 없습니다.

테스트는 무료, 유료 발행은 포인트 사전 충전

테스트 키는 포인트를 차감하지 않습니다. 라이브에서 유료 발행을 요청하기 전에 포인트를 충전하세요. 잔액이 부족하면 요청이 실패합니다.

포인트 충전 방식 보기 (새 창)

볼타 API를 사용하는 고객

오더체크 로고
“실시간 API 테스트 환경 덕분에 바로 검증할 수 있었고, 연동 절차도 하루 만에 마칠 수 있었어요.”
오더체크

테스트 환경에서 연동 검증

브랜더진 로고
“백오피스에서 세금계산서 발행도 처리할 수 있게 되서 업무가 훨씬 편해졌어요.”
브랜더진

백오피스에서 발행 업무 처리

모먼트 스튜디오 로고
“매일 켜놓는 노션에서 바로 발행하고 화면 전환 없이 처리하니, 매일 15분 이상 절약돼요.”
모먼트 스튜디오

노션에서 발행 흐름 연결

연동 전 자주 묻는 질문

API를 이용하려면 별도 문의나 계약이 필요한가요?

가입 후 개발자센터에서 테스트와 라이브 API 키를 직접 발급할 수 있습니다. 사업자 상태 조회 요금은 이용 범위에 따라 별도 협의합니다.

API만 이용하려면 유료 구독이 필요한가요?

API 키는 유료 구독 없이 발급할 수 있습니다. 입출금내역 API는 스탠다드 이상 구독이 필요하며, 다른 API는 상품별 요금과 이용 조건에 따라 사용합니다.

한 플랫폼에서 여러 연동 유형을 함께 사용할 수 있나요?

네. 거래마다 공급자와 공급받는자를 기준으로 선택하세요. 플랫폼의 자체 이용료와 수수료는 우리 회사 매출로 발행하고, 입점업체의 판매분은 고객사 매출로 대리 발행합니다. 매입 내역을 작성해 공급자에게 승인을 요청하는 거래에는 역발행을 연결합니다.

대리 정발행과 위수탁 발행은 어떻게 다른가요?

대리 정발행은 고객사인 공급자의 인증서로 발행을 요청합니다. 위수탁 발행은 수탁자 인증서를 사용하고, 공급자, 공급받는자, 수탁자 정보를 함께 보냅니다.

역발행 승인 방식에 따라 무엇을 준비해야 하나요?

두 방식 모두 공급자를 발급자로 등록합니다. 이메일 승인은 공급자 인증서의 사전 등록 없이 요청하고, 공급자가 볼타에서 보낸 이메일 링크를 열어 승인합니다. 간편 승인은 공급자가 인증서를 등록한 뒤 연동 시스템에서 승인 URL을 안내합니다. 두 방식 모두 공급자가 직접 승인해야 발행을 진행합니다.

실제 발행 전에 무엇을 준비해야 하나요?

세금계산서 정발행에는 발급자와 공동인증서 등록이 필요합니다. 역발행은 승인 방식에 따라 준비물이 달라집니다. 라이브 키로 유료 발행을 요청하기 전에는 개발자센터에서 포인트를 충전하세요.

테스트하면 국세청에 실제로 전송되나요?

아니요. 테스트 키(test_)는 실제 국세청 전송 없이 연동을 검증하며 포인트를 차감하지 않습니다. 테스트 인증서도 사용할 수 있습니다. 라이브 키(live_)는 실제 발행에 사용합니다.

API 응답을 받으면 발행이 완료된 건가요?

issuanceKey 응답은 요청 접수를 뜻합니다. 최종 발행 결과는 웹훅이나 조회 API로 확인하세요. 웹훅 발송 시점은 세금계산서와 현금영수증이 다릅니다.

응답을 받지 못하면 다시 발행 요청을 보내도 되나요?

세금계산서는 요청에 사용한 관리번호로 접수 상태를 먼저 조회하세요. 같은 관리번호를 다시 쓰면 중복 요청 오류가 발생합니다. 현금영수증은 중복 요청 처리 방식이 다르므로 인증 가이드의 제품별 규칙을 따릅니다.

볼타 세금계산서 API는 어떤 언어를 지원하나요?

HTTP 요청을 보낼 수 있는 언어와 환경에서 연동할 수 있습니다. API 문서에 언어별 요청 예제가 있습니다. 언어별 HTTP 예제와 공식 SDK는 서로 다릅니다.

노코드 도구로도 연결할 수 있나요?

Zapier와 Make 연동 가이드를 제공합니다. 쓰는 도구에서 발행에 필요한 데이터를 준비한 다음 API 인증과 요청을 설정합니다. 지원 범위와 설정 방법은 각 가이드에 있습니다.

연동에는 얼마나 걸리나요?

무료 테스트 환경에서 발행, 고객 등록, 승인 흐름을 연결한 뒤 라이브 키로 실제 발행을 시작하세요.

API 사용량 결제는 어떻게 이루어지나요?

사전 충전한 포인트에서 정발행과 수정발행은 1건당 90원, 역발행은 1건당 200원을 차감합니다. 최소 사용료와 기술지원비, 유지보수비는 없습니다. 유료 발행을 요청하려면 포인트 잔액이 남아 있어야 합니다.

볼타 API로 개발을 시작하세요.

별도 문의나 계약 없이 API 키를 직접 발급하고, 사용한 만큼만 결제합니다.