U8C API中心

API中心

合同管理
采购合同

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

采购合同新增

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

详细描述:用于采购合同新增

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

全量参数存货&数量必填的场景参照请购单新增合同场景示例

参数名	类型	是否数组	必填	描述
ManageVO_Z2		是	是
childrenvo		是	是	采购合同表体VO
amount	double	否	否	数量
astmeasid	string	否	否	辅计量单位
crowno	string	否	否	行号
def20	string	否	否	备注
invclid	string	否	否	存货分类
invid	string	否	否	存货
measid	string	否	否	主计量单位
oriprice	double	否	否	原币无税单价
orisum	double	否	否	原币无税金额
oritaxmny	double	否	否	原币税额
oritaxprice	double	否	否	原币含税单价
oritaxsummny	double	否	是	原币价税合计
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_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
taxration	double	否	否	税率
parentvo		否	是	采购合同表头VO
actualinvalidate	string	否	是	实际终止日期
audiid	string	否	否	审核人
auditdate	string	否	否	审核日期
clastoperatorid	string	否	否	最后修改人
ct_code	string	否	否	合同编码
ct_name	string	否	是	合同名称
ctflag	int	否	否	合同状态
currid	string	否	是	币种
currrate	double	否	否	折本汇率
custid	string	否	是	供应商
depid	string	否	否	部门
invallidate	string	否	是	计划失效日期
iprintcount	int	否	否	打印次数
noriprepaymny	double	否	否	原币预付款
noritotalgpamount	double	否	否	累计原币付款总额
operdate	string	否	否	制单日期
operid	string	否	是	制单人
personnelid	string	否	否	人员
pk_corp	string	否	是	公司
pk_ct_type	string	否	是	合同类型
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_defdoc2	string	否	否	自定义项2
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
projectid	string	否	否	项目号
subscribedate	string	否	是	合同签订日期
taudittime	string	否	否	审批时间
tlastmaketime	string	否	否	最后修改时间
tmaketime	string	否	否	制单时间
valdate	string	否	是	计划生效日期
version	string	否	否	版本号

返回类型参数:

参数名	类型	是否数组	必填	描述
ManageVO_Z2				采购合同聚合实体_返回
childrenvo		是	否	采购合同表体返回值实体
amount	double	否	否	数量
astmeascode	string	否	否	辅计量单位编码
astmeasid	string	否	否	辅计量单位id
astmeasname	string	否	否	辅计量单位名称
crowno	string	否	否	行号
def1	string	否	否	自定义项1
def10	string	否	否	自定义项10
def11	string	否	否	自定义项11
def12	string	否	否	自定义项12
def13	string	否	否	自定义项13
def14	string	否	否	自定义项14
def15	string	否	否	自定义项15
def16	string	否	否	自定义项16
def17	string	否	否	自定义项17
def18	string	否	否	自定义项18
def19	string	否	否	自定义项19
def2	string	否	否	自定义项2
def20	string	否	否	自定义项20
def3	string	否	否	自定义项3
def4	string	否	否	自定义项4
def5	string	否	否	自定义项5
def6	string	否	否	自定义项6
def7	string	否	否	自定义项7
def8	string	否	否	自定义项8
def9	string	否	否	自定义项9
invclasscode	string	否	否	存货分类编码
invclassname	string	否	否	存货分类名称
invcode	string	否	否	存货编码
invid	string	否	否	存货id
invname	string	否	否	存货名称
meascode	string	否	否	主计量单位编码
measid	string	否	否	主计量单位id
measname	string	否	否	主计量单位名称
noritotalgpmny	double	否	否	累计原币付款金额
ordnum	double	否	否	订单执行累计数量
ordsum	double	否	否	订单执行累计本币价税合计
oriprice	double	否	否	原币无税单价
orisum	double	否	否	原币无税金额
oritaxmny	double	否	否	原币税额
oritaxprice	double	否	否	原币含税单价
oritaxsummny	double	否	否	原币价税合计
pk_ct_manage_b	string	否	否	合同表体主键（V5.0sp开始支持）
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
taxration	double	否	否	税率
parentvo		否	否	采购合同表头返回值实体
actualinvalidate	string	否	否	实际终止日期
audicode	string	否	否	审批人编码
audiid	string	否	否	审核人id
audiname	string	否	否	审批人名称
auditdate	string	否	否	审核日期
clastoperatorid	string	否	否	最后修改人id
ct_code	string	否	否	合同编码
ct_name	string	否	否	合同名称
ctflag	int	否	否	合同状态
currcode	string	否	否	币种编码
currid	string	否	否	币种id
currname	string	否	否	币种名称
currrate	double	否	否	折本汇率
custcode	string	否	否	供应商编码
custid	string	否	否	供应商id
custname	string	否	否	供应商名称
def1	string	否	否	自定义项1
def10	string	否	否	自定义项10
def11	string	否	否	自定义项11
def12	string	否	否	自定义项12
def13	string	否	否	自定义项13
def14	string	否	否	自定义项14
def15	string	否	否	自定义项15
def16	string	否	否	自定义项16
def17	string	否	否	自定义项17
def18	string	否	否	自定义项18
def19	string	否	否	自定义项19
def2	string	否	否	自定义项2
def20	string	否	否	自定义项20
def3	string	否	否	自定义项3
def4	string	否	否	自定义项4
def5	string	否	否	自定义项5
def6	string	否	否	自定义项6
def7	string	否	否	自定义项7
def8	string	否	否	自定义项8
def9	string	否	否	自定义项9
depcode	string	否	否	部门编码
depid	string	否	否	部门id
depname	string	否	否	部门名称
invallidate	string	否	否	计划失效日期
iprintcount	int	否	否	打印次数
noriprepaymny	double	否	否	原币预付款
noritotalgpamount	double	否	否	累计原币付款总额
opercode	string	否	否	制单人编码
operdate	string	否	否	制单日期
operid	string	否	否	制单人id
opername	string	否	否	制单人名称
percode	string	否	否	人员编码
pername	string	否	否	人员名称
personnelid	string	否	否	人员id
pk_corp	string	否	否	公司id
pk_ct_manage	string	否	否	合同主键（V5.0sp开始支持）
pk_ct_type	string	否	否	合同类型id
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
projectcode	string	否	否	项目编码
projectid	string	否	否	项目号id
projectname	string	否	否	项目名称
subscribedate	string	否	否	合同签订日期
taudittime	string	否	否	审批时间
tlastmaketime	string	否	否	最后修改时间
tmaketime	string	否	否	制单时间
typecode	string	否	否	合同类型编码
typename	string	否	否	合同类型名称
unitcode	string	否	否	公司编码
unitname	string	否	否	公司名称
valdate	string	否	否	计划生效日期
version	string	否	否	版本号
vlastoperatorcode	string	否	否	最后修改人编码
vlastoperatorname	string	否	否	最后修改人名称

