볼타 같은 미수금 관리 프로그램 만들기: 팝빌 API와 입금 매칭

핵심 요약

1. 증빙 발행부터 입금 확인과 재안내까지 연결하는 B2B 수금 관리 프로그램을 만듭니다. 2. 팝빌 API로 증빙 발행·수집과 계좌조회를 연결하고 SOLAPI와 Microsoft Graph API로 안내를 전달합니다. 3. 반복 청구 일정, 입금 배분, 미수 잔액 계산과 재안내 중단 조건은 자체 로직으로 구현합니다.

볼타의 수금 흐름을 제작 요구사항으로 바꾸기

볼타는 국내 세금계산서 발행과 입금 확인, 거래처별 미수금 추적을 연결하는 서비스입니다. 여러 거래처의 증빙과 통장 내역을 대조하는 경리·재무 담당자에게 필요한 흐름입니다. 별도 프로그램을 만든다면 청구별 처리 상태와 다음 안내 대상을 한곳에서 확인하도록 설계할 수 있습니다.

아래는 볼타의 공개 기능을 참고해 유사 제품을 만드는 구현 제안입니다. 외부 서비스의 기능과 데이터를 호출하는 API와 자체 개발할 업무 로직을 나누어 설명합니다.

전자세금계산서 API 연동으로 반복 청구 만들기

사용자가 거래처, 공급가액·세액, 청구일과 반복 주기를 입력합니다. 팝빌 전자세금계산서 API는 정발행·역발행·수정발행과 국세청 전송, 발행 상태 조회를 담당합니다. 정발행과 세금계산서 역발행은 서로 다른 절차로 관리합니다.

세금계산서 반복 발행에는 정해진 시각에 작업을 실행하는 자체 스케줄러를 사용합니다. 청구 건과 회차를 묶은 식별자로 중복 발행을 막고, API 응답을 저장해 발행 성공·실패 상태를 출력합니다. 현금영수증 발행·취소는 팝빌 현금영수증 API로 별도 연결합니다.

홈택스 세금계산서 수집으로 청구 원장 채우기

이미 다른 곳에서 발행한 증빙도 함께 관리하려면 사업자와 조회 기간을 입력받습니다. 팝빌 홈택스수집 API에 RequestJob으로 수집을 요청하고, GetJobState로 완료 여부를 확인한 뒤 Search로 결과를 가져옵니다. 수집은 기존 내역을 확보하는 과정이며 새 증빙을 발행하는 작업과 구분합니다.

자체 로직은 발행·수집 내역의 증빙 식별자를 비교해 중복을 제거합니다. 그 결과를 거래처, 청구 금액, 입금 기한을 관리하는 청구 원장에 연결합니다. 현금영수증 수집은 전자세금계산서 수집 범위에 포함하지 않고 별도 htcashbill 서비스를 검토합니다.

AI 입금 매칭의 데이터 수집과 판단 로직

입금 매칭 시스템 개발의 입력은 청구 증빙과 입금 일시·금액·입금자 표기입니다. 팝빌 계좌조회 API의 Search로 등록 계좌의 거래내역을 확보하고, 자체 로직이 거래처명과 적요인 거래 내용 메모를 정리해 매칭 후보를 찾습니다. 금액·날짜가 맞는지 비교하고 이름이 다른 입금이나 여러 청구를 합친 입금은 확인 대상으로 남깁니다.

Claude API는 선택적으로 연결해 후보별 근거를 설명하고 담당자의 확인을 돕도록 구성할 수 있습니다. 금융 데이터 공급은 계좌조회 API가, 입금 배분과 확정 처리는 자체 로직이 담당합니다. 출력은 청구별 매칭 후보, 연결 근거와 확인 상태이며 모호한 연결은 담당자 승인 후 원장에 반영합니다.

거래처별 미수금 관리와 ERP 연결

매칭이 확정되면 청구 금액과 배분된 입금액을 입력으로 미수 잔액을 계산합니다. 예를 들어 100만 원 청구에 40만 원이 입금되었다면 잔액은 60만 원으로 표시합니다. 한 입금의 중복 반영과 청구액을 넘는 배분은 자체 로직으로 제한합니다.

이 결과를 거래처별 미수금 관리 화면에 모아 부분 입금·완납·기한 경과 상태를 보여줍니다. 수금 관리 ERP 연동에서는 기존 전사 업무 시스템의 거래처·청구 식별자와 새 원장의 식별자를 연결합니다. 수정·취소된 증빙과 입금 배분 변경도 이력으로 남겨 잔액이 어떻게 바뀌었는지 확인하도록 설계합니다.

입금 요청 메일 자동화와 미수금 자동 재안내

청구 원장의 계좌·입금 기한·미수 잔액을 바탕으로 자체 로직이 발송 대상과 시점을 정합니다. SOLAPI는 메시지 전달에, Microsoft Graph API는 이메일 전달에 연결하는 후보입니다. 안내문에는 청구 내역과 남은 금액을 넣고, 발송 결과를 해당 청구 건에 기록합니다.

발송 직전에 최신 입금·잔액을 다시 확인해 완납 건의 미수금 자동 재안내를 중단합니다. 입금 데이터가 아직 갱신되지 않았거나 매칭 확인이 남았다면 발송을 보류하도록 설계합니다. 재시도 때 같은 안내가 중복 발송되지 않도록 발송 이력도 관리합니다.

국내 국세청·은행 연계를 전제로 이용 가능한 계좌와 조회 권한을 확인해야 합니다. 계좌조회 API의 반환 항목은 은행 정책에 따라 달라질 수 있습니다. 메시지·메일 연동에는 사용할 발신 계정과 발송 권한을 함께 확인합니다. 볼타의 화면 제공 기능과 공개 API 제공 범위도 구분해 도입 범위를 정합니다.

미수금 관리 프로그램 제작을 준비한다면 필요한 증빙, 연결 계좌와 ERP, 안내 시점을 정리해 주세요. 트램스 AI에서 업무에 맞는 구현 범위를 상담할 수 있습니다: https://trams.co.kr/ai-si/contact/#inquiry