> Agent-readable docs index: /llms.txt. Fetch only the needed Markdown pages first; use /docs.zip only for broad search after checking /docs-manifest.json or /docs.zip.sha256.

# 내원객

내원객 관련 API입니다.

내원객 조회, 중복 내원객 조회, 내원객 검색, 초진지 조회와 제출 기능을 제공합니다.

<details>
<summary>주요 개념</summary>
<dl>
<dt>내원객</dt>
<dd><strong>정의:</strong> 병원에 방문하거나 예약을 진행하는 사람의 고객 정보입니다.<br /><strong>설명:</strong> 이름, 전화번호, 차트 번호, 생년월일, 성별, 국적 같은 정보를 기준으로 조회하거나 검색합니다.</dd>
<dt>내원객 ID</dt>
<dd><strong>정의:</strong> 내원객을 식별하는 고유 ID입니다.<br /><strong>설명:</strong> 예약, 수납, 시술권, 선불카드처럼 다른 도메인의 데이터를 특정 내원객과 연결할 때 사용합니다.</dd>
<dt>중복 내원객</dt>
<dd><strong>정의:</strong> 같은 사람일 가능성이 있는 기존 내원객 후보입니다.<br /><strong>설명:</strong> 이름, 전화번호, 여권 정보, 생년월일, SNS 정보 등을 기준으로 이미 등록된 내원객이 있는지 확인할 때 사용합니다.</dd>
<dt>초진 문진표</dt>
<dd><strong>정의:</strong> 내원객이 첫 방문 전에 작성하는 문진 정보입니다.<br /><strong>설명:</strong> 문진표 조회 API로 작성 항목을 확인하고, 제출 API로 내원객의 응답을 전달합니다.</dd>
<dt>연동 정보</dt>
<dd><strong>정의:</strong> 외부 채널에서 내원객을 식별하기 위한 연결 정보입니다.<br /><strong>설명:</strong> LINE, 강남언니 같은 채널의 사용자 정보를 내원객과 연결해 중복 확인이나 예약 생성에 활용할 수 있습니다.</dd>
<dt>마케팅 수신 동의</dt>
<dd><strong>정의:</strong> 내원객의 마케팅 연락 수신 여부와 관련된 동의 정보입니다.<br /><strong>설명:</strong> 공개 API에서는 전화번호를 기준으로 마케팅 수신 동의를 해제할 수 있습니다.</dd>
</dl>
</details>


## 엔드포인트

- [마케팅 수신 동의 해제](/docs/openapi/disable-advertising-agreement-to-visitors.md): `POST /visitor/open/v1/commands/disable-advertising-agreement-to-visitors`
- [내원객 초진 설문지 제출](/docs/openapi/submit-visitor-questionnaire.md): `POST /visitor/open/v1/commands/submit-visitor-questionnaire`
- [이미 등록된 내원객 ID 조회](/docs/openapi/find-duplicated-visitor-id.md): `POST /visitor/open/v1/queries/find-duplicated-visitor-id`
- [초진 설문지 동의항목 조회](/docs/openapi/get-questionnaire-agreements.md): `POST /visitor/open/v1/queries/get-questionnaire-agreements`
- [제출된 초진 설문지 조회](/docs/openapi/get-questionnaire-submit.md): `POST /visitor/open/v1/queries/get-questionnaire-submit`
- [내원객 초진 설문지 조회](/docs/openapi/get-visitor-questionnaire.md): `POST /visitor/open/v1/queries/get-visitor-questionnaire`
- [내원객 정보 검색](/docs/openapi/search-visitors.md): `POST /visitor/open/v1/queries/search-visitors`
- [내원객 검색](/docs/openapi/find-visitor.md) 사용 중단됨: `POST /visitor/open/v1/queries/find-visitor`
