参数填写指南
请求参数(header):
参数填写指南| 参数名 | 必填 | 描述 | 默认值 |
|---|---|---|---|
| Content-Type | 是 | 请求体数据类型 | application/json |
| usercode | 是 | 用户 | |
| password | 是 | 密码 | |
| trantype | 是 | 翻译类型,按编码为code,不需要翻译为pk | code |
| 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 |
返回类型参数:
| 参数名 | 类型 | 是否数组 | 必填 | 描述 | 默认值 |
|---|
代码示例:
请求参数示例:
复制代码
{
"specialbillvo":[
{
"parentvo":{
"cspecialhid":"1001ZZ1000000000JHE1",
"pk_corp":"1000",
"cauditorid":"15268635139",
"cdispatcherid":"F1",
"cwhsmanagerid":"HI1709050005",
"coutdeptid":"100",
"coutbsor":"HI2007150043",
"cinwarehouseid":"1",
"coutwarehouseid":"2"
},
"childrenvo":[
{
"cspecialbid":"1001ZZ1000000000JHE2"
},
{
"cspecialbid":"1001ZZ1000000000JHE3"
}
]
}
]
}正确返回示例:
复制代码
{
"status":"success",
"data":"单据ZH2103250077签字成功",
"taskNumber":"202103250021"
}错误返回示例:
复制代码
{
"status":"falied",
"errorcode":"-32000",
"errormsg":"U8C返回信息:未查到单据,请确认查询条件是否可用。",
"stacktrace":"nc.vo.pub.BusinessException: 未查到单据,请确认查询条件是否可用。
u8c.impl.ic.m4n.action.M4NAPIQueryAction.queryDataBySql(M4NAPIQueryAction.java:168)
u8c.impl.ic.m4n.action.M4NAPIQueryAction.queryByWhere(M4NAPIQueryAction.java:59)
u8c.impl.ic.m4n.action.M4NAPIQueryAction.queryByWhere(M4NAPIQueryAction.java:1)
u8c.bs.action.query.AbstractQueryAction.query(AbstractQueryAction.java:546)
u8c.bs.action.query.AbstractQueryAction.queryVOS(AbstractQueryAction.java:164)
u8c.impl.ic.m4n.action.M4NAPISignAction.doAction(M4NAPISignAction.java:34)
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":"202103250022"
}