글 목록

블로그
article

홈택스 API 연동 개발, 조회한 자료를 회계 프로그램에 넣으려면

홈택스에서 받은 매입·매출 자료를 원본 보관, 거래처 연결, 검토 대기, 회계 반영으로 나누는 구축 기준입니다.

이국환SION.LAB 대표예상 읽기 시간 6분

홈택스 API 연동 개발, 조회한 자료를 회계 프로그램에 넣으려면

매입 자료를 자동으로 받았는데 회계 담당자는 여전히 엑셀을 열고 있습니다. 거래처 이름을 맞추고 계정과목을 고른 뒤, 이미 입력한 거래인지 찾아야 하기 때문입니다. 조회가 끝났다는 표시만으로는 장부에 반영할 수 없습니다. 첫 구축 범위는 자료를 받는 기능과 전표를 확정하는 기능 사이의 검토 과정을 포함해야 합니다.

조회 다음은, 전표 검토 · 업무 검토 화면
조회 다음은, 전표 검토 · 업무별 검토 카드
이 글에서 설명하는 업무를 위해 제작한 화면입니다. 회사명·거래 번호·금액·상태는 설명용이며 고객의 실제 운영 자료가 아닙니다.

원본 한 건과 장부 한 건을 이어 둡니다

화면의 설명용 거래 TX-102는 공급가액 100,000원과 세액 10,000원, 합계 110,000원으로 구성했습니다. 이 값은 고객 실적이 아닙니다. 원본 식별번호, 사업자, 조회 기간을 함께 보관하고 그 거래가 연결된 회계 전표 번호를 따로 남기는 설계입니다. 같은 자료를 다시 받아도 원본을 찾을 수 있어야 합니다.

거래처명은 바뀌거나 약칭으로 들어올 수 있어 이름만으로 같은 거래를 판단하지 않습니다. 사업자 식별값과 원본 문서의 고유값을 우선 확인합니다. 연동 대상 프로그램이 제공하는 입력 방법에 따라 API 전송, 검토용 파일 내보내기, 수동 확정을 구분합니다. 프로그램에 입력 API가 있다고 가정하고 개발 범위를 확정하지 않습니다.

조회 다음은, 전표 검토 · 전체 처리 흐름
조회 다음은, 전표 검토 · 단계별 처리 흐름
입력 자료부터 결과 확인까지 담당자와 시스템이 맡을 일을 나눈 업무 흐름입니다.

자동으로 채울 항목과 사람이 정할 항목

문서에 있는 금액·일자·거래처 식별값은 정해진 규칙으로 옮길 수 있습니다. 계정과목과 부서 배부처럼 업무 해석이 필요한 항목은 추천과 확정을 나눕니다. 예시 화면에서 TX-102는 거래처 연결까지 끝났지만 계정과목 확인 때문에 전송 대기 상태입니다. 담당자가 확정하기 전에는 장부 반영 성공 건수에 포함하지 않습니다.

회계 담당자는 반복해서 같은 판단을 하는 항목부터 규칙으로 등록합니다. 단, 한 번 선택한 값을 모든 거래에 적용하지 않고 거래 유형과 적용 시작일을 함께 정합니다. 개발 담당자는 규칙을 바꾼 뒤 기존 전표까지 다시 계산되는지, 다음 입력부터 적용되는지 설명해야 합니다.

오류는 조회·변환·반영 단계별로 나눕니다

조회 실패와 거래가 없는 기간은 다릅니다. 인증 문제로 자료를 받지 못한 날은 금액 0원이 아니라 미수집으로 표시합니다. 자료를 받은 뒤 거래처 연결이 안 된 경우에는 해당 건만 검토함으로 보내고, 이미 확인된 건을 다시 조회할 필요가 없게 합니다.

전송 요청 후 응답이 끊겼다면 회계 프로그램에서 전표가 만들어졌는지 먼저 확인합니다. 결과를 모르는 상태에서 재전송하면 중복이 생길 수 있습니다. 담당자는 원본 번호와 전표 번호의 연결을 보고 재시도 여부를 결정합니다. 조회 완료와 전표 반영 완료를 따로 보여 주는 이유가 여기에 있습니다.

검수는 같은 자료를 한 번 더 넣어 봅니다

정상 거래 한 건을 넣어 보는 것으로 검수를 끝내지 않습니다. 같은 자료를 다시 넣었을 때 전표가 늘지 않는지, 거래처 미등록 건이 멈추는지, 원본과 합계가 다른 건이 자동 확정되지 않는지 확인합니다. 회계 처리는 회사의 기준에 맞춰 담당자가 결정하며 이 화면이 세무 판단을 대신하지 않습니다.

조회 다음은, 전표 검토 · 예외별 다음 행동
조회 다음은, 전표 검토 · 예외별 처리 카드
정상 처리 외에 확인·보류·재처리가 필요한 조건과 다음 행동을 정리했습니다.

회계 프로그램을 바꾸지 않고 시작할 수 있나요?

먼저 현재 프로그램에서 어떤 입력 경로를 사용할 수 있는지 확인합니다. 직접 전송이 어려우면 검토를 끝낸 자료를 정해진 파일 형식으로 내보내는 구간부터 만들 수 있습니다. 담당자가 지금 하는 확인은 유지하되, 거래처 연결과 중복 찾기를 먼저 줄이는 범위입니다. 최종 전표 입력이 수동으로 남는다면 그 경계를 견적과 완료 기준에 적어야 합니다.

우리 업무에서 먼저 확인할 항목

  • 원본 거래와 전표를 양쪽에서 찾을 수 있는가
  • 재조회로 전표가 늘어나지 않는가
  • 미수집을 0원으로 합산하지 않는가
화면의 항목과 상태를 텍스트로 확인하기
원본 번호거래처합계회계 반영
TX-101가온상사55,000원전표 연결 완료
TX-102나래유통110,000원계정과목 확인
TX-103거래처 미연결88,000원검토 대기

처음 연결할 범위와 상담

한 사업자의 매입 자료와 현재 회계 프로그램 한 곳부터 연결합니다. 상담에는 사용하는 프로그램, 자료 종류, 반복해서 확인하는 항목을 알려 주세요. 원본 증빙이나 인증 정보는 보내지 않아도 됩니다.

회계 자료의 추천·검토·확정 구성에서 관련 흐름을 볼 수 있습니다. 연결 사례는 회계 검토 구조를 참고하기 위한 자료입니다. 이 글의 화면과 수치는 새로 만든 설명용이며 실제 고객 운영 성과를 뜻하지 않습니다.

회계 자동화 구축에서 업무 연결 방향을 살펴보거나, **우리 회사 회계 업무 연결 상담**으로 현재 반복하는 일을 알려 주세요.

관련 업무의 기존 설명

참고한 기준

제공사의 홈택스 수집 요청은 자료를 받는 절차입니다. 이 글의 회계 검토·전표 반영은 별도로 제안한 업무 설계입니다. 팝빌 개발자센터 홈택스 수집 요청 · 확인일 2026-10-28.

글의 화면·처리 순서·검수 항목은 SION.LAB이 해당 업무를 설명하기 위해 구성한 설계안입니다. 실제 적용 시 사용하는 프로그램과 담당자의 기준에 맞춰 확인합니다.

#회계 자동화#업무 설계
문의하기