3.24 合同列表查询 - 甄零开放平台

请求参数

Query 参数

domain

string

可选

示例值:

BASE.CONTRACT.PAGE_QUERY

Header 参数

Authorization

string

可选

默认值:

Body 参数application/json

page

integer

必需

size

integer

必需

startTime

string

最后更新日期从，如2025-04-01 00:00:00

必需

endTime

string

最后更新日期至，如2025-04-01 00:00:00

必需

contractNumber

string

合同编码

可选

contractSerialNumber

string

合同流水号

可选

otherSourceReceipt

string

来源单据号

可选

和创建合同API中的 sourceCode 一致

statusCode

string

合同状态

可选

多个状态用英文逗号隔开，如 N,S 状态参考字典 310-CONTRACT_STATUS

condition

object

其他任意查询条件

可选

合同基本信息中的字段都可用于查询

categoryUuid

string

合同分类uuid

可选

多个值以英文逗号隔开

startDate

string

有效期从，如2025-04-01

可选

endDate

string

有效期至，如2025-04-01

可选

departmentCode

string

签订部门编码

可选

belongingDepartmentCode

string

业务归属部门编码

可选

示例

{
    "page": 0,
    "size": 100,
    "startTime": "2025-04-01 00:00:00",
    "endTime": "2025-04-30 23:59:59",
    "contractNumber": "",
    "contractSerialNumber": "202504090007",
    "otherSourceReceipt": "",
    "statusCode": "N",
    "condition": {
        "categoryUuid": "98e8d165ae044264a060a4ab58026d4c",
        "startDate": "",
        "endDate": "",
        "departmentCode": "",
        "belongingDepartmentCode": ""
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://oc-test.onecontract-cloud.com/api/hitf/v2p/rest/invoke/SFpFUk86T1JDSEVTVFJBVElPTjpISVRGLkFQSS5TSU5HTEUtU0NSSVBU?domain=BASE.CONTRACT.PAGE_QUERY' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 0,
    "size": 100,
    "startTime": "2025-04-01 00:00:00",
    "endTime": "2025-04-30 23:59:59",
    "contractNumber": "",
    "contractSerialNumber": "202504090007",
    "otherSourceReceipt": "",
    "statusCode": "N",
    "condition": {
        "categoryUuid": "98e8d165ae044264a060a4ab58026d4c",
        "startDate": "",
        "endDate": "",
        "departmentCode": "",
        "belongingDepartmentCode": ""
    }
}'

返回响应

🟢200成功

application/json

Body

message

string

必需

result

object

必需

code

string

必需

msg

string

必需

data

object

必需

success

boolean

必需

示例

{
    "message": "execute success",
    "result": {
        "code": "0",
        "msg": "查询成功",
        "data": {
            "content": [
                {
                    "objectVersionNumber": "6",
                    "createSourceType": "CREATE",
                    "lastStatusCode": "A",
                    "endDate": "2050-01-01 00:00:00",
                    "watermarkFlag": true,
                    "lastUpdateDate": "2025-04-09 10:55:59",
                    "companyName": "上海甄零科技有限公司",
                    "convertPdfTime": "2025-04-09 10:55:55",
                    "departmentId": "476947875839709473",
                    "uuid": "c8383fdcc3344aebbb3250cc12e4be34",
                    "invertedFlag": "NO",
                    "propertyCode": "ORDINARY",
                    "validDateStartType": "DATE",
                    "isCooperative": false,
                    "changeApprovalFlag": false,
                    "contentUuid": "4542f952a6ae4ab5ad7d08751a155893",
                    "id": "320190341213675103",
                    "departmentName": "研发中心/技术部",
                    "lastUpdatedBy": "695643182304997376",
                    "contractNumber": "CON_0120250409004",
                    "principalName": "陈勇俊",
                    "creationDate": "2025-04-09 10:55:47",
                    "contractSerialNumber": "202504090007",
                    "version": "0",
                    "approvedDate": "2025-04-09 10:55:54",
                    "categoryUuid": "98e8d165ae044264a060a4ab58026d4c",
                    "companyId": "12555621",
                    "submitTime": "2025-04-09 10:55:54",
                    "textSource": "LOCAL",
                    "convertPdfNodeId": "24632:convertFile",
                    "rootContractUuid": "c8383fdcc3344aebbb3250cc12e4be34",
                    "executeStatusCode": "N",
                    "startDate": "2025-01-01 00:00:00",
                    "statusCode": "SIGNING",
                    "belongingDepartmentName": "研发中心/技术部",
                    "closedBy": "0",
                    "sourceSystem": "oms",
                    "principalId": "476953648972028374",
                    "categoryName": "大客销售类合同 ",
                    "hcbmSourceContractLineId": "2540",
                    "createFrom": "NEW",
                    "unitCompanyId": "476947875839709463",
                    "createSettleFlag": "0",
                    "creationMethodCode": "EP",
                    "contractName": "示例合同",
                    "applyRuleId": "266226380394598400",
                    "latest": true,
                    "validDateEndType": "DATE",
                    "tradingName": "上海甄零科技有限公司杭州分公司,上海甄零科技有限公司",
                    "belongingDepartmentId": "476947875839709473",
                    "amount": "1000.12",
                    "creator": "陈勇俊",
                    "existChange": "false",
                    "categoryCode": "0101",
                    "inOutTypeCode": "I",
                    "existSync": false,
                    "renewed": "NO",
                    "createdBy": "695643182304997376",
                    "contractId": "320190341213675103",
                    "tenantId": "1273",
                    "otherSourceReceipt": "DEMO_20250101007",
                    "closed": "NO",
                    "paymentInitFlag": false,
                    "createByEmployeeNumber": "0001",
                    "departmentCode": "1001",
                    "belongingDepartmentCode": "1001",
                    "principalNum": "0001"
                }
            ],
            "number": 0,
            "size": 100,
            "totalElements": 1,
            "totalPages": 1
        }
    },
    "success": true
}