📋 프로젝트 개요
바로빌(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 연동을 검증한 후, 운영 환경으로 전환합니다.
🏢 코드브릿지엑스 파트너 서비스
수익형 파트너코드브릿지엑스는 바로빌 공식 수익형 파트너로서, 멀티테넌시 환경에서 회원사에게 전자세금계산서, 카드/계좌 조회 등 회계 자동화 서비스를 재판매합니다.
🔗 파트너 연동 구조
수익형 파트너 구조
- •코드브릿지엑스는 바로빌과 계약한 파트너 단가로 서비스를 이용합니다.
- •회원사에게는 파트너 단가에 판매 마진을 더한 금액으로 서비스를 제공합니다.
- •회원사는 코드브릿지엑스의 솔루션을 통해 바로빌 API 서비스를 이용합니다.
💰 서비스별 이용 요금
선불 포인트 차감 방식으로, 서비스 이용 시 건당 단가가 차감됩니다.
| 서비스 | 기본 단가 | 회원사 단가 | 비고 |
|---|---|---|---|
| 전자문서 서비스 | |||
|
📄
전자세금계산서 발급
|
100원 | 80원 | 국세청 전송 포함 |
|
📄
전자계산서 발급 (면세)
|
100원 | 80원 | 면세 사업자용 |
|
🧾
현금영수증 발급
|
0원 | 무료 | 발급 건수 무제한 |
| 금융 데이터 수집 | |||
|
💳
카드 사용내역 조회
|
500원 | 400원 | 카드당 월 1회 수집 |
|
🏦
계좌 입출금내역 조회
|
500원 | 400원 | 계좌당 월 1회 수집 |
| 홈택스 연동 | |||
|
📊
홈택스 매입매출 조회
|
300원 | 250원 | 건당 과금 |
|
🔍
사업자 휴폐업 조회
|
0원 | 무료 | 조회 건수 무제한 |
💡 요금 안내
- • 위 요금은 코드브릿지엑스 회원사 기준 단가입니다.
- • 대량 사용 시 볼륨 디스카운트가 적용될 수 있습니다.
- • 최소 충전 금액: 10,000원 / 결제 수단: 카드, 계좌이체, 가상계좌
📋 회원사 가입 프로세스
코드브릿지엑스 솔루션을 통해 바로빌 API 서비스를 이용하려면 아래 절차를 따르세요.
회원사 등록
사업자 정보 입력 및 이용약관 동의
연동키 발급
RegistCorp API로 회원사 고유 연동키 생성
인증서 등록
세금계산서 발급용 공인인증서 등록
포인트 충전
선불 포인트 충전 후 서비스 이용 시작
⚙️ 과금 방식 상세
💎 포인트 시스템
-
•
선불 충전: 포인트를 미리 충전한 후 서비스 이용 시 차감
-
•
자동 알림: 잔액 부족 시 이메일/SMS 알림 발송
-
•
사용 내역: 실시간 포인트 사용 내역 조회 가능
-
•
유효기간: 충전일로부터 5년간 유효
📊 정산 및 결제
-
•
결제 수단: 신용카드, 실시간 계좌이체, 가상계좌
-
•
세금계산서: 충전 금액에 대해 전자세금계산서 발급
-
•
정산 주기: 월별 사용 내역 리포트 제공
-
•
대량 할인: 월 사용량에 따른 볼륨 디스카운트
회원사 포인트 조회 API
과금 정책 문의
대량 사용, 맞춤 요금제 등 문의사항이 있으시면 연락주세요.