U8C API中心

API中心

采购管理
采购订单

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

采购订单新增

接口所在U8C版本:U8 cloud2.7以及更高版本

详细描述:用于采购订单新增

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

全量参数自制最简来源请购单直运来源销售订单借入转采购来源库存借入单来源采购合同带统计型自定义项带备注型自定义项

参数名	类型	是否数组	必填	描述	默认值	示例值
puordervo		是	是	采购订单聚合实体

返回类型参数:

参数名	类型	是否数组	必填	描述
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#模板示例下载

请求参数示例:

自制最简来源请购单直运来源销售订单借入转采购来源库存借入单来源采购合同带统计型自定义项带备注型自定义项

复制代码

{"puordervo":[{"childrenvo":[{"cmangid":"0901","nordernum":"1","noriginalcurprice":"10","norgtaxprice":"12"}],"parentvo":{"cbiztype":"pu01","cdeptid":"777","coperator":"apiwjh","cpurorganization":"1234","cvendormangid":"CU2023","pk_corp":"2401"}}]}

正确返回示例:

复制代码

{"status":"success","data":"[{\"parentvo\":{\"pk_corp\":\"1005\",\"unitcode\":\"2401\",\"corp_name\":\"wjh石油天然气集团有限公司\",\"cbiztype\":\"1005F4100000000011TW\",\"busicode\":\"pu01\",\"cbiztype_name\":\"采购-到货-入库\",\"cpurorganization\":\"0001F410000000040YMQ\",\"code\":\"1234\",\"cpurorganization_name\":\"w采购组织\",\"cdeptid\":\"1005F4100000000011TA\",\"deptcode\":\"777\",\"cdept_name\":\"w部门\",\"coperator\":\"0001A11000000002QQ4J\",\"user_code\":\"apiwjh\",\"coperator_name\":\"wjh\",\"corderid\":\"1005ZZ10000000002HI9\",\"dorderdate\":\"2023-09-01\",\"forderstatus\":\"0\",\"vordercode\":\"CD0013\",\"nversion\":\"1\",\"tmaketime\":\"2023-09-01 10:35:30\",\"breturn\":false,\"bislatest\":true,\"cvendormangid\":\"0001F410000000040YN3\",\"custcode\":\"CU2023\",\"cvendormang_name\":\"w供应商\",\"bisreplenish\":false,\"cvendorbaseid\":\"0001F410000000040YMY\",\"ccurrencytypeid\":\"00010000000000000001\",\"currtype_code\":\"CNY\",\"currtype_name\":\"人民币\",\"nexchangeotobrate\":\"1.00000000\"},\"childrenvo\":[{\"ccurrencytypeid\":\"00010000000000000001\",\"termid\":\"CNY\",\"ccurrencytype_name\":\"人民币\",\"cmangid\":\"0001F410000000044TSE\",\"invcode\":\"0901\",\"cmang_name\":\"大数量存货\",\"pk_invoicecorp\":\"1005\",\"unitcode\":\"2401\",\"invoicecorp_name\":\"wjh石油天然气集团有限公司\",\"pk_arrvcorp\":\"1005\",\"pk_corp\":\"1005\",\"corp_name\":\"wjh石油天然气集团有限公司\",\"corder_bid\":\"1005ZZ10000000002HIA\",\"corderid\":\"1005ZZ10000000002HI9\",\"crowno\":\"10\",\"nexchangeotobrate\":\"1.00000000\",\"nordernum\":\"1\",\"norgtaxprice\":\"11.30\",\"noriginalcurprice\":\"10\",\"ntaxrate\":\"13.00000000\",\"iisactive\":\"0\",\"idiscounttaxtype\":\"1\",\"forderrowstatus\":\"0\",\"cbaseid\":\"0001F410000000044TSB\",\"breceiveplan\":false}]}]","taskNumber":"202309010009"}

错误返回示例:

普通错误返回示例

复制代码

{
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 的值不能为空。]"
}