山东省药品和医用耗材招采管理.docx

PAGE28

山东省药品和医用耗材招采管理

子系统配送企业接口规范

（v1.1）

山东省医疗保障局

2023年8月11日

PAGE27

目录

TOC\o1-3\h\z\u1.接口开通 2

2.签名 2

2.1参数解析： 2

2.2加密规则： 2

2.2.1SDK 2

2.2.2加密示例 3

2.2.3注意事项 6

3.接口说明 6

3.1.订单票据场景 6

3.1.1.待确认订单查询接口 6

3.1.2.订单确认接口 8

3.1.3.待配送订单明细查询接口 10

3.1.4.订单配送接口 14

3.1.5.待确认退货明细查询接口 16

3.1.6.确认退货接口 19

3.1.7.挂网目录查询接口 21

3.1.8.上传票据信息 23

3.1.9.更新票据信息 25

3.1.10.设置发票关联关系 27

接口开通

须开通医保网络专线，向相关人员申请接口secretKey与ApiKey。

签名

2.1参数解析：

基本参数

说明

举例

Header

ApiKey

医保提供的apikey值

7yn6ghr6hffb7drd37hq8xpu

Sign

验签串（见下面的加密方式）

f07e01d39cc96181d9078c209e9bff966339946442f44f7ded4140752765eda3

Timestamp

时间戳,格式:yyyyMMddHHmmss

20230413112635

SignType

签名类型KEY:SHA256和MD5两种

SHA256

secretKey

医保提供的secrectKey

d4hitkc7zefs0lks2u46cyisr1zqyog9

Body

RequestBody

请求body的json字符串，对应于post请求，参考接口的请求入参

{current:1,size:20}

2.2加密规则：

2.2.1SDK：引入医保提供的sdk包，开源hutool包

dependency

groupIdcom.hxmec/groupId

artifactIdhx-open-sdk/artifactId

version1.0.3/version

/dependency

dependency

groupIdcn.hutool/groupId

artifactIdhutool-all/artifactId

version5.0.6/version

/dependency

2.2.2对接及加密demo

importcom.alibaba.fastjson.JSONObject;

importm.dto.req.InvoicePageReqDTO;

importcom.hxmec.sdk.model.HxCommonJsonRequest;

importcom.hxmec.sdk.utils.SignatureUtil;

importlombok.SneakyThrows;

importorg.apache.http.HttpEntity;

importorg.apache.http.HttpStatus;

importorg.apache.http.StatusLine;

importorg.apache.http.client.methods.CloseableHttpResponse;

importorg.apache.http.client.methods.HttpPost;

importorg.apache.http.entity.StringEntity;

importorg.apache.http.impl.client.CloseableHttpClient;

importorg.apache.http.impl.client.HttpClients;

importorg.apache.http.util.EntityUtils;

importorg.junit.Test;

importjava.io.IOException;

importjava.text.SimpleDateFormat;

importjava.util.Date;

importjava.util.HashMap;

importjava.util.Map;

publicclassOpenApiTests{