物资系统接口

目的

本文档指导第三方系统对接追溯系统，实现目标：

向追溯系统增加一次性物品模板信息；

向追溯系统入库一次性物品；

对接说明

追溯系统提供WebAPI；

数据提交方式：Post；

数据格式：JSON；

数据传输格式：utf-8；

对接地址：现场配置，如：http://192.168.x.x:12345/api.ashx；

数据格式

1、post和返回格式相同；

签名说明

sign=md5(dateTime.ToString("yyyy-MM-dd HH:mm:ss")   "|"   rndCode   "|"   sKey   "|"   dataLng)

md5的时候把字符串按GBK2312的方式编码后参与计算；

sKey:现场分配；

参考代码（c#）：

/// <summary>

/// 返回sign

/// </summary>

/// <param name="dtime">流水时间</param>

/// <param name="dataLng">流水正文长度</param>

/// <param name="sKey">系统分配的sKey</param>

/// <returns></returns>

public static string GetMD5(DateTime dtime, int dataLng,string sKey)

{

    //获取需要加密的字符串

    string encypStr = dtime.ToString("yyyy-MM-dd HH:mm:ss")   "|"   Guid.NewGuid().ToString("N")   "|"   sKey   "|"   dataLng;

    //返回加密后的内容

    return System.BitConverter.ToString((new MD5CryptoServiceProvider()).ComputeHash(Encoding.GetEncoding("GB2312").GetBytes(encypStr))).ToUpper();

}

成功时返回报文正文说明

{... ... "OK":true,  ... ... }

成功时报文正文里必有：OK:true

其它内容参见各函数说明；

示例：

{

  "dateTime": "2021-01-01 00:00:00",

  "rndCode": "df4a4949-dabb-4b15-9038-0409ebf047ae",

  "dataLng": "???",

  "sign": "xxxx",

  "data": {

"OK": true

...... （有可能不存在其它参数）

  }

}

失败时返回报文正文说明

{... ..."OK":false,"Message":"错误说明", ... ...}

失败时报文正文里必有：OK:false 及 Message；

Message里表示失败原因，如果有用户界面，该失败原因可直接向用户显示；

示例：

{

  "dateTime": "2021-01-01 00:00:00",

  "rndCode": "df4a4949-dabb-4b15-9038-0409ebf047ae",

  "dataLng": "???",

  "sign": "xxxx",

  "data": {

    "OK": false,

    "Message": "???"

  }

}

【函数说明】

【登陆】

传入参数

返回内容

示例：

{

  "dateTime": "2021-01-01 00:00:00",

  "rndCode": "df4a4949-dabb-4b15-9038-0409ebf047ae",

  "dataLng": "???",

  "sign": "xxxx",

  "data": {

    "menukey": "login.webonekey",

    "username": "???",

    "nodecode": "???"

  }

}

实例：

{"data":"{\"menukey\":\"login.webonekey\",\"username\":\"621764\",\"nodecode\":\"741A2E10-5FF2-4C66-AE2F-00124887765D\"}","dateTime":"2021-09-02 16:10:49","rndCode":"31f5d485-71b1-44c3-ab29-9f376bcd62be","dataLng":99,"sign":"B380C2D9AD401A21989D406057218419"}

里面没有换行符，因显示的原因产生了换行

【增加供应商或厂家】

传入参数

标*字段直接填写常量。

返回内容

示例：

{

    "pagekey":"267",

    "menukey":"pubgrid.add",

    "iconUrl":"",

    "isDel":"0",

    "viewUrl":"",

    "isStop":"0",

    "idInt":"331",

    "kehuID":"2",

    "name":"test",

    "parentId":"faa2e53b-9a28-440a-a7cf-8a1e5cebd66e",

    "parentIdName":"xxx",

    "fullName":"",

    "id":"608ac1b7-b051-4e3e-905c-40bd75a0e410",

    "keshiType":"00000000-0000-0000-0000-000000000000",

    "nameJM":"TEST",

    "keshiTypeName":"",

    "jieshuanKeshiName":"",

    "jieshuanKeshi":"00000000-0000-0000-0000-000000000000",

    "tel":"",

    "orderNum":"0",

    "isGongyinshang":"false",

    "isChangjia":"true",

    "isCSSD":"0",

    "isWailaibaoGongShi":"0",

    "isFenYuan":"0",

    "isWJKuFang":"0",

    "isYCXKuFang":"0",

    "isHCKuFang":"0",

    "isJieshuanKeshi":"0",

    "isDaixiaoYiYuan":"0",

    "isShousuKeshi":"0",

    "canHuiShouOrFaFang":"0",

    "memo":"",

    "gxtoken":"37f05265-22ba-40c8-aecb-0cfda5eff254"

}

