API开发文档 - 道一云

开发说明

开发说明

功能说明：获取到合同信息
请求方式：POST（HTTPS）
请求地址：https://qwif.do1.com.cn/qwcgi/api/crmAction/getContractInfo.do?token=token&corpId=corpId

请求包体：

{
    "startTimes":"2017-01-01",
    "endTime":"2017-01-31",
    "pageSize":100,
    "currentPage":1
}

请求参数说明：

参数	说明	类型	是否必须	备注
token	用于验证	String	是	详见道一云平台TOKEN接口文档
corpId	公司唯一标识	String	是	企业corpId
startTimes	创建时间开始点	String	是	时间格式为yyyy-MM-dd
endTime	创建时间结束点	String	是	创建时间间隔不的超过两个月
currentPage	查询页码	int	是	必须为正整数,如果当前页超过最大页数,则当前页默认为最大页
pageSize	分页大小	int	否	默认为100,并且不超过1000

SDK调用示例：

		// 创建请求参数
		CrmDataPush vo = new CrmDataPush();
		// 设置当前页面
		vo.setCurrentPage(1);
		// 设置分页大小
		vo.setPageSize(10);
		// 设置合同信息的查询时间段（不超过两个月）
		vo.setStartTimes("2018-06-01");
		vo.setEndTime("2018-8-01");
		System.out.println(JSONUtil.stringify(vo));
		CrmApi api = QwSdkUtil.getInter(CrmApi.class);
		// 调用接口
		CrmContractInfoPageResult contractInfo = api.getContractInfo(
				QwSdkUtil.getCacheToken(), vo);
		System.out.println(JSONUtil.stringify(contractInfo));

返回结果：

{
  "code": "0",
  "desc": "成功",
  "data": {
    "currPage": 1,
    "pageSize": 100,
    "maxPage": 1,
    "totalRows": 38,
    "pageData": [
      {
        "id": "abbd478f035f470a88324848f0302c41",
        "businessName": "道一云平台_商机",
        "ccPersonNames": "杨嘉明,罗博文,邓振鹏",
        "relativePersonNames": "小道,企小薇",
        "clientName": "某知名企业",
        "content": "VIP",
        "contractAmount": "3000.0",
        "contractCode": "20171203123123",
        "contractStatus": "1",
        "deelDate": "2017-04-01 00:00:00.0",
        "endTime": "2017-04-08 00:00:00.0",
        "nonPaymentAmount": 20093401.0,
        "nonPaymentInvoice": 172204365.4,
        "ourSignatory": "企小薇",
        "payment": "1",
        "paymentAmount": 77000,
        "personName": "小道",
        "remark": "备注信息",
        "signatory": "张三",
        "startTime": "2017-04-01 00:00:00.0",
        "title": "采购合同",
        "typeName": "采购合同"
        "optionMap": {
          "选项": "选项1",
          "日期": "2018-02-01 14:04",
          "联系电话": "134302xxxxx",
          "单行文本": "xxxxx",
          "多行文本": "xxxxx"
        },
        "receiveStepInfo": [
          {
            "actualReceive": [
              {
                "actualMoney": 1000.0,
                "actualTime": "2017-04-01"
              }
            ],
            "invoice": [
              {
                "invoiceMoney": 1000.0,
                "invoicelTime": "2017-04-01"
              }
            ],
            "planReceive": {
              "planMoney": 1000.0,
              "planTime": "2017-04-02"
            }
          }
        ]
      }
    ]
  }
}

返回参数说明：

参数	说明
currentPage	当前页
pageSize	分页大小
maxPage	最大页
totalRows	信息总条数

pageData参数	说明
id	合同ID
businessName	商机名称
ccPersonNames	负责人名称，两个以上用英文逗号“,”隔开
relativePersonNames	相关人名称，两个以上用英文逗号“,”隔开
clientName	客户名称
content	内容
contractAmount	合同金额
contractCode	合同代码
contractStatus	合同状态 0执行前 1执行中 2结束 3意外终止
deelDate	签约日期
endTime	合同结束时间
nonPaymentAmount	未回款金额
nonPaymentInvoice	已开票未回款金额
ourSignatory	我方签约人，两个以上用英文逗号“,”隔开
payment	支付方式 0支票 1现金 2邮政汇款 3电汇 4网上转账 5支付宝 6微信 7其他
paymentAmount	回款金额
personName	创建人
remark	备注
signatory	对方签约人
startTime	合同开始时间
title	标题
typeName	类型名
optionMap	自定义字段键值对
receiveStepInfo	回款期次详细见回款期次信息说明

回款期次	说明
planReceive	该期次计划回款信息
planTime	该期次计划回款时间
planMoney	该期次计划回款金额
actualReceive	该期次实际回款信息数组
actualTime	该期次实际回款时间
actualMoney	该期次实际回款金额
invoice	该期次开票信息数组
invoiceTime	该期次开票时间
invoiceMoney	该期次开票金额

企业微信

获取合同信息列表

开发说明