@extends('layouts.app') @section('title', '바로빌 연동 가이드') @push('styles') @endpush @section('content')
{{-- ===== 히어로 ===== --}}
🔗

SAM 도움말

바로빌 연동 가이드

SAM과 바로빌(Barobill) 플랫폼의 연동을 위한 필수 설정 가이드. 카드 등록, 공인인증서 등록, 계정 연결부터 세금계산서, 홈택스 연동까지 한 번에 정리합니다.

{{-- ===== 탭 0: 전체 구조 ===== --}}

SAM ↔ 바로빌 연동 구조

바로빌은 세금계산서, 계좌, 카드, 홈택스 데이터를 SAM에 자동 연동하는 핵심 플랫폼입니다.

{{-- 연동 흐름도 --}}

데이터 연동 흐름

🏢
바로빌
플랫폼 (barobill.co.kr)
←→
🔑
SOAP API
인증키 기반 통신
←→
SAM 서버
API + MNG
📊
자동 반영
전표/장부/대시보드
핵심 원리: 바로빌은 은행/카드사/국세청과 직접 통신하여 데이터를 수집하고, SAM은 바로빌 API를 통해 이 데이터를 가져옵니다. 따라서 바로빌에 카드/계좌/공인인증서를 먼저 등록해야 SAM에서 데이터를 조회할 수 있습니다.
{{-- 바로빌 5대 서비스 --}}

바로빌 연동 5대 서비스

📄 전자세금계산서 (eTax)

세금계산서 발행/수취/국세청 전송을 자동화합니다.

세금계산서 발행 (매출)
세금계산서 수취 (매입)
국세청(NTS) 자동 전송
발행 상태 추적
필수 공인인증서 등록
🏦 계좌 입출금 (eAccount)

법인 통장 입출금 내역을 자동 수집합니다.

계좌 입출금내역 조회
거래 분할 (split) 처리
분개(전표) 자동 생성
수동 거래 입력
필수 계좌 등록 + 공인인증서
💳 카드사용내역 (eCard)

법인카드 사용내역을 자동 수집합니다.

카드 거래내역 조회
거래 분할 (split) 처리
분개(전표) 자동 생성
숨김/복원 처리
필수 카드 등록
🏛 홈택스 연동 (HomeTax)

국세청 홈택스의 매출/매입 데이터를 자동 동기화합니다.

홈택스 매출 조회 (스크래핑)
홈택스 매입 조회 (스크래핑)
분개(전표) 자동 생성
수동 매입 등록
필수 홈택스 공인인증서
💬 카카오톡/SMS

알림톡, 친구톡, SMS 발송 기능입니다.

알림톡 발송 (템플릿 기반)
전자계약 서명 요청 알림
SMS 문자 발송
발송 이력 관리
선택 카카오 채널 개설
{{-- 바로빌이란? --}}

바로빌이란?

바로빌(Barobill)은 전자세금계산서, 계좌/카드 조회, 홈택스 연동, 카카오톡/SMS 발송 등 기업 회계에 필요한 외부 데이터 연동 플랫폼입니다.

SAM은 바로빌의 SOAP API를 통해 데이터를 주고받으며, 이를 통해 수작업 없이 세금계산서 발행, 카드/계좌 거래 조회, 홈택스 데이터 동기화가 가능합니다.

바로빌 공식 사이트: www.barobill.co.kr

구분바로빌 역할SAM 역할
세금계산서발행/전송 처리요청/조회/관리
계좌은행 데이터 수집조회/분개 처리
카드카드사 데이터 수집조회/분개 처리
홈택스국세청 스크래핑동기화/분개 처리
카카오톡메시지 발송 대행발송 요청/이력
{{-- ===== 탭 1: 초기 설정 ===== --}}

바로빌 초기 설정 (필수)

SAM에서 바로빌 기능을 사용하려면 아래 순서대로 설정을 완료해야 합니다.

{{-- 설정 체크리스트 --}}

필수 테넌트 초기 설정 체크리스트

