尽消存

调用方法

地址说明

  • 通过获取程序Api地址接口返回参数中ApiServerAddress的值

调用方法

  • POST
  • ContentType: application/x-www-form-urlencoded;Charset=UTF-8

参数：

参数名必选类型说明
managename是string接口名 固定值为：GraspCMServerApi.dll
dbname是string数据库名称
actiontype是string新增=add 修改=modify
rec是string新增传0，修改时需要传入基本信息的rec
basetype是string基础资料类型 详见文档：基础资料Json格式
baseinfodata是string基础资料数据json 详见文档：基础资料Json格式
apiparam是string通过获取程序API地址接口返回
apitype是string接口类型 传baseinfo
sign是string签名字符串
mobile是string云平台手机号 获取API地址返回的GraspCloudMobile，为空时传0
serviceid是string云平台ServerID 获取API地址返回的GraspCloudServerId，为空时传0
interiorapi是int该参数始终为1

参数传入说明
1、采用x-www-form-urlencode的方式传参，即参数通过key=value&key=value拼接成字符串，再通过Body传入。
2.再拼接字符串时需要对参数中的所有value做URLEncode，特别注意只有再拼接Post传入参数时才对Value做URLEncode，而计算签名时不要进行转译

sign签名规则

  1. 将上述参数中除了sign以外的所有参数，根据参数名按照字母排序，以Key+Value的形式拼接字符串。
  2. 字符串拼接后在结尾加上SignKey。(SignKey获取方法见：获取接口所需SignStr接口)
  3. 将这个最终拼接成的字符串通过MD5加密，取32位小写。

MD5加密前字符串示例

actiontypemodifyapiparam7/eAVT1NN2MtBY+MkAylEBVN/FsnC9BL4IzSHtHyt+2s+jAZRVqfMAwzFgSudBH3eDau916Vd6aNEFxve2ZoYey1Zvi+Vp8xb7VrAnJNbCs=apitypebaseinfobaseinfodata{"usercode":"A0023","fullname":"A0023","gpfullname":"库存商品","inputno":"会计人"}basetypeptypedbnameM7215API测试interiorapi1managenameGraspCMServerApi.dllmobile0rec0serviceid02020cmgmsignkeyappkey@#986

PostMan传参示例
image.png

返回参数说明

参数名类型说明
codestring小于等于0表示失败 成功时会返回基本信息的唯一rec
messagestring单据过账消息 成功还是失败都会返回消息
responsejson数组失败时会返回具体的错误信息

错误信息response

参数名类型说明
errormessagestring错误信息

返回参数示例

{
 "code": "-1",
 "message": "单据过账失败。",
 "response": [
   {
     "errormessage": "单据表头的仓库不存在"
   },
   {
     "errormessage": "单据表头的结算单位不存在"
   }
 ]
}