文档系统
简介
  • 财贸
  • 尽消存
  • 部署指南
  • 商城
  • 建站

    • 企业/个人网站
    • 官网小程序
foo&bar
简介
  • 财贸
  • 尽消存
  • 部署指南
  • 商城
  • 建站

    • 企业/个人网站
    • 官网小程序
foo&bar
  • API接口概述
  • 22.0以上版本接口
    • 成本计算接口
    • 订单中止和恢复
  • 通用接口
    • 获取接口所需的SignKey
    • 获取程序Api地址
  • 业务接口
    • 基础资料新增接口

基础资料新增接口

调用方法

地址说明

  • 通过获取程序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": "单据表头的结算单位不存在"
    }
  ]
}

基础资料Json格式

客户

基础资料类型 customer

参数名必选类型说明
parusercode否string基本信息字段:上级客户编号
parfullname否string基本信息字段:上级客户全名 不传上级则默认添加在第一级
usercode是string客户编号
fullname是string客户全名
name否string客户简名
namepy否string客户助记码
address否string地址
person否string联系人
attnid否string证件号
mobile否string手机
tel否string电话
fax否string传真
arusercode否string基本信息字段:地区编号
arfullname否string基本信息字段:地区全名
eusercode否string基本信息字段:职员编号
efullname否string基本信息字段:职员全名
busercode否string基本信息字段:结算单位编号
bfullname否string基本信息字段:结算单位i全名
arlimit否double信用额度
preprice否int预设售价说明详见下文
settlemode是string结算方式 1收款期限(天) 2月结日期 3收款期限(月)
rdate否int结算方式对应值 结算方式是1时为天数 2时为日期(只能传1~31) 3时为月数
taxnumber否string税号
email否string电子信箱
bank否string开户行
postcode否string邮编
bankaccount否string开户行账号
taxregnumber否string税务登记号
comment否string备注
comment1否string备用字段1
comment2否string备用字段2
comment3否string备用字段3
comment4否string备用字段4
comment5否string备用字段5
comment6否string备用字段6
comment7否string备用字段7
comment8否string备用字段8
customerlevel否int客户级别, 0表示空,1表示A,2表示B,3表示C,4表示D,5表示E。24.0新增字段
inputno是string创建人或修改人名称
deleted否int停用标志 0为正常 1为停用

单据Json示例

  • 示例只展示必录项,其他项目内容按需添加
 {
  "usercode": "00101",
  "fullname": "客户101"
} 

预设售价参数说明

  • 0=最新售价
  • 1=本客户最新售价
  • 2=一级批发价
  • 3=二级批发价
  • 4=三级批发价
  • 5=四级批发价
  • 6=五级批发价
  • 7=参考零售价
  • 8=不使用预设售价
  • 9=六级批发价
  • 10=七级批发价
  • 11=八级批发价
  • 12=九级批发价
  • 13=十级批发价
  • 14=十一级批发价
  • 15=十二级批发价
  • 16=十三级批发价
  • 17=十四级批发价
  • 18=十五级批发价
  • 19=客户协议价

供应商

基础资料类型 supplier

参数名必选类型说明
parusercode否string基本信息字段:上级供应商编号
parfullname否string基本信息字段:上级供应商全名 不传上级则默认添加在第一级
usercode是string供应商编号
fullname是string供应商全名
name否string供应商简名
namepy否string供应商助记码
address否string地址
person否string联系人
attnid否string证件号
mobile否string手机
tel否string电话
fax否string传真
arusercode否string基本信息字段:地区编号
arfullname否string基本信息字段:地区全名
eusercode否string基本信息字段:职员编号
efullname否string基本信息字段:职员全名
busercode否string基本信息字段:结算单位编号
bfullname否string基本信息字段:结算单位全名
aplimit否double信用额度
preprice否int预设采购价:0=最新进价 1=本供应商上次采购价, 3=不使用预设采购价
settlemode否string结算方式 1收款期限(天) 2月结日期 3收款期限(月)
rdate否int结算方式对应值 结算方式是1时为天数 2时为日期(不能超过31日) 3时为月数
taxnumber否string税号
email否string电子信箱
bank否string开户行
postcode否string邮编
bankaccount否string开户行账号
taxregnumber否string税务登记号
comment否string备注
comment1否string备用字段1
comment2否string备用字段2
comment3否string备用字段3
comment4否string备用字段4
comment5否string备用字段5
comment6否string备用字段6
comment7否string备用字段7
comment8否string备用字段8
inputno是string创建人或修改人名称
isweiwai否int是否是委外单位
bquality否int是否需要质检
deleted否int停用标志 0为正常 1为停用

单据Json示例

  • 示例只展示必录项,其他项目内容按需添加
  
 {
  "usercode": "00101",
  "fullname": "供应商101"
} 

存货档案

基础资料类型 ptype

存货信息

