这个接口解决什么问题

在吉客云与金蝶云·旗舰版等ERP的供应链集成场景中,组装拆卸出库单是连接库存异动与财务核算的关键凭证。本接口(erp.storage.goodsdocout.v2)以 inouttype=207 固定过滤组装拆卸类出库,按创建时间增量拉取主表与明细行,供下游组装单/拆卸单对接、成本与批次追溯使用。

接口能力总览

认证方式:吉客云开放平台 AppKey/AppSecret 签名认证,请求头携带 AccessToken。
请求结构:POST 表单/JSON,核心参数 startDate、endDate、inouttype(固定 207)、pageIndex、pageSize(默认 50)、selelctFields(逗号拼接)。
响应结构:JSON 对象含 data.list(主表数组,每条带 goodsDocDetailList 明细行数组)与 data.total(总条数)。
分页/增量:基于 pageIndex/pageSize 分页,默认每页 50 条;增量游标使用 {{LAST_SYNC_TIME}} 到 {{CURRENT_TIME}} 的创建时间窗口。
定时策略:生产环境常配 1-59/5 6-23 * * *,每日 6–23 点每 5 分钟触发。

典型字段映射

字段名	类型	含义	实战注意事项
recId	string	主表系统内唯一ID	metadata 的 `id` 字段,跨系统对账的主键锚点
goodsdocNo	string	出库单业务编码	metadata 的 `number` 字段,业务引用与下游匹配的桥梁
billNo	string	关联单号(组装/拆卸单号)	与金蝶组装单号一一对应,做幂等去重
inouttype	string	出库类型编码	本策略固定传 `"207"`,不可漏传否则会拉全量
inouttypeName	string	类型显示名	用于日志与异常排查,不宜做编码
gmtCreate	string	创建时间	增量同步的时间锚点,时区为东八区
redStatus	string	红冲状态(1蓝/2被冲/9红冲)	红冲单需在下游过滤或反向冲销
financeBillStatus	string	财务状态(1/11/21/25/31)	仅 `21/25` 才代表可入账,需在轻易云字段映射器里加条件分支
warehouseCode / warehouseName	string	出库仓库编码/名称	名称易变,跨系统对接务必用编码
companyCode / companyName	string	公司编码/名称	多组织场景下,编码是组织映射的稳定键
vendCustomerCode	string	往来单位编码	组装拆卸多走内部组织,常为空,需容忍 null
goodsDocDetailList.recId	string	明细行主键	单据回写幂等的关键
goodsNo / skuId / skuBarcode	string	物料编码/SKU ID/条码	三者并存时优先 `goodsNo` 做主匹配,SKU 做规格补全
batchNo / batchNumber	string	批次号/批次编号	保质期管理行业强依赖,不可丢字段
quantity / unitName	string	数量/单位	单位需做统一换算,轻易云字段映射器支持单位换算函数
estPrice / estCost / estTax / taxRate	string	预估价格、成本、税额、税率	与 `trans*` 系列二选一使用,组装拆卸多走预估成本
transHasTaxAmount / transNoTaxAmount	string	交易含税/不含税金额	财务入账字段,需与税额 `transTaxAmount` 校验勾稽
field1~~field5 / detailField1~~5	string	主表/明细自定义字段	留给客户扩展,轻易云可一键透传

在轻易云上如何配置

在轻易云数据集成平台里,该接口通常以「吉客云适配器 + 查询策略」组合接入:

适配器选择:平台内置「吉客云 ERP 适配器」,直接选 erp.storage.goodsdocout.v2,认证页填 AppKey/AppSecret,平台会自动续签 Token。
请求参数封装:在策略画布里把 inouttype 写死为 207,startDate/endDate 绑定到轻易云内置的 LAST_SYNC_TIME / CURRENT_TIME 变量;pageSize 默认 50,selelctFields 由平台的「字段映射器」按当前画布引用到的字段自动裁剪,避免拉全量字段拖慢接口。
字段映射器:平台会把响应里的 goodsDocDetailList 自动展开成主子表双流,主表的 recId/goodsdocNo 流向目标单头,明细行的 recId/goodsNo/quantity/batchNo 流向目标单行;自定义字段 field1~5 走透传通道。
去重与幂等:把 recId + goodsDocDetailList.recId 作为幂等键写入轻易云的「主键去重」节点,避免重复写入。
Target 写空操作:本策略是纯查询场景,目标端在轻易云里配置为「空写入」,仅落库到中间表供下游消费。

跨方案实战要点

inouttype 必须固定为 207:多个客户方案里,一旦漏传或传错,该接口会混入销售出库/调拨出库等数据,造成金蝶侧单据类型错乱。
增量窗口以 gmtCreate 为准:不要用 inOutDate(业务日期),跨月补单或反审核场景下会漏数据;轻易云的 LAST_SYNC_TIME 默认按 gmtCreate 维护,稳妥。
主键 + 单号双锚点去重:主表用 recId 做幂等,业务侧用 goodsdocNo 做对账锚点;明细行同理,goodsDocDetailList.recId 必须落到目标端。
金额字段二选一:est*(预估)与 trans*(交易)两套价格/成本/税额字段并存,组装拆卸业务通常走 est* 系列;务必在轻易云映射器里固定一套,避免下游金蝶侧成本波动。
红蓝单与财务状态联动:redStatus=9(红冲单)需在下游做反向冲销;financeBillStatus<21 的单据不应作为入账依据,可在字段映射器里加过滤。
分页 50 与定时 5 分钟的搭配:每 5 分钟一轮、每页 50 条,在日均单量 1 万以内的客户环境稳定;若瞬时积压,轻易云会自动并发多页拉取,无需手工调优。

踩坑复盘

漏传 inouttype=207 导致混入销售出库:某零售客户首次上线未固定 inouttype,结果把销售出库单同步到金蝶组装单,生成大量错单。稳妥做法:在轻易云适配器里把 inouttype 写常量,严禁走变量。
用业务日期做增量漏数据:客户用 inOutDate 做增量窗口,反审核修改业务日期后,后续 7 天数据全部漏拉。稳妥做法:增量键统一用 gmtCreate,轻易云默认即此字段。
明细行主键未透传导致重复写入:目标金蝶组装单未保存吉客云明细 recId,后续补传时全部重复。稳妥做法:明细行 recId 一定要作为自定义字段写回目标单。
field1~5 被轻易云默认裁掉:早期版本平台会丢弃未在画布引用的自定义字段,导致客户扩展数据丢失。稳妥做法:在轻易云适配器里勾选「透传未引用字段」,或在 selelctFields 中显式列出。
时区未对齐,增量窗口漂移:私有化部署服务器时区为 UTC,东八区业务傍晚触发时,窗口末端数据被截断。稳妥做法:轻易云部署统一设 Asia/Shanghai,并在适配器里把 gmtCreate 显式声明为 +0800。

何时选用

适用于吉客云与下游 ERP(典型为金蝶云·旗舰版)做组装拆卸业务集成、需要按 inouttype=207 增量同步出库主表与明细的场景。若目标端不需要写入,或仅做库存台账核对,本纯查询接口即可满足;若需要写回金蝶组装单/拆卸单,需配合下游 SYNC 策略联合编排。

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