📋 프로젝트 개요
바로빌(Barobill) API를 활용한 멀티테넌시 환경의 회계 자동화 시스템
회원사 관리
API 기반 가입 및 관리
인증서 연동
공인인증서 플러그인
전자세금계산서
발행 및 관리
금융 데이터
카드/계좌 실시간 조회
🔄 통합 워크플로우
1 회원 온보딩 프로세스
사업자 정보 입력 → RegistCorp API → 연동키 발급
플러그인 호출 → 인증서 선택 → 보안 서버 전송
등록 완료 → 상태 '활성(Active)' 변경
2 서비스 이용 프로세스
매출 데이터 → RegistTaxInvoice → 국세청 전송
카드 등록 → GetCardLog → 지출 내역 스크래핑
계좌 연결 → GetBankAccountLog → 입출금 동기화
🗂️ 메뉴 구조도
- 회계 요약
- 알림
- 전자세금계산서 발행/목록
- 카드 이용 내역
- 계좌 거래 내역
- 회사 정보 관리
- 바로빌 연동 설정
- 사용자 권한 설정
🛡️ 멀티테넌시 데이터 관리
🔒 데이터 격리
- • 모든 테이블에 TenantID 부여
- • 회원사 간 데이터 혼선 방지
- • 테넌트별 고유 연동키 동적 매핑
⚠️ 보안 및 예외 처리
- • HTTPS 통신 및 토큰 기반 보안
- • 인증서 만료/API 한도 초과 알림
- • API 요청/응답 로그 기록
🔗 바로빌 API 연동 서비스
개발자센터 바로가기 →바로빌 개발자센터는 전자세금계산서, 카드/계좌 조회, 홈택스 매입매출 연동 등 B2B API 서비스를 제공합니다. Java, Python, PHP, .NET, Node.js 등 HTTP 통신이 가능한 모든 개발언어를 지원합니다.
📄 전자세금계산서 API
발급 유형
공급자가 세금계산서 작성 후 인증서로 전자서명하여 발급하고, 공급받는자에게 이메일로 발송
공급받는자가 세금계산서 작성 후 공급자에게 발급 요청, 공급자가 확인 후 전자서명하여 발급
공급자(위탁자)를 대신하여 수탁자가 세금계산서를 작성 및 발급(전자서명)
주요 API 메소드
| 메소드명 | 기능 | 비고 |
|---|---|---|
RegistTaxInvoice |
세금계산서 임시저장 | 발급 전 데이터 저장 |
IssueTaxInvoiceEx |
세금계산서 발급 | 문자, 첨부파일 지원 |
GetTaxInvoiceNK |
세금계산서 내용 조회 | 국세청승인번호 사용 |
GetTaxInvoiceStatesIK |
세금계산서 상태 조회 | 최대 100건 |
GetTaxInvoiceSalesList |
매출 세금계산서 목록 조회 | 국세청 전송완료 건 |
GetTaxInvoicePurchaseList |
매입 세금계산서 목록 조회 | 국세청 전송완료 건 |
ProcTaxInvoice |
세금계산서 승인/거부/취소 | 역발행 처리용 |
GetTaxInvoicesPrintURL |
세금계산서 인쇄 URL | 최대 50건 |
세금계산서 객체 필드 명세
💳 카드 사용내역 조회 API
서비스 개요
개인/법인카드의 사용내역을 자동으로 수집하여 사용일시, 승인번호, 승인구분, 거래금액, 과세유형 정보를 제공합니다.
- •매일 자동 업데이트
- •기간별/카드별 조회 가능
- •가맹점 과세유형 조회 지원
- •부가세 신고 자료 활용
조회 가능 필드
주요 API 메소드
RegistCard
카드 정보 등록 (카드번호, 유효기간, 비밀번호)
GetCardLog
카드 사용내역 조회 (기간, 카드번호 지정)
GetCardList
등록된 카드 목록 조회
DeleteCard
등록된 카드 삭제
🏦 계좌 입출금내역 조회 API
서비스 개요
총 20개 뱅킹의 기업/개인 계좌 입출금내역을 수집하여 입출금일시, 입출금액, 잔액, 이체내역 등의 정보를 제공합니다.
- •은행 직접 접속 불필요
- •다수 은행 통합 조회
- •다양한 조회 주기 설정
- •자동 수집 기능
조회 가능 필드
주요 API 메소드
RegistBankAccount
계좌 정보 등록 (은행코드, 계좌번호, 비밀번호)
GetBankAccountLog
계좌 입출금내역 조회 (기간, 계좌번호 지정)
GetBankAccountList
등록된 계좌 목록 조회
GetBankAccountBalance
계좌 잔액 조회
지원 금융기관 (20개)
📊 홈택스 매입매출자료 연동 API
홈택스에 신고/수집된 세금계산서, 현금영수증, 신용카드 매입내역 등을 API로 조회하여 부가세 신고 및 결산 자료로 활용할 수 있습니다.
- • 매출/매입 세금계산서 조회
- • 국세청 전송 상태 확인
- • 수정세금계산서 이력
- • 발급/취소 내역 조회
- • 매입자료 수집
- • 공제/불공제 구분
- • 매입세액 공제 자료
- • 가맹점별 내역 조회
- • 과세유형 자동 분류
⚙️ 설정 및 연동 관리
바로빌 API 연동을 위한 회사 정보, 인증서, 사용자 권한을 관리합니다.
회사 정보 관리
사업자등록번호, 상호, 대표자, 업태/종목 등 기본 정보 관리
바로빌 연동 설정
API 연동키, 공인인증서 등록, 연동 상태 확인
사용자 권한 설정
담당자별 접근 권한, 발급 권한, 조회 범위 설정
📖 연동 가이드
바로빌 개발자센터 회원가입
dev.barobill.co.kr에서 회원가입 후 테스트 API 키를 발급받습니다.
회원사 등록 (RegistCorp)
사업자 정보를 입력하고 RegistCorp API를 호출하여 연동키를 발급받습니다.
공인인증서 등록
바로빌 전용 플러그인을 통해 세금계산서 발급용 공인인증서를 등록합니다.
테스트 및 운영 전환
테스트베드에서 API 연동을 검증한 후, 운영 환경으로 전환합니다.
🏢 바로빌 할인형 연동 서비스
할인형 연동본 서비스는 바로빌(Barobill)의 공식 API를 활용하여 할인된 계약 단가로 제공되는 회계 자동화 솔루션입니다. 정산요율은 '바로빌 100% / 파트너 0%' 방식으로, 별도의 판매 마진 없이 최저가 수준의 비용으로 서비스를 이용하실 수 있습니다.
� 요금 체계 요약
- 단가 범위7.7원 ~ 110원
- 과금 방식사용량 × 단가
- 주요 서비스세금계산서, 문자, 카카오톡
- 단가 범위3,300원 ~ 33,000원
- 과금 방식매월 고정 요금
- 주요 서비스홈택스, 계좌 스크래핑
� 1. 건당 과금 서비스
| 서비스 항목 | 건당 단가 | 비고 |
|---|---|---|
| 전자문서 발행 | ||
| 📄 세금계산서 | 110원 | 전자세금계산서 |
| � 종지세금계산서 / 대량발행 | 55원 | 거래명세서, 청구서, 견적서 등 동일 |
| 🧾 현금영수증 | 11원 | - |
| 메시징 서비스 | ||
| � 카카오 알림톡 | 7.7원 | 최저가 권장 |
| 📱 문자 (SMS) | 16.5원 | 90byte 이하 |
| 📱 문자 (LMS) | 38.5원 | 2,000byte 이하 |
| 📠 팩스 (Fax) | 55원 | - |
| 기타 조회 | ||
| 🔍 사업자등록 상태조회 | 11원 | 휴/폐업 실시간 확인 |
📅 2. 월정액 서비스
| 서비스 항목 | 월 요금 | 비고 |
|---|---|---|
| 홈택스 자동 수집 | ||
| 홈택스 매입매출조회 (세금계산서/현금영수증) | 33,000원 | 각 항목별 자동 수집 |
| 금융 스크래핑 | ||
| 카드 매출 조회 | 3,300원 | 최저가 |
| 계좌 조회 (1일 주기) | 3,300원 | 최저가 |
| 계좌 조회 (10분 주기) | 6,600원 | 실시간형 |
| 기타 월정액 | ||
| 080 수신거부 번호 | 31,900원 | 번호 유지비 포함 |
📊 월별 예상 비용 시나리오
- 세금계산서 100건
- 알림톡 500건
- 계좌조회(1일) 1회
- 세금계산서 500건
- 알림톡 2,000건
- 홈택스 조회 포함
- 세금계산서 2,000건
- 알림톡 10,000건
- 계좌/홈택스 풀세트
💡 검토 및 권장 사항
- • 알림톡 우선 활용: SMS(16.5원) 대비 알림톡(7.7원)이 약 53% 저렴하여 비용 절감에 효과적입니다.
- • 계좌 주기 최적화: 실시간 확인이 불필요한 경우 1일 주기(3,300원)를 선택하여 고정비를 낮출 수 있습니다.
- • 홈택스 연동: 매입/매출 자동 수집(33,000원)을 통해 경리 업무의 90% 이상을 자동화할 수 있습니다.
- • 사업자 상태조회: 건당 11원으로 거래처의 휴/폐업 여부를 자동으로 판별하여 리스크를 관리하세요.
📋 회원사 가입 프로세스
코드브릿지엑스 솔루션을 통해 바로빌 API 서비스를 이용하려면 아래 절차를 따르세요.
회원사 등록
사업자 정보 입력 및 이용약관 동의
연동키 발급
RegistCorp API로 회원사 고유 연동키 생성
인증서 등록
세금계산서 발급용 공인인증서 등록
포인트 충전
선불 포인트 충전 후 서비스 이용 시작
⚙️ 과금 방식 상세
💎 포인트 시스템
-
•
선불 충전: 포인트를 미리 충전한 후 서비스 이용 시 차감
-
•
자동 알림: 잔액 부족 시 이메일/SMS 알림 발송
-
•
사용 내역: 실시간 포인트 사용 내역 조회 가능
-
•
유효기간: 충전일로부터 5년간 유효
📊 정산 및 결제
-
•
결제 수단: 신용카드, 실시간 계좌이체, 가상계좌
-
•
세금계산서: 충전 금액에 대해 전자세금계산서 발급
-
•
정산 주기: 월별 사용 내역 리포트 제공
-
•
대량 할인: 월 사용량에 따른 볼륨 디스카운트
회원사 포인트 조회 API
과금 정책 문의
대량 사용, 맞춤 요금제 등 문의사항이 있으시면 연락주세요.
바로빌 API 구간별 상세 단가표
전체 구간별 할인 요율 및 계산 예시 · VAT 별도
전자세금계산서
발급 건당 과금 · 6개 구간
구간별 기본 단가
| 구간 | 발급건수 | 단가 |
|---|---|---|
| 기본 | 3,000건 이하 | 100원 |
| 1구간 | 3,001 ~ 4,000 | 90원 |
| 2구간 | 4,001 ~ 5,000 | 80원 |
| 3구간 | 5,001 ~ 8,000 | 70원 |
| 4구간 | 8,001 ~ 10,000 | 60원 |
| 5구간 | 10,000건 초과 | 50원 |
| 구간 | 수량 | 단가 | 금액 |
|---|---|---|---|
| 기본 (3,000) | 3,000 | 100원 | 300,000 |
| 1구간 (1,000) | 1,000 | 90원 | 90,000 |
| 계 | 390,000원 | ||
계좌조회 (10분주기)
등록 건당 과금 · 5개 구간
구간별 기본 단가
| 구간 | 등록수 | 단가 |
|---|---|---|
| 기본 (1~50) | 50개 | 6,000원 |
| 1구간 (51~100) | 50개 | 5,000원 |
| 2구간 (101~500) | 400개 | 4,000원 |
| 3구간 (501~1,000) | 500개 | 3,500원 |
| 4구간 (1,000 초과) | - | 3,000원 |
법인/개인카드 조회
등록 건당 과금 · 5개 구간
구간별 기본 단가
| 구간 | 등록수 | 단가 |
|---|---|---|
| 기본 (1~50) | 50개 | 3,000원 |
| 1구간 (51~100) | 50개 | 2,500원 |
| 2구간 (101~500) | 400개 | 2,300원 |
| 3구간 (501~1,000) | 500개 | 1,900원 |
| 4구간 (1,000 초과) | - | 1,700원 |
홈택스 매입/매출 조회
개사당 월정액 · 6개 구간
구간별 기본 단가
| 구간 | 개사수 | 단가 |
|---|---|---|
| 기본 (1~20) | 20개사 | 30,000원 |
| 1구간 (21~50) | 30개사 | 20,000원 |
| 2구간 (51~100) | 50개사 | 18,000원 |
| 3구간 (101~200) | 100개사 | 15,000원 |
| 4구간 (201~500) | 300개사 | 12,000원 |
| 5구간 (500 초과) | - | 10,000원 |
서비스별 할인 요율 요약
대량 사용 시 최대 할인폭 비교
위 단가표는 Code Bridge X 파트너 전용 특별 할인 단가입니다.
정확한 견적은 사용량 추이에 따라 매달 정산됩니다.