← 返回教程列表
字段与单据金蝶云星辰
金蝶云星辰销售出库单按客户模糊查找:公开筛选与本地索引如何取舍
发布于 更新于 华远智联科技有限公司技术团队
接口字段、权限与调用限制可能随产品版本调整。本文用于说明对接与排查思路,实际接入请核对当前官方文档,并在测试环境验证。
适用于自建查询页面需要按客户名称查找销售出库单的场景。前台页面提供的搜索能力,不一定与公开API参数相同。应先核实接口当前支持什么,再选择实现方法。
先验证两个边界
第一,查销售出库单列表文档,确认可用的是客户内码、编码、名称,还是其他条件;名称条件是否支持模糊匹配,应以文档说明和测试结果为依据。第二,查客户资料接口是否能根据名称找出候选客户,以及单据接口是否接受相应标识。不要假设支持数组,也不要自行设置未经公开的批量上限。
有候选客户时怎么处理
同名客户、简称和停用客户都可能造成歧义。查询页面可以先展示候选客户,让使用者确认具体客户,再按单据接口支持的条件查询。集成层应使用客户稳定标识关联单据,把名称当作展示属性,而不是主键。
公开接口不足时的选择
如果单据接口没有相应筛选能力,可评估在授权范围内同步必要客户资料与单据索引,再在本地检索。必须先能完整取得目标数据,并维护后续变化,不能把本页返回结果的本地过滤称为全量搜索。索引还需处理更名、删除、分页和同步失败。
如何验收
准备同名客户、含括号或空格的名称、客户更名及多页出库单样本,检查结果是否完整且没有跨客户串单。记录接口端过滤与本地过滤各自的范围。数据量较大时,先评估同步成本,再决定是否提供跨历史期间的模糊检索。
参考与适用边界
- 金蝶开发者社区原始问题:社区历史讨论,用于定位问题现象;技术规则请核对当前官方文档。
- 精斗云开放平台文档入口:接入前选择对应产品与版本,核对当前接口说明。
本文提供问题排查与集成设计建议;具体字段、权限和业务限制需按当前文档在授权测试环境验证。
下一步:确认对接范围
需要将接口能力落地到业务系统?可先了解对应产品的实施范围与交付方式。