# 就診人

# 1.背景介紹

該文檔主要是幫助合作方了解就診人這里的整體處理流程，如果變更會向下兼容。 同時約定了騰訊健康與合作方對接的接口定義及數(shù)據(jù)格式

# 2.處理流程

新增就診人

主要流程為：用戶選擇新增就診人后，界面跳轉(zhuǎn)至合作方提供的添加就診人的H5界面，用戶在合作方界面操作完成后，由合作方調(diào)用syncPartnerPatient接口將用戶數(shù)據(jù)同步給騰訊健康，并跳轉(zhuǎn)回騰訊健康界面。值得注意的是，不同公眾號下用戶的openId均不同，因此數(shù)據(jù)同步時appId和openId一定不能為空！

查詢就診人

主要流程為：小程序請求就診人列表，騰訊健康后臺調(diào)用合作方getPartnerPatients接口獲取就診人列表，合作方返回就診人列表后，騰訊健康將查詢到的數(shù)據(jù)整理后返回給小程序。

# 3.合作方涉及操作

提供新增就診人H5界面 修改新增就診人邏輯：增加數(shù)據(jù)同步(調(diào)用syncPartnerPatient)、界面跳轉(zhuǎn)騰訊健康測試界面 提供查詢接口getPartnerPatients

# 4.接口定義

# 4.1 網(wǎng)關接入

網(wǎng)關接入請看網(wǎng)關接入標準。

# 4.2 單個同步接口：syncPartnerPatient

# 4.2.1 請求報文 變量名 類型 必填 描述 openId string ?? 用戶在合作方公眾號下的openId appId string ?? 合作方公眾號的appId patient patient ?? 就診人，具體結(jié)構(gòu)參見patient # patient結(jié)構(gòu)體 變量名 類型 必填 描述 hospitalId string ?? 醫(yī)院id appId string ?? 合作方公眾號的appId openId string ?? 用戶在合作方公眾號下的openId userName string ?? 就診人姓名 patientNo string ?? 就診人全局唯一標識，例如就診卡號 userCardType int ?? 就診人的證件類型: 1-身份證 userCard string ?? 就診人的證件號 gender int ?? 就診人性別: 1-男; 2-女 birthDay string ?? 就診人出生年月日(20190415) relation int ?? 就診人與openId的關系: 1-本人; 2-父母; 3-子女; 4-夫妻; 5-親屬; 6-朋友; 7-其他 phone string ?? 就診人手機號碼 # 報文示列 # 4.2.2 響應報文 變量名 類型 必填 描述 code int ?? 錯誤碼: 0-成功; 小于0-網(wǎng)關錯誤; 大于0-業(yè)務錯誤 message string ?? 錯誤信息 # 報文示列 # 4.2.3 業(yè)務錯誤碼 錯誤碼 描述 0 成功 1605001 參數(shù)錯誤 1605003 身份信息不正確

# 4.3 查詢接口：getPartnerPatients

# 4.3.1 請求報文 變量名 類型 必填 描述 appId string ?? 合作方公眾號的appId openId string ?? 用戶在合作方公眾號下的openId # 報文示列 # 4.3.2 響應報文 變量名 類型 必填 描述 patients array ?? 就診人列表，具體結(jié)構(gòu)參見patient # 報文示列

# 4.2 批量同步接口：syncPatientsBatch

# 4.2.1 請求報文 變量名 類型 必填 描述 total int ?? 總共需要同步的就診人個數(shù) offset int ?? 當前總共同步的就診人個數(shù) requestId string ?? 用于唯一識別此次的同步操作 patients patient ?? 就診人詳情，長度不超過100，具體結(jié)構(gòu)參見patient # patient結(jié)構(gòu)體 變量名 類型 必填 描述 hospitalId string ?? 醫(yī)院id appId string ?? 合作方公眾號的appId openId string ?? 用戶在合作方公眾號下的openId userName string ?? 就診人姓名 patientNo string ?? 就診人全局唯一標識，例如就診卡號 userCardType int ?? 就診人的證件類型: 1-身份證 userCard string ?? 就診人的證件號 gender int ?? 就診人性別: 1-男; 2-女 birthDay string ?? 就診人出生年月日(20190415) relation int ?? 就診人與openId的關系: 1-本人; 2-父母; 3-子女; 4-夫妻; 5-親屬; 6-朋友; 7-其他 phone string ?? 就診人手機號碼 # 報文示列 # 4.2.2 響應報文 變量名 類型 必填 描述 code int ?? 錯誤碼: 0-成功; 小于0-網(wǎng)關錯誤; 大于0-業(yè)務錯誤 message string ?? 錯誤信息 # 報文示列

相關知識

就診人
全國發(fā)熱門診就診人數(shù)上升，流感病例成就診主要群體
京醫(yī)通如何解綁已增加的就診人 刪除就診人信息方法
門診就診流程
就診須知
就診流程
就診卡個人信息怎么改
江蘇健康通app添加就診人
就診指南
就診卡號怎么查（就診卡號怎么查詢）

網(wǎng)址: 就診人 http://www.u1s5d6.cn/newsview1197117.html