纷享销客开发者手册 纷享销客开发者手册
  • APL开发手册
  • PWC开发手册
  • OpenAPI 文档
  • 快速入门
  • API 授权流程
  • API 基础说明
  • OpenAPI
  • 免登集成方案
  • 客户端开发
  • 常见问题
  • OpenApi V1版本 (opens new window)
  • 简体中文
  • English
  • 快速入门
  • API 授权流程
  • API 基础说明
  • OpenAPI
  • 免登集成方案
  • 客户端开发
  • 常见问题
  • OpenApi V1版本 (opens new window)
  • 简体中文
  • English
  • 快速入门

  • API授权流程

  • API基础说明

  • OpenAPI

    • CRM对象接口

    • CRM对象通用接口

    • 通讯录接口

    • 其他接口

      • 任务待办接口

      • 考勤外勤接口

        • 创建外勤计划
          • 获取考勤数据列表
          • 获取高级外勤数据列表
          • 查询考勤规则
          • 获取外勤类型
          • 获取外勤数据列表
          • 获取高级外勤数据描述
          • 获取高级外勤数据详情
          • 保存外勤路线接口
          • 获取考勤数据列表(新)
        • 协同审批接口

        • 企业互联接口

        • 消息接口

        • 素材管理接口

        • 网盘接口

        • 营销通接口

        • 文件服务

        • ERP接口

        • BI接口

        • 下线接口

    • 免登集成方案

    • 客户端开发

    • 常见问题

    目录

    创建外勤计划

    # 描述

    创建外勤计划

    # 请求说明

    请求方式:POST + application/json

    请求路径:https://${填入所在云的域名}/cgi/seniorOutsideAttendance/createPlan?thirdTraceId=${随机字符串}

    请求头填写 :参考公共参数填写

    # 请求参数

    参数 类型 是否必填 说明
    data Map 是 数据集
      planTime Long 否 计划执行时间,未来某个时间的时间戳
      checkTypeId String 否 外勤类型Id
      executorId String 否 计划执行人的openUserId
      assistantIds List 否 协访人的openUserId列表
      extFields Map 否 外勤计划的配置自定义字段模块,字段描述参考高级外勤
      mainObject Map 否 主对象数据
        apiName String 否 关联的主对象的apiName
        dataId String 否 关联的主对象的Id
        info String 否 客户的经纬度
      referenceObject List 否 从对象数据

    # 请求示例

    {
      "data": {
        "extFields": {
          "field_wtdjl__c": [
            "FSUID_2A5C47312075A11F9156B94FC66C0E7A"
          ],
          "field_Xtlzv__c": [
            {
              "path": "b2b09ea0-893b-4ca6-9275-e95a482a5c75"
            }
          ],
          "field_P816C__c": "5e17e1c2bd00210001ffebb4",
          "field_B6U86__c": "option1",
          "field_01RyR__c": "测试哈哈哈"
        },
        "referenceObject": [
          {
            "apiName": "ContactObj",
            "dataId": "5e0239ef10b549000180f30a"
          }
        ],
        "executorId": "{openUserId}",
        "assistantIds": [
          "FSUID_2B2FAD127CFACB0A45CFF551BCE8A4CF"
        ],
        "planTime": 1581519600000,
        "checkTypeId": "5e3c1e5e827f1700013272fb",
        "mainObject": {
          "apiName": "AccountObj",
          "dataId": "116.332363#%$39.976518#%$卫星大厦",
          "info": "5d4414d7e63cd100010efc9d"
        }
      }
    }
    

    # 返回参数

    参数 类型 说明
    traceId string 请求唯一ID
    errorDescription string 错误描述
    errorMessage string 错误信息
    errorCode Int 查看错误码
    checkinId string 外勤计划id

    # 返回示例

    {
      "traceId": "E-O.827xxxxxx",
      "errorDescription": "success",
      "errorMessage": "OK",
      "errorCode": 0,
      "checkinId":"123456"
    }
    

    # 注意事项

    • 不能使用返回值的message字段做逻辑判断,errorMessage会有变化;
    设置企信状态为撤销请假
    获取考勤数据列表

    ← 设置企信状态为撤销请假 获取考勤数据列表 →

    • 跟随系统
    • 浅色模式
    • 深色模式
    • 阅读模式