这个接口解决什么问题

仓库是供应链集成的主数据基石。在多个真实客户项目里，我们经常需要把金蝶云星辰的仓库同步到管易云（或反之），用于库存维度匹配、出入库单据选择、多仓调拨等场景。/jdy/v2/bd/store 接口正是为此设计的纯查询入口，支持按修改时间增量拉取，避免全量刷库带来的性能与一致性问题。

接口能力总览

认证方式：金蝶云星辰 WebAPI 标准的 Access Token 鉴权，由轻易云适配器统一托管刷新。
请求方式：GET，请求路径 /jdy/v2/bd/store。
请求参数：modify_start_time / modify_end_time（毫秒时间戳，用于增量）、page（默认 1）、page_size（由 PAGINATION_PAGE_SIZE 变量控制）、enable（默认 1 仅查启用仓库）、group_id（按仓库分类筛选）。
响应结构：JSON 数组，每条记录包含 id、number、name、enable、groupid_id、groupid_number、groupid_name、isallowfreight、isallowneg 等字段。
分页模式：基于 page 的传统分页，配合增量时间窗口可在轻易云中实现断点续拉。
增量模式：通过 modify_start_time 与 modify_end_time 划定时间区间，按修改时间过滤，是该接口的官方推荐同步策略。

字段名	类型	含义	实战注意事项
id	string	仓库主键 ID，系统唯一标识	跨系统映射时优先用 `number`，`id` 仅作为兜底
number	string	仓库业务编码	跨系统映射的首选键，需保持编码规则一致
name	string	仓库显示名称	名称可能重复，禁止作为唯一键
enable	string	状态：1=启用、0=禁用	禁用仓库需在目标系统置灰或过滤
groupid_id	string	仓库分类 ID	用于层级展示与权限隔离
groupid_number	string	仓库分类编码	可作为分类维度的映射键
groupid_name	string	仓库分类名称	冗余字段，便于列表直接渲染
isallowfreight	string	是否启用仓位管理/运费开关	字段名易误读，建议在轻易云字段映射器里加中文别名
isallowneg	string	是否允许负库存	涉及超卖逻辑时务必同步该开关

在轻易云数据集成平台里，这个接口的调用通常采用金蝶云星辰 V2 适配器 + 纯查询策略的组合：

适配器选择：在「源系统」连接器中选择「金蝶云星辰 V2」，填写租户标识与应用凭证（由轻易云的凭证管理统一加密存储）。
策略类型：选 QUERY（纯查询），Target 配置为「写入空操作」，不写入目标系统，仅产出数据供下游策略消费。
字段映射器配置：轻易云的字段映射器会自动把金蝶的 groupid_id、isallowfreight 等嵌套字段扁平化，并允许你直接拖拽到目标字段。
增量变量：在轻易云的「调度变量」中定义 PAGINATION_PAGE_SIZE（如 100），并在增量窗口配置里绑定上一次同步的 modify_end_time。
定时调度：建议沿用 */10 7-21 * * * 的高频窗口，覆盖门店营业时段。

number 是跨系统映射的生命线：在多个客户项目里，仓库编码不一致是导致调拨失败的 TOP1 原因，务必在轻易云里建立「编码对照表」并校验唯一性。
禁用仓库要明确处理策略：禁用不等于删除，目标系统若不做过滤会导致单据选不到仓库。
增量窗口要留 1–2 分钟重叠：金蝶的修改时间戳精度可能与本地时钟有偏差，重叠窗口能避免漏拉边界数据。
page_size 不要贪大：实际场景中超过 200 易触发限流，轻易云默认 100 是稳妥的选择。
仓库分类（groupid）建议单独同步：作为维度表独立维护，下游单据按分类过滤会更高效。
轻易云的元数据配置里，id 和 number 必须分别声明：这是金蝶查询接口的硬性要求，缺一会导致整页返回为空。

坑 1：isallowfreight 字段语义混淆。我们曾在某零售企业项目里把它当作「允许运费」直接同步到目标系统，结果下游开启了不该开的仓位管理。这里容易翻车——稳妥的做法是在轻易云字段映射器里加备注，明确它是仓位管理开关。
坑 2：时间戳单位错配。金蝶用的是毫秒时间戳，而有些上游给的 ISO 字符串，直接传会导致增量窗口失效。请在轻易云里用 toUnixMillis() 函数统一转换。
坑 3：分页死循环。当 page_size 恰好等于总数且未递增 page，会陷入无限拉取。轻易云的分页器默认会检测并终止，但仍建议在调试态开启日志。
坑 4：enable=1 默认过滤了禁用仓库。如果业务需要全量（含历史禁用仓库），必须显式传 enable 为空或 0，否则禁用仓库永远不会进入下游。
坑 5：定时窗口外无数据。*/10 7-21 * * * 意味着夜间 22:00–次日 6:59 不会拉取，若有跨夜调拨需求，需调整 cron 或在轻易云里开启「窗口外补拉」策略。

当你的集成场景需要金蝶云星辰仓库主数据按修改时间增量同步到下游系统（如管易云、ERP、BI），且只需读取不需回写时，本接口是最优解。若需要反向写入或复杂事务，建议改用金蝶的保存型 API 组合。