본문으로 이동

API 연동

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

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

01

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

발행, 사업자 데이터, 내역 조회. 필요한 API부터 붙이세요.

02

업무에 맞춰 연결하세요.

우리 회사 매출 발행

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

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

  1. 거래나 청구 금액 확정

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

  3. 발행 결과 반영

자세히 보기

03

지원 기능

지원 기능
기능이럴 때할 수 있는 일
정발행 (새 창)공급자가 거래 내용을 작성해 발행할 때과세, 영세율 세금계산서와 면세 전자계산서 발행
수정발행 (새 창)이미 발행한 세금계산서를 정정할 때계약 해제와 공급가액 변동, 착오에 의한 이중발급 사유로 정정
역발행 (새 창)공급받는자가 작성하고 공급자가 승인할 때이메일 또는 승인 URL로 승인 절차 연결
현금영수증 (새 창)소득공제, 지출증빙, 자진발급이 필요할 때발행 요청, 상태 조회, 전액 취소
  • 대리 정발행

    공급자인 고객사가 자신의 인증서를 직접 등록합니다. 플랫폼은 고객사의 인증서로 공급자 대신 정발행을 요청합니다.
  • 위수탁 발행

    수탁자의 인증서를 사용합니다. 공급자와 공급받는자 외에 수탁자 정보를 함께 보내 정발행을 요청합니다.

04

첫 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 가이드 (새 창)

05

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

06

API별 요금과 이용 조건

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

  • 정발행1건당 90원

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

  • 수정발행1건당 90원

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

  • 역발행1건당 200원

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

  • 현금영수증무료

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

  • 사업자 프로필 검색결과 1건당 9원

    검색으로 돌려준 결과 수만큼 차감합니다. 다음 결과를 받아도 받은 건수만큼 차감합니다.

  • 사업자 프로필 상세 조회사업자등록번호 1건당 90원

    상세 조회에 성공한 건만 차감합니다. 프로필이 없거나 오류가 나면 차감하지 않습니다.

  • 사업자등록 상태 조회사업자등록번호 1건당 10원

    상태를 확인한 사업자등록번호만 차감합니다. 확인하지 못한 번호와 테스트 키 호출은 차감하지 않습니다.

  • 사업자등록증 인식서류 1건당 100원

    진위확인에서 일치나 불일치 결과를 받은 문서마다 차감합니다. 국세청 장애로 확인하지 못한 문서, 오류 응답, 테스트 키 호출은 차감하지 않습니다.

  • 예금주 조회성공 조회 계좌당 50원

    예금주를 돌려준 계좌만 차감합니다. 예금주를 못 찾은 계좌, 조회 실패, 한도 초과는 차감하지 않습니다. 테스트 키는 언제나 무료입니다.

  • 홈택스 서류 발급서류 1건당 500원

    발급에 성공한 건만 차감합니다. 실패한 건과 테스트 키 호출은 차감하지 않습니다.

  • 법인등기사항전부증명서(열람용)서류 1건당 1,000원

    내용 확인용 등기부입니다. 공동인증서 없이 법인등록번호로 요청합니다.

  • 법인등기사항전부증명서(제출용)서류 1건당 1,500원

    관공서나 은행에 내는 등기부입니다. 발급에 실패하면 차감하지 않습니다.

  • 입출금 내역 조회스탠다드 플랜 이상

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

  • 매출/매입 내역 조회스탠다드 플랜 이상

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

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

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

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

07

볼타 API를 사용하는 고객

  • CJ ENM 커머스부문

  • HD현대

  • 현대벤디스

  • 고위드

  • 김캐디

  • 팬딩

  • 후르츠패밀리

  • 바카티오

연동한 고객의 이야기

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

    오더체크테스트 환경에서 연동 검증

  • “백오피스에서 세금계산서 발행도 처리할 수 있게 돼서 업무가 훨씬 편해졌어요.”

    브랜더진백오피스에서 발행 업무 처리

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

    모먼트 스튜디오노션에서 발행 흐름 연결

08FAQ

연동 전 자주 묻는 질문

연동 방법과 오류 코드는 API 문서에 정리돼 있습니다.

API 문서 보기 (새 창)
API를 이용하려면 별도 문의나 계약이 필요한가요?

아니요. 가입 후 개발자센터에서 테스트와 라이브 API 키를 직접 발급합니다. 사업자등록 상태 조회도 사업자등록번호 1건당 10원으로 바로 이용하세요.

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 키를 직접 발급하고, 사용한 만큼만 결제합니다.

도입 범위를 먼저 상의하고 싶다면API 도입 상담