3등 – 시그마차트 API와 AI를 활용한 기존 키오스크 접수·수납 앱 개발

1. 개발 배경

안녕하세요. OOO한의원 OOO입니다.

시그마차트로 이전하면서 기존 OO차트용 키오스크를 계속 활용하기 위해 접수·수납 앱을 직접 개발했습니다.

차트 이전을 결정한 중요한 이유 중 하나는 시그마차트 API의 활용 가능성이었습니다. 필요한 기능을 직접 연결하여 접수·수납 업무를 개선하고, 앞으로 환자 관리와 진료 지원까지 확장하고자 했습니다.

기존 장비의 프로그램을 시그마차트 측에서 수정하는 것과, 사용자가 공개 API로 별도 앱을 개발하는 것은 다르다는 안내를 받고 직접 개발할 방향을 잡았습니다.

2. 개발 도구 및 연동 구성

구분도구 및 활용 내용
AI 개발 도구OpenAI Codex
차트 연동시그마차트 공개 API
활용 장비기존 오케이차트용 키오스크, 카드 단말기, 프린터
개발 작업화면 구성, API 연동, 프로그램 수정, 오류 분석, 자동 검증, 배포 파일 정리
사용성 개선큰 글씨, 터치 버튼, 단계별 안내, 한글 터치 키보드

필요한 기능을 자연어로 설명하고, AI와 함께 구현한 뒤 실제 화면과 장비의 동작을 확인하며 수정했습니다.

3. 초진·재진 접수

개인정보 동의부터 접수 완료까지 단계별 화면을 구성하고 시그마차트 접수 API에 연결했습니다.

기능세부 내용
개인정보 동의·본인 확인접수에 필요한 확인 절차를 단계별로 진행합니다.
초진 정보 입력신규 환자가 필요한 정보를 입력합니다.
보험 유형 선택건강보험·일반 진료 등을 구분하며, 자동차보험은 데스크 안내 문구를 표시합니다.
입력 편의 기능한글 터치 키보드와 ‘글자 크게’ 기능을 제공합니다.
내원경로 연동시그마차트의 내원경로 목록을 읽고 해당 식별값으로 접수합니다.

초기에는 앱에 고정한 내원경로 이름과 실제 차트 설정이 달라 초진 접수가 거절되었습니다. 서버 로그를 분석하여 원인을 찾고, 실제 목록을 조회하는 방식으로 수정했습니다.

4. 진료비 조회 및 카드 수납

진료비 확인

기능세부 내용
당일 진료·미납액 조회시그마차트에서 오늘의 진료와 미납액을 불러옵니다.
금액 구분 표시급여·비급여 본인부담금과 결제 총액을 구분합니다.
처방 완료 확인수납 진행 전 처방 완료 여부를 확인합니다.
결제 직전 재조회진료비를 다시 조회하고 변경된 내역이 있으면 진행을 멈춥니다.

카드 결제·취소 및 차트 기록

기능세부 내용
카드 승인 연동카드 승인 후 시그마차트 수납 기록을 연결합니다.
취소·환불 대조카드 취소 시 차트 환불 기록과 대조합니다.
완료 결과 확인처리 결과가 확인된 경우에만 정상 완료로 표시합니다.
불확실한 거래 구분통신 오류 등으로 결과가 불명확하면 직원 확인 대상으로 구분합니다.
재결제 방지승인 여부가 불확실한 거래는 자동으로 재결제하지 않도록 구성했습니다.

5. 출력 및 다음 환자 이용 준비

기능세부 내용
수납·취소 출력처리 내용을 출력합니다.
출력물 구성본인부담금 구분, 총액 강조, 카드번호 마스킹을 적용했습니다.
이용 종료 처리개인정보와 화면 상태를 정리한 뒤 처음 화면으로 돌아갑니다.

6. 직원 관리 및 오류 대응

직원 인증 후 접수·수납·환불 기록과 미완료 거래를 확인할 수 있는 관리 화면을 마련했습니다.

점검 항목대응 및 검증 내용
중복 클릭반복 입력 상황을 모의 시험으로 점검했습니다.
카드 입력 시간 초과미결제 안내 후 처음 화면으로 돌아가도록 보완했습니다.
승인 결과 불확실자동 재결제 대신 직원 확인 대상으로 처리합니다.
차트 응답 유실응답을 받지 못한 상황을 모의 시험으로 점검했습니다.
출력 실패출력 실패 상황을 모의 시험으로 점검했습니다.

7. 검증 결과 및 현재 진행 단계

구분확인한 내용
실제 접수 시험테스트 환자로 재진 접수와 차트 반영을 확인했습니다.
실제 결제·취소 시험5,100원 카드 승인 → 차트 수납 → 카드 취소 → 차트 환불 결과를 확인했습니다.
후속 기능 검증모의 데이터와 자동 시험으로 개선 기능을 검증했습니다.
배포 준비버전별 배포 묶음으로 정리했습니다.
남은 단계최신 보완 기능의 현장 설치와 최종 검증이 필요합니다.

