单据通用查询(ExecuteBillQuery·销售订单)

## 接口说明 ExecuteBillQuery 是金蝶云星空开放能力最强的查询接口:对任意单据 FormId 指定返回字段(FieldKeys)与过滤条件(FilterString,类 SQL where 语法),以分页方式返回行数据。同步销售订单时 FormId 取 SAL_SaleOrder,其他常用 FormId 有采购订单 PUR_PurchaseOrder、销售出库单 SAL_OUTSTOCK、应收单 AR_RECEIVABLE 等。 ### 请求要点 1. 必须先完成 LoginByAppSecret 登录并携带会话 Cookie 调用。 2. FieldKeys 用英文逗号拼接字段标识,明细行字段要带实体前缀,例如 FSaleOrderEntry_FMaterialId.FNumber。 3. FilterString 建议按单据修改时间增量过滤:FModifyDate >= '上次同步时间',配合 FDocumentStatus 过滤已审核单据。 4. 分页使用 StartRow + Limit(单页建议 2000 行以内),返回行数小于 Limit 时说明已到末页。 5. TopRowCount 一般传 0(不限制),仅靠分页参数控制。 ### 集成建议 轻易云读取金蝶销售订单时,默认以 FModifyDate 做增量游标,并将 FBillNo + 明细行序号作为幂等键写入目标系统,避免重复推送造成目标单据重复。 ### 常见排错 FieldKeys 写了单据上不存在的字段标识会导致整次调用失败,建议先用金蝶云星空开放平台的在线调试工具确认字段标识;FilterString 中字符串字面量要用两个单引号转义;二次开发的自定义字段以 BOS 设计器中的字段标识为准,且第三方应用必须被授予对应单据的查询权限,否则返回空数据而非报错。