SAM을 사용하는 각 테넌트(고객사)는 아래 항목을 모두 완료해야 바로빌 연동이 정상 동작합니다.

  • 1
    바로빌 회원 가입
    www.barobill.co.kr에서 사업자 회원으로 가입합니다. 사업자번호 기반으로 회원 등록됩니다.
  • 2
    바로빌 ID/PW를 SAM에 등록
    SAM 관리자가 바로빌 설정 메뉴에서 바로빌 계정 ID와 비밀번호를 입력합니다. 이 정보가 있어야 SAM이 바로빌 API를 호출할 수 있습니다.
    SAM > 바로빌 > 바로빌 설정
  • 3
    사업자번호 및 인증키 등록
    바로빌에서 발급받은 인증키(cert_key)를 SAM에 등록합니다. 인증키는 SAM 서버에서 암호화하여 저장됩니다.
    SAM > 바로빌 > 바로빌 설정
  • 4
    공인인증서 등록 (바로빌 사이트)
    바로빌 사이트에 로그인 → 인증서 관리에서 법인 공인인증서를 등록합니다. 세금계산서 발행 및 홈택스 스크래핑에 필수입니다.
  • 5
    법인카드 등록 (바로빌 사이트)
    바로빌 사이트 → 카드관리에서 법인카드를 등록합니다. 카드사별로 등록 방법이 다르며, 일부 카드사는 카드사 홈페이지에서 바로빌 연동을 별도로 신청해야 합니다.
  • 6
    계좌 등록 (바로빌 사이트)
    바로빌 사이트 → 계좌관리에서 법인 계좌를 등록합니다. 은행별 공인인증서 또는 OTP 인증이 필요할 수 있습니다.
  • 7
    연동 테스트
    SAM의 바로빌 설정에서 연동 테스트 버튼을 클릭하여 정상 연결을 확인합니다.
    SAM > 바로빌 > 바로빌 설정 > 연동 테스트
{{-- 상세 설정 카드 --}}
SAM에서 설정하는 항목
1
바로빌 ID / 비밀번호
바로빌 로그인 계정. SAM이 API 호출 시 이 계정으로 인증합니다. 비밀번호는 암호화 저장됩니다.
2
사업자번호
하이픈 포함 형식 (예: 123-45-67890). 세금계산서 발행/수취의 기준이 됩니다.
3
인증키 (cert_key)
바로빌에서 발급한 API 인증키. Laravel Crypt로 암호화하여 DB에 저장됩니다.
4
테스트/운영 모드 설정
테스트 모드에서는 바로빌 테스트 서버(testws.baroservice.com)를 사용합니다.
바로빌 사이트에서 설정하는 항목
1
공인인증서 등록
법인 공인인증서 파일(.pfx/.p12)을 바로빌에 업로드합니다. 세금계산서와 홈택스 연동에 필수.
2
법인카드 등록
카드번호, 카드사 선택, 카드 별칭 입력. 일부 카드사는 카드사 홈페이지에서 '바로빌' 서비스 연동을 신청해야 합니다.
3
계좌 등록
은행 선택, 계좌번호 입력. 은행별로 인터넷뱅킹 인증서 또는 OTP 인증이 필요합니다.
4
서비스 신청
사용할 서비스(세금계산서/계좌조회/카드조회/홈택스)를 개별적으로 신청합니다.
{{-- 보안 주의사항 --}}
보안 주의사항:
  • 바로빌 비밀번호는 SAM 서버에서 암호화(Crypt)하여 저장됩니다. 평문으로 노출되지 않습니다.
  • 인증키(cert_key)도 동일하게 암호화 저장됩니다.
  • 바로빌 계정 비밀번호를 변경한 경우, SAM의 바로빌 설정에서도 반드시 업데이트해야 합니다.
  • 공인인증서 갱신 시 바로빌 사이트에서 새 인증서를 재등록해야 합니다.
{{-- 테넌트별 독립 관리 --}}
멀티테넌트 구조: SAM은 테넌트(고객사)별로 바로빌 설정이 완전히 분리되어 있습니다. 각 테넌트는 자체 바로빌 계정, 사업자번호, 인증키를 독립적으로 관리합니다. 테넌트 A의 바로빌 설정은 테넌트 B에 영향을 주지 않습니다.
{{-- ===== 탭 2: 세금계산서 ===== --}}

전자세금계산서 (eTax)