【增加一次性物品模板】

传入参数

标*字段直接填写常量。

返回内容

示例：

{

    "pagekey":"265",

    "menukey":"pubgrid.add",

    "ImgMores":"",

    "id":"029a04ac-1d4a-4d34-afbe-7776a00c5166",

    "name":"test",

    "nameJM":"TEST",

    "codeText":"t",

    "guige":"1",

    "defChangjia":"608ac1b7-b051-4e3e-905c-40bd75a0e410",

    "defChangjiaName":"test",

    "defGongyinshang":"436dc24a-2c89-4882-8e15-42ad28e69679",

    "defGongyinshangName":"aa",

    "minDanwei":"只",

    "minDanweiName":"只",

    "inGongzhuoliang":"0",

    "inDanwei":"件",

    "inDanweiName":"件",

    "inDanweiBeilv":"10",

    "outDanwei":"件",

    "outDanweiName":"件",

    "outDanweiBeilv":"10",

    "outGongzhuoliang":"0",

    "inMoney":"1",

    "outMoney":"1",

    "jinjieOne":"0",

    "jinjieTwo":"0",

    "kehuID":"2",

    "keshiID":"1743043f-b1bc-4a75-be5d-a58fb2c328a8",

    "keshiName":"消毒供应中心",

    "maxKucun":"0",

    "nowYue":"0",

    "sysTypeID":"2",

    "userTypeName":"默认",

    "userTypeNameName":"默认",

    "youxiaoqiDay":"365",

    "isStop":"0",

    "isDel":"0",

    "ImgSmallID":"",

    "ImgIconID":"",

    "ImgDefID":"",

    "gxtoken":"37f05265-22ba-40c8-aecb-0cfda5eff254"

}

【入库】

单据信息，传入参数

标*字段直接填写常量。

返回内容

{

    "pagekey":"286",

    "menukey":"pubgrid.add",

    "ImgMores":"",

    "gongyinshang":"436dc24a-2c89-4882-8e15-42ad28e69679",

    "gongyinshangName":"aa",

    "sysTypeID":"2",

    "id":"6270a234-2dca-4871-846e-281d77472698",

    "isDel":"0",

    "kehuID":"2",

    "keshi":"1743043f-b1bc-4a75-be5d-a58fb2c328a8",

    "nodeName":"",

    "typeName":"入库",

    "userID":"f8818f13-007a-47ed-bbc0-503900783722",

    "addDatetime":"2022-07-20 10:56:36",

    "userIDName":"测试员",

    "keshiName":"消毒供应中心",

    "sumGongzhuoliang":"0",

    "sumMoney":"10",

    "memo":"",

    "ImgIconID":"",

    "ImgDefID":"",

    "ImgSmallID":"",

    "gxtoken":"37f05265-22ba-40c8-aecb-0cfda5eff254"

}

 单据明细，传入参数，多条明细需多次调用接口

标*字段直接填写常量。

返回内容

示例：

{

    "pagekey":"286_ycxwp",

    "menukey":"pubgrid.add",

    "ImgMores":"",

    "isDel":"0",

    "pics":"",

    "outDanjia":"1",

    "haocaiID":"029a04ac-1d4a-4d34-afbe-7776a00c5166",

    "haocaiIDName":"test",

    "outGongzhuoliang":"0",

    "gongyinshangName":"aa",

    "changjiaName":"test",

    "linkInId":"00000000-0000-0000-0000-000000000000",

    "danwei":"只",

    "danjia":"1",

    "oldNumber":"10",

    "gongzhuoliang":"0",

    "Number":"10",

    "pichihao":"12",

    "shencandate":"2022-07-20",

    "shixiaodate":"2023-07-20",

    "danjuID":"6270a234-2dca-4871-846e-281d77472698",

    "id":"3942dc18-713e-4c1e-b79d-0d00cdd47e09",

    "typeName":"入库",

    "gxtoken":"37f05265-22ba-40c8-aecb-0cfda5eff254"

}