## 接口说明
getapprovallist 按时间范围游标分页返回审批单号(sp_no)列表,是企业微信审批数据集成的第一步:先取单号,再用 cgi-bin/oa/getapprovaldetail 按 sp_no 拉审批详情(模板控件值、审批流程、状态)。典型场景:报销、付款、请假审批同步到 ERP 生成应付、凭证或考勤记录。
### 请求要点
1. POST + application/json,access_token 放 URL query。
2. body 参数:starttime/endtime(秒级时间戳,窗口不能超过 30 天)、new_cursor(游标,首页可不传或 0)、size(每页 ≤100)、filters(过滤数组,支持 key=template_id 按模板过滤、key=sp_status 按审批状态过滤)。
3. 响应 sp_no_list 为单号数组,next_cursor 用于翻页;返回空数组即拉完。
4. 时间窗口 ≤30 天,历史回补按月切片;增量同步以 endtime 为游标推进并重叠数分钟,防止审批状态变化漏抓。
### 集成建议
- 详情接口中控件值在 applyer/template_content 结构里,控件 id 与标题随模板版本变化,映射配置建议字典化维护。
- 审批状态 sp_status:2 表示已通过,只有已通过的审批单才写入财务;轻易云以 sp_no 为幂等键,状态变化触发更新而非重复建单。
- 拉取频率受企业微信频控限制,批量回补要控制并发。