U8C API中心

API中心

采购管理
采购订单

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

采购订单修订

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

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

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式: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	否	否	订单编号

返回类型参数:

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

No Data

代码示例:

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

请求参数示例:

复制代码

{"puordervo":[{"parentvo":{"corderid":"1001ZZ1000000000H9X3","pk_corp":"1000","vordercode":"test111122251312313","taudittime":"","tlastmaketime":"","tmaketime":"","breturn":false,"bislatest":true,"bisreplenish":false,"cvendormangid":"S1002","ccurrencytypeid":"USD","drevisiondate":"2020-10-30"},"childrenvo":[{"cmangid":"1302","pk_invoicecorp":"1000","pk_arrvcorp":"1001","arrvcorp_name":"天海总公司","pk_reqcorp":"1001","reqcorp_name":"天海总公司","coperator":"demo1","pk_corp":"1000","corp_name":"天海总公司","corder_bid":"1001ZZ1000000000H9X4","corderid":"1001ZZ1000000000H9X3","crowno":"10","nmoney":56.84,"nordernum":20,"norgnettaxprice":123,"norgtaxprice":123,"noriginalcurmny":56.84,"noriginalcurprice":1.14,"noriginalnetprice":1.14,"noriginaltaxmny":9.66,"noriginaltaxpricemny":66.5,"ntaxmny":9.66,"ntaxpricemny":66.5,"ntaxrate":13,"ts":"2020-12-24 10:57:53","ndiscountrate":100,"iisreplenish":"0","iisactive":"0","idiscounttaxtype":"1","cbaseid":"00011210000000003NYL","breceiveplan":false}]},{"parentvo":{"corderid":"1001ZZ1000000000H9X6","pk_corp":"1000","vordercode":"test111122251312313","taudittime":"","tlastmaketime":"","tmaketime":"","breturn":false,"bislatest":true,"bisreplenish":false,"cvendormangid":"S1002","ccurrencytypeid":"USD","drevisiondate":"2020-10-30"},"childrenvo":[{"cmangid":"1301","pk_invoicecorp":"1000","pk_arrvcorp":"1001","arrvcorp_name":"天海总公司","pk_reqcorp":"1001","reqcorp_name":"天海总公司","coperator":"demo1","pk_corp":"1000","corp_name":"天海总公司","corder_bid":"1001ZZ1000000000H9X7","corderid":"1001ZZ1000000000H9X6","crowno":"10","nmoney":56.84,"nordernum":20,"norgnettaxprice":123,"norgtaxprice":123,"noriginalcurmny":56.84,"noriginalcurprice":1.14,"noriginalnetprice":1.14,"noriginaltaxmny":9.66,"noriginaltaxpricemny":66.5,"ntaxmny":9.66,"ntaxpricemny":66.5,"ntaxrate":13,"ts":"2020-12-24 10:57:53","ndiscountrate":100,"iisreplenish":"0","iisactive":"0","idiscounttaxtype":"1","cbaseid":"00011210000000003NYL","breceiveplan":false}]}]}

正确返回示例:

复制代码