参数名必选类型说明
parusercode否string基本信息字段:上级存货编号
parfullname否string基本信息字段:上级存货全名 不传上级则默认添加在第一级
usercode是string存货编号
fullname是string存货全名
name否string存货简名
namepy否string存货助记码
standard否string规格
type否string型号
area否string产地
unitother否string副单位
brusercode否string基本信息字段:品牌编号
brfullname否string基本信息字段:品牌全名
busercode否string基本信息字段:缺省供应商编号
bfullname否string基本信息字段:缺省供应商全名
kusercode否string基本信息字段:缺省仓库编号
kfullname否string基本信息字段:缺省仓库全名
wusercode否string基本信息字段:缺省车间编号
wfullname否string基本信息字段:缺省车间全名
psusercode否string基本信息字段:货位编号 24.0新增字段
psfullname否string基本信息字段:货位全名 24.0新增字段
gpfullname是string基本信息字段:存货核算方法全名
bblockno否int是否管理批号
bcustom1否int是否管理自定义项1
bcustom2否int是否管理自定义项2
bcustom3否int是否管理自定义项3
bcustom4否int是否管理自定义项4
costmode是int存货成本计价方式 0移动平均法 1先进先出法 3个别计价法 4全月平均法
bpurchase否int是否外购
bproduce否int是否自制
bconsign否int是否委外
definunit否int缺省入库单位
defoutunit否int缺省出库单位
defpandianunit否int缺省盘点单位
manserialnum否int是否管理序列号
takeout否int是否近效期先出
refprice否string参考成本
costprice否string单位定额成本
istaxprice否int是否批发价含税
safeqty否double安全库存数量
safedaycount否int安全库存天数
beforedate否int采购周期
producebeforeday否int生产周期
ConsignBeforeDay否int委外周期
c1usercode否string基本信息字段:存货自定义1编号
c1fullname否string基本信息字段:存货自定义1全名
c2usercode否string基本信息字段:存货自定义2编号
c2fullname否string基本信息字段:存货自定义2全名
c3usercode否string基本信息字段:存货自定义3编号
c3fullname否string基本信息字段:存货自定义3全名
c4usercode否string基本信息字段:存货自定义4编号
c4fullname否string基本信息字段:存货自定义4全名
comment否string备注
comment1否string备用字段1
comment2否string备用字段2
comment3否string备用字段3
comment4否string备用字段4
comment5否string备用字段5
comment6否string备用字段6
comment7否string备用字段7
comment8否string备用字段8
inputno是string创建人或修改人名称
definunit否int默认入库单位,传入1=基本单位,2=辅助单位1,3=辅助单位2
defoutunit否int默认出库单位,传入1=基本单位,2=辅助单位1,3=辅助单位2
defpandianunit否int默认盘点单位,传入1=基本单位,2=辅助单位1,3=辅助单位2
deleted否int停用标志 0为正常 1为停用
verimode否int质检方式 传入0=未启用,1=全检,2=抽样,3=免检
verirate否double抽样比例,质检方式传2时才可以传入值,可以传入0~100,2位小数
shelflife否int保质期天数
shelflifemode否int保质期类型 0=天 1=月
warndays否int预警天数
units否array[]存货单位信息

存货单位信息

  • `存货支持最多3个单位,默认第一行为基本单位
参数名必选类型说明
unitname是string存货单位全名
unitrate是double存货单位换算率 基本单位时始终为1 辅助单位时必录
retailprice否double参考零售价
minsaleprice否double最低售价
defaultprice否double默认报价
barcode否string条码
tradeprice1否double一级批发价
tradeprice2否double二级批发价
tradeprice3否double三级批发价
tradeprice4否double四级批发价
tradeprice5否double五级批发价
tradeprice6否double六级批发价
tradeprice7否double七级批发价
tradeprice8否double八级批发价
tradeprice9否double九级批发价
tradeprice10否double十级批发价
tradeprice11否double十一级批发价
tradeprice12否double十二级批发价
tradeprice13否double十三级批发价
tradeprice14否double十四级批发价
tradeprice15否double十五级批发价
weights否double重量 24.0新增字段
volume否double体积 24.0新增字段

单据Json示例

提示

示例只展示必录项,其他项目内容按需添加

{
  "usercode": "001",
  "fullname": "存货1",
  "gpfullname": "库存商品",
  "units": [
    {
      "unitname": "个",
      "unitrate": 1
    },
    {
      "unitname": "件",
      "unitrate": 6
    },
    {
      "unitname": "箱",
      "unitrate": 12
    }
  ]
}

标准BOM

注意事项

该接口仅23.5以上版本才支持。

基础资料类型 standardbom

参数名必选类型说明
parusercode否stringbom类别编号
parfullname否stringbom类别全名 不传则默认为全部清单
usercode是stringbom编号
fullname是stringbom全名
pusercode是string父项存货编号
pfullname是string父项存货全名
qty是float父项存货数量,大于0,6位小数
maxhour否float定额工时,4位小数
summary否string摘要
inputno是string创建人名称
modifyperson否string修改人名称,修改时传入
auditor否string审核人名称 ,不传bom就是未审核状态
detail是array[]bom明细

detail bom明细

参数名必选类型说明
pusercode是string子件存货编号
pfullname是string子件存货全名
qty是float子件存货数量,大于0,6位小数
baseqty是int底数,没有底数就固定传1
wastage否float损耗率,大于0,2位小数
comment否string备注1
comment2否string备注2

单据Json示例


{
  "usercode ": "BOM001",
  "fullname ": "BOM001",
  "pusercode ": "P001",
  "pfullname ": "产成品01",
  "qty": 1,
  "inputno": "会计主管",
  "detail": [
    {
      "pusercode": "P002",
      "pfullname ": "材料01",
      "qty": 10,
      "baseqty":1
    },
    {
      "pusercode": "P003",
      "pfullname ": "材料02",
      "qty": 20,
      "baseqty":1
    }
  ]
}
Prev
通用接口