U8C API中心

API中心

库存管理
盘点单

指导视频
对接方案模板
工具
游客

盘点单修改

接口所在U8C版本:U8 cloud5.0以及更高版本

详细描述:用于盘点单修改

API视频讲解API详情补丁列表常见问题参考

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/ic/special4r/update

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

参数名	必填	描述	默认值
Content-Type	是	请求体数据类型	application/json
usercode	是	用户
password	是	密码
trantype	是	翻译类型，按编码为code，不需要翻译为pk
system	是	系统参数

请求参数(body):

参数名	类型	是否数组	必填	描述
specialbillvo		是	是	盘点单聚合实体
childrenvo		是	是	库存特殊单据新增子实体
castunitid	string	否	否	辅计量单位
cinventoryid	string	否	是	存货id
crowno	string	否	否	行号（转库单必传）
cspaceid	string	否	否	货位
cspecialbid	string	否	否	子实体主键(形态转换单修改/签字时必填或盘点单修改接口当status不为2时必传)
cspecialhid	string	否	否	主实体主键
cvendorid	string	否	否	供应商id
dshldtransnum	string	否	否	应转数量（转库单必传）
dvalidate	string	否	否	失效日期
fbillrowflag	string	否	否	转换类型属性(2/3,转换前2,转换后3)
hsl	float	否	否	换算率
locator		是	否	出入库货位信息（仓库开启货位管理时必传）
cspaceid	string	否	是	货位id
ningrossnum	double	否	否	入库毛重数量
ninspaceassistnum	double	否	否	入库辅数量
ninspacenum	double	否	否	入库数量
noutgrossnum	double	否	否	出库毛重数量
noutspaceassistnum	double	否	否	出库辅数量
noutspacenum	double	否	否	出库数量
naccountastnum	double	否	否	账面辅数量
naccountgrsnum	double	否	否	账面毛重
naccountnum	double	否	否	账面数量
nadjustastnum	double	否	否	调整辅数量
nadjustgrsnum	double	否	否	调整毛重
nadjustnum	double	否	否	调整数量
nbarcodenum	double	否	否	条码数量
ncheckastnum	double	否	否	盘点辅数量
ncheckgrsnum	double	否	否	盘点毛重
nchecknum	double	否	否	盘点数量
nperiodastnum	double	否	否	期间业务辅数量
nperiodnum	double	否	否	期间业务数量
nplannedprice	double	否	否	计划单价
nprice	double	否	否	调整单价
nshldtransastnum	string	否	否	应转辅数量
pk_defdoc1	string	否	否	自定义项1（统计类）
pk_measdoc	string	否	是	主计量单位
status	string	否	否	单据状态(1-修改2-新增3-删除，默认2，盘点单修改接口用)
ts	string	否	否	时间戳
vbatchcode	double	否	否	批次号
vfree0	string	否	否	自由项
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vnote	string	否	否	行备注
vuserdef1	string	否	否	自定义项1（备注类型）
parentvo		否	是	库存特殊单据新增主实体
bccountflag	boolean	否	否	是否条码盘点
cauditor	string	否	否	审核人
cinbsrid	string	否	否	库管员
cindeptid	string	否	否	入库部门
cinwarehouseid	string	否	否	入库仓库（转库单必填）
clastmodiid	string	否	否	最后修改人
coperatorid	string	否	是	制单人
coutbsor	string	否	否	盘点人
coutdeptid	string	否	否	部门
coutwarehouseid	string	否	是	出库仓库（转库单必填）
cspecialhid	string	否	否	主实体主键（形态转换单修改/签字或盘点单修改接口时必填）
dbilldate	string	否	否	单据日期（如果自动生成出入库，所有出入库单的日期只与第一张形态转换的日期相同，建议日期不同的转换单分开进行传输）
denddate	string	否	否	盘点日期
fassistantflag	boolean	否	否	是否计算期间业务量
fbillflag	string	否	否	单据状态（盘点单传“10”，可以不经过前台取数即可审批）
icheckmode	string	否	否	盘点方式
pk_calbody	string	否	是	库存组织
pk_corp	string	否	是	公司
pk_defdoc1	string	否	否	自定义项1
pk_defdoc10	string	否	否	自定义项10
pk_defdoc11	string	否	否	自定义项11
pk_defdoc12	string	否	否	自定义项12
pk_defdoc13	string	否	否	自定义项13
pk_defdoc14	string	否	否	自定义项14
pk_defdoc15	string	否	否	自定义项15
pk_defdoc16	string	否	否	自定义项16
pk_defdoc17	string	否	否	自定义项17
pk_defdoc18	string	否	否	自定义项18
pk_defdoc19	string	否	否	自定义项19
pk_defdoc2	string	否	否	自定义项2
pk_defdoc20	string	否	否	自定义项20
pk_defdoc3	string	否	否	自定义项3
pk_defdoc4	string	否	否	自定义项4
pk_defdoc5	string	否	否	自定义项5
pk_defdoc6	string	否	否	自定义项6
pk_defdoc7	string	否	否	自定义项7
pk_defdoc8	string	否	否	自定义项8
pk_defdoc9	string	否	否	自定义项9
tlastmoditime	string	否	否	最后修改时间
tmaketime	string	否	否	制单时间
ts	string	否	否	时间戳
vadjuster	string	否	否	调整人
vbillcode	string	否	否	单据编号
vnote	string	否	否	备注
vuserdef1	string	否	否	自定义项1
vuserdef10	string	否	否	自定义项10
vuserdef11	string	否	否	自定义项11
vuserdef12	string	否	否	自定义项12
vuserdef13	string	否	否	自定义项13
vuserdef14	string	否	否	自定义项14
vuserdef15	string	否	否	自定义项15
vuserdef16	string	否	否	自定义项16
vuserdef17	string	否	否	自定义项17
vuserdef18	string	否	否	自定义项18
vuserdef19	string	否	否	自定义项19
vuserdef2	string	否	否	自定义项2
vuserdef20	string	否	否	自定义项20
vuserdef3	string	否	否	自定义项3
vuserdef4	string	否	否	自定义项4
vuserdef5	string	否	否	自定义项5
vuserdef6	string	否	否	自定义项6
vuserdef7	string	否	否	自定义项7
vuserdef8	string	否	否	自定义项8
vuserdef9	string	否	否	自定义项9

