API中心

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

销售订单修改

接口所在U8C版本:U8 cloud3.0以及更高版本
详细描述:表体行号crowno必填，根据行号查到原单据的表体行，然后只需传要修改的字段。表体行状态vostatus必填，修改传update，删除行传delete。
API视频讲解API详情补丁列表常见问题参考
接口地址
请求方式
请求参数header
请求参数body
返回类型参数
代码示例
请求参数示例
正确返回示例
错误返回示例
接口地址:http://ip:port/u8cloud/api/so/saleorder/update

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南
参数名必填描述默认值
Content-Type是请求体数据类型application/json
usercode是用户
password是密码
trantype否翻译类型，按编码为code，不需要翻译为pkcode
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否否收货地址

返回类型参数:

参数名类型是否数组必填描述默认值
SaleOrderVO销售订单保存后返回VO
children否否
advisecalbody_codestring否否发货库存组组织code
advisecalbody_namestring否否发货库存组组织name
bbindflagstring否否是否捆绑存货
bdericttransstring否否是否直运
blargessflagstring否否是否赠品
boosflagstring否否缺货标志
breturnprofitstring否否是否参与返利
bsafepricestring否否是否参与价保
bsupplyflagstring否否补货标志
cadvisecalbodyidstring否否建议发货库存组织
cbatchidstring否否批次
cbatchid string否否批次
cbodywarehouseidstring否否发货仓库主键
cbomorderidstring否否配置单ID
cchantypeidstring否否渠道类型ID
cconsigncorpidstring否否发货公司
ccurrencytypeidstring否否原币
cfactoryidstring否否工厂ID
cfreezeidstring否否库存冻结ID
cinvbasdocidstring否否存货档案主键
cinventoryidstring否否存货ID
cinventoryid1string否否存货ID1
clargessrownostring否否主存货行号
consigncorp_codestring否否发货公司code
consigncorp_namestring否否发货公司name
coperatoridstring否否制单人
corder_bidstring否否销售订单附表ID
cpackunitidstring否否辅单位
cpricecalprocstring否否价格计算过程
cpriceitemidstring否否价格项目ID
cpriceitemtablestring否否价目表
cpricepolicyidstring否否价格政策ID
cprolineidstring否否产品线
cprovideridstring否否供应商
cquoteunitidstring否否报价计量单位
crecaddrnodestring否否收货地点
creccalbodyidstring否否收货库存组织
creceiptareaidstring否否收货地区
creceiptcorpidstring否否收货单位
creceipttypestring否否来源单据类型（V5.1开始支持）
crecwareidstring否否收货仓库
crownostring否否行号
csaleidstring否否销售主表ID
csourcebillbodyidstring否否来源单据附表ID（V5.1开始支持）
csourcebillidstring否否来源单据主表ID（V5.1开始支持）
ct_managebidstring否否合同行ID
ct_manageidstring否否合同ID
cunitidstring否否主计量单位
dconsigndatestring否否发货日期
ddeliverdatestring否否交货日期
dept_codestring否否部门code
dept_namestring否否部门name
drint否否删除标志
fbatchstatusint否否批次状态
frownotestring否否行备注
frowstatusint否否行状态
inventory_codestring否否存货code
inventory_namestring否否存货name
nastretprofnumdouble否否已参与返利辅数量
nasttaldcnumdouble否否已参与价保辅数量
ndiscountmnydouble否否本币折扣额
ndiscountratedouble否否整单折扣
nestbalancenumberstring否否累计暂估应收
nexchangeotobratedouble否否折本汇率
nitemdiscountratedouble否否单品折扣率
nmnydouble否否本币无税金额
nnetpricedouble否否本币无税净价
nnumberdouble否否数量
norgqtnetprcdouble否否报价单位无税净价
norgqtprcdouble否否报价单位无税单价
norgqttaxnetprcdouble否否报价单位含税净价
norgqttaxprcdouble否否报价单位含税单价
noriginalcurdiscountmnydouble否否原币折扣额
noriginalcurmnydouble否否原币无税金额
noriginalcurnetpricedouble否否原币无税净价
noriginalcurpricedouble否否原币无税单价
noriginalcursummnydouble否否原币价税合计
noriginalcurtaxmnydouble否否原币税额
noriginalcurtaxnetpricedouble否否原币含税净价
noriginalcurtaxpricedouble否否原币含税单价
npacknumberdouble否否辅数量
npricedouble否否本币无税单价
nqtnetprcdouble否否报价单位本币无税净价
nqtorgnetprcdouble否否询价原币无税净价
nqtorgprcdouble否否询价原币无税单价
nqtorgtaxnetprcdouble否否询价原币含税净价
nqtorgtaxprc double否否询价原币含税单价
nqtprcdouble否否报价单位本币无税单价
nqttaxnetprcdouble否否报价单位本币含税净价
nqttaxprcdouble否否报价单位本币含税单价
nquoteunitnumdouble否否报价单位数量
nquoteunitratedouble否否报价计量单位换算率
nretprofmnydouble否否返利金额
nretprofnumdouble否否已参与返利主数量
nreturntaxratedouble否否出口退税率
nsummnydouble否否本币价税合计
ntaldcmnydouble否否价保金额
ntaldcnumdouble否否已参与价保主数量
ntaxmnydouble否否本币税额
ntaxnetpricedouble否否本币含税净价
ntaxpricedouble否否本币含税单价
ntaxratedouble否否税率
ntotalbalancenumberstring否否累计应收确认数量
ntotalinventorynumberstring否否累计出库
ntotalinvoicenumberstring否否累计开票
ntotalpaymnystring否否累计收款金额
ntotalreceivenumberstring否否累计发货数量
ntotlbalcostnumstring否否累计成本结算数量
packunit_codestring否否辅单位code
packunit_namestring否否辅单位name
pk_corpstring否否公司主键
recaddrnode_codestring否否收货地点code
recaddrnode_namestring否否收货地点name
receiptarea_codestring否否收货地区code
receiptarea_namestring否否收货地区name
receiptcorp_codestring否否开票单位code
receiptcorp_namestring否否开票单位name
tconsigntimestring否否发货时间
tdelivertimestring否否到货时间
tsstring否否时间戳
unit_codestring否否单位code
unit_namestring否否单位name
veditreasonstring否否修订理由
vreceiveaddressstring否否收货地址
warehouse_codestring否否发货仓库code
warehouse_namestring否否发货仓库name
parent否否
approver_codestring否否审批人code
approver_namestring否否审批人name
bcooptopostring否否是否已协同生成采购订单
bfreecustflagstring否否是否散户
binitflagstring否否期初标志
binvoicendflagstring否否开票关闭标记
biztype_codestring否否业务类型code
biztype_namestring否否业务类型name
boutendflagstring否否出库关闭标记
boverdatestring否否是否超帐期
bpayendflagstring否否付款关闭标记
bpocooptomestring否否是否由采购订单协同生成
breceiptendflagstring否否发货关闭标记
bretinvflagstring否否退货标记
btransendflagstring否否运输关闭标志
calbody_codestring否否库存组织code
calbody_namestring否否库存组织name
capproveidstring否否审批人
cbaltypeidstring否否结算方式
cbiztypestring否否业务类型
ccalbodyidstring否否库存组织
ccooppohidstring否否对方订单号
ccreditnumstring否否信用证号
ccustbankidstring否否开户银行
ccustomeridstring否否客户
cdeptidstring否否部门
cemployeeidstring否否业务员
cfreecustidstring否否散户ID
coperatoridstring否否制单人
corp_codestring否否公司code
corp_namestring否否公司name
creceiptareaidstring否否收货地区
creceiptcorpidstring否否开票单位
creceiptcustomeridstring否否收货单位
creceipttypestring否否单据类型
csalecorpidstring否否销售组织
csaleidstring否否销售主表ID
ctermprotocolidstring否否收款协议
ctransmodeidstring否否运输方式
customer_codestring否否客户code
customer_namestring否否客户name
cwarehouseidstring否否仓库
dapprovedatestring否否审批日期
daudittimestring否否审批时间
dbilldatestring否否日期
dbilltimestring否否制单时间
dept_codestring否否部门code
dept_namestring否否部门name
dmakedatestring否否制单日期
dmoditimestring否否最后修改时间
drint否否删除标志
editauthorstring否否修订人
editdatestring否否修订日期
editionnumstring否否修订版本号
employee_codestring否否业务员code
employee_namestring否否业务员name
finvoiceclassdouble否否发票类别
finvoicetypedouble否否发票类型
fstatusdouble否否状态
ibalanceflagdouble否否结算标志
iprintcountstring否否打印次数
naccountperioddouble否否帐期
ndiscountratedouble否否整单折扣
nevaluatecarriagedouble否否预估运费
nheadsummnydouble否否金额合计
npreceivemnydouble否否预收款金额
npreceiveratedouble否否预收款比例
nsubscriptiondouble否否订金
operator_codestring否否制单人code
operator_namestring否否制单人name
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
receiptarea_codestring否否收货地区code
receiptarea_namestring否否收货地区name
receiptcorp_codestring否否开票单位code
receiptcorp_namestring否否开票单位name
receiptcustomer_codestring否否收货单位code
receiptcustomer_namestring否否收货单位name
salecorp_codestring否否销售组织code
salecorp_namestring否否销售组织name
transmode_codestring否否运输方式code
transmode_namestring否否运输方式name
tsstring否否时间戳
vaccountyearstring否否会计年度
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否否自定义项2-
vdef3string否否自定义项3
vdef4string否否自定义项4
vdef5string否否自定义项5
vdef6string否否自定义项6
vdef7string否否自定义项7
vdef8string否否自定义项8
vdef9string否否自定义项9
veditreasonstring否否修订理由
vnotestring否否备注
vreceiptcodestring否否单据号
vreceiveaddressstring否否收货地址