바로빌을 통한 전자세금계산서 발행, 수취, 국세청 전송 프로세스를 설명합니다.

{{-- 발행 흐름 --}}

세금계산서 발행 프로세스

📝
계산서 작성
SAM에서 입력
🔐
전자서명
공인인증서 서명
📤
바로빌 전송
API 호출
🏛
국세청 전송
NTS 자동 신고
발행 완료
상태 확인
{{-- 발행/수취 --}}
매출 세금계산서 (발행)
1
거래처(공급받는자) 선택
SAM에 등록된 거래처를 검색하여 선택합니다. 사업자번호, 상호, 대표자 등이 자동 입력됩니다.
2
품목/금액 입력
품목명, 수량, 단가, 공급가액, 세액을 입력합니다. 세액은 공급가액의 10%로 자동 계산됩니다.
3
발행 및 국세청 전송
발행 버튼 클릭 시 바로빌 API를 통해 전자서명 → 국세청 전송이 자동 처리됩니다.
SAM > 바로빌 > 전자세금계산서
매입 세금계산서 (수취)
1
수신함 확인
거래처가 발행한 세금계산서가 바로빌을 통해 자동으로 수신됩니다.
2
내용 확인 및 승인
수취한 세금계산서의 금액, 품목 등을 확인하고 승인 처리합니다.
3
매입 장부 반영
승인된 매입 세금계산서는 홈택스 매입 데이터와 함께 부가세 신고 자료가 됩니다.
{{-- 사전 조건 --}}
세금계산서 발행 전 필수 조건:
  • 바로빌 사이트에 공인인증서가 등록되어 있어야 합니다 (전자서명용).
  • SAM에 바로빌 ID/PW와 인증키가 등록되어 있어야 합니다.
  • 발행할 때 사용할 이메일 주소가 바로빌 설정에 등록되어 있어야 합니다.
  • 사업자번호 휴폐업 조회를 통해 거래처의 사업 상태를 미리 확인하세요.
{{-- ===== 탭 3: 계좌/카드 ===== --}}

계좌 입출금 / 카드사용내역

바로빌을 통해 자동 수집되는 계좌 입출금 내역과 카드 거래 내역의 관리 방법을 설명합니다.

{{-- 계좌 --}}

계좌 계좌 입출금 내역 조회

1
바로빌에 계좌 등록
바로빌 사이트 → 계좌관리 → 은행 선택 → 계좌번호 입력 → 인증서로 인증. 등록 후 바로빌이 자동으로 입출금 데이터를 수집합니다.
2
SAM에서 조회
계좌입출금내역 메뉴에서 기간/계좌를 선택하면 바로빌에서 수집된 데이터가 표시됩니다.
SAM > 바로빌 > 계좌입출금내역
3
분개(전표) 처리
입출금 내역을 선택하여 분개(일반전표)를 자동 생성할 수 있습니다. 계정과목을 지정하면 장부에 바로 반영됩니다.
거래 분할(Split): 하나의 입출금 건에 여러 계정과목이 포함된 경우 (예: 급여 이체 + 보험료), 거래를 분할하여 각각 다른 계정으로 분개할 수 있습니다.
수동 거래 입력: 바로빌에서 자동 수집되지 않는 현금 거래 등은 수동으로 입력할 수 있습니다. 수동 입력도 분개 처리가 가능합니다.
{{-- 카드 --}}

카드 카드사용내역 조회

1
바로빌에 카드 등록
바로빌 사이트 → 카드관리 → 카드사 선택 → 카드번호 입력. 일부 카드사는 카드사 홈페이지에서 별도로 '바로빌 연동 신청'이 필요합니다.
2
SAM에서 조회
카드사용내역 메뉴에서 기간/카드를 선택하면 카드 거래 내역이 표시됩니다.
SAM > 바로빌 > 카드사용내역
3
분개(전표) 처리
카드 거래 내역을 선택하여 분개를 생성합니다. 매입세액공제 여부도 함께 처리할 수 있습니다.
카드 거래 숨김/복원: 개인적 사용 등 회계 처리가 불필요한 건은 '숨김' 처리하여 목록에서 제외할 수 있습니다. 숨긴 건은 언제든 복원 가능합니다.
카드사별 등록 주의:
  • 삼성/현대/KB 등: 바로빌에서 직접 등록 가능
  • 롯데/하나 등: 카드사 홈페이지에서 '바로빌' 연동을 별도로 신청 후 바로빌에서 등록
  • 등록 후 데이터 수집까지 1~2영업일 소요될 수 있습니다.
{{-- 계좌 vs 카드 비교 --}}

