关联前置单据介绍

你在什么情况下能用到？

公司同时使用多个系统（采购系统、财务系统、ERP管理系统等），当我需要发起合同申请时，是需要关联一下我在别的系统中已审批通过的单据，作为我发起合同的依据。
例如：智书合同一个涉及采购的合同审批，采购的业务同学提交合同申请时需要把在采购系统中的审批单据作为依据贴在合同申请中，法务、财务在进行合同审批时

可以帮你解决什么问题？

其他系统中的流程单据可以作为当前表单内容展示给审批人看。

通过配置后，可以通过查询获取需要关联上的前置单据。

如何三个步骤完成你的配置？

需要公司开发同学根据「开发者文档」中的要求开发相应数据接口；

管理员将开发同学开发的接口填入关联前置单据的接口中

入口：合同字段管理，在「相关单据」中新增「关联前置单据」字段

字段中「可关联的单据类型」选择第三方系统审批单据

然后点击配置API接口

添加完成后，点击编辑进入接口配置

前置审批单据的API配置

URL，配置获取外部数据源的接口

token与key，为了确保数据安全，开发者可以设置接口的 token 和 key，管理员配置时填入，确保数据不被外泄（ key 为非必需）

完成配置后，需要进行模拟，验证一下接口配置的效果

在模拟中可以模拟申请人、合同类型等数据

模拟成功后就完成添加了

3. 用户使用关联前置单据

在表单配置中添加「关联前置单据」的字段并完成发布

员工在提交时就可以选择前置单据了

技术文档

请求

参数	说明
HttpUrl	业务方提供
HttpMethod	POST

请求头

名称	类型	必填	描述	示例值
token	string	是	值格式："access_token"	"u - 7f1bcd13fc57d46bac21793a18e560"

说明

access_token由业务方提供或者通过动态token接口获取

查询参数

名称	类型	必填	描述	示例值
userId	string	是	用户ID，智书开放平台的user_id	xxxx0001
keywords	string	否	用户搜索的关键词	预算
contractTypes	object	是	合同类型	-
level1Name	string	是	合同一级分类	-
level1Id	string	是	一级分类ID	-
level2Name	string	是	合同二级分类	-
level2Id	string	是	二级分类ID	-

说明：

user_id为智书开放平台的user_id

示例

返回结果

编码	类型	是否必须	描述
code	int	是	结果码，非 0 即错误
msg	string	结果码 = 0 时，必须	错误描述
data	-	是	-
∟ total	int	是	总共数量
∟ receipts	[]	是	单据
∟∟ id	string	是	唯一标识
∟∟ title	string	是	标题
∟∟ content	string	是	内容
∟∟ createTime	long	是	创建时间
∟∟ mobileAppLink	string	是	手机端访问链接
∟∟ pcAppLink	string	是	pc 端访问链接
∟∟ sponsor	string	是	实际是需要使用飞书的userId

说明：

如果返回的结果超过 100 条，则默认返回前 100 条，排序规则是按照创建时间倒排；

如果需要加密则对整个返回结果进行加密返回

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "total": 2,
        "receipts": [
            {
                "id": "100001",
                "title": "预算审批单据——103498173857245",
                "content": "采购部 预算金额10000元",
                "sponsor": "1013213",
                "createTime": 4345834230000,
                "pcAppLink": "https://myapp/100001",
                "mobileAppLink": ""
            },
            {
                "id": "100002",
                "title": "预算审批单据——103498543857245",
                "content": "合规部 预算金额10000元",
                "sponsor": "1013212",
                "createTime": 4345834230000,
                "pcAppLink": "https://myapp/100002",
                "mobileAppLink": ""
            }
        ]
    }
}

错误码

编码	描述
0	正确
60001	token 校验失败
60002	加解密异常
60003	系统异常

关联前置单据

关联前置单据介绍#

你在什么情况下能用到？#

可以帮你解决什么问题？#

如何三个步骤完成你的配置？#

技术文档#

请求#

请求头#

查询参数#

示例#

返回#

返回结果#

返回示例#

错误码#