bolta-open-api
  1. 가이드
bolta-open-api
  • 볼타 전자(세금)계산서 API 문서
  • 가이드
    • API 키
    • 요청·응답 본문
    • 방화벽 및 보안 프로토콜
    • 웹훅(Webhook) 연결하기
    • 공동인증서 등록 Redirect 정책
    • 전자(세금)계산서 발행마감일 정책
  • 전자(세금)계산서 발행 API 연동 사례
    • 연동 사례 1: 플랫폼 고객이 전자(세금)계산서를 발행하는 경우
    • 연동 사례 2: 우리 회사의 전자(세금)계산서만 발행하는 경우
  • API 문서
    • 전자(세금)계산서 정발행
      • 전자(세금)계산서 정발행
      • 전자(세금)계산서 수정발행 - 계약의 해제
      • 전자(세금)계산서 수정발행 - 공급가액 변동
    • 전자(세금)계산서 역발행
      • 전자(세금)계산서 역발행
    • 전자(세금)계산서 조회
      • 전자(세금)계산서 국세청승인번호 조회
    • 고객
      • 고객 생성
      • 고객 공동인증서 등록 URL 조회
      • 고객 조회
  • SDK
    • SDK: Zapier
    • SDK: Make
  • 에러 코드
    • 전자(세금)계산서 발행 API
    • 전자(세금)계산서 발행 웹훅
    • 고객 생성 API
    • 공통 에러
  1. 가이드

방화벽 및 보안 프로토콜

방화벽 설정#

방화벽은 외부의 신뢰할 수 없는 네트워크가 내부 네트워크에 접근하지 못하도록 하는 보안 시스템입니다. 특정 포트나 IP에서 들어오는 요청을 필터링하거나, 사용자 인증 요청, 프록시, 주소변환기능(NAT) 등의 방법이 있습니다.

포트 번호를 허용하세요.#

1. API 요청을 위한 443 포트#

파트너 서버에서 볼타 서버에 요청을 보내려면 HTTPS로 접근할 수 있는 443 포트가 허용되어 있어야 합니다.

2. 웹훅 URL 포트#

발행 상태 변경과 같은 변경 사항을 받아볼 수 있는 웹훅 이벤트를 등록하려면 방화벽 설정에서 웹훅 URL에 지정된 포트 번호로 인바운드 트래픽(Inbound Traffic)을 허용해주세요. Inbound IP 주소 허용이 필요하신 경우 별도로 문의해주세요.

HTTP 프로토콜#

HTTPS만 사용합니다.#

볼타 API는 HTTPS로 호출해야 합니다. HTTPS는 HTTP의 보안(Secured) 버전입니다. HTTP로 주고 받는 데이터는 암호화되지 않은 평문(plaintext)이기 때문에 정보가 유출될 수 있습니다. 따라서 고객의 발행 정보와 개인 정보를 보호하는 보안을 강화한 프로토콜인 HTTPS를 사용해야 합니다.

TLS 버전 1.2 이상을 지원합니다#

TLS(전송 계층 보안)은 안전한 통신 프로토콜입니다. 볼타 API는 TLS 버전 1.2 이상만 지원합니다.
TLS 1.2 미만의 SSL/TLS 버전은 보안이 취약하여 지원하지 않습니다. 파트너 서버의 HTTP 클라이언트 환경이 TLS 1.2 이상을 지원하는지 확인해주세요.
Previous
요청·응답 본문
Next
웹훅(Webhook) 연결하기
Built with