U8C API中心

API中心

合同管理
销售合同

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

销售合同查询

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

详细描述:合同状态(ctflag)可输入的值：0（自由状态）、1（审核状态）、2（生效状态）、4（冻结状态）、5（终止状态）、6（正在审核）、不填值（全部状态）

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/ct/so/query

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

参数名	必填	描述	默认值
Content-Type	是	请求体数据类型	application/json
usercode	是	用户
password	是	密码
system	是	系统参数

请求参数(body):

参数名	是否数组	必填	描述
corp	否	是	公司
ctcode	否	否	合同编码
ctflag	否	否	合同状态
cust	否	否	客户
date_begin	否	否	起始日期（v3.5版本前必填）
date_end	否	否	结束日期（v3.5版本前必填）
dep	否	否	部门
endSubscribedate	否	否	合同签订日期止（v3.5版本支持）
endTs	否	否	结束时间戳（v3.5版本支持）
inv	否	否	存货
invcl	否	否	存货分类
maker	否	否	制单人
page_now	否	否	起始页
page_size	否	否	每页显示条数
personnel	否	否	人员
startSubscribedate	否	否	合同签订日期起（v3.5版本支持）
startTs	否	否	开始时间戳（v3.5版本支持）

返回类型参数:

参数名	类型	是否数组	必填	描述
ManageVO_Z4				销售合同聚合实体_返回
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	否	否	存货分类名称
invclid	string	否	否	存货分类id
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	否	否	合同表体主键
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		否	否	销售合同表头返回值实体
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	否	否	客户名称
custunit	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	否	否	打印次数
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	否	否	合同主键
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	否	否	项目号
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#模板示例下载

请求参数示例:

复制代码

{"date_end":"2018-09-12","date_begin":"2018-08-02","ctflag":0,"inv":"123123","invcl":"11","corp":"8000","startTs":"2021-08-09 14:32:00","endTs":"2021-08-10 14:32:00"}

正确返回示例:

复制代码

{
"status": "success",
 "data": "{\"allcount\":1,\"retcount\":1,\"datas\":[{\"parentvo\":{\"pk_corp\":\"1020\",\"unitcode\":\"8000\",\"unitname\":\"好未来\",\"ct_code\":\"RC1809120002\",\"ct_name\":\"111\",\"pk_ct_type\":\"1020ZZ10000000000MDV\",\"typecode\":\"03\",\"typename\":\"test03\",\"version\":\"1.0\",\"subscribedate\":\"2018-09-12\",\"valdate\":\"2018-09-12\",\"invallidate\":\"2018-09-13\",\"custid\":\"1020F8100000000003V8\",\"custcode\":\"5599\",\"custname\":\"八\",\"currid\":\"00010000000000000001\",\"currcode\":\"CNY\",\"currname\":\"人民币\",\"currrate\":\"1.00000000\",\"ctflag\":\"0\",\"operdate\":\"2018-09-12\",\"tmaketime\":\"2018-09-12 09:38:00\",\"clastoperatorid\":\"0001F8100000000003WZ\",\"vlastoperatorcode\":\"18246070991\",\"vlastoperatorname\":\"体验人员\",\"tlastmaketime\":\"2018-09-12 09:38:00\",\"iprintcount\":\"0\",\"operid\":\"0001F8100000000003WZ\",\"opercode\":\"18246070991\",\"opername\":\"体验人员\"},\"childrenvo\":[{\"invid\":\"1020F8100000000003W1\",\"invcode\":\"123123\",\"invname\":\"欠妥\",\"crowno\":\"10\",\"measid\":\"0001F810000000000DAJ\",\"meascode\":\"01\",\"measname\":\"个\",\"amount\":10,\"taxration\":16}]}]}"
}

错误返回示例:

复制代码

{
"status": "falied",
"errorcode": "-32000",
"errormsg": "下列查询条件必须输入：[corp]"
}