参数填写指南
请求参数(header):
参数填写指南| 参数名 | 必填 | 描述 | 默认值 |
|---|---|---|---|
| Content-Type | 是 | 请求体数据类型 | application/json |
| usercode | 是 | 用户 | |
| password | 是 | 密码 | |
| trantype | 否 | 翻译类型,按编码为code,不需要翻译为pk | |
| system | 是 | 系统参数 | |
| uniquekey | 否 | 幂等唯一key |
请求参数(body):
| 参数名 | 类型 | 是否数组 | 必填 | 描述 | 默认值 | 示例值 |
|---|---|---|---|---|---|---|
| GeneralBillVO | 否 | 是 | ||||
| childrenvo | 是 | 否 | 库存销售出库单表体头VO | |||
| bonroadflag | string | 否 | 否 | 是否在途 | ||
| castunitid | string | 否 | 否 | 辅计量单位 | ||
| ccorrespondcode | string | 否 | 否 | 对应入库单号 | ||
| ccorrespondtype | string | 否 | 否 | 对应入库单单据类型 | ||
| cfirstbillbid | string | 否 | 否 | 源头单据表体ID | ||
| cfirstbillhid | string | 否 | 否 | 源头单据表头ID | ||
| cfirsttype | string | 否 | 否 | 源头单据类型 | ||
| cinventoryid | string | 否 | 是 | 存货ID | ||
| cprojectid | string | 否 | 否 | 项目 | ||
| crowno | string | 否 | 否 | 行号(调用修改接口的时候需要传这个属性) | ||
| csignwastbid | string | 否 | 否 | 出入库单其它来源单据行id | ||
| csignwasthid | string | 否 | 否 | 出入库单其它来源单据id | ||
| csignwasttype | string | 否 | 否 | 出入库单其它来源类型 | ||
| csourcebillbid | string | 否 | 否 | 来源单据表体序列号 | ||
| csourcebillhid | string | 否 | 否 | 来源单据表头序列号 | ||
| csourcetype | string | 否 | 否 | 来源单据类型 | ||
| cvendorid | string | 否 | 否 | 供应商ID | ||
| dbizdate | string | 否 | 否 | 业务日期(出库日期) | ||
| ddeliverdate | string | 否 | 否 | 要求收货日期 | ||
| dstandbydate | string | 否 | 否 | 备用日期(保质期) | ||
| dvalidate | string | 否 | 否 | 失效日期 | ||
| flargess | string | 否 | 否 | 是否赠品(赠品标记) | ||
| hsl | double | 否 | 否 | 换算率 | ||
| locator | 是 | 否 | 货位 | |||
| cspaceid | string | 否 | 否 | 货位(货位仓的必传) | ||
| noutgrossnum | double | 否 | 否 | 出库毛重数量 | ||
| noutspaceassistnum | double | 否 | 否 | 出库辅数量 | ||
| noutspacenum | double | 否 | 否 | 出库数量(货位仓的必传) | ||
| nmny | double | 否 | 否 | 金额 | ||
| noritaxmny | string | 否 | 否 | 税额 | ||
| noutassistnum | double | 否 | 否 | 实出辅数量 | ||
| noutgrossnum | string | 否 | 否 | 出库毛重数量 | ||
| noutnum | double | 否 | 是 | 实出数量 | ||
| nprice | double | 否 | 否 | 单价 | ||
| nshouldoutassistnum | double | 否 | 否 | 应出辅数量 | ||
| nshouldoutnum | double | 否 | 是 | 应出数量 | ||
| ntaxmny | string | 否 | 否 | 含税金额 | ||
| ntaxprice | 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 | ||
| serial | 是 | 否 | 序列号 | |||
| vserialcode | string | 否 | 否 | 序列号(序列号管理的必填) | ||
| vbatchcode | string | 否 | 否 | 批次号 | ||
| vcorrespondrowno | 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 | ||
| vnotebody | string | 否 | 否 | 行备注 | ||
| vostatus | string | 否 | 否 | 调用修改时使用传update | ||
| vsignwastcode | string | 否 | 否 | 出入库单其它来源单据号 | ||
| vsignwastrowno | string | 否 | 否 | 出入库单其它来源单据行号 | ||
| vsourcebillcode | string | 否 | 否 | 来源单据号 | ||
| vsourcerowno | 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(文本类型用这个传值) | ||
| parentvo | 否 | 否 | 库存销售出库单表头VO | |||
| boutretflag | string | 否 | 否 | 是否退回 | ||
| bsalecooppur | string | 否 | 否 | 销售出是否已协同生成采购入 | ||
| cbizid | string | 否 | 否 | 业务员ID | ||
| cbiztype | string | 否 | 否 | 业务类型ID | ||
| ccustomerid | string | 否 | 否 | 客户 | ||
| cdilivertypeid | string | 否 | 否 | 发运方式 | ||
| cdispatcherid | string | 否 | 否 | 收发类别ID | ||
| cdptid | string | 否 | 否 | 部门ID | ||
| coperatorid | string | 否 | 是 | 制单人 | ||
| ctrancustid | string | 否 | 否 | 承运商 | ||
| cwarehouseid | string | 否 | 是 | 仓库ID | ||
| cwhsmanagerid | string | 否 | 否 | 库管员ID | ||
| dbilldate | string | 否 | 否 | 单据日期 | ||
| freplenishflag | string | 否 | 否 | 退货标志 | ||
| isautopick | string | 否 | 否 | 是否自动拣货(Y/N)(5.0sp支持) | ||
| pk_calbody | string | 否 | 是 | 库存组织PK | ||
| 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 | ||
| 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 |
返回类型参数:
| 参数名 | 类型 | 是否数组 | 必填 | 描述 | 默认值 |
|---|
代码示例:
请求参数示例:
复制代码
{"GeneralBillVO":[{"parentvo":{"cbiztype":"so02","ccustomerid":"2101123","coperatorid":"apicyc","cwarehouseid":"3101^C01","dbilldate":"2023-09-12","pk_calbody":"3101-_-K1001","pk_corp":"3101"},"childrenvo":[{"vsourcebillcode":"30TO4C100000000","vsourcerowno":"10","csourcetype":"30","noutnum":"0.01","nshouldoutnum":"0.01","cinventoryid":"IN0007"}]}]}
正确返回示例:
复制代码
{
"status": "success",
"data": "[{\"parentvo\":{\"pk_corp\":\"1004\",\"corp_code\":\"LYX\",\"corp_name\":\"刘云祥国电有限公司\",\"coperatorid\":\"0001A2100000000000Y8\",\"operator_code\":\"17055590069\",\"operator_name\":\"李昱郿\",\"cwarehouseid\":\"1004A2100000000001MC\",\"warehouseid_code\":\"2301^C01\",\"warehouseid_name\":\"C总仓\",\"pk_calbody\":\"1004A2100000000001M4\",\"calbody_code\":\"2301-_-K1001\",\"calbody_name\":\"A总-管\",\"ccustomerid\":\"0001A21000000001JARN\",\"customer_code\":\"2201\",\"customer_name\":\"尹茜网络科技有限公司\",\"daccountdate\":\"2023-07-17\",\"fbillflag\":\"3\",\"bsalecooppur\":false,\"dbilldate\":\"2023-07-17\",\"taccounttime\":\"2023-07-17 10:45:36\",\"tlastmoditime\":\"2023-07-17 10:45:35\",\"tmaketime\":\"2023-07-17 00:00:00\",\"ts\":\"2023-07-17 10:45:36\",\"freplenishflag\":false,\"vnote\":\"2021092101028#鲁H72M71\",\"vbillcode\":\"XC2307170005\",\"bassetcard\":false,\"bdirecttranflag\":false,\"cbilltypecode\":\"4C\",\"clastmodiid\":\"0001A2100000000000Y8\",\"lastmodi_code\":\"17055590069\",\"lastmodi_name\":\"李昱郿\",\"cregister\":\"0001A2100000000000Y8\",\"register_code\":\"17055590069\",\"register_name\":\"李昱郿\"},\"childrenvo\":[{\"cgeneralbid\":\"1004ZZ1000000002JS0R\",\"cgeneralhid\":\"1004ZZ1000000002JS0Q\",\"crowno\":\"10\",\"noutnum\":\"1.00000000\",\"cinventoryid\":\"0001A210000000001GOR\",\"inventory_code\":\"IN3001\",\"inventory_name\":\"西瓜\",\"invspec\":\"945\",\"pk_measdoc\":\"0001A210000000000KKZ\",\"measdoc _code\":\"20\",\"measdoc _name\":\"A千克\",\"bonroadflag\":false,\"flargess\":false,\"ts\":\"2023-07-17 10:45:35\",\"bsafeprice\":false,\"breturnprofit\":false,\"bsourcelargess\":false,\"bsupplyflag\":false,\"cbodybilltypecode\":\"4C\",\"cbodywarehouseid\":\"1004A2100000000001MC\",\"bodywarehouse_code\":\"2301^C01\",\"bodywarehouse_name\":\"C总仓\",\"dbizdate\":\"2023-07-17\",\"fassertcardflag\":false,\"btou8rm\":false}]}]",
"taskNumber": "202307170006"
}错误返回示例:
复制代码
{
"status": "falied",
"errorcode": "-32000",
"errormsg": "U8C返回信息:以下档案在U8cloud系统中根据公司或者账簿信息找不到,请检查!详细信息:1、档案类型:公司目录,档案编码:n;2、档案类型:仓库档案,公司编码:n,档案编码:ck01;3、档案类型:库存组织,公司编码:n,档案编码:1000;4、档案类型:客户档案,公司编码:n,档案编码:C1016;",
"stacktrace": "nc.vo.pub.BusinessException: 以下档案在U8cloud系统中根据公司或者账簿信息找不到,请检查!详细信息:1、档案类型:公司目录,档案编码:n;2、档案类型:仓库档案,公司编码:n,档案编码:ck01;3、档案类型:库存组织,公司编码:n,档案编码:1000;4、档案类型:客户档案,公司编码:n,档案编码:C1016;\r\nu8c.bs.translate.bp.AbstractTranBP.buildErrMessage(AbstractTranBP.java:180)\r\nu8c.bs.translate.bp.AbstractTranBP.translate(AbstractTranBP.java:96)\r\nu8c.bs.translate.bp.AggVOTranBP.translate(AggVOTranBP.java:33)\r\nu8c.bs.action.save.AbstractBatchSaveAggVOAction.translate(AbstractBatchSaveAggVOAction.java:56)\r\nu8c.bs.action.save.AbstractBatchSaveAggVOAction.translate(AbstractBatchSaveAggVOAction.java:1)\r\nu8c.bs.action.save.AbstractBatchSaveAction.save(AbstractBatchSaveAction.java:133)\r\nu8c.bs.action.save.AbstractBatchSaveAction.doAction(AbstractBatchSaveAction.java:76)\r\nu8c.bs.invoke.bp.JSONInvokeBP.invoke(JSONInvokeBP.java:80)\r\nu8c.impl.invoke.json.InvokeWithJSonImpl.invoke(InvokeWithJSonImpl.java:29)\r\nsun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)\r\nsun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)\r\nsun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)\r\njava.lang.reflect.Method.invoke(Method.java:498)\r\nnc.bs.framework.ejb.CMTProxyImpl.delegate(CMTProxyImpl.java:22)\r\nnc.itf.framework.ejb.CMTProxyEjbBean.delegate(CMTProxyEjbBean.java:44)\r\nnc.itf.framework.ejb.CMTProxy_Local.delegate(CMTProxy_Local.java:61)\r\nsun.reflect.GeneratedMethodAccessor72.invoke(Unknown Source)\r\nsun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)\r\njava.lang.reflect.Method.invoke(Method.java:498)\r\nnc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:56)\r\nnc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:34)\r\ncom.sun.proxy.$Proxy12.delegate(Unknown Source)\r\nnc.bs.framework.ejb.CMTEJBServiceHandler.invoke(CMTEJBServiceHandler.java:32)\r\ncom.sun.proxy.$Proxy37.invoke(Unknown Source)\r\nu8c.vo.oip.task.APITask.execute(APITask.java:99)\r\nu8c.impl.oip.task.APITaskServiceImpl.executeTask(APITaskServiceImpl.java:70)\r\nu8c.server.APIController.forWard(APIController.java:143)\r\nu8c.server.APIServletForJSON.doAction(APIServletForJSON.java:74)\r\nnc.bs.framework.server.extsys.ExtSystemInvokerServlet.doAction(ExtSystemInvokerServlet.java:170)\r\nnc.bs.framework.server.extsys.ExtSystemInvokerServlet.doPost(ExtSystemInvokerServlet.java:76)\r\njavax.servlet.http.HttpServlet.service(HttpServlet.java:665)\r\njavax.servlet.http.HttpServlet.service(HttpServlet.java:750)\r\norg.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:231)\r\norg.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)\r\norg.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)\r\norg.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)\r\norg.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)\r\nnc.bs.framework.server.LoggerServletFilter.doFilter(LoggerServletFilter.java:34)\r\norg.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)\r\norg.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)\r\norg.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:197)\r\norg.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:97)\r\norg.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:543)\r\norg.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:135)\r\norg.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:92)\r\norg.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:78)\r\norg.apache.catalina.valves.RemoteIpValve.invoke(RemoteIpValve.java:769)\r\norg.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:367)\r\norg.apache.coyote.http11.Http11Processor.service(Http11Processor.java:639)\r\norg.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:65)\r\norg.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:882)\r\norg.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1647)\r\norg.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:49)\r\norg.apache.tomcat.util.threads.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1191)\r\norg.apache.tomcat.util.threads.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:659)\r\norg.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)\r\njava.lang.Thread.run(Thread.java:748)\r\n",
"taskNumber": "202307170006"
}