U8C API中心

API中心

采购管理
采购订单

指导视频
对接方案模板
工具
游客

采购订单修改

接口所在U8C版本:U8 cloud3.1以及更高版本

详细描述:用于采购订单修改

API视频讲解API详情补丁列表常见问题参考

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/pu/order/update

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

参数名	类型	是否数组	必填	描述	默认值
puordervo		是	是	采购订单聚合实体
childrenvo		是	是	采购订单子实体
blargess	boolean	否	否	是否赠品（传Y/N）
cassistunit	string	否	否	辅计量单位
cbaseid	string	否	否	存货基本ID
ccurrencytypeid	string	否	否	币种ID
cmangid	string	否	是	存货管理ID
coperator	string	否	否	操作员
corder_bid	string	否	否	采购订单子表主键（调用修改、修订接口必填字段）
corderid	string	否	否	采购订单主表主键
cprojectid	string	否	否	项目
crowno	string	否	否	行号
csourcebillid	string	否	否	来源单据id
csourcebilltype	string	否	否	来源单据类型
csourcerowid	string	否	否	来源单据行id
cupsourcebillid	string	否	否	上层来源单据号3.1版本支持
cupsourcebillrowid	string	否	否	上层来源单据行号3.1版本支持
cupsourcebilltype	string	否	否	上层来源单据类型3.1版本支持
cusedeptid	string	否	否	使用部门
cwarehouseid	string	否	否	收货仓库
dplanarrvdate	string	否	否	计划到货日期（格式：2021-07-09）
forderrowstatus	int	否	否	订单行状态
idiscounttaxtype	string	否	否	扣税类别
nassistnum	double	否	否	辅单位数量
ndiscountrate	double	否	否	扣率
nexchangeotobrate	double	否	否	折本汇率
nmoney	double	否	否	本币金额
nordernum	double	否	是	订货数量
norgnettaxprice	double	否	否	原币净含税单价
norgtaxprice	double	否	是	原币含税单价	自动计算价税合计时此值必填
noriginalcurmny	double	否	否	原币净无税金额
noriginalcurprice	double	否	否	原币无税单价
noriginalnetprice	double	否	否	原币净无税单价
noriginaltaxmny	double	否	否	原币税额
noriginaltaxpricemny	double	否	否	原币价税合计
ntaxmny	double	否	否	本币税额
ntaxpricemny	double	否	否	本币价税合计
ntaxrate	double	否	否	税率
pk_arrvcorp	string	否	否	收货公司pk
pk_arrvstoorg	string	否	否	收货库存组织（填写此属性需同时填写收货公司属性pk_arrvcorp）
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
pk_invoicecorp	string	否	否	收票公司
vdef1	string	否	否	自定义项1
vdef10	string	否	否	自定义项10
vdef11	string	否	否	自定义项11
vdef12	string	否	否	自定义项12
vdef13	string	否	否	自定义项13
vdef14	string	否	否	自定义项14
vdef15	string	否	否	自定义项15
vdef16	string	否	否	自定义项16
vdef17	string	否	否	自定义项17
vdef18	string	否	否	自定义项18
vdef19	string	否	否	自定义项19
vdef2	string	否	否	自定义项2
vdef20	string	否	否	自定义项20
vdef3	string	否	否	自定义项3
vdef4	string	否	否	自定义项4
vdef5	string	否	否	自定义项5
vdef6	string	否	否	自定义项6
vdef7	string	否	否	自定义项7
vdef8	string	否	否	自定义项8
vdef9	string	否	否	自定义项9
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vmemo	string	否	否	备注
vostatus	string	否	否	状态5.1版本支持（调用修改接口时使用，传值：修改时update、删除时delete、新增时new）
vproducenum	string	否	否	批次号
parentvo		否	是	采购订单主实体
bcooptoso	string	否	否	是否已协同生成销售订单
bislatest	string	否	否	是否最新版本
bisreplenish	string	否	否	补货标志
bpubtoec	string	否	否	是否发布(电子商务使用)
breturn	string	否	否	是否退货
bsocooptome	string	否	否	是否由销售订单协同生成
caccountbankid	string	否	否	开户银行
caccountyear	string	否	否	会计年度
cauditpsn	string	否	否	审批人
cbiztype	string	否	是	业务流程
ccontracttextpath	string	否	否	合同附件
ccurrencytypeid	string	否	否	整单币种（3.2版本支持）
cdeliveraddress	string	否	否	供应商收发货地址
cdeptid	string	否	是	采购部门
cemployeeid	string	否	否	采购员
cfreecustid	string	否	否	散户
cgiveinvoicevendor	string	否	否	发票方
coperator	string	否	是	制单人
corderid	string	否	否	采购订单主表主键（调用修改、修订接口必填字段）
cpubpsn	string	否	否	发布人(电子商务使用)
cpurorganization	string	否	是	采购组织
creciever	string	否	否	收货方
cresppsn	string	否	否	响应人(电子商务使用)
crevisepsn	string	否	否	修订人
ctermprotocolid	string	否	否	付款协议
ctransmodeid	string	否	否	运输方式
cunfreeze	string	否	否	解冻人
cvendormangid	string	否	是	供应商管理
dauditdate	string	否	否	审批日期（保存即审批接口使用，日期格式：2023-9-25）
dorderdate	string	否	否	订单日期（日期格式：2023-9-25）
drevisiondate	string	否	否	修订日期（日期格式：2023-9-25）
forderstatus	int	否	否	单据状态
isSaveWhenOverStockOnHand	string	否	否	超现存量时是否继续保存（5.1sp支持）	Y/N
nexchangeotobrate	string	否	否	整单折本汇率（3.2版本支持）
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
tlastmaketime	string	否	否	最后修改时间
tmaketime	string	否	否	制单时间
vdef1	string	否	否	自定义项1
vdef10	string	否	否	自定义项10
vdef11	string	否	否	自定义项11
vdef12	string	否	否	自定义项12
vdef13	string	否	否	自定义项13
vdef14	string	否	否	自定义项14
vdef15	string	否	否	自定义项15
vdef16	string	否	否	自定义项16
vdef17	string	否	否	自定义项17
vdef18	string	否	否	自定义项18
vdef19	string	否	否	自定义项19
vdef2	string	否	否	自定义项2
vdef20	string	否	否	自定义项20
vdef3	string	否	否	自定义项3
vdef4	string	否	否	自定义项4
vdef5	string	否	否	自定义项5
vdef6	string	否	否	自定义项6
vdef7	string	否	否	自定义项7
vdef8	string	否	否	自定义项8
vdef9	string	否	否	自定义项9
vmemo	string	否	否	备注
vordercode	string	否	否	订单编号

