API中心

  1. 库存管理
  2. 形态转换单
返回

形态转换单新增即签字

接口所在U8C版本:U8 cloud3.5以及更高版本
详细描述:用于形态转换单新增即签字
API视频讲解API详情补丁列表常见问题参考
接口地址
请求方式
请求参数header
请求参数body
返回类型参数
代码示例
请求参数示例
正确返回示例
错误返回示例
接口地址:http://ip:port/u8cloud/api/ic/special4n/insertsign

参数填写指南

请求方式:POST

请求参数(header):

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

请求参数(body):

参数名类型是否数组必填描述默认值
specialbillvo形态转换单实体
childrenvo形态转换单子实体VO
castunitidstring辅计量单位
cfirstbillbidstring源头单据子表主键
cfirstbillhidstring源头单据主表主键
cfirsttypestring源头单据类型
cinventoryidstring存货id
csourcebillbidstring来源单据子表主键
csourcebillhidstring来源单据主表主键
csourcetypestring来源单据类型
cspaceidstring货位
cspecialbidstring子实体主键(形态转换单修改/签字时必填)
cspecialhidstring主实体主键
cvendoridstring供应商
cwarehouseidstring仓库
dshldtransnumstring数量
dvalidatestring失效日期
fbillrowflagstring转换类型属性(2/3,转换前2,转换后3)
hslstring换算率
naccountastnumstring账面辅数量
naccountnumstring账面数量
nadjustastnumstring调整辅数量
nadjustnumstring调整数量
ncheckastnumstring盘点辅数量
nchecknumstring盘点数量
npricestring单价
nshldtransastnumstring辅数量
pk_defdoc1stringB-UDCPK1
pk_defdoc10stringB-UDCPK10
pk_defdoc11stringB-UDCPK11
pk_defdoc12stringB-UDCPK12
pk_defdoc13stringB-UDCPK13
pk_defdoc14stringB-UDCPK14
pk_defdoc15stringB-UDCPK15
pk_defdoc16stringB-UDCPK16
pk_defdoc17stringB-UDCPK17
pk_defdoc18stringB-UDCPK18
pk_defdoc19stringB-UDCPK19
pk_defdoc2stringB-UDCPK2
pk_defdoc20stringB-UDCPK20
pk_defdoc3stringB-UDCPK3
pk_defdoc4stringB-UDCPK4
pk_defdoc5stringB-UDCPK5
pk_defdoc6stringB-UDCPK6
pk_defdoc7stringB-UDCPK7
pk_defdoc8stringB-UDCPK8
pk_defdoc9stringB-UDCPK9
vbatchcodestring批次号
vfree1string自由项1
vfree10string自由项10
vfree2string自由项2
vfree3string自由项3
vfree4string自由项4
vfree5string自由项5
vfree6string自由项6
vfree7string自由项7
vfree8string自由项8
vfree9string自由项9
vsourcebillcodestring来源单据号
parentvo形态转换单主实体VO
bccountflagboolean是否条码盘点
cauditorstring审核人
cinbsridstring库管员
cindeptidstring入库部门
cinwarehouseidstring入库仓库(转库单必填)
clastmodiidstring最后修改人
coperatoridstring制单人
coutbsorstring盘点人
coutdeptidstring部门
coutwarehouseidstring出库仓库(转库单必填)
cspecialhidstring主实体主键(形态转换单修改/签字或盘点单修改接口时必填)
dbilldatestring单据日期(如果自动生成出入库,所有出入库单的日期只与第一张形态转换的日期相同,建议日期不同的转换单分开进行传输)
denddatestring盘点日期
fassistantflagboolean是否计算期间业务量
fbillflagstring单据状态(盘点单传“10”,可以不经过前台取数即可审批)
icheckmodestring盘点方式
pk_calbodystring库存组织
pk_corpstring公司
pk_defdoc1string自定义项1
pk_defdoc10string自定义项10
pk_defdoc11string自定义项11
pk_defdoc12string自定义项12
pk_defdoc13string自定义项13
pk_defdoc14string自定义项14
pk_defdoc15string自定义项15
pk_defdoc16string自定义项16
pk_defdoc17string自定义项17
pk_defdoc18string自定义项18
pk_defdoc19string自定义项19
pk_defdoc2string自定义项2
pk_defdoc20string自定义项20
pk_defdoc3string自定义项3
pk_defdoc4string自定义项4
pk_defdoc5string自定义项5
pk_defdoc6string自定义项6
pk_defdoc7string自定义项7
pk_defdoc8string自定义项8
pk_defdoc9string自定义项9
tlastmoditimestring最后修改时间
tmaketimestring制单时间
tsstring时间戳
vadjusterstring调整人
vbillcodestring单据编号
vnotestring备注
vuserdef1string自定义项1
vuserdef10string自定义项10
vuserdef11string自定义项11
vuserdef12string自定义项12
vuserdef13string自定义项13
vuserdef14string自定义项14
vuserdef15string自定义项15
vuserdef16string自定义项16
vuserdef17string自定义项17
vuserdef18string自定义项18
vuserdef19string自定义项19
vuserdef2string自定义项2
vuserdef20string自定义项20
vuserdef3string自定义项3
vuserdef4string自定义项4
vuserdef5string自定义项5
vuserdef6string自定义项6
vuserdef7string自定义项7
vuserdef8string自定义项8
vuserdef9string自定义项9

