세무·회계 사무소의 계좌 거래내역 조회 API 도입 순서

NEW

세무·회계 사무소가 고객사 한 곳으로 시작해 일괄 조회로 넓히는 도입 순서와 점검 항목을 정리했습니다.

도입 전에 사무소가 정리해 둘 것은 무엇인가요?

기장과 결산을 맡은 사무소는 고객사 통장 내역을 받는 일이 반복됩니다. 계좌 거래내역 조회 API를 붙이기 전에 아래 세 가지를 먼저 정해 두면 도입이 수월합니다.

  • 위임 절차: 뱅크레일은 B2B 전용이며, 회원사인 사무소가 고객사의 위임을 받아야 조회할 수 있습니다. 위임을 받는 양식과 보관 방법을 먼저 정하세요.

  • 고객 구분: 개인 고객과 법인 고객을 user_type(personal, business)으로 나눠 등록합니다. 사무소의 고객 코드는 external_ref에 넣어 두면 조회 결과와 연결하기 쉽습니다.

  • 담당자와 알림: 인증서 오류나 조회 실패가 났을 때 누가 고객에게 연락할지 정해 둡니다.

어떤 순서로 도입하나요?

  1. 고객사 한 곳으로 시작합니다. 최종 사용자(고객사)를 등록하고, 해당 고객사의 공동인증서를 등록합니다. 인증서는 최종 사용자당 1개이며 콘솔에서의 등록과 교체는 PC에서만 가능합니다.

  2. 단건 조회로 결과를 확인합니다. 은행 코드와 사용자를 지정해 요청하고, 작업 상태가 success가 되면 계좌와 거래내역이 사무소 시스템의 항목과 맞는지 봅니다.

  3. 상태별 처리 규칙을 정합니다. failed는 사유를 기록해 재요청을 판단하고, blocked와 cert_not_registered는 고객사에 인증서 확인을 안내합니다.

  4. 고객사를 늘립니다. 일괄 조회 요청으로 한 번에 최대 500건까지 보내고, 건마다 ref를 붙여 결과를 연결합니다.

  5. 정기 수집 일정을 정합니다. 결산 전에 몰리지 않도록 조회 시점을 나누고, 저장된 결과는 정해진 기간만 보관되므로 필요한 내역은 사무소 시스템에도 반영해 둡니다.

기장 업무에서는 조회 결과를 어디에 쓰나요?

업무쓰는 데이터점검할 점
거래내역 대조거래일시, 금액, 거래처, 적요증빙과 맞지 않는 건을 따로 표시합니다
잔액 확인계좌 잔액조회 시점과 기준일이 다를 수 있으므로 시각을 함께 기록합니다
누락 점검기간별 거래 목록조회 기간을 넉넉히 잡고 누락 구간이 없는지 봅니다

이런 점은 알고 있어야 합니다

  • 조회 전용입니다. 입금과 이체를 실행하는 기능은 없고 카드 사용내역 조회도 없습니다.

  • 은행 시스템 변경 등으로 조회가 일시 중단될 수 있으므로, 결산 일정에는 여유를 두세요.

  • 지원 은행은 신한, KB국민, 우리, 하나, IBK기업, NH농협 6곳입니다. 카카오뱅크와 토스뱅크는 지원하지 않습니다.

무료 조회는 이벤트로 제공되며 사전 안내 없이 종료될 수 있고, 종료 후에는 요금이 바뀔 수 있습니다. 요금은 메인 페이지의 요금 안내를 확인하세요.

자주 묻는 질문

고객사가 위임을 거두면 어떻게 하나요?

사무소는 고객사가 위임을 거두면 해당 조회를 멈추는 절차를 미리 정해 두세요. 최종 사용자 정보를 삭제하면 인증서는 즉시 파기됩니다. 열람·정정·삭제·처리 정지 요청은 개인정보처리방침의 접수 방법(이메일)을 따릅니다.

고객사 인증서를 다시 등록하면 어떻게 되나요?

최종 사용자당 1개만 등록되므로 다시 등록하면 기존 인증서가 교체됩니다.

목록으로