新疆医保支付接口规范(2)

新疆(喀什)医保支付接口应用编程接口规范

astr_jysr_xml 交易输入 String 入口参数 xml方式，组织方式见业务说明，字符串最大长度65534字符 astr_jylsh astr_jyyzm 交易流水号 交易验证码 String String 出口参数 唯一标识一次交易，VARCHAR(20) 出口参数 处理类交易返回，确认交易时传入 VARCHAR(15) astr_jysc_xml 交易输出 aint_appcode 交易标志 String long 出口参数 xml方式，组织方式见业务说明 出口参数 小于0均为失败。此值数据类型是整数，范围为-2147483648 to +2147483647 astr_appmsg 交易信息 String 出口参数 错误信息描述。aint_appcode小于0时存放错误描述，其他aint_appcode不用关心该参数内容。 ? 函数说明：

交易主函数，完成所有医疗业务的实际处理。

由于交易调用远程方法，并且可能存在用户交互界面，因此建议所有交易不要纳入HIS系统事务管理。

在交易接口函数定义中，传递的参数都是字符串。但是在交易详细说明中，数据类型都是逻辑类型，常用类型有三种：string,number,datetime，下面的表格描述了交易接口进行类型转换的限制和说明。

数据类型 string number 空字符串 视同空串 视同0 格式不合法 无 返回错误 其它说明 无特别说明标注的长度为最大长度 无特别说明标注的长度为最大长度（小数尾数同） datetime 视同空值 返回错误 足19位长，格式如下： YYYY-MM-DD hh24:mm:ss date 视同空值 返回错误 足19位长，格式如下： YYYY-MM-DD astr_jykz_xml、astr_jysr_xml、astr_jysc_xml参数均按照交易详细说明里xml参数组合，顺

第 6 页 共 88 页

新疆(喀什)医保支付接口应用编程接口规范

序无关。接口调用示例：

VB调用

Dim yinhaiobject As Object '定义存放引用对象的变量。

Set yinhaiobject = CreateObject(\yinhai.xjcj.interface\'检查连接是否建立

If yinhaiobject Is Nothing Then MsgBox \对象为空!\End If

Dim BusinessID As String Dim Dataxml As String Dim Businesssequence As String Dim Businessvalidate As String Dim Outputxml As String Dim Appcode as Long Dim Appmsg As String

BusinessID=\Ctrlxml =\ '组织参数 Dataxml =\ '组织参数 yinhaiobject.yh_interface_call

BusinessID ,Dataxml ,Businesssequence,Businessvalidate,Outputxml,Appcode,Appmsg '判断返回信息 'HIS业务处理

Set yinhaiobject = Nothing '关闭对象

delphi调用

注意：delphi调用时先要 uses ComObj;否则不能引用oleobject。 Var

第 7 页 共 88 页

新疆(喀什)医保支付接口应用编程接口规范

yinhaiobject: Variant; //定义存放引用对象的变量。 BusinessID : String Dataxml : String Businesssequence : String Businessvalidate : String Outputxml : String Appcode : integer Appmsg:String; Begin try

yinhaiobject := CreateOleObject('yinhai.xjcj.interface'); BusinessID:= '01';

yinhaiobject.yh_interface_call(BusinessID ,Dataxml ,Businesssequence,Businessvalidate,Outputxml,Appcode,Appmsg) //返回结果判断，HIS内部处理 finally

yinhaiobject:=Unassigned;// 关闭对象 end; End;

pb调用

oleobject yinhaiobject long result, Appcode

String BusinessID ,Dataxml ,Businesssequence String Businessvalidate,Outputxml, Appmsg yinhaiobject=create oleobject

result=yinhaiobject.ConnectToNewObject(\yinhai.xjcj.interface\if result<>0 then

messagebox(\，\

第 8 页 共 88 页

新疆(喀什)医保支付接口应用编程接口规范

return

end if

BusinessID=”01”

yinhaiobject.yh_interface_call(BusinessID ,Dataxml ,Businesssequence,Businessvalidate,Outputxml,Appcode,Appmsg) // 返回结果判断，HIS内部处理 // 关闭对象

yinhaiobject.DisconnectObject ( ) destroy yinhaiobject

? 原型定义：

yh_interface_confirm(

string astr_jylsh,

string astr_jyyzm,

ref long aint_appcode, ref string astr_appmsg)

参数名称 astr_jylsh astr_jyyzm aint_appcode astr_appmsg 参数含义 交易流水号 交易验证码 交易标志 交易信息 参数类型 参数类别 String String long String yh_interface_confirm

参数说明 入口参数 唯一标识一次交易，VARCHAR(20) 入口参数 处理类交易返回，VARCHAR(64) 出口参数 确认交易HIS不用关心本次处理出口参数 返回结果，但是必须采用查询不确定交易的方式来确定是否所有数据正确处理。 ? 函数说明：

交易辅助函数，完成交易的确认处理。

对于处理类交易，HIS调用接口成功后完成HIS系统数据保存，则调用该交易进行中心确认处理。

? 接口调用示例：

第 9 页 共 88 页

新疆(喀什)医保支付接口应用编程接口规范

参看yh_interface_call调用说明。

yh_interface_cancel

? 原型定义：

yh_interface_cancel (

string astr_jylsh, ref long aint_appcode, ref string astr_appmsg)

参数名称 astr_jylsh aint_appcode astr_appmsg 参数含义 参数类型 参数类别 入口参数 唯一标识一次交易，VARCHAR(20) 出口参数 确认交易HIS不用关心本次处理出口参数 返回结果，但是必须采用查询不确定交易的方式来确定是否所有数据正确处理。 ? 函数说明：

交易辅助函数，完成交易的取消处理。

对于处理类交易，HIS调用接口成功后未完成HIS系统数据保存，则调用该交易进行中心取消处理。 ? 接口调用示例：

参看yh_interface_call调用说明。

yh_interface_getuncertaintytrade

交易流水号 String 交易标志 交易信息 long String ? 原型定义：

yh_interface_getuncertaintytrade (

string astr_jybh, ref string astr_jgxml, ref long aint_appcode, ref string astr_appmsg)

第 10 页 共 88 页