현장에서 확인한 기능과 이후 모의 시험으로 검증한 기능을 구분하여 관리하고 있습니다.

8. 활용 효과 및 향후 계획

업무 영역마련한 개선 기반
장비 활용기존 키오스크를 시그마차트와 연결하여 활용
환자 이용큰 글씨와 단계별 안내로 접수·수납 진행
직원 업무반복 입력과 거래 확인 부담을 줄일 수 있는 구조 마련
거래 관리결제·취소 결과와 차트 기록을 대조하여 확인
운영 개선실제 사용 결과를 바탕으로 기능을 수정·확장

앞으로 실제 운영에서 업무 시간, 대기시간, 환자 반응을 확인하며 개선할 계획입니다. 장기적으로는 시그마차트 API와 AI를 환자 관리와 진료 지원에도 연결하여 운영과 환자 만족도 향상에 활용하고자 합니다.

9. 개발 지원에 대한 감사

이운희 원장님께서 공개 API를 이용한 직접 개발 가능성과 API 가이드 확인 방법을 안내해 주셨습니다.

수납 기록 연동 기능의 개발·배포 안내, API 적용 버전의 우선 업데이트 제안, 카드 결제 기록용 코드 확인, 자동차보험 신규 접수 관련 API 확장 논의도 개발을 이어가는 데 도움이 되었습니다.

현장의 질문을 구체적인 설명과 개선 논의로 이어주신 점에 감사드립니다.

10. 첨부 이미지 안내

번호파일명주요 내용
①01_대화_API직접개발_안내.png공개 API를 이용한 직접 개발 가능 여부 안내
②02_대화_기존키오스크_활용방향.png기존 장비 수정과 별도 앱 개발의 차이 및 개발 방향 확인
③03_대화_수납연동_배포안내.png수납 기록 연동 기능의 개발·배포 안내와 개발 진척 공유
④04_앱_키오스크_메인화면.png초진·재진·수납 버튼과 글자 확대 기능을 적용한 개발 화면
⑤05_앱_보험유형_선택화면.png건강보험·일반 진료 선택 및 자동차보험 데스크 안내 모의 화면
⑥06_앱_진료비_수납화면.png급여·비급여 본인부담금과 총액을 표시한 모의 화면. 7,100원은 검증용 금액입니다.
⑦07_수납출력물_개인정보가림.png가상 데이터 기반 출력 미리보기. 개인정보·거래 식별정보를 가렸으며, 실제 영수증이나 거래 증빙은 아닙니다.

제출원문

안녕하세요. OOO한의원에서 기존 OO차트용 키오스크를 시그마차트에서도 활용하기 위해, AI와 함께 접수·수납 앱을 개발한 경험을 소개합니다.

  1. 시그마차트로 이전한 이유는 API의 가능성이었습니다

OO차트에서 시그마차트로 이전하기로 마음먹은 중요한 이유는 시그마차트 API의 높은 활용도였습니다. API를 잘 이용하면 한의원에 필요한 기능을 직접 연결하고, 환자 관리와 진료 과정을 더 세밀하게 다듬을 수 있겠다고 생각했습니다.

궁극적으로는 시그마차트 API를 기반으로 AI 기능을 활용해 한의원의 매출과 환자 만족도를 함께 높이고 싶었습니다. 이번 키오스크 앱 개발은 그 방향으로 나아가는 구체적인 작업이었습니다. 접수·수납을 차트와 연결하는 기반을 만들고, 앞으로 환자 관리와 진료 지원으로 API·AI 활용을 넓혀 가고자 했습니다.

  1. 기존 키오스크를 계속 써야 해서 직접 개발을 시작했습니다

이미 OO차트용 키오스크를 보유하고 있었습니다. 시그마차트로 이전하면서 시그마차트 키오스크를 새로 구매하고 싶었지만, 기존에 보유한 장비를 계속 사용해야 하는 사정 때문에 신규 구매를 할 수 없었습니다.

결국 기존 키오스크에서 사용할 시그마차트용 앱을 직접 개발해야 했습니다. 처음부터 개발 자체가 목적이었던 것은 아니고, 말 그대로 ‘울며 겨자 먹기’로 시작한 일이었습니다. 기존 장비를 활용하면서 시그마차트와 접수·수납을 연결해야 한다는 현실적인 필요가 출발점이었습니다.

