基础资料新增接口
调用方法
地址说明
通过获取程序Api地址接口返回参数中ApiServerAddress的值
调用方法
POSTContentType: 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签名规则
- 将上述参数中除了sign以外的所有参数,根据参数名按照字母排序,以Key+Value的形式拼接字符串。
- 字符串拼接后在结尾加上SignKey。(SignKey获取方法见:获取接口所需SignStr接口)
- 将这个最终拼接成的字符串通过MD5加密,取32位小写。
MD5加密前字符串示例
actiontypemodifyapiparam7/eAVT1NN2MtBY+MkAylEBVN/FsnC9BL4IzSHtHyt+2s+jAZRVqfMAwzFgSudBH3eDau916Vd6aNEFxve2ZoYey1Zvi+Vp8xb7VrAnJNbCs=apitypebaseinfobaseinfodata{"usercode":"A0023","fullname":"A0023","gpfullname":"库存商品","inputno":"会计人"}basetypeptypedbnameM7215API测试interiorapi1managenameGraspCMServerApi.dllmobile0rec0serviceid02020cmgmsignkeyappkey@#986
PostMan传参示例![]()
返回参数
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 小于等于0表示失败 成功时会返回基本信息的唯一rec |
| message | string | 单据过账消息 成功还是失败都会返回消息 |
| response | json数组 | 失败时会返回具体的错误信息 |
错误信息response
| 参数名 | 类型 | 说明 |
|---|---|---|
| errormessage | string | 错误信息 |
返回参数示例
{
"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 | 税号 |
| 否 | 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 | 税号 |
| 否 | 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 | 否 | string | bom类别编号 |
| parfullname | 否 | string | bom类别全名 不传则默认为全部清单 |
| usercode | 是 | string | bom编号 |
| fullname | 是 | string | bom全名 |
| 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
}
]
}