查询吉客云入库单（组装拆卸）接口字段手册权威教程

这个接口解决什么问题

在吉客云与金蝶云·旗舰版的供应链集成中,组装拆卸业务产生的入库单需要跨系统传递。erp.storage.goodsdocin.v2 通过 inouttype=107 过滤,精准拉取组装拆卸入库单及明细(含物料、批次、成本税额),为金蝶侧组装单/拆卸单对接提供唯一数据源。

接口能力总览

• 认证方式:吉客云 OpenAPI 签名鉴权,AppKey/AppSecret 走 Header 或 QueryString。
• 请求结构:POST 类查询,Body 传 startDate、endDate、inouttype、pageIndex、pageSize、selelctFields、goodsDocNo。
• 响应结构:JSON 返回主表 + 明细数组 goodsDocDetailList,含 hasNext 分页标识。
• 分页/增量模式:基于创建时间区间分页,pageIndex 从 0 起、pageSize 默认 100;增量游标以 {{LAST_SYNC_TIME}} 推进。
• 执行节奏:定时 1-59/5 6-23 * * *,每日 6–23 点每 5 分钟一次。

典型字段映射

在轻易云上如何配置

在轻易云数据集成平台里,这个接口的调用通常封装为「吉客云入库单查询适配器」,平台预置 erp.storage.goodsdocin.v2 的请求模板与字段映射器。在策略编辑页:

1. 选择源系统「吉客云」→ 接口「入库单查询 v2」;
2. 在请求参数面板固定 inouttype=107,startDate/endDate 绑定平台内置的 LAST_SYNC_TIME/CURRENT_TIME 变量;
3. 轻易云的字段映射器会自动按主表/明细双层嵌套展开 goodsDocDetailList,并在映射画布里提供「主键→id」「业务编码→number」的快捷绑定;
4. 由于 Target 为「写入空操作」(纯查询策略),无需配置目标写入,直接以数据集形式供下游策略(如「吉客云-组装单→金蝶-组装单」)引用。

跨方案实战要点

1. 入库类型必须硬编码 107:多个客户方案均踩过类型错传导致数据混入其他业务单据的坑。
2. gmtCreate 优先于 gmtModified 做增量:跨方案一致经验是 gmtModified 易因反审核等操作回退,导致漏单。
3. 明细行 recId 必传 selelctFields:不显式声明时部分返回结构缺 goodsDocDetailList,下游对账直接失效。
4. pageSize=100 是性能甜点:实测低于 50 浪费请求、高于 100 易触发限流。
5. hasNext 与 pageIndex 双判:单凭 hasNext 在末页恰好满页时会漏翻页。
6. redStatus=9 建议过滤:红冲单若不下发,会在金蝶侧造成重复入库。

踩坑复盘

• 踩坑 1:增量起点错位。客户 A 用 gmtModified 增量,因红冲回写导致时间回退,出现漏单。稳妥做法是统一用 gmtCreate,并在首次全量后切增量。
• 踩坑 2:明细数组为空。客户 B 未在 selelctFields 列明细字段,接口默认只返回主表。修复方式是把 goodsDocDetailList.recId、goodsNo、quantity 等显式列入。
• 踩坑 3:数量字段字符串运算。quantity 为字符串,直接相加会出现 1+1=11。在轻易云字段映射器里启用「数值化转换」或在脚本里 parseFloat。
• 踩坑 4:成本字段取错。estCost 是预估成本,业务需用交易成本时必须取 transHasTaxAmount / transNoTaxAmount。
• 踩坑 5:跨公司仓库冲突。多公司客户 C 未带 companyCode,导致不同组织的同编码仓库互相覆盖。在请求参数里强制带入公司维度。

何时选用

适用于吉客云侧组装拆卸业务需要将入库单同步到金蝶云·旗舰版的私有化供应链集成场景;若业务仅需库存台账查询,建议用库存快照接口而非本明细接口,以减少带宽与对账复杂度。