단톡방에서 처음 문의했을 때는 ‘기존 기기와 연동할 수 없다’는 설명과 ‘API로 직접 개발할 수 있다’는 설명을 어떻게 이해해야 할지 혼란스러웠습니다. 이운희 원장님께서는 기존 장비의 프로그램을 시그마차트 측에서 직접 수정하는 것과, 제가 공개 API를 이용해 별도의 앱을 개발하는 것은 다른 문제라는 점을 설명해 주셨습니다. 그 대화를 통해 직접 개발해 볼 방향을 잡을 수 있었습니다. 관련 대화는 첨부 사진 1~2에 담았습니다.

  1. 사용한 AI 개발 도구와 자동화 기능

AI 개발 도구로 OpenAI Codex를 활용했습니다. 필요한 기능과 현장의 문제를 자연어로 설명하고, AI와 함께 화면 구성, 시그마차트 API 연동, 프로그램 수정, 오류 분석, 자동 검증, 배포 파일 정리를 진행했습니다.

특히 시그마차트 API 명세와 실제 응답을 대조하고, 카드 단말기와 프린터처럼 동작 방식이 다른 장비를 하나의 흐름으로 묶는 데 활용했습니다. 화면을 만든 뒤에는 큰 글씨와 터치 버튼, 안내 문구, 입력 순서 등을 반복해서 다듬었습니다.

구현한 주요 기능은 다음과 같습니다.

① 초진·재진 접수
개인정보 동의와 본인 확인, 초진 정보 입력, 보험 선택 등을 단계별 화면으로 구성하고 시그마차트 접수 API에 연결했습니다. 한글 터치 키보드와 ‘글자 크게’ 기능도 구현했습니다.

② 진료비 조회와 카드 수납
시그마차트에서 오늘의 진료와 미납액을 조회하고, 급여·비급여 본인부담금과 결제할 금액을 구분해 보여주도록 했습니다. 처방 완료 여부를 확인하고, 결제 직전에 진료비를 다시 조회해 변경된 내역이 있으면 진행을 멈추도록 했습니다.

③ 카드 결제·취소와 차트 기록 연동
카드 승인 후 시그마차트 수납 기록을 연결하고, 취소 시 차트 환불 기록과 대조하는 흐름을 구현했습니다. 결과가 확인된 경우에만 정상 완료로 처리하며, 통신 오류로 결과가 불확실한 거래는 직원이 확인할 수 있도록 구분했습니다.

④ 출력과 다음 환자 안내
수납·취소 내용을 출력하는 기능과 함께 본인부담금 구분, 총액 강조, 카드번호 마스킹 등 출력 내용을 다듬었습니다. 처리가 끝나면 개인정보와 화면 상태를 정리하고 처음 화면으로 돌아가는 흐름을 연결했습니다.

⑤ 직원 관리와 오류 대응
직원 인증 후 접수·수납·환불 기록과 미완료 거래를 확인하는 화면을 마련했습니다. 중복 클릭, 카드 입력 대기 시간 초과, 차트 응답 유실, 출력 실패 등도 모의 시험으로 점검했습니다.

  1. 현장의 문제를 AI와 함께 해결한 경험

가장 인상적이었던 것은 실제 오류를 개발 개선으로 연결한 경험입니다. 초진 접수가 거절됐을 때 AI와 서버 로그를 분석해, 앱에 고정해 둔 내원경로 이름이 실제 시그마차트 설정과 다르다는 원인을 찾았습니다. 이후 시그마차트에서 내원경로 목록을 읽고 해당 식별값으로 접수하도록 수정했습니다.

카드를 넣지 않아 입력 대기 시간이 끝난 경우에도 단순히 ‘결제 오류’로 처리하지 않고, 단말기 응답을 구분해 미결제 안내 후 처음 화면으로 돌아가도록 보완했습니다. 반대로 승인 여부가 불확실한 경우에는 자동으로 재결제하지 않도록 했습니다.

개발 과정에서는 테스트 환자로 실제 재진 접수와 차트 반영을 확인했고, 5,100원 카드 승인부터 차트 수납, 카드 취소, 차트 환불까지 현장 시험 결과를 확인했습니다. 이후 개선한 기능들은 모의 데이터와 자동 시험으로 검증하고 버전별 배포 묶음으로 정리했습니다. 최신 보완 기능의 현장 설치와 최종 검증은 별도로 진행할 단계입니다.

이번 작업을 통해 기존에 보유한 장비를 시그마차트와 연결해 활용할 수 있는 앱을 개발하고, 접수·진료비 확인·수납을 하나의 화면 흐름으로 묶을 수 있었습니다. 환자에게는 큰 글씨와 단계별 안내를 제공하고, 직원에게는 반복 입력과 거래 확인 부담을 줄일 수 있는 구조를 마련했습니다. 앞으로 실제 운영에서 업무 시간과 대기시간, 환자 반응을 확인하며 개선해 나가고자 합니다.

  1. 개발을 이어갈 수 있도록 도와주신 이운희 원장님께 감사드립니다

