服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端API
审批
更新审批模板
更新审批模板
最后更新:2024/09/18

目录

  • 错误说明
  • 可调用本接口更新审批模板。更新模板后,管理后台及审批应用内将更新原模板的内容,已配置的审批流程和规则不变。

    请求方式:POST(HTTPS
    请求地址: https://qyapi.weixin.qq.com/cgi-bin/oa/approval/update_template?access_token=ACCESS_TOKEN

    请求示例:

    {
        "template_id": "TEMPLATE_ID",
        "template_name": [{
            "text": "我的api测试模版",
            "lang": "zh_CN"
        }],
       "template_content": {
            "controls": [{
                "property": {
                    "control": "Selector",
                    "id": "Selector-01",
                    "title": [{
                        "text": "多选控件名称",
                        "lang": "zh_CN"
                    }],
                    "placeholder": [{
                        "text": "多选控件说明",
                        "lang": "zh_CN"
                    }],
                    "require": 0,
                    "un_print": 1
                },
                "config":{
                    "selector": {
                    "type": "multi",
                    "options": [
                        {
                            "key": "option-1", 
                            "value":{
                                "text":"选项1",
                                "lang":"zh_CN"
                            }
                        },
                        {
                            "key": "option-2",
                            "value":{
                                "text":"选项2",
                                "lang":"zh_CN"
                            }
                        }
                    ]
                    }
                }
            },
            {
                "property": {
                    "control": "Text",
                    "id": "Text-01",
                    "title": [{
                        "text": "文本控件名称",
                        "lang": "zh_CN"
                    }],
                    "placeholder": [{
                        "text": "文本控件说明",
                        "lang": "zh_CN"
                    }],
                    "require": 0,
                    "un_print": 1
                },
                "config":{
                    
                }
            }]
        }
    
    }

    参数说明:

    参数必须说明
    access_token调用接口凭证。必须使用审批应用或企业内自建应用的secret获取,获取方式参考:文档-获取access_token
    template_id模版id
    template_name模版名称数组
    └ text模版名称。需满足以下条件:1-模版名称不得和现有模版名称重复;2-长度不得超过40个字符。
    └ lang显示语言,中文:zh_CN(注意不是zh-CN)
    template_content审批模版控件设置,可以参考创建审批模板一节 template_content 参数说明

     

    注意
    1. 当模板的控件为必填属性时,表单中对应的控件必须有值。
    2. 一个模版中只能拥有一类假勤控件类型,Vacation-假期;Attendance-外出/出差/加班 均为假勤控件类型。

    权限说明

    应用类型权限要求
    自建应用配置到「审批 - 可调用接口的应用」中
    代开发应用具有「审批」权限
    第三方应用暂不支持
    • 仅能更新自身应用模板

    注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情


    返回结果:

    {
        "errcode":0,
        "errmsg":"ok"
    }

    参数说明:

    参数说明
    errcode错误码,详情见错误码说明
    errmsg错误码对应的错误信息提示

     

    错误说明

    错误码说明
    301088无审批应用权限
    301086审批控件参数错误
    301087企业模版数超过上限
    301115模板已配置自定义打印格式,不支持API修改模板
    620004服务器内部错误
    -1未知错误
    上一篇创建审批模板
    下一篇发起语音电话
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们