返回类型参数:

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

请求参数示例:

复制代码

{
    "specialbillvo":[
        {
            "parentvo":{
                "pk_corp":"82906",
                "coperatorid":"demo1"
            },
            "childrenvo":[
                {
                    "cinventoryid":"01001",
                    "vbatchcode":"22",
                    "fbillrowflag":"2",
                    "dshldtransnum":"1",
                    "cwarehouseid":"01"
                },
                {
                    "cinventoryid":"01002",
                    "vbatchcode":"11",
                    "fbillrowflag":"3",
                    "dshldtransnum":"1",
                    "cwarehouseid":"02"
                }
            ]
        }
    ]
}

正确返回示例:

复制代码

{
    "status":"success",
    "data":"[{"parentvo":{"cspecialhid":"1064ZZ1000000001G63N","cauditorid":"zzzzvx0y3x8wascbixzn","user_code":"demo1","user_name":"demo1","cbilltypecode":"4N","coperatorid":"zzzzvx0y3x8wascbixzn","vshldarrivedate":"2021-03-25","dbilldate":"2021-03-25","fbillflag":"3","pk_corp":"1064","unitcode":"82906","unitname":"新材料股份有限公司","vbillcode":"ZH2103250078","ts":"2021-03-25 15:12:16","fassistantflag":false,"icheckmode":"4","iprintcount":"0","clastmodiid":"zzzzvx0y3x8wascbixzn","tlastmoditime":"2021-03-25 00:00:00","tmaketime":"2021-03-25 15:12:16","bccountflag":false},"childrenvo":[{"cspecialbid":"1064ZZ1000000001G63O","cspecialhid":"1064ZZ1000000001G63N","cinventoryid":"1064A1100000000072KI","invcode":"01001","invname":"ODA","cwarehouseid":"1064A110000000005T7X","warehousecode":"01","warehousename":"原料库","dshldtransnum":1,"fbillrowflag":"2","vbatchcode":"22","ts":"2021-03-25 15:12:16","crowno":"10"},{"cspecialbid":"1064ZZ1000000001G63P","cspecialhid":"1064ZZ1000000001G63N","cinventoryid":"1064A1100000000072KO","invcode":"01002","invname":"PMDA","cwarehouseid":"1064A110000000005T7Y","warehousecode":"02","warehousename":"五金库","dshldtransnum":1,"fbillrowflag":"3","vbatchcode":"11","ts":"2021-03-25 15:12:16","crowno":"20"}]}]",
    "taskNumber":"202103250023"
}