계좌 vs 카드 기능 비교

기능 계좌 입출금 카드사용내역
바로빌 등록 필요필수 (계좌+인증서)필수 (카드번호)
데이터 수집 주기실시간 ~ 1일1~2일 (카드사 정산 후)
거래 분할 (Split)지원지원
분개 자동 생성지원지원
수동 입력지원지원
숨김/복원미지원지원
매입세액공제해당 없음지원
금액 재정의지원 (override)미지원
{{-- ===== 탭 4: 홈택스 연동 ===== --}}

홈택스 매출/매입 연동

국세청 홈택스 데이터를 바로빌을 통해 SAM에 자동 동기화하는 방법을 설명합니다.

{{-- 홈택스 연동 구조 --}}

홈택스 연동 구조

🏛
국세청 홈택스
매출/매입 원본
🔄
바로빌 스크래핑
공인인증서 기반
📊
SAM 동기화
API 호출
📒
분개 처리
전표 자동 생성
스크래핑이란? 바로빌이 등록된 공인인증서를 사용하여 홈택스에 자동 로그인 → 매출/매입 데이터를 수집하는 과정입니다. 사용자가 직접 홈택스에 접속할 필요 없이, SAM에서 버튼 하나로 최신 데이터를 가져올 수 있습니다.
{{-- 매출/매입 --}}
홈택스 매출 조회
1
스크래핑 실행
홈택스매출 메뉴에서 기간을 선택하고 '스크래핑' 버튼을 클릭합니다. 바로빌이 홈택스에서 매출 데이터를 수집합니다.
SAM > 바로빌 > 홈택스 매출
2
데이터 확인
수집된 매출 데이터(거래처, 공급가액, 세액 등)를 확인합니다.
3
분개 처리
매출 데이터를 선택하여 매출 전표를 자동 생성합니다.
홈택스 매입 조회
1
스크래핑 실행
홈택스매입 메뉴에서 기간을 선택하고 '스크래핑' 버튼을 클릭합니다.
SAM > 바로빌 > 홈택스 매입
2
수동 매입 등록
홈택스에 반영되지 않은 매입 건(현금 거래 등)은 수동으로 등록할 수 있습니다.
3
분개 처리 + 부가세 반영
매입 전표 생성 시 매입세액공제 여부를 설정합니다. 부가세 신고 자료에 자동 반영됩니다.
{{-- 홈택스 주의사항 --}}
홈택스 스크래핑 전 필수 조건:
  • 바로빌 사이트에 홈택스용 공인인증서가 등록되어 있어야 합니다.
  • 홈택스 공인인증서는 세금계산서용 인증서와 동일한 인증서를 사용하는 경우가 많습니다.
  • 스크래핑은 수 초 ~ 수십 초가 소요될 수 있습니다 (데이터 양에 따라).
  • 홈택스 시스템 점검 시간(주로 새벽)에는 스크래핑이 실패할 수 있습니다.
부가세 신고와의 연계: 홈택스 매출/매입 데이터는 SAM의 부가세관리 메뉴와 연동됩니다. 매출세액(홈택스 매출) - 매입세액(홈택스 매입 + 카드 매입세액공제) = 납부세액으로 자동 계산됩니다.
{{-- ===== 탭 5: 카카오톡/SMS ===== --}}

카카오톡 알림톡 / SMS

바로빌을 통한 카카오톡 알림톡, 친구톡, SMS 발송 기능을 설명합니다.

{{-- 알림톡 vs 친구톡 --}}

알림톡 vs 친구톡 비교

구분 알림톡 친구톡 SMS
용도 정보성 메시지 (주문확인, 서명요청) 광고성 메시지 (프로모션) 범용 문자 메시지
수신 대상 모든 카카오톡 사용자 채널 친구만 모든 휴대폰
템플릿 필수 (카카오 사전 검수) 불필요 (자유 형식) 불필요
비용 건당 약 8~9원 건당 약 15~20원 건당 약 20~30원
이미지 불가 가능 불가 (MMS는 가능)
대체발송 SMS로 자동 전환 가능 SMS로 자동 전환 가능 -
{{-- 카카오톡 설정 --}}