기존 OO차트용 키오스크를 시그마차트에서도 활용할 수 있도록 앱을 개발하는 과정에서, 이운희 원장님의 열린 태도와 구체적인 안내가 큰 힘이 되었습니다. 처음 문의했을 때 공개 API를 이용한 직접 개발이 가능하다고 설명해 주셨고, 체험판에서 API 가이드를 확인하는 방법도 알려주셨습니다. 수납 기록 연동이 막혔을 때는 검토를 이어가신 뒤 개발되어 배포 대기 중이라고 안내해 주셨으며, 개발 진척을 축하하면서 API 적용 버전의 우선 업데이트 설정도 제안해 주셨습니다. 카드 결제 기록에 사용할 코드까지 확인해 주시고, 자보 신규 접수의 제약에는 API 확장 의사를 밝혀주신 점도 감사했습니다. 현장의 질문을 구체적인 설명과 개선 논의로 이어주신 덕분에 개발을 계속해 나갈 용기를 얻었습니다.

첨부 사진 3에는 수납 기록 연동 기능이 개발되어 배포 대기 중이라는 안내와, 제가 기존 키오스크용 프로그램의 개발 진척을 전한 대화를 담았습니다.

  1. 활용 소감과 앞으로의 계획

처음에는 기존 키오스크를 계속 써야 해서 어쩔 수 없이 시작했지만, 개발을 진행하면서 시그마차트 API와 AI를 이용해 우리 한의원의 업무를 직접 개선할 수 있다는 가능성을 확인했습니다.

차트 이전을 결정하게 한 API의 활용도가 실제 개발로 이어졌고, 화면 디자인부터 차트 연동, 결제 예외 처리, 출력까지 필요한 기능을 구체적으로 만들고 검증할 수 있었습니다. 이운희 원장님의 안내와 도움도 그 과정을 이어가는 데 큰 힘이 됐습니다.

앞으로는 키오스크를 현장 피드백에 맞춰 다듬는 한편, 시그마차트 API와 AI를 환자 관리와 진료 지원에도 연결해 나가고 싶습니다. 그렇게 한의원 운영과 매출에 도움이 되고, 환자분들도 더 만족할 수 있는 진료 환경을 만드는 것이 목표입니다.

첨부 이미지 설명 — 총 7장

사진 1. 공개 API를 이용한 직접 개발 가능 여부 안내
기존 장비와의 연동에 관해 질문하고, 공개 API로 직접 개발할 수 있다는 설명을 받은 대화입니다. 화면에는 오전 11:56부터 오후 12:03까지의 대화가 보입니다.
파일: 01_대화_API직접개발_안내.png

사진 2. 기존 키오스크 활용과 직접 개발 방향 확인
시그마차트 측이 기존 기기를 직접 수정하는 것과 사용자가 API로 앱을 개발하는 것의 차이를 확인하고, 직접 개발 가능성에 대해 대화한 내용입니다. 사진 1의 마지막 대화와 일부 겹치며 오후 12:05~12:19의 흐름으로 이어집니다.
파일: 02_대화_기존키오스크_활용방향.png

사진 3. 수납 기록 연동 개발·배포 안내와 개발 진척 공유
수납 기록 연동에 대한 문의에 개발되어 배포 대기 중이라는 답변을 받고, 기존 키오스크용 프로그램의 개발 진척을 전한 대화입니다. 관련 대화는 오후 1:19~1:26에 표시되어 있습니다.
파일: 03_대화_수납연동_배포안내.png

사진 4. 직접 개발한 키오스크 메인 화면
초진·재진·진료비 수납을 구분하고, 큰 터치 버튼과 글자 확대 기능을 적용한 개발 화면입니다.
파일: 04_앱_키오스크_메인화면.png

사진 5. 보험 유형 선택 화면
건강보험과 일반 진료를 구분해 선택하도록 구성한 모의 시험 화면입니다. 자동차보험은 데스크 안내 문구를 함께 표시했습니다.
파일: 05_앱_보험유형_선택화면.png

사진 6. 진료비 수납 화면
급여·비급여 본인부담금과 결제 총액을 구분해 표시한 모의 시험 화면입니다. 표시된 7,100원은 화면 검증용 금액이며 실제 거래 증빙이 아닙니다.
파일: 06_앱_진료비_수납화면.png

사진 7. 수납 출력물 미리보기 — 개인정보 가림 처리
급여·비급여 본인부담금과 총액을 표시한 가상 데이터 기반 출력 미리보기입니다. 대표자명·사업자번호·연락처·주소·수납자명과 거래 식별정보는 가림 처리했습니다. 실제 종이 영수증의 촬영 사진이나 실제 거래 증빙은 아닙니다. 사진 6과는 별도의 샘플입니다.
파일: 07_수납출력물_개인정보가림.png

감사합니다.
OOO한의원
성명: OOO