错误返回示例:

复制代码

{
    "status":"falied",
    "errorcode":"",
    "errormsg":"U8C返回信息:单据ZH2103250080签字失败[以下表体行中的批次号不存在,不允许出库: 
行:10  批次号:GS0099
]
",
    "stacktrace":"nc.vo.pub.BusinessException: 单据ZH2103250080签字失败[以下表体行中的批次号不存在,不允许出库: 
行:10  批次号:GS0099
]

u8c.impl.ic.m4n.action.M4NAPIInsertSignAction.save(M4NAPIInsertSignAction.java:45)
u8c.impl.ic.m4n.action.M4NAPIInsertSignAction.save(M4NAPIInsertSignAction.java:1)
u8c.bs.action.save.AbstractBatchSaveAction.businessProcess(AbstractBatchSaveAction.java:58)
u8c.bs.action.save.AbstractBatchSaveAggVOAction.businessProcess(AbstractBatchSaveAggVOAction.java:27)
u8c.bs.action.save.AbstractBatchSaveAggVOAction.businessProcess(AbstractBatchSaveAggVOAction.java:1)
u8c.bs.action.save.AbstractBatchSaveAction.save(AbstractBatchSaveAction.java:142)
u8c.bs.action.save.AbstractBatchSaveAction.doAction(AbstractBatchSaveAction.java:70)
u8c.bs.invoke.bp.JSONInvokeBP.invoke(JSONInvokeBP.java:80)
u8c.impl.invoke.json.InvokeWithJSonImpl.invoke(InvokeWithJSonImpl.java:29)
sun.reflect.GeneratedMethodAccessor220.invoke(Unknown Source)
sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
java.lang.reflect.Method.invoke(Method.java:606)
nc.bs.framework.ejb.CMTProxyImpl.delegate(CMTProxyImpl.java:22)
nc.itf.framework.ejb.CMTProxyEjbBean.delegate(CMTProxyEjbBean.java:44)
nc.itf.framework.ejb.CMTProxy_Local.delegate(CMTProxy_Local.java:61)
sun.reflect.GeneratedMethodAccessor52.invoke(Unknown Source)
sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
java.lang.reflect.Method.invoke(Method.java:606)
nc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:56)
nc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:34)
com.sun.proxy.$Proxy11.delegate(Unknown Source)
nc.bs.framework.ejb.CMTEJBServiceHandler.invoke(CMTEJBServiceHandler.java:32)
com.sun.proxy.$Proxy35.invoke(Unknown Source)
u8c.vo.oip.task.APITask.execute(APITask.java:93)
u8c.impl.oip.task.APITaskServiceImpl.executeTask(APITaskServiceImpl.java:68)
u8c.server.APIController.forWard(APIController.java:137)
u8c.server.APIServletForJSON.doAction(APIServletForJSON.java:27)
nc.bs.framework.server.extsys.ExtSystemInvokerServlet.doAction(ExtSystemInvokerServlet.java:170)
nc.bs.framework.server.extsys.ExtSystemInvokerServlet.doPost(ExtSystemInvokerServlet.java:76)
javax.servlet.http.HttpServlet.service(HttpServlet.java:641)
javax.servlet.http.HttpServlet.service(HttpServlet.java:722)
org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:303)
org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)
org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)
org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
nc.bs.framework.server.LoggerServletFilter.doFilter(LoggerServletFilter.java:34)
org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)
org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:219)
org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:110)
org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:492)
org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:165)
org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:104)
org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:116)
org.apache.catalina.valves.RemoteIpValve.invoke(RemoteIpValve.java:755)
org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:452)
org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1201)
org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:654)
org.apache.tomcat.              util.net.JIoEndpoint$SocketProcessor.run(JIoEndpoint.java:317)
java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)
java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615)
org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
java.lang.Thread.run(Thread.java:745)
",
    "taskNumber":"202103250025"
}