설정 카카오톡 발송을 위한 사전 준비

1
카카오톡 채널 개설
카카오비즈니스(business.kakao.com)에서 법인 명의로 채널을 개설합니다. 법인 명의 휴대폰이 필요합니다.
2
바로빌 카카오톡 서비스 신청
바로빌 관리자 페이지에서 카카오톡 서비스를 활성화합니다.
3
채널 연동 (바로빌 ↔ 카카오)
바로빌 관리 URL에서 카카오 채널과 바로빌 계정을 연동합니다.
4
알림톡 템플릿 등록/검수
발송할 메시지의 템플릿을 등록하고 카카오의 검수를 받습니다. 검수 소요: 1~3영업일.
현재 SAM에 등록된 템플릿:
  • 전자계약_서명요청 — 전자계약 서명 요청 알림
  • 전자계약_리마인드 — 미서명 계약 리마인드

추가 템플릿이 필요하면 바로빌 관리 페이지에서 등록 후 카카오 검수를 받아야 합니다.

SMS 발송: SMS는 별도의 카카오 채널 없이 바로빌 계정만으로 사용 가능합니다. 다만, 발신번호 등록이 필요합니다 (통신사 인증).
{{-- 발송 흐름 --}}

알림톡 발송 흐름 (전자계약 예시)

📝
전자계약 생성
SAM E-Sign
💬
알림톡 발송
바로빌 API 호출
📱
카카오톡 수신
서명 요청 메시지
서명 완료
링크 클릭 → 서명
2단계 검증 필수: 바로빌이 SendKey를 반환해도 실제 카카오톡 전달이 실패할 수 있습니다. SAM은 3초 후 전달 결과를 자동 확인하며, 실패 시 이메일로 대체 발송합니다.
{{-- ===== 탭 6: 메뉴 맵 ===== --}}

SAM 바로빌 메뉴 맵

SAM에서 바로빌 관련 기능이 위치한 메뉴 구조를 보여줍니다.

{{-- FAQ --}}

자주 묻는 질문 (FAQ)

"카드 내역이 안 보여요"
1. 바로빌 사이트에서 카드 등록 확인
2. 카드사 홈페이지에서 바로빌 연동 신청 여부 확인
3. 등록 후 1~2영업일 대기
4. SAM 바로빌 설정에서 연동 테스트 실행
"세금계산서 발행이 안 돼요"
1. 바로빌에 공인인증서 등록 확인
2. 인증서 유효기간 만료 여부 확인
3. SAM에 바로빌 ID/PW/인증키 등록 확인
4. 거래처 사업자번호 정확성 확인
"바로빌 비밀번호를 변경했어요"
바로빌 사이트에서 비밀번호를 변경하면
반드시 SAM에서도 업데이트해야 합니다.
SAM > 바로빌 > 바로빌 설정 > 비밀번호 수정
미변경 시 모든 API 호출이 실패합니다.
"홈택스 스크래핑이 실패해요"
1. 바로빌에 홈택스용 공인인증서 등록 확인
2. 인증서 유효기간 확인
3. 홈택스 시스템 점검 시간 아닌지 확인
4. 조회 기간이 너무 길면 타임아웃 가능 → 분할 조회
"알림톡이 발송 안 돼요"
1. 카카오톡 채널 개설 및 바로빌 연동 확인
2. 발송 메시지가 등록된 템플릿과 정확히 일치하는지 확인
3. 버튼 URL이 등록된 URL과 1글자도 다르면 실패
4. SMS 대체발송 시 발신번호 등록 필요
"인증서가 만료되었어요"
공인인증서는 보통 1년 주기로 갱신해야 합니다.
갱신 후 바로빌 사이트에서 새 인증서를 재등록하세요.
미갱신 시 세금계산서 발행, 홈택스 스크래핑이 모두 중단됩니다.
{{-- max-width wrapper --}}
{{-- brb-body --}} @endsection @push('scripts') @endpush