API中心

  1. 库存管理
  2. 销售出库
返回

库存销售出库单保存即审批接口

接口所在U8C版本:U8 cloud3.6以及更高版本
详细描述:当数字类型字段值超过8位时,需要当字符串String类型传值,加上双引号,否则会因为数据转换出现误差。
API视频讲解API详情补丁列表常见问题参考
接口地址
请求方式
请求参数header
请求参数body
返回类型参数
代码示例
请求参数示例
正确返回示例
错误返回示例
接口地址:http://ip:port/u8cloud/api/ic/saleout/save/sign

参数填写指南

请求方式:POST

请求参数(header):

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

请求参数(body):

全量参数来源销售订单来源发货单来源销售发票带统计型自定义项带备注型自定义项自动拣货场景
参数名类型是否数组必填描述默认值示例值
GeneralBillVO
childrenvo库存销售出库单表体头VO
bonroadflagstring是否在途
castunitidstring辅计量单位
ccorrespondcodestring对应入库单号
ccorrespondtypestring对应入库单单据类型
cfirstbillbidstring源头单据表体ID
cfirstbillhidstring源头单据表头ID
cfirsttypestring源头单据类型
cinventoryidstring存货ID
cprojectidstring项目
crownostring行号(调用修改接口的时候需要传这个属性)
csignwastbidstring出入库单其它来源单据行id
csignwasthidstring出入库单其它来源单据id
csignwasttypestring出入库单其它来源类型
csourcebillbidstring来源单据表体序列号
csourcebillhidstring来源单据表头序列号
csourcetypestring来源单据类型
cvendoridstring供应商ID
dbizdatestring业务日期(出库日期)
ddeliverdatestring要求收货日期
dstandbydatestring备用日期(保质期)
dvalidatestring失效日期
flargessstring是否赠品(赠品标记)
hsldouble换算率
locator货位
cspaceidstring货位(货位仓的必传)
noutgrossnumdouble出库毛重数量
noutspaceassistnumdouble出库辅数量
noutspacenumdouble出库数量(货位仓的必传)
nmnydouble金额
noritaxmnystring税额
noutassistnumdouble实出辅数量
noutgrossnumstring出库毛重数量
noutnumdouble实出数量
npricedouble单价
nshouldoutassistnumdouble应出辅数量
nshouldoutnumdouble应出数量
ntaxmnystring含税金额
ntaxpricestring含税价格
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
serial序列号
vserialcodestring序列号(序列号管理的必填)
vbatchcodestring批次号
vcorrespondrownostring对应入库单行号
vfree1string自由项1
vfree10string自由项10
vfree2string自由项2
vfree3string自由项3
vfree4string自由项4
vfree5string自由项5
vfree6string自由项6
vfree7string自由项7
vfree8string自由项8
vfree9string自由项9
vnotebodystring行备注
vostatusstring调用修改时使用传update
vsignwastcodestring出入库单其它来源单据号
vsignwastrownostring出入库单其它来源单据行号
vsourcebillcodestring来源单据号
vsourcerownostring来源单据行号
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(文本类型用这个传值)
parentvo库存销售出库单表头VO
boutretflagstring是否退回
bsalecooppurstring销售出是否已协同生成采购入
cbizidstring业务员ID
cbiztypestring业务类型ID
ccustomeridstring客户
cdilivertypeidstring发运方式
cdispatcheridstring收发类别ID
cdptidstring部门ID
coperatoridstring制单人
ctrancustidstring承运商
cwarehouseidstring仓库ID
cwhsmanageridstring库管员ID
dbilldatestring单据日期
freplenishflagstring退货标志
isautopickstring是否自动拣货(Y/N)(5.0sp支持)
pk_calbodystring库存组织PK
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
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

请求参数示例:

来源销售订单来源发货单来源销售发票带统计型自定义项带备注型自定义项自动拣货场景

复制代码

{"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"
}