返回类型参数:

参数名	类型	是否数组	必填	描述	默认值

No Data

代码示例:

Java模板示例下载 C#模板示例下载

请求参数示例:

复制代码

{
	"specialbillvo": [{
		"parentvo": {
			"cspecialhid": "1008ZZ10000000001I0Q",
			"pk_corp": "2701",
			"coperatorid": "15268635139"
		},
		"childrenvo": [{
				"cspecialbid": "1008ZZ10000000001I0R",
                "pk_measdoc": "1",
				"status":"3"
			},
			{
				"cinventoryid": "IN0221",
				"pk_measdoc": "22"
			}
		]
	}]
}

正确返回示例:

复制代码

{
    "status": "success",
    "data": "[{\"parentvo\":{\"cspecialhid\":\"1008ZZ10000000001I0Q\",\"dbilldate\":\"2023-01-05\",\"bccountflag\":false,\"cbilltypecode\":\"4R\",\"coutwarehouseid\":\"1008A11000000000066H\",\"storcode\":\"2701^C01\",\"storname\":\"C总仓\",\"denddate\":\"2023-01-05\",\"iprintcount\":\"0\",\"fassistantflag\":false,\"fbillflag\":\"10\",\"icheckmode\":\"4\",\"pk_corp\":\"1008\",\"unitcode\":\"2701\",\"unitname\":\"白希星保险（集团）股份有限公司\",\"ts\":\"2023-01-31 14:17:54\",\"vbillcode\":\"PD2301050002\",\"clastmodiid\":\"0001A110000000000T1F\",\"user_code\":\"15268635139\",\"user_name\":\"白希星\",\"coperatorid\":\"0001A110000000000T1F\",\"tlastmoditime\":\"2023-01-31 14:17:54\"},\"childrenvo\":[{\"cspecialbid\":\"1008ZZ10000000001ISL\",\"cspecialhid\":\"1008ZZ10000000001I0Q\",\"cinventoryid\":\"1008ZZ100000000013CP\",\"invcode\":\"IN0221\",\"invname\":\"蟠桃1\",\"crowno\":\"50\",\"ts\":\"2023-01-31 14:17:54\",\"pk_measdoc\":\"0001A110000000001SX9\",\"shortname\":\"22\",\"measname\":\"斤\"},{\"cspecialbid\":\"1008ZZ10000000001I0S\",\"cspecialhid\":\"1008ZZ10000000001I0Q\",\"cinventoryid\":\"0001A11000000000TMC6\",\"invcode\":\"0002\",\"invname\":\"甜味苹果汁\",\"crowno\":\"20\",\"ts\":\"2023-01-05 16:45:29\",\"nadjustastnum\":0,\"nadjustnum\":2,\"nbarcodenum\":2,\"nchecknum\":2},{\"cspecialbid\":\"1008ZZ10000000001I0T\",\"cspecialhid\":\"1008ZZ10000000001I0Q\",\"cinventoryid\":\"0001A11000000000TMC7\",\"invcode\":\"IN0185\",\"invname\":\"分配是否带附件\",\"crowno\":\"30\",\"ts\":\"2023-01-05 16:45:29\",\"nadjustastnum\":0,\"nadjustnum\":3,\"nbarcodenum\":3,\"nchecknum\":3},{\"cspecialbid\":\"1008ZZ10000000001I0U\",\"cspecialhid\":\"1008ZZ10000000001I0Q\",\"hsl\":10,\"castunitid\":\"0001A110000000000STD\",\"shortname\":\"2\",\"measname\":\"公斤\",\"cinventoryid\":\"1008ZZ10000000001I0K\",\"invcode\":\"C001\",\"invname\":\"辅计量存货01\",\"crowno\":\"40\",\"ts\":\"2023-01-05 16:45:29\",\"nadjustastnum\":0.4,\"nadjustnum\":4,\"nbarcodenum\":4,\"ncheckastnum\":0.4,\"nchecknum\":4}]}]",
    "taskNumber": "202301310018"
}

错误返回示例:

复制代码

{
  "status": "falied",
  "errorcode": "-32000",
  "errormsg": "下面的档案无法翻译：档案类型：操作员,档案编码：18856956889,可能的原因是当前单据使用的公司没有启用单据所在的模块或者档案没有分配到当前使用的公司！"
 }