택스봇은 스크래핑 API로 세무 업무를 어떻게 자동화하는가
들어가며
세무사무소 업무에서 많은 시간을 차지하는 일은 판단보다 수집과 전달입니다. 신고가 끝나면 직원들은 수임처마다 홈택스·위택스에서 납부서를 내려받아 카카오톡이나 이메일로 안내 자료를 보냅니다.
택스봇은 세무사무소의 단순하지만 중요한 반복 업무를 자동화해 업무 시간을 줄이고 누락 가능성을 낮추도록 돕는 서비스입니다. 그 중심에는 세무 데이터를 자동으로 모아 오는 스크래핑이 있습니다.
이 글에서는 택스봇이 인포텍 스크래핑 API로 세무 업무를 어떻게 자동화했는지, 그리고 이를 안정적으로 운영하기 위해 어떤 구조로 설계했는지를 이야기해 보려 합니다.
왜 스크래핑 API인가
세무 데이터 수집에는 홈택스, 위택스, 4대보험 포털처럼 기관별로 운영되는 사이트와 인증 절차를 다뤄야 하는 경우가 많습니다.
직접 수집 로직을 구현하면 기관별 인증 방식과 화면 구조를 계속 관리해야 합니다. 사이트 변경이나 업무 흐름 차이까지 고려하면 유지보수 부담도 커집니다.
택스봇은 수집 로직을 직접 구현하는 대신 인포텍 스크래핑 API를 사용합니다. 택스봇은 API를 호출해 구조화된 결과를 받고, 이를 업무 화면과 발송 흐름에 연결합니다. 이 방식의 이점은 세 가지입니다.
사이트 변경 대응 부담을 줄인다: 기관 사이트 변화에 대한 대응은 API 제공 범위에서 관리되므로, 택스봇은 업무 흐름 개선에 집중할 수 있습니다.
여러 기관을 같은 흐름으로 다룬다: 홈택스, 위택스, 4대보험 관련 업무를 공통된 요청과 응답 흐름으로 처리해 성공·실패 판단 기준을 일관되게 운영할 수 있습니다.
업무 흐름 개발에 집중할 수 있다: 수집과 결과 구조화는 API를 사용하고, 택스봇은 세무사무소가 실제로 쓰는 화면과 발송 흐름을 설계합니다.
대표 업무 사례: 납부서 발송
택스봇의 기능은 대부분 '수임처 데이터를 가져와 정리하고 고객에게 전달한다'는 같은 뼈대 위에 있습니다. 그중 효과가 가장 직접적으로 체감되는 것이 납부서발송입니다.
수집된 신고 내역과 서류를 납부서 발송 화면 한 곳에서 확인하고, 그 화면에서 바로 고객에게 보냅니다.
단계
|
수작업
|
택스봇 (납부서 발송 화면)
|
신고 내역 확인
|
수임처마다 홈택스에 들어가 조회
|
수집된 신고 내역이 한 목록에 모임
|
서류 준비
|
납부서·접수증·신고서를 한 건씩 다운로드
|
필요한 서류만 골라 수집 요청
|
지방세
|
위택스에서 따로 내려받아 함께 정리
|
지방소득세 납부서를 같은 건에 첨부
|
발송
|
카카오톡·메일로 하나씩 발송
|
같은 화면에서 선택해 발송, 서류가 없으면 그 자리에서 수집 후 발송
|
결과 확인
|
고객별로 따로 확인
|
발송 상태·일시와 열람 여부가 목록에 기록
|
가장 큰 차이는 발송 단계에서 드러납니다.
직원이 보낼 건을 골라 [발송하기]를 누르면, 아직 서류가 없는 건은 그 자리에서 API로 수집을 요청하고 수집이 끝나면 바로 발송으로 이어집니다.
서류를 미리 모아 둘 필요 없이 버튼 하나에 수집과 발송이 함께 묶여 있는 셈입니다.
발송이 끝나면 발송 상태와 일시, 고객의 열람 여부가 같은 목록에 남습니다. 직원은 열람하지 않은 수임처를 우선 확인해 필요한 안내를 이어갈 수 있습니다.
아키텍처
택스봇의 역할 분담은 단순합니다. 수집은 인포텍 스크래핑 API가, 적재와 가공은 택스봇이 맡습니다.

역할 분담 · 수집은 인포텍 API, 적재와 가공은 택스봇
기관 사이트와 직접 통신하는 부분은 인포텍 스크래핑 API가 맡고, 택스봇은 요청부터 화면·발송까지를 맡습니다.
인포텍 스크래핑 API: 기관 사이트 조회, 문서 다운로드, 결과 구조화를 맡습니다. 택스봇은 HTML을 직접 파싱하지 않고 구조화된 결과만 받습니다
택스봇: 무엇을 언제 수집할지 정해 API에 요청하고, 받은 결과를 적재한 뒤 직원이 바로 쓸 수 있는 형태로 가공합니다. 수집 요청은 DB에 등록되고, 스케줄러가 순서와 양을 조절하며 API를 호출합니다.
안정적인 자동화를 위한 요청 제어
인포텍 스크래핑 API를 사용하더라도 요청을 보내는 일만으로 운영이 끝나지는 않습니다. API 호출은 기관 사이트 조회로 이어지기 때문에, 택스봇은 요청 시점과 처리량, 우선순위를 조절합니다.
신고 시즌에는 여러 사무소의 요청이 같은 시기에 몰릴 수 있습니다. 요청을 한꺼번에 처리하면 기관 사이트와 사용자 계정에 부담이 집중될 수 있으므로, API 요청의 양과 순서를 조절하는 것이 중요합니다.
스케줄러로 요청 처리하기
사용자가 수집을 요청하거나 예약 수집 시각이 되면 수집 건이 요청 목록에 등록됩니다. 스케줄러는 우선순위와 처리 가능량을 고려해 요청을 순차적으로 처리합니다.
주기와 동시 처리 한도로 처리량 조절하기
스케줄러는 일정 주기로 요청을 처리합니다. 업무별 동시 처리 한도를 두고, 처리 가능량에 맞춰 다음 요청을 가져오는 방식으로 요청량을 제어합니다.
이를 통해 요청이 한꺼번에 몰릴 때도 안정적인 처리를 돕습니다.
처리 자원은 업무 특성에 맞춰 분리합니다. 한 업무의 요청이 늘어나도 다른 업무에 미치는 영향을 줄이고, 동시 처리가 제한적인 업무는 더 보수적으로 처리량을 조절합니다.
같은 계정의 요청을 겹치지 않게 처리하기
동일한 사용자 계정에 대한 중복 요청을 막는 것도 중요합니다. 택스봇은 계정별 처리 상태를 관리해 진행 중인 요청이 있을 때는 다음 요청을 순서대로 처리합니다.
결과적으로 계정 사이에서는 병렬, 계정 안에서는 순차로 처리됩니다.
마치며
인포텍 스크래핑 API를 사용하면 홈택스·위택스·4대보험 관련 수집 업무를 공통된 흐름으로 연결할 수 있습니다.
택스봇은 이 결과를 세무사무소가 바로 활용할 수 있는 기능으로 제공합니다. 납부서 발송에서는 신고 내역 확인부터 고객 발송과 열람 확인까지 한 화면에서 처리할 수 있습니다.
수집은 API를 사용하고 업무 흐름과 운영은 택스봇이 맡아, 세무사무소가 자료 수집 시간을 줄이고 수임처 관리와 상담에 더 집중할 수 있도록 돕습니다.