U8C API中心

API中心

采购管理
采购订单

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

采购订单保存即审批

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

详细描述:用于采购订单保存即审批

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(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":{"cbiztype":"V004","cdeptid":"106","coperator":"18242366050","cpurorganization":"1000","cvendormangid":"C1016","pk_corp":"1000","vmemo":"api接口增加的单
据","vordercode":"caigou0728-006"},"childrenvo":[{"cbaseid":"010493","cmangid":"010493","nordernum":"10","noriginalcurprice":"11"}]}]}

正确返回示例:

复制代码

{
  "status": "success",
  "data": "[{\"parentvo\":{\"pk_corp\":\"1001\",\"unitcode\":\"1000\",\"corp_name\":\"天海总公司\",\"cbiztype\":\"1001131000000001EKND\",\"busicode\":\"V004\",\"cbiztype_name\":\"21-23\",
\"cpurorganization\":\"00011110000000001GHD\",\"code\":\"1000\",\"cpurorganization_name\":\"天海总公司采购组织\",\"cdeptid\":\"100111100000000000PA\",\"deptcode\":\"106\",\"cdept_name\":\"采购部
\",\"cauditpsn\":\"000111100000000000RV\",\"user_code\":\"18242366050\",\"cauditpsn_name\":\"刘云祥\",\"coperator\":\"000111100000000000RV\",\"coperator_name\":\"刘云祥\",\"corderid\":
\"1001ZZ1000000001MK0X\",\"dorderdate\":\"2020-07-28\",\"forderstatus\":\"3\",\"vordercode\":\"caigou0728-006\",\"vmemo\":\"api接口增加的单据\",\"ts\":\"2020-07-28 20:51:59\",\"nversion\":\"1\",
\"taudittime\":\"2020-07-28 20:51:57\",\"tmaketime\":\"2020-07-28 20:51:55\",\"breturn\":false,\"bislatest\":true,\"cvendormangid\":\"000111100000000008RZ\",\"custcode\":\"C1016\",
\"cvendormang_name\":\"双鸭山吉缘商贸有限公司\",\"bisreplenish\":false,\"cvendorbaseid\":\"000111100000000006JT\"},\"childrenvo\":[{\"ccurrencytypeid\":\"00010000000000000001\",\"termid\":\"CNY\",
\"ccurrencytype_name\":\"人民币\",\"cmangid\":\"0001ZZ1000000000YMXK\",\"invcode\":\"010493\",\"cmang_name\":\"自制汽\",\"pk_corp\":\"1001\",\"unitcode\":\"1000\",\"corp_name\":\"天海总公司\",
\"corder_bid\":\"1001ZZ1000000001MK0Y\",\"corderid\":\"1001ZZ1000000001MK0X\",\"crowno\":\"10\",\"nexchangeotobrate\":1,\"nordernum\":10,\"norgtaxprice\":12.87,\"noriginalcurprice\":11,\"ntaxrate
\":17,\"iisactive\":\"0\",\"idiscounttaxtype\":\"1\",\"forderrowstatus\":\"0\",\"cbaseid\":\"000112100000000065PD\",\"breceiveplan\":false}]}]",
  "taskNumber": "202007280015"
}

错误返回示例:

复制代码

{
  "status": "falied",
  "errorcode": "-32000",
  "errormsg": "U8C返回信息:下面的档案无法翻译：档案类型：供应商档案,档案编码：C1016,档案类型：存货档案,档案编码：010493,档案类型：业务类型,档案编码：V004,档案类型：部门档案,档案编码：106,可能的原因
是当前单据使用的公司没有启用单据所在的模块或者档案没有分配到当前使用的公司！",
  "stacktrace": "nc.vo.pub.BusinessException: 下面的档案无法翻译：档案类型：供应商档案,档案编码：C1016,档案类型：存货档案,档案编码：010493,档案类型：业务类型,档案编码：V004,档案类型：部门档案,档案
编码：106,可能的原因是当前单据使用的公司没有启用单据所在的模块或者档案没有分配到当前使用的公司！\r\nu8c.bs.translate.bp.AbstractTranBP.buildErrMessage(AbstractTranBP.java:139)\r
\nu8c.bs.translate.bp.AbstractTranBP.translate(AbstractTranBP.java:85)\r\nu8c.bs.tran…………,
  "taskNumber": "202007280016"
}