代码示例:

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

请求参数示例:

存货&数量必填的场景参照请购单新增合同场景示例

复制代码

{"ManageVO_Z2":[{"parentvo":{"pk_corp":"3101","operid":"apicyc","ct_name":"Z2INSERT","pk_ct_type":"c2","subscribedate":"2023-10-08","valdate":"2023-10-08","invallidate":"2030-09-07","custid":"CU0029","currid":"CNY","actualinvalidate":"2030-09-07"},"childrenvo":[{"oritaxsummny":"10","invid":"c09011","amount":"1"}]}]}

正确返回示例:

复制代码

{"status":"success","data":"[{\"parentvo\":{\"pk_corp\":\"1012\",\"unitcode\":\"3101\",\"unitname\":\"cyc交通建设集团有限公司\",\"ct_code\":\"RC2310080001\",\"ct_name\":\"Z2INSERT\",\"pk_ct_type\":\"1012A210000000001YZM\",\"typecode\":\"c2\",\"typename\":\"c2\",\"version\":\"1.0\",\"subscribedate\":\"2023-10-08\",\"valdate\":\"2023-10-08\",\"invallidate\":\"2030-09-07\",\"actualinvalidate\":\"2030-09-07\",\"custid\":\"0001A21000000000LS8G\",\"custcode\":\"CU0029\",\"custname\":\"测试一下\",\"depid\":\"\",\"currid\":\"00010000000000000001\",\"currcode\":\"CNY\",\"currname\":\"人民币\",\"currrate\":\"1.00000000\",\"ctflag\":\"0\",\"operid\":\"0001A2100000000000YV\",\"opercode\":\"apicyc\",\"opername\":\"cyc\",\"operdate\":\"2023-10-08\",\"tmaketime\":\"2023-10-08 16:24:22\",\"clastoperatorid\":\"0001A2100000000000YV\",\"vlastoperatorcode\":\"apicyc\",\"vlastoperatorname\":\"cyc\",\"tlastmaketime\":\"2023-10-08 16:24:22\",\"iprintcount\":\"0\",\"pk_ct_manage\":\"1012A210000000001YZT\"},\"childrenvo\":[{\"crowno\":\"10\",\"invid\":\"1012F410000000001HA5\",\"invcode\":\"c09011\",\"invname\":\"c09011\",\"measid\":\"0001A2100000000003DG\",\"meascode\":\"1\",\"measname\":\"件1\",\"amount\":\"1\",\"oriprice\":\"8.85\",\"taxration\":\"13.00000000\",\"oritaxprice\":\"10.00\",\"orisum\":\"8.849558\",\"oritaxmny\":\"1.150442\",\"oritaxsummny\":\"10\",\"pk_ct_manage_b\":\"1012A210000000001YZU\"}]}]","taskNumber":"202310080005"}

错误返回示例:

复制代码

{
"status": "falied",
"errorcode": "-32000",
"errormsg": "制单人不能为空！"
}