현금영수증 내역을 연도별로 보여 주는 법: APICK 조회 API 화면 설계
현금영수증 소득공제 내역 API를 활용해 조회연도, 전체 합계, 연도별 사용 내역을 일관되게 구성하는 방법입니다.
홍보용 서비스 소개 · 기능과 활용 흐름을 안내하는 글입니다.
연도별 내역은 같은 기준으로 읽혀야 합니다
사용자가 현금영수증 기록을 확인하는 화면에서는 숫자가 많다는 것보다 어느 기간의 기록인지 이해되는 것이 중요합니다. 선택한 연도와 표시되는 합계의 범위가 다르면 사용자에게 불필요한 질문이 생길 수 있습니다. 표를 만들기 전 조회 조건과 집계 범위를 한 문장으로 설명해 보세요.
에이픽의 현금영수증 소득공제 내역 API는 실제 연도로 구성된 조회연도 목록, 전체 합계, 연도별 합계와 사용 내역을 다루는 기능을 안내합니다. 이 구조를 기준으로 사용자 화면과 내부 데이터 모델을 함께 설계할 수 있습니다.
공식 사이트 실제 화면 · 캡처 2026-11-01 · 원본 페이지 확인
연도는 순서가 아니라 값으로 관리하기
첫 번째 연도, 두 번째 연도라는 위치만 믿고 화면을 연결하기보다 해당 연도 값을 기준으로 데이터를 찾는 설계를 권합니다. 자료가 추가되거나 특정 연도에 내역이 없더라도 화면이 다른 기간의 수치를 잘못 보여 주지 않도록 하기 위해서입니다. 표시 순서는 별도 규칙으로 정해 두면 됩니다.
사용자가 연도를 바꿀 때는 이전 연도의 제목과 새 연도의 숫자가 섞이지 않게 화면 상태를 관리하세요. 전체 기간 보기와 한 해 보기의 동작도 구분하는 편이 좋습니다. 기간을 바꾸는 버튼 근처에 현재 선택값을 명확하게 표시하면 모바일 화면에서도 읽기 편합니다.
공식 사이트 실제 화면 · 보관 캡처(현재 화면과 다를 수 있음) · 캡처 2026-10-28 · 원본 페이지 확인
전체 합계와 연도 합계를 다른 이름으로
전체 합계 카드와 선택 연도 합계 카드를 함께 둔다면 제목만 보아도 범위를 구분할 수 있도록 작성하세요. 두 카드가 같은 금액처럼 보이더라도 의미가 다를 수 있으므로 단순히 총액이라는 이름을 반복하지 않는 편이 좋습니다. 사용자에게 필요한 합계만 먼저 보여 주고 상세 정보를 펼치게 만들 수도 있습니다.
사용 내역 표에는 정렬 기준과 빈 값 표시 규칙을 마련하세요. 응답이 제공하는 범위를 넘어 거래 내용을 추정하거나 누락 항목을 임의로 채우지 않아야 합니다. 가공한 값을 표시한다면 원래 조회한 값과 서비스가 계산한 값을 구분해 두는 것이 이후 운영에도 도움이 됩니다.
공식 사이트 실제 화면 · 보관 캡처(현재 화면과 다를 수 있음) · 캡처 2026-10-28 · 원본 페이지 확인
빈 내역을 자연스럽게 안내하는 화면
선택한 연도에 내역이 없다면 오류 화면처럼 강한 경고를 띄우기보다 확인한 기간과 다음 행동을 안내해 보세요. 다른 연도로 이동하거나 조회 조건을 점검할 수 있는 버튼을 제공할 수 있습니다. 아직 자료를 받는 중인 상태와 확인을 마쳤지만 내용이 없는 상태는 내부적으로 구분해 관리해야 합니다.
간편인증 과정에서 사용자가 승인하지 않은 경우에도 내역 없음으로 표시하지 않도록 주의하세요. 인증을 완료하면 자료를 확인할 수 있다는 설명이 더 적절합니다. 이러한 문구는 조회 상태를 사용자 언어로 바꾸는 작업이며, 서비스에서 직접 설계하는 경험의 일부입니다.
공식 사이트 실제 화면 · 보관 캡처(현재 화면과 다를 수 있음) · 캡처 2026-10-28 · 원본 페이지 확인
조회 화면을 먼저 만들고 활용 범위 넓히기
현금영수증 자료를 연결하는 첫 단계에서는 기간 선택과 합계, 사용 내역을 정확하게 보여 주는 데 집중해 보세요. 자료만으로 공제 결과나 환급 금액을 확정하는 식의 설명은 피하고, 실제로 제공하는 조회 범위를 안내하는 것이 좋습니다. 추가 계산이 필요하면 그 기준을 별도 기능으로 검토하세요.
APICK으로 연도별 자료를 연결하고 우리 서비스에 맞는 읽기 쉬운 화면을 완성해 보세요. 정리된 기간 구조는 이용자가 과거 기록을 찾는 동선을 설계하는 데 유용합니다. 공식 응답 항목을 확인한 뒤 실제 연도 값으로 화면을 연결하는 작은 원칙부터 적용하면 좋습니다.
댓글
댓글 쓰기