{
    "status": "success",
    "data": "[{\"parentvo\":{\"pk_corp\":\"1001\",\"unitcode\":\"1000\",\"corp_name\":\"天海总公司\",\"cbiztype\":\"10011110000000000022\",\"busicode\":\"c001\",\"cbiztype_name\":\"普通采购\",\"cpurorganization\":\"00011110000000001GHD\",\"code\":\"1000\",\"cpurorganization_name\":\"天海总公司采购组织\",\"cdeptid\":\"100111100000000000OS\",\"deptcode\":\"100\",\"cdept_name\":\"总裁办公室\",\"cauditpsn\":\"0001111000000000011U\",\"user_code\":\"demo1\",\"cauditpsn_name\":\"demo1\",\"coperator\":\"0001111000000000011U\",\"coperator_name\":\"demo1\",\"corderid\":\"1001ZZ1000000000H9X3\",\"dauditdate\":\"2021-09-26\",\"dorderdate\":\"2021-09-26\",\"forderstatus\":\"3\",\"vordercode\":\"test111122251312313\",\"ts\":\"2021-09-26 17:25:53\",\"nversion\":\"2\",\"taudittime\":\"2021-09-26 17:25:53\",\"tlastmaketime\":\"2021-11-19 16:32:21\",\"tmaketime\":\"2021-09-26 17:25:51\",\"breturn\":false,\"bislatest\":true,\"cvendormangid\":\"000111100000000008UN\",\"custcode\":\"S1002\",\"cvendormang_name\":\"沈阳金瑞日盛衡器商行\",\"bisreplenish\":false,\"cvendorbaseid\":\"000111100000000006LA\",\"drevisiondate\":\"2020-10-30\",\"ccurrencytypeid\":\"00010000000000000002\",\"currtype_code\":\"USD\",\"currtype_name\":\"美元\",\"nexchangeotobrate\":6.4079},\"childrenvo\":[{\"ccurrencytypeid\":\"00010000000000000002\",\"termid\":\"USD\",\"ccurrencytype_name\":\"美元\",\"cmangid\":\"00011210000000003O0H\",\"invcode\":\"1302\",\"cmang_name\":\"粉笔\",\"pk_invoicecorp\":\"1001\",\"unitcode\":\"1000\",\"invoicecorp_name\":\"天海总公司\",\"pk_arrvcorp\":\"1002\",\"arrvcorp_name\":\"天海销售总公司\",\"pk_reqcorp\":\"1002\",\"reqcorp_name\":\"天海销售总公司\",\"coperator\":\"0001111000000000011U\",\"user_code\":\"demo1\",\"coperate_name\":\"demo1\",\"pk_corp\":\"1001\",\"corp_name\":\"天海总公司\",\"corder_bid\":\"1001ZZ1000000000H9X4\",\"corderid\":\"1001ZZ1000000000H9X3\",\"crowno\":\"10\",\"nexchangeotobrate\":1,\"nmoney\":58.85,\"nordernum\":20,\"norgnettaxprice\":3.33,\"norgtaxprice\":3.33,\"noriginalcurmny\":58.85,\"noriginalcurprice\":2.95,\"noriginalnetprice\":2.95,\"noriginaltaxmny\":7.65,\"noriginaltaxpricemny\":66.5,\"ntaxmny\":7.65,\"ntaxpricemny\":66.5,\"ntaxrate\":13,\"ts\":\"2020-12-24 10:57:53\",\"ndiscountrate\":100,\"iisreplenish\":\"0\",\"iisactive\":\"0\",\"idiscounttaxtype\":\"1\",\"forderrowstatus\":\"0\",\"cbaseid\":\"00011210000000003NYX\",\"breceiveplan\":false}]},{\"parentvo\":{\"pk_corp\":\"1001\",\"unitcode\":\"1000\",\"corp_name\":\"天海总公司\",\"cbiztype\":\"10011110000000000022\",\"busicode\":\"c001\",\"cbiztype_name\":\"普通采购\",\"cpurorganization\":\"00011110000000001GHD\",\"code\":\"1000\",\"cpurorganization_name\":\"天海总公司采购组织\",\"cdeptid\":\"100111100000000000OS\",\"deptcode\":\"100\",\"cdept_name\":\"总裁办公室\",\"cauditpsn\":\"0001111000000000011U\",\"user_code\":\"demo1\",\"cauditpsn_name\":\"demo1\",\"coperator\":\"0001111000000000011U\",\"coperator_name\":\"demo1\",\"corderid\":\"1001ZZ1000000000H9X6\",\"dauditdate\":\"2021-09-26\",\"dorderdate\":\"2021-09-26\",\"forderstatus\":\"3\",\"vordercode\":\"test111122251312313\",\"ts\":\"2021-11-19 16:25:25\",\"nversion\":\"3\",\"taudittime\":\"2021-09-26 17:10:50\",\"tlastmaketime\":\"2021-11-19 16:25:24\",\"tmaketime\":\"2021-09-26 17:10:46\",\"breturn\":false,\"bislatest\":true,\"cvendormangid\":\"000111100000000008UN\",\"custcode\":\"S1002\",\"cvendormang_name\":\"沈阳金瑞日盛衡器商行\",\"bisreplenish\":false,\"cvendorbaseid\":\"000111100000000006LA\",\"drevisiondate\":\"2020-10-30\",\"ccurrencytypeid\":\"00010000000000000002\",\"currtype_code\":\"USD\",\"currtype_name\":\"美元\",\"nexchangeotobrate\":6.4079},\"childrenvo\":[{\"ccurrencytypeid\":\"00010000000000000002\",\"termid\":\"USD\",\"ccurrencytype_name\":\"美元\",\"cmangid\":\"00011210000000003O0G\",\"invcode\":\"1301\",\"cmang_name\":\"桌子\",\"pk_invoicecorp\":\"1001\",\"unitcode\":\"1000\",\"invoicecorp_name\":\"天海总公司\",\"pk_arrvcorp\":\"1002\",\"arrvcorp_name\":\"天海销售总公司\",\"pk_reqcorp\":\"1002\",\"reqcorp_name\":\"天海销售总公司\",\"coperator\":\"0001111000000000011U\",\"user_code\":\"demo1\",\"coperate_name\":\"demo1\",\"pk_corp\":\"1001\",\"corp_name\":\"天海总公司\",\"corder_bid\":\"1001ZZ1000000000H9X7\",\"corderid\":\"1001ZZ1000000000H9X6\",\"crowno\":\"10\",\"nexchangeotobrate\":1,\"nmoney\":58.85,\"nordernum\":20,\"norgnettaxprice\":3.33,\"norgtaxprice\":3.33,\"noriginalcurmny\":58.85,\"noriginalcurprice\":2.95,\"noriginalnetprice\":2.95,\"noriginaltaxmny\":7.65,\"noriginaltaxpricemny\":66.5,\"ntaxmny\":7.65,\"ntaxpricemny\":66.5,\"ntaxrate\":13,\"ts\":\"2020-12-24 10:57:53\",\"ndiscountrate\":100,\"iisreplenish\":\"0\",\"iisactive\":\"0\",\"idiscounttaxtype\":\"1\",\"forderrowstatus\":\"0\",\"cbaseid\":\"00011210000000003NYV\",\"breceiveplan\":false}]}]",
    "taskNumber": "202111190035"
}

错误返回示例:

复制代码

{
    "status": "falied",
    "errorcode": "-32000",
    "errormsg": "U8C返回信息:下面的档案通过传入的以下信息在U8C系统中找不到，请检查！可能的原因：1、当前单据使用的公司没有启用单据所在的模块；2、如果是【存货/项目/客商/人员/收支项目】档案，请检查是否没有分配到当前使用的公司；3、如果是【会计科目】档案，请检查是否没有分配到当前使用的会计主体账簿。找不到的档案列表：1、档案类型【存货档案】，档案编码列表【1303】；"
}