## 接口说明
该接口按查询条件分页检索飞书审批实例,是飞书审批数据集成的入口。典型场景:把审批通过的费用报销、付款申请、采购申请实例同步到 ERP/财务系统生成凭证或单据,打通 OA 审批到业财核算。
### 请求要点
1. POST + application/json,header 带 Authorization: Bearer {tenant_access_token}。
2. body 参数:approval_code(审批定义编码,可多个)、instance_code(按实例编号精确查)、start_time/end_time(毫秒时间戳,限定实例创建时间)、page_size(≤100)、page_token(翻页)。
3. 响应 data.instance_code_list(或按版本返回实例摘要数组)+ page_token/has_more;拿到实例编号后用 /open-apis/approval/v4/instances/{instance_id} 拉表单详情(form 字段为 JSON 字符串,需二次解析)。
4. 查询窗口建议按天切片;增量同步以 start_time 游标推进并重叠数分钟。
### 字段映射要点
- 表单详情中每个控件有 id、name、type、value;金额控件值为字符串数字,日期控件为毫秒时间戳,映射到 ERP 字段前要统一类型。
- 审批状态:APPROVED 才应写入财务;REJECTED/CANCELED 要同步状态用于冲销。
### 幂等
轻易云以 instance_code 作为幂等键,同一实例重复拉取不会产生重复凭证。