diff --git a/app/Http/Controllers/Help/BarobillGuideController.php b/app/Http/Controllers/Help/BarobillGuideController.php new file mode 100644 index 00000000..226e49f5 --- /dev/null +++ b/app/Http/Controllers/Help/BarobillGuideController.php @@ -0,0 +1,23 @@ + 바로빌 연동 가이드 컨트롤러 + */ +class BarobillGuideController extends Controller +{ + public function index(Request $request): View|Response + { + if ($request->header('HX-Request')) { + return response('', 200)->header('HX-Redirect', route('help.barobill.index')); + } + + return view('help.barobill.index'); + } +} diff --git a/resources/views/help/barobill/index.blade.php b/resources/views/help/barobill/index.blade.php new file mode 100644 index 00000000..fcdf350f --- /dev/null +++ b/resources/views/help/barobill/index.blade.php @@ -0,0 +1,1061 @@ +@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에서 바로빌 관련 기능이 위치한 메뉴 구조를 보여줍니다.

+ +
+ {{-- 바로빌 --}} +
+
+ + 바로빌 (직접 메뉴) +
+
+
1 전자세금계산서
+
2 계좌입출금내역
+
3 카드사용내역
+
4 홈택스 매출
+
5 홈택스 매입
+
6 카카오톡
+
7 SMS
+
+
+ + {{-- 바로빌 관리 --}} +
+
+ + 바로빌 관리/설정 +
+
+
1 바로빌 설정
+
2 회원사관리
+
3 사용량조회
+
4 과금관리
+
5 계좌조회
+
6 개발문서
+
+
+ + {{-- 연동 메뉴 --}} +
+
+ + 바로빌 데이터를 사용하는 메뉴 +
+
+
1 일반전표입력 (분개)
+
2 부가세관리
+
3 법인카드관리
+
4 재무 대시보드
+
5 전자계약 (E-Sign)
+
+
+
+ + {{-- 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 diff --git a/routes/web.php b/routes/web.php index 4c8d9da8..5f36763c 100644 --- a/routes/web.php +++ b/routes/web.php @@ -18,6 +18,7 @@ use App\Http\Controllers\ChinaTech\ChinaAiController; use App\Http\Controllers\Help\AccountingGuideController; use App\Http\Controllers\Help\AttendanceGuideController; +use App\Http\Controllers\Help\BarobillGuideController; use App\Http\Controllers\ClaudeCode\CoworkController as ClaudeCodeCoworkController; use App\Http\Controllers\ClaudeCode\NewsController as ClaudeCodeNewsController; use App\Http\Controllers\ClaudeCode\PricingController as ClaudeCodePricingController; @@ -862,6 +863,7 @@ Route::prefix('help')->name('help.')->group(function () { Route::get('/accounting', [AccountingGuideController::class, 'index'])->name('accounting.index'); Route::get('/attendance', [AttendanceGuideController::class, 'index'])->name('attendance.index'); + Route::get('/barobill', [BarobillGuideController::class, 'index'])->name('barobill.index'); }); /*