API中心

  1. 销售管理
  2. 销售订单
返回

销售订单保存即审批

接口所在U8C版本:U8 cloud3.1以及更高版本
详细描述:1、当数字类型字段值超过8位时。需要当字符串String类型传值，否则会因为数据转换出现误差。2、date日期型字段传参格式为2023-10-23，time时间型字段传参格式为2023-10-23 00:00:00。<br />  
API视频讲解API详情补丁列表常见问题参考
接口地址
请求方式
请求参数header
请求参数body
返回类型参数
代码示例
请求参数示例
正确返回示例
错误返回示例
接口地址:http://ip:port/u8cloud/api/so/saleorder/saveapprove

参数填写指南

请求方式:POST

请求参数(header):

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

请求参数(body):

全量参数自制最简来源预订单来源销售合同来源销售报价单借出转销售-来源库存借出单带统计型自定义项带备注型自定义项
参数名类型是否数组必填描述默认值示例值
saleorder否是
childrenvo是是销售订单子实体
blargessflagdouble否否是否赠品
cadvisecalbodyidstring否否发货库存组织（填写此属性需要同时填写【发货公司】）
cbatchidstring否否批次号
cbodywarehouseidstring否否发货仓库（填写此属性需要同时填写【发货公司】）
cconsigncorpidstring否否发货公司
ccurrencytypeidstring否否币种
cinventoryidstring否是存货
corder_bidstring否否明细主键（修改/删除明细时必填）
cpackunitidstring否否辅单位
cprojectidstring否否项目
crecaddrnodestring否否收货地点
creccalbodyidstring否否收货库存组织
creceiptareaidstring否否收货地区
creceiptcorpidstring否否收货单位
creceipttypestring否否来源单据类型
crecwareidstring否否收货仓库
crownostring否否行号
csourcebillbodyidstring否否来源单据行id
csourcebillcodestring否否来源单据号
csourcebillidstring否否来源单据id
dconsigndatestring否否计划发货日期
ddeliverdatestring否否要求收货日期
frownotestring否否行备注
nestbalancenumberstring否否累计暂估应收数量
nexchangeotobratedouble否否折本汇率
nitemdiscountratedouble否否单品折扣
nnumberdouble否是数量
noriginalcurdiscountmnydouble否否折扣额
noriginalcurmnydouble否否无税金额
noriginalcurnetpricedouble否否无税净价
noriginalcurpricedouble否是无税单价
noriginalcursummnydouble否否价税合计（3.2及其之前此字段必填，想不必填提DSP工单）
noriginalcurtaxmnydouble否否税额
noriginalcurtaxnetpricedouble否否含税净价
noriginalcurtaxpricestring否否含税单价
npacknumberdouble否否辅数量
ntaxratedouble否否税率
ntotalbalancenumberstring否否累计应收确认数量
ntotalinventorynumberstring否否累计出库数量
ntotalinvoicenumberstring否否累计开票数量
ntotalreceivenumberstring否否累计发货数量
ntotlbalcostnumstring否否累计成本结算数量
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（统计类型传）
vdef1string否否自定义项1（除统计类型外用这个字段）
vdef10string否否自定义项10（除统计类型外用这个字段）
vdef11string否否自定义项11（除统计类型外用这个字段）
vdef12string否否自定义项12（除统计类型外用这个字段）
vdef13string否否自定义项13（除统计类型外用这个字段）
vdef14string否否自定义项14（除统计类型外用这个字段）
vdef15string否否自定义项15（除统计类型外用这个字段）
vdef16string否否自定义项16（除统计类型外用这个字段）
vdef17string否否自定义项17（除统计类型外用这个字段）
vdef18string否否自定义项18（除统计类型外用这个字段）
vdef19string否否自定义项19（除统计类型外用这个字段）
vdef2string否否自定义项2（除统计类型外用这个字段）
vdef20string否否自定义项20（除统计类型外用这个字段）
vdef3string否否自定义项3（除统计类型外用这个字段）
vdef4string否否自定义项4（除统计类型外用这个字段）
vdef5string否否自定义项5（除统计类型外用这个字段）
vdef6string否否自定义项6（除统计类型外用这个字段）
vdef7string否否自定义项7（除统计类型外用这个字段）
vdef8string否否自定义项8（除统计类型外用这个字段）
vdef9string否否自定义项9（除统计类型外用这个字段）
vfree1string否否自由项1
vfree2string否否自由项2
vfree3string否否自由项3
vfree4string否否自由项4
vfree5string否否自由项5
vostatusstring否否状态（调用修改接口时使用，传值：修改时update、删除时delete、新增时new）
vreceiveaddressstring否否收货地址
vsourcerownostring否否来源单据行号
parentvo否是销售订单主实体
bretinvflagstring否否退货标记（Y / N）
cbiztypestring否是业务流程
ccalbodyidstring否是库存组织
ccurrencytypeidstring否否币种（5.0sp开始支持）
ccustomeridstring否是客户
cdeptidstring否是部门
cemployeeidstring否否业务员
cfreecustidstring否否散户
coperatoridstring否是制单人
creceiptareaidstring否否收货地区
creceiptcorpidstring否否开票单位
creceiptcustomeridstring否否收货单位
csalecorpidstring否是销售组织
ctermprotocolidstring否否收款协议
ctransmodeidstring否否运输方式
cwarehouseidstring否否仓库
dapprovedatestring否否审核日期（3.6版本开始支持））
dbilldatestring否否单据日期
ndiscountratedouble否否整单折扣
nheadsummnystring否否整单价税合计
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
vdef1string否否自定义项1（备注型自定义项用此传值）
vdef10string否否自定义项10（备注型自定义项用此传值）
vdef11string否否自定义项11（备注型自定义项用此传值）
vdef12string否否自定义项12（备注型自定义项用此传值）
vdef13string否否自定义项13（备注型自定义项用此传值）
vdef14string否否自定义项14（备注型自定义项用此传值）
vdef15string否否自定义项15（备注型自定义项用此传值）
vdef16string否否自定义项16（备注型自定义项用此传值）
vdef17string否否自定义项17（备注型自定义项用此传值）
vdef18string否否自定义项18（备注型自定义项用此传值）
vdef19string否否自定义项19（备注型自定义项用此传值）
vdef2string否否自定义项2（备注型自定义项用此传值）
vdef20string否否自定义项20（备注型自定义项用此传值）
vdef3string否否自定义项3（备注型自定义项用此传值）
vdef4string否否自定义项4（备注型自定义项用此传值）
vdef5string否否自定义项5（备注型自定义项用此传值）
vdef6string否否自定义项6（备注型自定义项用此传值）
vdef7string否否自定义项7（备注型自定义项用此传值）
vdef8string否否自定义项8（备注型自定义项用此传值）
vdef9string否否自定义项9（备注型自定义项用此传值）
vnotestring否否备注
vreceiptcodestring否否单据号
vreceiveaddressstring否否收货地址

