U8C API中心

API中心

库存管理
盘点单

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

盘点单新增

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

详细描述:用于盘点单新增

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(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

返回类型参数:

参数名	类型	是否数组	必填	描述
specialbillvo				盘点单实体_返回
childrenvo		是	否	形态转换单表体VO_返回
castunitid	string	否	否	辅计量单位
castunitname	string	否	否	辅计量单位
cfirstbillbid	string	否	否	源头单据子表主键
cfirstbillhid	string	否	否	源头单据主表主键
cfirsttype	string	否	否	源头单据类型
cinventorycode	string	否	否	存货编码
cinventoryid	string	否	否	存货id
cscode	string	否	否	货位编码
csname	string	否	否	货位名称
csourcebillbid	string	否	否	来源单据子表主键
csourcebillhid	string	否	否	来源单据主表主键
csourcetype	string	否	否	来源单据类型
cspaceid	string	否	否	货位
cspecialbid	string	否	否	表体ID
cspecialhid	string	否	否	表头ID
cvendorid	string	否	否	供应商
cwarehouseid	string	否	否	仓库
dshldtransnum	string	否	否	数量
dvalidate	string	否	否	失效日期
fbillrowflag	string	否	否	类型
hsl	string	否	否	hsl
invcode	string	否	否	存货编码编码
invname	string	否	否	存货编码名称
measname	string	否	否	辅计量单位名称
naccountastnum	string	否	否	账面辅数量
naccountnum	string	否	否	账面数量
nadjustastnum	string	否	否	调整辅数量
nadjustnum	string	否	否	调整数量
ncheckastnum	string	否	否	盘点辅数量
nchecknum	string	否	否	盘点数量
nprice	string	否	否	单价
nshldtransastnum	string	否	否	辅数量
pk_defdoc1	string	否	否	B-UDCPK1
pk_defdoc10	string	否	否	B-UDCPK10
pk_defdoc11	string	否	否	B-UDCPK11
pk_defdoc12	string	否	否	B-UDCPK12
pk_defdoc13	string	否	否	B-UDCPK13
pk_defdoc14	string	否	否	B-UDCPK14
pk_defdoc15	string	否	否	B-UDCPK15
pk_defdoc16	string	否	否	B-UDCPK16
pk_defdoc17	string	否	否	B-UDCPK17
pk_defdoc18	string	否	否	B-UDCPK18
pk_defdoc19	string	否	否	B-UDCPK19
pk_defdoc2	string	否	否	B-UDCPK2
pk_defdoc20	string	否	否	B-UDCPK20
pk_defdoc3	string	否	否	B-UDCPK3
pk_defdoc4	string	否	否	B-UDCPK4
pk_defdoc5	string	否	否	B-UDCPK5
pk_defdoc6	string	否	否	B-UDCPK6
pk_defdoc7	string	否	否	B-UDCPK7
pk_defdoc8	string	否	否	B-UDCPK8
pk_defdoc9	string	否	否	B-UDCPK9
shortname	string	否	否	辅计量单位编码
vbatchcode	string	否	否	批次号
vendor_code	string	否	否	供应商编码
vendor_name	string	否	否	供应商名称
vfree1	string	否	否	自由项1
vfree10	string	否	否	自由项10
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vfree6	string	否	否	自由项6
vfree7	string	否	否	自由项7
vfree8	string	否	否	自由项8
vfree9	string	否	否	自由项9
vsourcebillcode	string	否	否	来源单据号
warehousecode	string	否	否	仓库编码
warehousename	string	否	否	仓库名称
parentvo		是	否	形态转换单表头VO_返回
bccountflag	string	否	否	是否条码盘点
cauditorid	string	否	否	审核人
cbilltypecode	string	否	否	形态转换单据类型
cdispatcherid	string	否	否	收发类别
cinbsrid	string	否	否	经手人
cindeptid	string	否	否	入库部门
cinwarehouseid	string	否	否	入库仓库
clastmodiid	string	否	否	最后修改人
coperatorid	string	否	否	制单人
coutbsor	string	否	否	业务员
coutdeptid	string	否	否	部门
coutwarehouseid	string	否	否	仓库
cshlddiliverdate	string	否	否	应发货日期
cspecialhid	string	否	否	表头ID
cwhsmanagerid	string	否	否	库管员
dbilldate	string	否	否	单据日期
deptcode	string	否	否	入库部门编码
deptname	string	否	否	入库部门名称
dispatcher_code	string	否	否	收发类别编码
dispatcher_name	string	否	否	收发类别名称
fassistantflag	string	否	否	是否计算期间业务量
fbillflag	string	否	否	单据状态
icheckmode	string	否	否	盘点方式
iprintcount	string	否	否	打印次数
pk_corp	string	否	否	公司
pk_defdoc1	string	否	否	H-UDCPK1
pk_defdoc10	string	否	否	H-UDCPK10
pk_defdoc11	string	否	否	H-UDCPK11
pk_defdoc12	string	否	否	H-UDCPK12
pk_defdoc13	string	否	否	H-UDCPK13
pk_defdoc14	string	否	否	H-UDCPK14
pk_defdoc15	string	否	否	H-UDCPK15
pk_defdoc16	string	否	否	H-UDCPK16
pk_defdoc17	string	否	否	H-UDCPK17
pk_defdoc18	string	否	否	H-UDCPK18
pk_defdoc19	string	否	否	H-UDCPK19
pk_defdoc2	string	否	否	H-UDCPK2
pk_defdoc20	string	否	否	H-UDCPK20
pk_defdoc3	string	否	否	H-UDCPK3
pk_defdoc4	string	否	否	H-UDCPK4
pk_defdoc5	string	否	否	H-UDCPK5
pk_defdoc6	string	否	否	H-UDCPK6
pk_defdoc7	string	否	否	H-UDCPK7
pk_defdoc8	string	否	否	H-UDCPK8
pk_defdoc9	string	否	否	H-UDCPK9
psncode	string	否	否	经手人编码
psnname	string	否	否	经手人名称
storcode	string	否	否	入库仓库编码
storname	string	否	否	入库仓库名称
tlastmoditime	string	否	否	最后修改时间
tmaketime	string	否	否	制单时间
ts	string	否	否	时间戳
unitcode	string	否	否	公司编码
unitname	string	否	否	公司名称
user_code	string	否	否	审核人编码
user_name	string	否	否	审核人名称
vadjuster	string	否	否	调整人
vbillcode	string	否	否	单据号
vnote	string	否	否	备注
vshldarrivedate	string	否	否	应到货日期
whsmanager_code	string	否	否	库管员编码
whsmanager_name	string	否	否	库管员名称

代码示例:

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

请求参数示例:

最简示例货位示例

复制代码

{
    "specialbillvo": [
        {
            "parentvo": {
                "coutwarehouseid": "ck01", 
                "pk_corp": "100101", 
                "coperatorid": "14452369855"
            }, 
            "childrenvo": [
                {
                    "cinventoryid": "030100", 
                    "pk_measdoc": "02"
                }, 
                {
                    "cinventoryid": "030101", 
                    "pk_measdoc": "03"
                }
            ]
        }
    ]
}

正确返回示例:

复制代码

{
    "status": "success",
    "data": [
        {
            "parentvo": {
                "cspecialhid": "1003ZZ10000000000Q8H",
                "dbilldate": "2018-11-12",
                "bccountflag": false,
                "cbilltypecode": "4R",
                "coutwarehouseid": "10031110000000000335",
                "storcode": "ck01",
                "storname": "天海北京分公司仓库",
                "iprintcount": "0",
                "fassistantflag": false,
                "fbillflag": "2",
                "pk_corp": "1003",
                "unitcode": "100101",
                "unitname": "天海北京分公司",
                "ts": "2018-11-12 09:47:16",
                "vbillcode": "PDBJ1811120003",
                "clastmodiid": "0001ZZ10000000006JE5",
                "user_code": "19913144131",
                "user_name": "Tom",
                "coperatorid": "0001ZZ10000000006JE5",
                "tlastmoditime": "2018-11-12 09:47:16",
                "tmaketime": "2018-11-12 09:47:16"
            },
            "childrenvo": [
                {
                    "cspecialbid": "1003ZZ10000000000Q8I",
                    "cspecialhid": "1003ZZ10000000000Q8H",
                    "cinventoryid": "00011110000000000EPI",
                    "invcode": "030100",
                    "invname": "耐用文具",
                    "crowno": "10",
                    "ts": "2018-11-12 09:47:17",
                    "pk_measdoc": "000111100000000006J1",
                    "shortname": "02",
                    "measname": "套"
                },
                {
                    "cspecialbid": "1003ZZ10000000000Q8J",
                    "cspecialhid": "1003ZZ10000000000Q8H",
                    "cinventoryid": "00011110000000000EPJ",
                    "invcode": "030101",
                    "invname": "订书器",
                    "crowno": "20",
                    "ts": "2018-11-12 09:47:17",
                    "pk_measdoc": "000111100000000006J2",
                    "shortname": "03",
                    "measname": "个"
                }
            ]
        }
    ]
}

错误返回示例:

复制代码

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