短缺药试点企业API接口&前置机对接接口说明.docx
接口:http://203.156.214.133:8052/Data24api/ReportAuth
接口名称 | 上报企业用户授权(获取tokenId) |
请求地址 | http://203.156.214.133:8052/Data24api/ReportAuth |
请求方式 | POST |
返回值类型 | JSON |
功能描述 | 上报企业提交用户信息并取得授权 |
请求参数说明 |
参数名 | 参数说明 | 参数类型 | 是否必填 |
userName | varchar | 用户名 | 是 |
密码 | varchar | 密码 | 是 |
请求参数示例 |
"body": {"userName":"","password":""} 以上参数经RSA公钥加密后生成密文POST给API服务 |
返回结果 |
成功: { “ResultCode” :“0”, “Msg” :“Success”, "tokenId":"***" //32位MD5加密字符串 } 失败: { “ResultCode” :“500”, “Msg” :“Failed”, } |
|
|
|
|
|
对提交的用户名密码进行RSA加密
示例:
提交数据:string0 = “{"userName":"abcd","password":"123456"}”
根据我们提供的RSA公钥进行加密:
公钥:
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDB3pbEC94GwisNvRj0GWQQMUH2z923cPz+0VAaHoM4sZJ1B50pamlDc+TqKnK5zYsG4QGu6uUTiAC9MIZZjCRCvBrj1vX1bO/z1Dhu9gUhbM3wy2TI+pTVI4QjojMmHygfidOewK519vasAuR8vWWuUVcYnVMmTcP3ZF9awyR6TwIDAQAB
加密:string1 = RSA(string0,公钥)
(加密方法请参照《用户校验中的加密算法.doc》文档)
本接口将实际生成的加密数据string1以数据流格式提交到信息中心
医药中心收到string1后,返回类似如下格式JSON:
{"ResultCode":"0","Msg":"Success","tokenId":"sjdksfjksjdksfjksjdksfjksjdksfjk"},其中tokenId参数值会在下面的上报接口中使用(tokenId的使用时效为一小时,超过一小时后需要重新调用此接口申请)
接口:http://203.156.214.133:8052/Data24api/Data24
接口名称 | 月报有产品短缺药 |
请求地址 | http://203.156.214.133:8052/Data24api/Data24 |
请求方式 | POST |
返回值类型 | JSON |
功能描述 | 上报月报有产品短缺药信息 |
请求参数说明 |
参数名 | 参数说明 | 参数类型 | 是否必填 |
Year | int | 年 | 是 |
Month | int | 月 | 是 |
EnterpriseNo | nvarchar | 企业no | 是 |
ItemCode | varchar | 产品no,即productno | 是 |
IsProduct | nvarchar | 是否实际生产 | 否 |
BeginStorage | decimal | 期初库存 | 否 |
ProduceSum | decimal | 1-本月生产量 | 否 |
SaleSum | decimal | 1-本月销售量 | 否 |
OwnSum | decimal | 企业累计自用量及其他 | 否 |
EndStorage | decimal | 期末库存 |
|
SalesSum | decimal | 1-本月销售额 |
|
ExportSum | decimal | 其中1-本月出口 |
|
ProduceSumThisReal | decimal | 本月生产量 |
|
SaleSumThisReal | decimal | 本月销售量 |
|
ExportSumThisReal | decimal | 其中本月出口量 |
|
SalesSumThisReal | decimal | 本月销售额 | 否 |
BuyTime | int | 采购周期 | 否 |
ProductTime | int | 生产周期 | 否 |
StroageTime | int | 库存周转 | 否 |
CapacityRate | decimal | 产能利用率 | 否 |
IsreducePlan | nvarchar | 是否有减产停产计划 | 否 |
ReduceTime | nvarchar | 减产停产时长 | 否 |
ReduceReson | nvarchar(MAX) | 减产停产原因 | 否 |
Ttems | varchar | 短缺药字表数组,对应ProductDuanQueDetail表 | 否 |
请求参数示例 |
"body": {"tokenId":"","data":[{ "Year":2019, "Month":12, "EnterpriseNo":"EP100000000000", "ItemCode":”271010101011111111111”, "IsProduct":”是”, "BeginStorage":10000, "ProduceSum":199, "SaleSum":199, "OwnSum":199, "EndStorage":199, "SalesSum":199, "ExportSum":300, "ProduceSumThisReal":400, "SaleSumThisReal":500, "ExportSumThisReal":500, "SalesSumThisReal":500, "BuyTime":1, "ProductTime":500, "StroageTime":500, "CapacityRate":500, "IsreducePlan":”是”, "ReduceTime":”1个月”, "ReduceReson":”生产规范要求”, "Ttems":[ { "Year":2019, "Month":12, "EnterpriseNo":"EP1000000000", "ItemCode":"27110101001011111", "FuLiaoName":"原辅料", "Specification":"规格", "FactoryName":”XX企业”, "Unit":"单位" "UseAageThisReal":1000 "Supply":"充足" } ] }],sign:"***"} //根据上报企业签名key计算(详见2.5.1) |
返回结果 |
成功: { “ResultCode” :“0”, “Msg” :“Success”, } 失败: { “ResultCode” :“500”, “Msg” :“Failed”, } |
|
|
|
|
|
示例:
secretKey: 89E12A128CEBC695
上报数据(格式JSON):
{“tokenId”:” 58DA2E7EAF03224A3C452328E1D3BB52”,”data”:”********”}
加密生成signKey:
String1 =” {“tokenId”:” 58DA2E7EAF03224A3C452328E1D3BB52”,”data”:”********”}89E12A128CEBC695”
signKey = MD5(String1), 即 MD5(上报数据+secretKey)
最后实际上报数据格式如下:
{“tokenId”:” 58DA2E7EAF03224A3C452328E1D3BB52”,”data”:”********”,”sign”:” 3F69B130F2E2AE71CD1330E5439F3C3F”}
相关数据字典:
表名:data24
字段 | 字段类型 | 注释 | 主键 | 不为空 |
Year | int | 年 | ✔ | ✔ |
Month | int | 月 | ✔ | ✔ |
EnterpriseNo | nvarchar | 企业no | ✔ | ✔ |
ItemCode | varchar | 产品no,即productno | ✔ | ✔ |
IsProduct | nvarchar | 是否实际生产 |
|
|
BeginStorage | decimal | 期初库存 |
|
|
ProduceSum | decimal | 1-本月生产量 |
|
|
SaleSum | decimal | 1-本月销售量 |
|
|
OwnSum | decimal | 企业累计自用量及其他 |
|
|
EndStorage | decimal | 期末库存 |
|
|
SalesSum | decimal | 1-本月销售额 |
|
|
ExportSum | decimal | 其中1-本月出口 |
|
|
ProduceSumThisReal | decimal | 本月生产量 |
|
|
SaleSumThisReal | decimal | 本月销售量 |
|
|
ExportSumThisReal | decimal | 其中本月出口量 |
|
|
SalesSumThisReal | decimal | 本月销售额 |
|
|
BuyTime | int | 采购周期 |
|
|
ProductTime | int | 生产周期 |
|
|
StroageTime | int | 库存周转 |
|
|
CapacityRate | decimal | 产能利用率 |
|
|
IsreducePlan | nvarchar | 是否有减产停产计划 |
|
|
ReduceTime | nvarchar | 减产停产时长 |
|
|
ReduceReson | nvarchar(MAX) | 减产停产原因 |
|
|
表名:ProductDuanQueDetail (data24子表)
字段 | 字段类型 | 注释 | 主键 | 不为空 |
Year | int | 年 | ✔ | ✔ |
Month | int | 月 | ✔ | ✔ |
EnterpriseNo | nvarchar | 企业no | ✔ | ✔ |
ItemCode | nvarchar | 产品no | ✔ | ✔ |
FuLiaoName | nvarchar | 原辅料名称 | ✔ | ✔ |
Specification | nvarchar | 规格 |
|
|
FactoryName | nvarchar | 生产企业 |
|
|
Unit | nvarchar | 单位 |
|
|
UseAageThisReal | decimal | 本月使用量 |
|
|
Supply | nvarchar | 供应情况 |
|
|
字段规则:
Data24 | IsProduct | 是否实际生产 | 是,否 |
IsreducePlan | 是否有减产停产计划 | 是,否 |
ReduceReson | 减产停产原因 | 生产规范要求 |
活性成分短缺 |
非活性成分组分的短缺 |
停止生产该药物 |
其他 |
ProductDuanQueDetail | Supply | 供应情况 | 充足 |
一般 |
紧张 |
短缺 |
企业端回调地址接收数据格式说明:
{"code":"402","Msg":"XX必填,不能为空"}