代码示例:

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

请求参数示例:

#常规示例#增删行示例

复制代码

#
{"saleorder":[{"childrenvo":[{"crowno":"10","vostatus":"update","cconsigncorpid":"1000","cadvisecalbodyid":"1000","cbodywarehouseid":"1","cinventoryid":"1103","nnumber":"50","noriginalcurprice":"111"}],"parentvo":{"ccustomerid":"C1014","pk_corp":"1000","cbiztype":"so81","coperatorid":"18242366050","cdeptid":"107","vreceiptcode":"SO10002101293074"}}]}

正确返回示例:

复制代码

{
    "status": "success",
    "data": "[{\"parentvo\":{\"pk_corp\":\"1001\",\"corp_code\":\"1000\",\"corp_name\":\"天海总公司\",\"cbiztype\":\"1001121000000000433A\",\"biztype_code\":\"so81\",\"biztype_name\":\"30-4331-4c\",\"ccustomerid\":\"000111100000000008R2\",\"customer_code\":\"C1014\",\"customer_name\":\"沈阳康贝商贸有限公司\",\"csalecorpid\":\"00011110000000000999\",\"salecorp_code\":\"1001\",\"salecorp_name\":\"天海销售总公司销售组织\",\"ccalbodyid\":\"100111100000000000OQ\",\"calbody_code\":\"1000\",\"calbody_name\":\"天海集团库存组织\",\"coperatorid\":\"00011310000000007F1O\",\"operator_code\":\"18242366050\",\"operator_name\":\"刘云祥\",\"cdeptid\":\"100111100000000000PD\",\"dept_code\":\"107\",\"dept_name\":\"销售部门\",\"vreceiptcode\":\"SO10002101293074\",\"dbilldate\":\"2021-01-29\",\"dmakedate\":\"2021-01-29\",\"dbilltime\":\"2021-01-29 10:40:23\",\"dmoditime\":\"2021-01-29 10:40:23\",\"creceiptcustomerid\":\"000111100000000008R2\",\"receiptcustomer_code\":\"C1014\",\"receiptcustomer_name\":\"沈阳康贝商贸有限公司\",\"creceiptcorpid\":\"000111100000000008R2\",\"receiptcorp_code\":\"C1014\",\"receiptcorp_name\":\"沈阳康贝商贸有限公司\",\"ndiscountrate\":100,\"csaleid\":\"100112100000000062L9\",\"ts\":\"2021-01-29 10:40:24\",\"fstatus\":\"1\",\"dr\":\"0\",\"nheadsummny\":6493.5,\"bretinvflag\":false,\"boutendflag\":false,\"breceiptendflag\":false},\"childrenvo\":[{\"cinventoryid\":\"00011210000000003O06\",\"inventory_code\":\"1103\",\"inventory_name\":\"稻香村\",\"nnumber\":50,\"noriginalcursummny\":6493.5,\"cunitid\":\"000111100000000006JB\",\"unit_code\":\"11\",\"unit_name\":\"盒\",\"cdeptid\":\"100111100000000000PD\",\"dept_code\":\"107\",\"dept_name\":\"销售部门\",\"csalecorpid\":\"00011110000000000999\",\"creceiptcorpid\":\"000111100000000008R2\",\"receiptcorp_code\":\"C1014\",\"receiptcorp_name\":\"沈阳康贝商贸有限公司\",\"cadvisecalbodyid\":\"100111100000000000OQ\",\"cbodywarehouseid\":\"10011210000000001E5N\",\"blargessflag\":false,\"noriginalcurprice\":111,\"crowno\":\"10\",\"ntaxrate\":17,\"noriginalcurtaxprice\":129.87,\"noriginalcurmny\":5550,\"noriginalcurtaxmny\":943.5,\"ndiscountrate\":100,\"nitemdiscountrate\":100,\"noriginalcurnetprice\":111,\"noriginalcurtaxnetprice\":129.87,\"noriginalcurdiscountmny\":0,\"dconsigndate\":\"2021-01-29\",\"ddeliverdate\":\"2021-01-29\",\"cquoteunitid\":\"000111100000000006JB\",\"cquoteunit_code\":\"11\",\"cquoteunit_name\":\"盒\",\"csaleid\":\"100112100000000062L9\",\"corder_bid\":\"100112100000000062LA\",\"ts\":\"2021-01-29 10:40:24\"}]}]",
    "taskNumber": "202101290018"
}

错误返回示例:

复制代码

{
    "status": "falied",
    "errorcode": "-32000",
    "errormsg": "U8C返回信息:[单据号：SO10002101293074,csaleid:100112100000000062L9]的单据不是自由态，不能修改！",
    "taskNumber": "202101290019"
}