返回类型参数:

参数名	类型	是否数组	必填	描述
puordervo				采购订单聚合返回实体
childrenvo		是	是	采购订单查询结果子实体
arrvcorp_name	string	否	否	收货公司名称
arrvstoorg_name	string	否	否	收货库存组织名称
blargess	string	否	否	是否赠品
bodycode	string	否	否	组织编码
breceiveplan	string	否	否	存在到货计划
btransclosed	string	否	否	是否运输关闭
cassistunit	string	否	否	辅计量单位
cassistunit_name	string	否	否	辅计量单位名称
cbaseid	string	否	否	存货基础ID
ccloseuser_name	string	否	否	关闭人名称
ccloseuserid	string	否	否	关闭人
ccontractid	string	否	否	合同头ID
ccontractrowid	string	否	否	合同行ID
ccorrectrowid	string	否	否	修正行ID
ccurrencytype_name	string	否	否	原币币种名称
ccurrencytypeid	string	否	否	原币币种ID
cdevaddrid	string	否	否	收发货地点
cdevareaid	string	否	否	收发货地区
cmang_name	string	否	否	存货管理名称
cmangid	string	否	否	存货管理ID
coperate_name	string	否	否	操作员名称
coperator	string	否	否	操作员ID
corder_bid	string	否	否	采购订单行ID
corderid	string	否	否	采购订单表头_主键
corp_name	string	否	否	公司名称
cpriceaudit_bb1id	string	否	否	价格审批单存货子子表ID
cpriceaudit_bid	string	否	否	价格审批单存货子表ID
cpriceauditid	string	否	否	价格审批单ID
cproject_name	string	否	否	项目名称
cprojectid	string	否	否	项目ID
cprojectphase_name	string	否	否	项目阶段名称
cprojectphaseid	string	否	否	项目阶段ID
cqpbaseschemeid	string	否	否	优质优价主体方案ID
creqwareid_name	string	否	否	收货库存组织名称
crowno	string	否	否	行号
csourcebillid	string	否	否	来源单据ID
csourcebilltype	string	否	否	来源单据类型
csourcerowid	string	否	否	来源单据行ID
cupsourcebillid	string	否	否	上层来源单据ID
cupsourcebillrowid	string	否	否	上层来源单据行ID
cupsourcebilltype	string	否	否	上层来源单据类型
cusedept_name	string	否	否	使用部门名称
cusedeptid	string	否	否	使用部门ID
cvenddevaddrid	string	否	否	供应商收发货地点
cvenddevareaid	string	否	否	供应商收发货地区
cwarehouse_name	string	否	否	收货仓库名称
cwarehouseid	string	否	否	收货仓库ID
dclosedate	string	否	否	关闭日期
dconfirmdate	string	否	否	确认日期
dcorrectdate	string	否	否	修正日期
deptcode	string	否	否	使用部门编码
dplanarrvdate	string	否	否	计划到货日期
forderrowstatus	string	否	否	订单行状态
idiscounttaxtype	string	否	否	扣税类别
iisactive	string	否	否	是否激活
iisreplenish	string	否	否	补货标志
invoicecorp_name	string	否	否	收票公司名称
jobcode	string	否	否	项目编码
jobphasecode	string	否	否	项目阶段编码
naccumarrvnum	string	否	否	累计到货数量
naccumdevnum	string	否	否	累计运输数量
naccuminvoicenum	string	否	否	累计发票数量
naccumrpnum	string	否	否	累计到货计划数量
naccumstorenum	string	否	否	累计入库数量
naccumwastnum	string	否	否	累计途耗数量
nassistnum	string	否	否	辅计量数量
nbackarrvnum	string	否	否	累计退货数量
nbackstorenum	string	否	否	累计退库数量
nconfirmnum	string	否	否	确认数量
ndiscountrate	string	否	否	扣率
nexchangeotobrate	string	否	否	扣率
nmoney	string	否	否	本币金额
nordernum	string	否	否	订货数量
norgnettaxprice	string	否	否	原币净含税单价
norgtaxprice	string	否	否	原币含税单价
noriginalcurmny	string	否	否	原币净无税金额
noriginalcurprice	string	否	否	原币无税单价
noriginalnetprice	string	否	否	原币净无税单价
noriginaltaxmny	string	否	否	原币税额
noriginaltaxpricemny	string	否	否	原币价税合计
ntaxmny	string	否	否	本币税额
ntaxpricemny	string	否	否	本币价税合计
ntaxrate	string	否	否	税率
pk_arrvcorp	string	否	否	收货公司
pk_arrvstoorg	string	否	否	收货库存组织
pk_corp	string	否	否	公司主键
pk_creqwareid	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
pk_invoicecorp	string	否	否	收票公司
pk_reqcorp	string	否	否	需求公司
pk_reqstoorg	string	否	否	需求库存组织
psncode	string	否	否	关闭人编码
reqcorp_name	string	否	否	需求公司名称
reqstoorg_name	string	否	否	需求库存组织名称
shortname	string	否	否	辅计量单位编码
storcode	string	否	否	收货仓库编码
termid	string	否	否	原币币种编码
ts	string	否	否	时间戳
unitcode	string	否	否	公司编码
user_code	string	否	否	操作员编码
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vmemo	string	否	否	备注
vpriceauditcode	string	否	否	价格审批单号
vproducenum	string	否	否	批次号
vreceiveaddress	string	否	否	收发货地址
vvenddevaddr	string	否	否	供应商收发货地址
vvendinventorycode	string	否	否	对应存货编码
vvendinventoryname	string	否	否	对应存货名称
vvendorordercode	string	否	否	对方订单号
vvendororderrow	string	否	否	对方订单行号
parentvo		否	是	采购订单查询结果主实体
bankdoccode	string	否	否	开户银行编码
bislatest	string	否	否	是否最新版本
breturn	string	否	否	是否退货
bsocooptome	string	否	否	是否由销售订单协同生成
busicode	string	否	否	业务类型编码
caccountbank_name	string	否	否	开户银行名称
caccountbankid	string	否	否	开户银行
caccountyear	string	否	否	会计年度
cauditpsn	string	否	否	审批人ID
cauditpsn_name	string	否	否	审批人名称
cbiztype	string	否	否	业务类型
cbiztype_name	string	否	否	业务类型名称
ccurrencytypeid	string	否	否	整单币种
cdept_name	string	否	否	采购部门名称
cdeptid	string	否	否	采购部门
cemployee_name	string	否	否	采购员名称
cemployeeid	string	否	否	采购员
cgiveinvoicevendor	string	否	否	发票方
cgiveinvoicevendor_name	string	否	否	发票方名称
code	string	否	否	采购组织编码
coperator	string	否	否	制单人ID
coperator_name	string	否	否	制单人名称
corderid	string	否	否	采购订单ID
corp_name	string	否	否	公司名称
cproject_name	string	否	否	项目名称
cprojectid	string	否	否	项目
cpurorganization	string	否	否	采购组织
cpurorganization_name	string	否	否	采购组织名称
creciever	string	否	否	收货方
creciever_name	string	否	否	收货方名称
crevisepsn	string	否	否	修订人
crevisepsn_name	string	否	否	修订人名称
ctermprotocol_name	string	否	否	付款协议名称
ctermprotocolid	string	否	否	付款协议
ctransmode_name	string	否	否	运输方式名称
ctransmodeid	string	否	否	运输方式
cunfreeze	string	否	否	解冻人ID
cunfreeze_name	string	否	否	解冻人名称
currtype_code	string	否	否	整单编码
currtype_name	string	否	否	整单名称
custcode	string	否	否	收货方编码
cvendormangid	string	否	否	供应商管理档案ID
dauditdate	string	否	否	审批日期
deptcode	string	否	否	采购部门编码
dorderdate	string	否	否	订单日期
drevisiondate	string	否	否	修订日期
forderstatus	string	否	否	订单状态
iprintcount	string	否	否	打印次数
jobcode	string	否	否	项目编码
nexchangeotobrate	string	否	否	整单折本汇率
nprepaymaxmny	string	否	否	本币预付款限额
nprepaymny	string	否	否	本币预付款
nversion	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
psncode	string	否	否	采购员编码
sendcode	string	否	否	运输方式编码
taudittime	string	否	否	审批时间
termid	string	否	否	付款协议编码
tlastmaketime	string	否	否	最后修改时间
tmaketime	string	否	否	制单时间
trevisiontime	string	否	否	修订时间
ts	string	否	否	时间戳
unitcode	string	否	否	公司编码
user_code	string	否	否	审批人编码
vcoopordercode	string	否	否	对方订单号
vmemo	string	否	否	备注
vordercode	string	否	否	订单编号