返回类型参数:

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

代码示例:

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

请求参数示例:

自制最简来源预订单来源销售合同来源销售报价单借出转销售-来源库存借出单带统计型自定义项带备注型自定义项

复制代码

{"saleorder":[{"childrenvo":[{"cinventoryid":"IN0007","nnumber":"1000","noriginalcurprice":"33"}],"parentvo":{"cbiztype":"so02","ccalbodyid":"3101-_-K1001","ccustomerid":"2101123","csalecorpid":"1","cdeptid":"3101-_-2001","coperatorid":"apicyc","pk_corp":"3101"}}]}

正确返回示例:

复制代码

{"status":"success","data":"[{\"parentvo\":{\"pk_corp\":\"1012\",\"corp_code\":\"3101\",\"corp_name\":\"cyc交通建设集团有限公司\",\"cbiztype\":\"1012A21000000000003Q\",\"biztype_code\":\"so02\",\"biztype_name\":\"普通销售\",\"ccustomerid\":\"0001A11000000003GAH5\",\"customer_code\":\"2101123\",\"customer_name\":\"徐老板信息技术有限公司\",\"csalecorpid\":\"0001A21000000000YC08\",\"salecorp_code\":\"1\",\"salecorp_name\":\"1\",\"ccalbodyid\":\"1012A2100000000001LI\",\"calbody_code\":\"3101-_-K1001\",\"calbody_name\":\"A总-管\",\"coperatorid\":\"0001A2100000000000YV\",\"operator_code\":\"apicyc\",\"operator_name\":\"cyc\",\"cdeptid\":\"1012A2100000000001LA\",\"dept_code\":\"3101-_-2001\",\"dept_name\":\"A销售-省内\",\"vreceiptcode\":\"SO23082100002\",\"dbilldate\":\"2023-08-21\",\"dmakedate\":\"2023-08-21\",\"dbilltime\":\"2023-08-21 11:29:31\",\"dapprovedate\":\"2023-08-21\",\"daudittime\":\"2023-08-21 11:29:32\",\"dmoditime\":\"2023-08-21 11:29:31\",\"capproveid\":\"0001A2100000000000YV\",\"approver_code\":\"apicyc\",\"approver_name\":\"cyc\",\"creceiptcustomerid\":\"0001A11000000003GAH5\",\"receiptcustomer_code\":\"2101123\",\"receiptcustomer_name\":\"徐老板信息技术有限公司\",\"creceiptcorpid\":\"0001A11000000003GAH5\",\"receiptcorp_code\":\"2101123\",\"receiptcorp_name\":\"徐老板信息技术有限公司\",\"ndiscountrate\":\"100\",\"csaleid\":\"1012ZZ10000000001FP9\",\"fstatus\":\"1\",\"nheadsummny\":\"37290.00000000\",\"ccurrencytypeid\":\"00010000000000000001\",\"ccurrencyid_code\":\"CNY\",\"ccurrencyid_name\":\"人民币\"},\"childrenvo\":[{\"cinventoryid\":\"0001A210000000001H35\",\"inventory_code\":\"IN0007\",\"inventory_name\":\"TEST11111\",\"invspec\":\"123\",\"invtype\":\"4\",\"nnumber\":\"1000\",\"noriginalcursummny\":\"37290.000000\",\"cunitid\":\"0001A2100000000003DG\",\"unit_code\":\"1\",\"unit_name\":\"件1\",\"creceiptcorpid\":\"0001A11000000003GAH5\",\"receiptcorp_code\":\"2101123\",\"receiptcorp_name\":\"徐老板信息技术有限公司\",\"blargessflag\":false,\"noriginalcurprice\":\"33\",\"crowno\":\"10\",\"ntaxrate\":\"13.00000000\",\"noriginalcurtaxprice\":\"37.29\",\"noriginalcurmny\":\"33000.000000\",\"noriginalcurtaxmny\":\"4290.000000\",\"ndiscountrate\":\"100\",\"nitemdiscountrate\":\"100\",\"noriginalcurnetprice\":\"33.00\",\"noriginalcurtaxnetprice\":\"37.29\",\"noriginalcurdiscountmny\":\"0.00000000\",\"dconsigndate\":\"2023-08-21\",\"ddeliverdate\":\"2023-08-21\",\"cquoteunitid\":\"0001A2100000000003DG\",\"cquoteunit_code\":\"1\",\"cquoteunit_name\":\"件1\",\"csaleid\":\"1012ZZ10000000001FP9\",\"corder_bid\":\"1012ZZ10000000001FPA\",\"nexchangeotobrate\":\"1.00000000\",\"ccurrencytypeid\":\"00010000000000000001\",\"ccurrencyid_code\":\"CNY\",\"ccurrencyid_name\":\"人民币\",\"cinvbasdocid\":\"0001ZZ10000000000DX1\",\"cadvisecalbodyid\":\"1012A2100000000001LI\",\"advisecalbody_code\":\"3101-_-K1001\",\"advisecalbody_name\":\"A总-管\",\"cconsigncorpid\":\"1012\",\"consigncorp_code\":\"3101\",\"consigncorp_name\":\"cyc交通建设集团有限公司\"}]}]","taskNumber":"202308210003"}

错误返回示例:

复制代码

{
status: "falied",
errorcode: "",
errormsg: "nc.vo.pub.BusinessException: 传入数据有的字段为空！第1条数据：表头：[业务流, 制单人, 客户, 公司]第1行表体：[存货, 数量]"
}