签约工地管理

创建/更新签约工地

接口地址:/openapi/zxb/customerInfo/saveOrUpdate

请求方式:POST

请求数据类型:multipart/form-data

响应数据类型:*/*

接口描述:
签约公司: https://doc.mokan.cn/docs/open-api/open-api-1d3olci3vp1uk#19onsd 查询type为COMPANY的公司，取id

1设计师: 调用https://doc.mokan.cn/docs/open-api/open-api-1d3ol4t51dta0#569q0p 接口， 取userId

contractFileList：新增必传，修改可不传，上传了文件会覆盖之前的文件
contractUrl: 新增不传，作为文件的地址回显，如果修改没有修改文件，重新传此参数

请求示例:

请求参数:

响应状态:

响应参数:

响应示例:

{
    "code": 0,
    "data": true/false,
    "message": "",
    "successful": true
}

分页列表

接口地址:/openapi/zxb/customerInfo/page?pageNo=1&pageSize=10

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "contractNo": "",
  "projectName": "",
  "houseOwnerName": "业主姓名或业主电话"
}

请求参数:

响应状态:

响应参数:

响应示例:

{
    "code": 0,
    "data": {
        "current": 0,
        "records": [
            {
                "id": 1,
                "tenantId": 1,
                "orgId": 1,
                "orgName": "",
                "projectName": "",
                "address": "",
                "houseOwnerName": "",
                "houseOwnerPhone": 0,
                "houseOwnerIdCard": "",
                "houseOwnerUserId": 1,
                "contractNo": "",
                "designerId": 1,
                "designerName": "",
                "planDays": 1,
                "planEndDate": "",
                "planStartDate": "",
                "contractUrl": "",
                "longitude": "",
                "latitude": "",
                "contractAmountYuan": 1.11,
                "earnestAmountYuan": 1.11,
                "orderRelease": true,
                "settleOff": false
            }
        ],
        "size": 0,
        "total": 0
    },
    "message": "",
    "successful": true
}

根据id详情

接口地址:/openapi/zxb/customerInfo/getById?id=123

请求方式:GET

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:

请求参数:

响应状态:

响应参数:

响应示例:

{
    "code": 0,
    "data": {
        "id": 1,
        "tenantId": 1,
        "orgId": 1,
        "orgName": "",
        "projectName": "",
        "address": "",
        "houseOwnerName": "",
        "houseOwnerPhone": 0,
        "houseOwnerIdCard": "",
        "houseOwnerUserId": 1,
        "contractNo": "",
        "designerId": 1,
        "designerName": "",
        "planDays": 1,
        "planEndDate": "",
        "planStartDate": "",
        "contractUrl": "",
        "longitude": "",
        "latitude": "",
        "contractAmountYuan": 1.11,
        "earnestAmountYuan": 1.11,
        "orderRelease": true,
        "settleOff": false
    },
    "message": "",
    "successful": true
}

根据ID删除签约工地

接口地址:/openapi/zxb/customerInfo/{id}

请求方式:DELETE

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:

请求参数:

响应状态:

响应参数:

响应示例:

{
    "code": 0,
    "data": {},
    "message": "",
    "successful": true
}

资金结算

接口地址:/openapi/zxb/customerInfo/fundSettlement?id=123

请求方式:POST

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:
id为签约工地id或业务工地id

请求参数:

响应状态:

响应参数:

响应示例:

{
    "code": 0,
    "data": {},
    "message": "",
    "successful": true
}

根据签约工地查询详情(用于确认开工时查询，组装新增实际工地时，用于回填实际工地的数据组装)

接口地址:/openapi/zxb/customerInfo/detailByCustomerId/{customerId}

请求方式:GET

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:
合同附件请在签约工地修改接口处理好，确认开工时不能修改合同附件

请求参数:

响应状态:

响应参数:

响应示例:

{
    "code": 200,
    "message": "成功",
    "data": {
        "project": {
            "name": "12312312311",
            "orgId": "1363692883161612290",
            "contractNo": "123331233",
            "address": "吉林省通化市集安市水云涧·美宿(集安火盆街店)",
            "longitude": "126.188324",
            "latitude": "41.128125",
            "planStartDate": "2025-10-23",
            "planEndDate": "2025-10-30",
            "contractAmountYuan": 123.00,
            "earnestAmountYuan": 321.00,
            "contractUrl": "[{\"url\": \"https://test.com/202510/0d5871d3-658c-4153-8c31-a1ddc18c4c8a.pdf\", \"name\": \"test.pdf\", \"type\": \"application/pdf\"}]",
            "cooperationCompanyId": "1363692883161612290",
            "houseOwners": [
                {
                    "userName": "123",
                    "userId": "1981250826076684289",
                    "phoneNumber": "12312312312",
                    "idCard": "123123123123123"
                }
            ],
            "positionMemberMap": {
                "1363006906646626305": [
                    {
                        "userId": "1364141217155510274",
                        "userName": "杜霖儿",
                        "orgId": "1364141051308535810",
                        "orgName": "设计一部",
                        "positionId": "1363006906646626305",
                        "positionName": "设计师",
                        "phoneNumber": "16284953758"
                    }
                ]
            }
        }
    },
    "successful": true
}

签约工地确认开工(创建在建工地)

接口地址: 调用下面一步工地新增或普通新增工地，后续工地维护接口调用https://doc.mokan.cn/docs/open-api/open-api-1d3ol4t51dta0 里的接口

请求方式:POST

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:
根据上个接口的返回数据组装创建在建工地数据，且自行补充其他必填参数
创建在建工地时新增需传参数：zxbCustomerId(签约工地id)、contractAmountYuan(合同金额(元))、earnestAmountYuan(定金金额(元))、contractUrl(合同附件url)、cooperationCompanyId(签约公司ID)、positionMemberMap(成员信息)

请求参数:

一步工地新增（带设备）

接口地址:/openapi/project/auto/oneStepAdd

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

提示:

为保证大屏正常显示，工地地址格式为：省市区街道小区名称
如：四川省成都市成华区仙韵二路33号泰博理想城

请求示例:

{
        "projectDevices": [{
                "serialNum": "DV6xxxxxx",
                "bindDate": "2022-06-29 18:00:54"
        }],
        "houseOwners":[{
            "userName":"张三",
            "phoneNumber":"1235545",
            "userId": "1981250826076684289",
            "idCard": "123123123123123" 
        }],
        "project": {
                "address": "xxxxxx泰博理想城",
                "supervisorName": "李主要（主要负责人）",
                "supervisorPhone": "1811xxx382",
                "managerName": "张次要（次要负责人）",
                "managerPhone": "1308xxx568",
                "stageId": 1802656139923218436,
                "name": "xxx邦泰天著18-1-13-52",
                "planDays": 75,
                "weekendWork": "true",
                "applyToSecondMaster":false,
                "latitude":"28.119164",
                "longitude":"112.963421",
                "productName":"产品名称",
                "companyId":"xxx",

                // 以下5个字段为签约工地回写字段
                "zxbCustomerId": 123,
                "contractAmountYuan": 1.12,
                "earnestAmountYuan": 1.1,
                "contractUrl": "[{\"url\": \"https://test.com/202510/0d5871d3-658c-4153-8c31-a1ddc18c4c8a.pdf\", \"name\": \"test.pdf\", \"type\": \"application/pdf\"}]",
                "cooperationCompanyId": 123
        },
        "positionMemberMap": { // 该字段为签约工地回写字段
            "1363006906646626305": [
                {
                    "userId": "1364141217155510274",
                    "userName": "杜霖儿",
                    "orgId": "1364141051308535810",
                    "orgName": "设计一部",
                    "positionId": "1363006906646626305",
                    "positionName": "设计师",
                    "phoneNumber": "16284953758"
                }
            ]
        }
}

请求参数:

请求参数:

响应状态:

响应参数:

响应示例:

{
    "code": 200,
    "data": "123456789522562",
    "message": "",
    "successful": true
}

普通新增工地（推荐使用一步新增）

接口地址:/openapi/project/add

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
    "address": "",
    "bathRoom": 0,
    "bedRoom": 0,
    "budgetAmount": 0,
    "buildArea": 0,
    "contractNo": "",
    "customerName": "",
    "customerPhone": "",
    "estateName": "",
    "houseNum": "1",
    "houseRoom": "1",
    "houseUnit": "1",
    "innerArea": 0,
    "latitude": "",
    "livingRoom": 0,
    "longitude": "",
    "managerEopId": 0,
    "name": "",
    "planDays": 0,
    "planStartDate": "",
    "supervisorEopId": 0,
    "weekendWork": false,
    "stageId":0,
    "productName":"产品名称",

    // 以下7个字段为签约工地回写字段
    "zxbCustomerId": 123,
    "contractAmountYuan": 1.12,
    "earnestAmountYuan": 1.1,
    "contractUrl": "[{\"url\": \"https://test.com/202510/0d5871d3-658c-4153-8c31-a1ddc18c4c8a.pdf\", \"name\": \"test.pdf\", \"type\": \"application/pdf\"}]",
    "cooperationCompanyId": 123,
    "houseOwners":[{
        "userName":"张三",
        "phoneNumber":"1235545",
        "userId": "1981250826076684289",
        "idCard": "123123123123123"
    }],
    "positionMemberMap": {
        "1363006906646626305": [
            {
                "userId": "1364141217155510274",
                "userName": "杜霖儿",
                "orgId": "1364141051308535810",
                "orgName": "设计一部",
                "positionId": "1363006906646626305",
                "positionName": "设计师",
                "phoneNumber": "16284953758"
            }
        ]
    }
}

请求参数:

响应状态:

响应参数:

响应示例:

{
    "code": 0,
    "data": {},
    "message": "",
    "successful": true
}