代码示例:

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

请求参数示例:

最简示例全属性示例增删明细参数示例5.1版本支持

复制代码

{"puordervo":[{"childrenvo":[{"cmangid":"IN0020","corderid":"ltw01","nordernum":"1","noriginalnetprice":"1","pk_corp":"1","pk_invoicecorp":"11"}],"parentvo":{"cbiztype":"c001","cdeptid":"1","coperator":"demo1","corderid":"1001A110000000001T74","cpurorganization":"1","cvendormangid":"JT0001","pk_corp":"1"}}]}

正确返回示例:

复制代码

{
status: "success",
data: "[{"parentvo":{"pk_corp":"天海销售总公司","unitcode":"1001","cbiztype":"普通采购","busicode":"c001","cpurorganization":"天海销售公司采购组织","code":"1001","cdeptid":"采购部","deptcode":"106","coperator":"体验181","user_code":"14444444181","corderid":"100214100000000008HL","dorderdate":"2018-06-26","forderstatus":"0","vordercode":"CDXS1806260005","nversion":"1","tmaketime":"1970-01-01 00:00:00","bislatest":true,"cvendormangid":"天海销售公司","custcode":"1001","bisreplenish":false,"cvendorbaseid":"000111100000000006LA"},"childrenvo":[{"ccurrencytypeid":"人民币","termid":"CNY","cmangid":"米奇宝新生儿配方奶粉900g","invcode":"010101","pk_invoicecorp":"天海销售总公司","unitcode":"1001","cassistunit":"箱","shortname":"05","pk_corp":"天海销售总公司","corder_bid":"100214100000000008HM","corderid":"100214100000000008HL","crowno":"10","nassistnum":0.17,"nexchangeotobrate":1,"nmoney":1,"nordernum":1,"norgnettaxprice":1,"norgtaxprice":100,"noriginalcurmny":1,"noriginalcurprice":1,"noriginalnetprice":1,"noriginaltaxmny":1,"noriginaltaxpricemny":1,"ntaxmny":1,"ntaxpricemny":1,"ntaxrate":17,"ndiscountrate":0.01,"iisactive":"0","idiscounttaxtype":"1","forderrowstatus":"0","cbaseid":"00011110000000000DWS","breceiveplan":false,"blargess":false}]}]"
}

错误返回示例:

复制代码

{
status: "falied",
errorcode: "-32000",
errormsg: "[第 1张采购订单的表头属性 coperator 的值不能为空。, 第 1张采购订单的表头属性 pk_corp 的值不能为空。, 第 1张采购订单的表头属性 cbiztype 的值不能为空。, 第 1张采购订单的表头属性 cpurorganization 的值不能为空。, 第 1张采购订单的表头属性 cvendormangid 的值不能为空。, 第 1张采购订单的表头属性 cdeptid 的值不能为空。, 第 1张采购订单, 第 1 行表体的属性 pk_invoicecorp 的值不能为空。, 第 1张采购订单, 第 1 行表体的属性 nordernum 的值不能为空。, 第 1张采购订单, 第 1 行表体的属性 ccurrencytypeid 的值不能为空。, 第 1张采购订单, 第 1 行表体的属性 nexchangeotobrate 的值不能为空。, 第 1张采购订单, 第 1 行表体的属性 cbaseid 的值不能为空。, 第 1张采购订单, 第 1 行表体的属性 cmangid 的值不能为空。]"
}