diff --git a/barobill/index.php b/barobill/index.php new file mode 100644 index 0000000..2e189f4 --- /dev/null +++ b/barobill/index.php @@ -0,0 +1,1496 @@ + + + + + + 바로빌 API 회계 솔루션 + + + + + + +
+
+
+
+ + 🏠 + +

바로빌 API 회계 솔루션

+
+ +
+
+
+ + + + +
+ + + +
+ +
+

+ 📋 프로젝트 개요 +

+

바로빌(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건
+
+
+ + +
+

세금계산서 객체 필드 명세

+
+ +
+
기본 정보
+
+
writeDate[필수] 작성일자 (yyyyMMdd)
+
issueType[필수] 발행형태
+
purposeType[필수] 영수/청구 구분
+
taxType[필수] 과세형태
+
chargeDirection[필수] 과금방향
+
+
+ +
+
공급자 정보
+
+
invoicerCorpNum[필수] 사업자번호 (10자리)
+
invoicerCorpName[필수] 상호
+
invoicerMgtKey[필수] 문서번호 (1~24자리)
+
invoicerCEOName[필수] 대표자 성명
+
invoicerEmail[선택] 담당자 이메일
+
+
+ +
+
공급받는자 정보
+
+
invoiceeCorpNum[필수] 사업자번호
+
invoiceeCorpName[필수] 상호
+
invoiceeType[필수] 구분 (사업자/개인/외국인)
+
invoiceeCEOName[필수] 대표자 성명
+
invoiceeEmail1[선택] 담당자 이메일
+
+
+ +
+
금액 정보
+
+
supplyCostTotal[필수] 공급가액 합계
+
taxTotal[필수] 세액 합계
+
totalAmount[필수] 합계금액
+
remark1~3[선택] 비고
+
+
+
+
+
+ + +
+

+ 💳 카드 사용내역 조회 API +

+ +
+ +
+

서비스 개요

+
+

+ 개인/법인카드의 사용내역을 자동으로 수집하여 사용일시, 승인번호, 승인구분, 거래금액, 과세유형 정보를 제공합니다. +

+
    +
  • •매일 자동 업데이트
    • +
  • •기간별/카드별 조회 가능
    • +
  • •가맹점 과세유형 조회 지원
    • +
  • •부가세 신고 자료 활용
    • +
+
+ +

조회 가능 필드

+
+
+
사용일시
+
승인번호
+
카드번호
+
거래금액
+
가맹점명
+
가맹점 사업자번호
+
승인구분
+
과세유형
+
+
+
+ + +
+

주요 API 메소드

+
+
+ RegistCard +

카드 정보 등록 (카드번호, 유효기간, 비밀번호)

+
+
+ GetCardLog +

카드 사용내역 조회 (기간, 카드번호 지정)

+
+
+ GetCardList +

등록된 카드 목록 조회

+
+
+ DeleteCard +

등록된 카드 삭제

+
+
+
+
+
+ + +
+

+ 🏦 계좌 입출금내역 조회 API +

+ +
+ +
+

서비스 개요

+
+

+ 총 20개 뱅킹의 기업/개인 계좌 입출금내역을 수집하여 입출금일시, 입출금액, 잔액, 이체내역 등의 정보를 제공합니다. +

+
    +
  • •은행 직접 접속 불필요
    • +
  • •다수 은행 통합 조회
    • +
  • •다양한 조회 주기 설정
    • +
  • •자동 수집 기능
    • +
+
+ +

조회 가능 필드

+
+
+
거래일시
+
입금액
+
출금액
+
잔액
+
거래점
+
적요
+
거래구분
+
메모
+
+
+
+ + +
+

주요 API 메소드

+
+
+ RegistBankAccount +

계좌 정보 등록 (은행코드, 계좌번호, 비밀번호)

+
+
+ GetBankAccountLog +

계좌 입출금내역 조회 (기간, 계좌번호 지정)

+
+
+ GetBankAccountList +

등록된 계좌 목록 조회

+
+
+ GetBankAccountBalance +

계좌 잔액 조회

+
+
+
+
+ + +
+

지원 금융기관 (20개)

+
+ '.$bank.''; + } + ?> +
+
+
+ + +
+

+ 📊 홈택스 매입매출자료 연동 API +

+ +
+

+ 홈택스에 신고/수집된 세금계산서, 현금영수증, 신용카드 매입내역 등을 API로 조회하여 부가세 신고 및 결산 자료로 활용할 수 있습니다. +

+
+ +
+
+
+ 📄 + 세금계산서 +
+
    +
  • • 매출/매입 세금계산서 조회
    • +
  • • 국세청 전송 상태 확인
    • +
  • • 수정세금계산서 이력
    • +
+
+
+
+ 🧾 + 현금영수증 +
+
    +
  • • 발급/취소 내역 조회
    • +
  • • 매입자료 수집
    • +
  • • 공제/불공제 구분
    • +
+
+
+
+ 💳 + 신용카드 매입 +
+
    +
  • • 매입세액 공제 자료
    • +
  • • 가맹점별 내역 조회
    • +
  • • 과세유형 자동 분류
    • +
+
+
+
+
+ + + + +
+
+

+ ⚙️ 설정 및 연동 관리 +

+

바로빌 API 연동을 위한 회사 정보, 인증서, 사용자 권한을 관리합니다.

+ +
+
+
+ 🏢 +
+

회사 정보 관리

+

사업자등록번호, 상호, 대표자, 업태/종목 등 기본 정보 관리

+ +
+
+
+ 🔐 +
+

바로빌 연동 설정

+

API 연동키, 공인인증서 등록, 연동 상태 확인

+ +
+
+
+ 👥 +
+

사용자 권한 설정

+

담당자별 접근 권한, 발급 권한, 조회 범위 설정

+ +
+
+
+ + +
+

+ 📖 연동 가이드 +

+ +
+
+ 1 +
+

바로빌 개발자센터 회원가입

+

dev.barobill.co.kr에서 회원가입 후 테스트 API 키를 발급받습니다.

+
+
+
+ 2 +
+

회원사 등록 (RegistCorp)

+

사업자 정보를 입력하고 RegistCorp API를 호출하여 연동키를 발급받습니다.

+
+
+
+ 3 +
+

공인인증서 등록

+

바로빌 전용 플러그인을 통해 세금계산서 발급용 공인인증서를 등록합니다.

+
+
+
+ 4 +
+

테스트 및 운영 전환

+

테스트베드에서 API 연동을 검증한 후, 운영 환경으로 전환합니다.

+
+
+
+
+
+ + + + +
+ +
+
+

+ 🏢 코드브릿지엑스 파트너 서비스 +

+ 수익형 파트너 +
+
+

+ 코드브릿지엑스는 바로빌 공식 수익형 파트너로서, 멀티테넌시 환경에서 회원사에게 전자세금계산서, 카드/계좌 조회 등 + 회계 자동화 서비스를 재판매합니다. +

+
+ 바로빌 공식 파트너 + 멀티테넌시 지원 + 종량제 과금 + 기술지원 포함 +
+
+
+
+
0원
+
초기 도입비
+
+
+
0원
+
월 유지비
+
+
+
종량제
+
사용한 만큼만
+
+
+
+ + +
+

+ 🔗 파트너 연동 구조 +

+
+
+
🏛️
+
바로빌
+
API 제공사
+
+
→
+
+
💼
+
코드브릿지엑스
+
수익형 파트너
+
+
→
+
+
🏢
+
회원사
+
서비스 이용 기업
+
+
+
+

수익형 파트너 구조

+
    +
  • •코드브릿지엑스는 바로빌과 계약한 파트너 단가로 서비스를 이용합니다.
    • +
  • •회원사에게는 파트너 단가에 판매 마진을 더한 금액으로 서비스를 제공합니다.
    • +
  • •회원사는 코드브릿지엑스의 솔루션을 통해 바로빌 API 서비스를 이용합니다.
    • +
+
+
+ + +
+

+ 💰 서비스별 이용 요금 +

+

선불 포인트 차감 방식으로, 서비스 이용 시 건당 단가가 차감됩니다.

+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
서비스기본 단가회원사 단가비고
전자문서 서비스
+
+ 📄 + 전자세금계산서 발급 +
+ 		100원80원국세청 전송 포함
+
+ 📄 + 전자계산서 발급 (면세) +
+ 		100원80원면세 사업자용
+
+ 🧾 + 현금영수증 발급 +
+ 		0원무료발급 건수 무제한
금융 데이터 수집
+
+ 💳 + 카드 사용내역 조회 +
+ 		500원400원카드당 월 1회 수집
+
+ 🏦 + 계좌 입출금내역 조회 +
+ 		500원400원계좌당 월 1회 수집
홈택스 연동
+
+ 📊 + 홈택스 매입매출 조회 +
+ 		300원250원건당 과금
+
+ 🔍 + 사업자 휴폐업 조회 +
+ 		0원무료조회 건수 무제한
+
+ +
+

+ 💡 요금 안내 +

+
    +
  • • 위 요금은 코드브릿지엑스 회원사 기준 단가입니다.
    • +
  • • 대량 사용 시 볼륨 디스카운트가 적용될 수 있습니다.
    • +
  • • 최소 충전 금액: 10,000원 / 결제 수단: 카드, 계좌이체, 가상계좌
    • +
+
+
+ + +
+

+ 📋 회원사 가입 프로세스 +

+

코드브릿지엑스 솔루션을 통해 바로빌 API 서비스를 이용하려면 아래 절차를 따르세요.

+ +
+
+
+
1
+
📝
+

회원사 등록

+

사업자 정보 입력 및 이용약관 동의

+
+
+
+
+
2
+
🔑
+

연동키 발급

+

RegistCorp API로 회원사 고유 연동키 생성

+
+
+
+
+
3
+
🔐
+

인증서 등록

+

세금계산서 발급용 공인인증서 등록

+
+
+
+
+
4
+
💳
+

포인트 충전

+

선불 포인트 충전 후 서비스 이용 시작

+
+
+
+
+ + +
+

+ ⚙️ 과금 방식 상세 +

+ +
+ +
+

+ 💎 + 포인트 시스템 +

+
    +
  • + • +
    선불 충전: 포인트를 미리 충전한 후 서비스 이용 시 차감
    +
    • +
  • + • +
    자동 알림: 잔액 부족 시 이메일/SMS 알림 발송
    +
    • +
  • + • +
    사용 내역: 실시간 포인트 사용 내역 조회 가능
    +
    • +
  • + • +
    유효기간: 충전일로부터 5년간 유효
    +
    • +
+
+ + +
+

+ 📊 + 정산 및 결제 +

+
    +
  • + • +
    결제 수단: 신용카드, 실시간 계좌이체, 가상계좌
    +
    • +
  • + • +
    세금계산서: 충전 금액에 대해 전자세금계산서 발급
    +
    • +
  • + • +
    정산 주기: 월별 사용 내역 리포트 제공
    +
    • +
  • + • +
    대량 할인: 월 사용량에 따른 볼륨 디스카운트
    +
    • +
+
+
+ + +
+

회원사 포인트 조회 API

+
+
// 회원사 포인트 잔액 조회
+
$balance = $barobill->GetBalance(
+
"CERT_KEY", // 파트너 인증키
+
"1234567890" // 회원사 사업자번호
+
);
+
// 반환값: 현재 잔액 (원)
+
+
+ + +
+
+
+

과금 정책 문의

+

대량 사용, 맞춤 요금제 등 문의사항이 있으시면 연락주세요.

+
+
+ + 📞 070-4040-5617 + + + 🌐 개발자센터 + +
+
+
+
+
+
+ + + + + + + + + + + + + + diff --git a/barobill/planning.md b/barobill/planning.md new file mode 100644 index 0000000..23e3758 --- /dev/null +++ b/barobill/planning.md @@ -0,0 +1,64 @@ +# [기획서] 바로빌 API 기반 멀티테넌시 회계 지원 솔루션 + +## 1. 프로젝트 개요 + +- **목적**: 바로빌(Barobill) API를 활용한 멀티테넌시 환경의 회계 자동화 시스템 구축 +- **주요 기능**: + - API 기반 회원사 가입 및 관리 + - 공인인증서 플러그인 연동 + - 전자세금계산서 발행 및 관리 + - 카드 내역 및 계좌 거래 내역 실시간 조회 + +--- + +## 2. 통합 워크플로우 (Workflow) + +### 2.1 회원 온보딩 프로세스 + +1. **회원 가입**: 솔루션 내에서 사업자 정보 입력 -> 바로빌 `RegistCorp` API 호출 -> 연동키 발급 및 DB 저장. +2. **인증서 등록**: 바로빌 전용 플러그인 호출 -> 사용자 인증서 선택 및 서명 -> 바로빌 보안 서버로 인증서 전송. +3. **연동 확인**: 등록 완료 후 솔루션 내에서 연동 상태 '활성(Active)'으로 변경. + +### 2.2 서비스 이용 프로세스 + +- **전자세금계산서**: 매출 데이터 생성 -> `RegistTaxInvoice` 호출 -> 국세청 전송 및 상태 모니터링. +- **금융 데이터 수집**: + - **카드**: 카드 정보 등록 -> `GetCardLog` 호출 -> 지출 내역 스크래핑 및 장부 기록. + - **계좌**: 계좌 연결 -> `GetBankAccountLog` 호출 -> 입출금 내역 동기화 및 미수금 대조. + +--- + +## 3. 메뉴 구조도 (Information Architecture) + +- **대메뉴 1: 대시보드** (회계 요약, 알림) +- **대메뉴 2: 매출/매입 관리** + - 전자세금계산서 발행/목록 + - 카드 이용 내역 + - 계좌 거래 내역 +- **대메뉴 3: 설정 및 연동** + - 회사 정보 관리 + - 바로빌 연동 설정 (인증서 관리) + - 사용자 권한 설정 + +--- + +## 4. 멀티테넌시 데이터 관리 전략 + +### 4.1 데이터 격리 (Data Isolation) + +- 모든 테이블에 `TenantID` 또는 `PartnerBarobillID`를 부여하여 회원사 간 데이터 혼선 방지. +- API 호출 시 해당 테넌트의 고유 연동키를 동적으로 매핑. + +### 4.2 보안 및 예외 처리 + +- **인증 보안**: HTTPS 통신 및 바로빌 인증 토큰 기반 보안 강화. +- **오류 대응**: 인증서 만료, API 호출 한도 초과 등에 대한 사용자 알림 로직 구현. +- **로그 관리**: API 요청 및 응답 전문을 로그로 기록하여 이슈 발생 시 추적 가능하도록 설계. + +--- + +## 5. 향후 상세 설계 항목 (Next Steps) + +1. **화면 설계서(Wireframe)**: 각 단계별 UI 레이아웃 확정. +2. **API 매핑 상세**: 솔루션 필드와 바로빌 파라미터 1:1 매칭 테이블 작성. +3. **DB 스키마 설계**: 테넌트 및 금융 데이터 저장을 위한 ERD 작성. diff --git a/index.php b/index.php index 849bd11..a7ee0ed 100644 --- a/index.php +++ b/index.php @@ -201,6 +201,9 @@ 경정청구 소개 + + 바로빌 API 통합기획서 + 기업분석 한국평가데이터 (kodata)