智能表格销售退货管理集成金蝶云星空解决方案
更新: 11/20/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 集成平台 | 目标系统 |
|---|---|---|
| 企业微信智能表格 | 成集云 | 金蝶云星空 |
| 销售退货申请登记表 | 数据集成中枢 | 供应链-销售退货单 |
销售退货是售后业务的高频场景:客户因质量问题、发错货、规格不符、多发漏发、临期滞销等原因退回货物,企业需要完成退货接收、数量核对、退货入库、红字冲销、退款/换货等一系列动作。在金蝶云星空里,退货入库通过"销售退货单"(SAL_RETURNSTOCK)承载,并按退货业务区分单据类型(XSTHD01_SYS 标准销售退货、XSTHD02_SYS 寄售退货、XSTHD03_SYS 零售退货、XSTHD07_SYS B2C 销售退货等)。
现实中,很多企业的退货申请先在企业微信智能表格里登记(退货单号、退货客户、退货原因、物料、实退数量、含税单价、退货仓库、退货日期等),售后或仓管确认后,再由财务手工在金蝶云星空录入销售退货单。两个环节脱节带来明显痛点:退货信息重复录入、退货客户与退货仓库选错导致往来账与库存账错误、实退数量与单价录错造成红字金额不符、退货原因未归档难以做质量分析、退货执行结果无法实时同步到申请表。通过成集云平台打通企业微信智能表格与金蝶云星空,退货申请确认后自动在金蝶生成销售退货单,客户、物料、仓库、数量、单价自动带入,退货类型按场景自动映射,退货结果回写表格,真正实现"一处登记、自动退货入库、业财同步"。
解决方案概述
本方案通过成集云平台将企业微信智能表格中的销售退货申请信息(退货单号、退货客户、销售组织、库存组织、退货原因、物料、实退数量、含税单价、退货仓库、退货日期等)自动同步至金蝶云星空销售退货单(SAL_RETURNSTOCK)。业务人员在智能表格提交退货申请后,成集云自动校验退货客户、物料、退货仓库是否合法、实退数量与单价是否完整、退货确认是否完成;确认通过后按退货场景自动映射单据类型(如"标准客户退货"→ XSTHD01_SYS、"电商 B2C 退货"→ XSTHD07_SYS),自动创建销售退货单表头与分录明细(FEntity),创建后回写退货单号与单据状态,审核后由金蝶库存与应收结果触发状态回流,保障退货申请、仓库收货与财务红冲全链路一致。
核心配色方案:
- 成集云:#4a5699
- 金蝶云星空:#4299e1
- 企业微信智能表格:#52c41a
业务流程
流程一:基础资料与退货模板初始化
流程二:退货申请校验与确认
流程三:销售退货单生成与审核
流程四:退货结果回写与财务红冲
对接说明
字段映射表
| 智能表格字段 | 字段说明 | 金蝶云星空字段 | 字段说明 | 转换规则 |
|---|---|---|---|---|
| return_no | 退货申请单号 | FBillNo | 单据编号 | 加前缀生成,跨系统唯一键 |
| biz_type | 退货场景 | FBillTypeID | 单据类型 | 场景映射 XSTHD01~09_SYS |
| sale_org | 销售组织 | FSaleOrgId | 销售组织 | 组织名称匹配金蝶组织编码 |
| stock_org | 库存组织 | FStockOrgId | 库存组织 | 组织名称匹配金蝶组织编码 |
| customer | 退货客户 | FRetcustId | 退货客户 | 客户名称匹配金蝶客户编码 |
| return_reason | 退货原因 | FReturnReason | 退货原因 | 原因字典映射 |
| return_date | 退货日期 | FDate | 日期 | 格式化为 yyyy-MM-dd |
| currency | 结算币别 | FSettleCurrId | 结算币别 | 默认 PRE001 人民币 |
| note | 备注 | FHeadNote | 表头备注 | 直接映射 |
| material_no | 物料编码 | FEntity.FMaterialId | 明细物料 | 匹配金蝶物料编码 |
| real_qty | 实退数量 | FEntity.FRealQty | 明细实退数量 | 直接映射,校验大于零 |
| tax_price | 含税单价 | FEntity.FTaxPrice | 明细含税单价 | 与原订单价格核对 |
| amount | 退货金额 | FEntity.FAmount | 明细金额 | 实退数量乘含税单价 |
| return_type | 退货类型 | FEntity.FReturnType | 明细退货类型 | 默认 THLX01_SYS |
| return_stock | 退货仓库 | FEntity.FStockId | 明细仓库 | 匹配金蝶仓库编码 |
| entry_note | 分录备注 | FEntity.FNote | 明细备注 | 直接映射 |
同步规则
| 规则项 | 说明 |
|---|---|
| 触发方式 | 智能表格新增退货申请或退货确认时触发,亦支持按日批量同步 |
| 同步频率 | 实时监听,确认通过后 1 分钟内完成退货单创建 |
| 去重策略 | 以退货单号映射的 FBillNo 作为跨系统唯一业务键,重复单拦截 |
| 基础资料校验 | 退货客户、物料、仓库、组织先与金蝶基础资料比对 |
| 单据类型映射 | 按退货场景集中维护字典:标准/寄售/零售/B2C/现销退货等 |
| 数量校验 | 实退数量须大于零且不超过原发货数量,异常时拦截 |
| 价格校验 | 含税单价与原销售订单核对,偏差超阈值触发预警 |
| 异常处理 | 客户非法、物料缺失、单据创建失败时记录日志并通知财务 |
| 回写机制 | 创建成功后回写退货单号与状态;审核后回写入库与红冲结果 |
| 红字联动 | 需要红字发票时联动开票流程并回写票号至智能表格 |
业务价值
- 退货提速:申请到退货单生成由数小时压缩至分钟级,财务免重复录单
- 类型准确:退货场景自动映射单据类型,往来账与库存账不再因选错类型而错误
- 业财同步:退货审核后库存自动入库、应收自动红冲,申请表实时同步执行状态
- 资料规范:客户、物料、仓库、币别统一校验,杜绝编码错填与数量错录
- 质量追溯:退货原因结构化归档,进入智能表格看板支撑质量问题分析与改进
- 移动登记:依托企业微信智能表格,售后可随时在手机端提交与跟踪退货
接口文档
接口一:查询金蝶基础资料内码
- 接口说明:校验退货客户、物料、仓库、组织是否存在并返回编码
- 请求参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| FormId | String | 是 | BD_Customer / BD_MATERIAL / BD_STOCK / BD_Org |
| FieldKeys | String | 是 | 返回字段,如 FNumber,FName |
| Filter | String | 是 | 编码或名称过滤条件 |
- 返回参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| FNumber | String | 基础资料编码 |
| FName | String | 基础资料名称 |
接口二:创建销售退货单
- 接口说明:向金蝶云星空写入销售退货单 SAL_RETURNSTOCK
- 请求参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| FormId | String | 是 | SAL_RETURNSTOCK |
| Operation | String | 是 | Save 或 batchSave |
| IsAutoSubmitAndAudit | Boolean | 否 | 是否自动提交并审核 |
| FBillTypeID | String | 是 | 单据类型,XSTHD01_SYS 等按场景映射 |
| FBillNo | String | 是 | 单据编号 |
| FSaleOrgId | Object | 是 | 销售组织 |
| FDate | Date | 是 | 日期 |
| FStockOrgId | Object | 是 | 库存组织 |
| FRetcustId | Object | 是 | 退货客户 |
| FSettleCurrId | String | 否 | 结算币别,默认 PRE001 |
| FHeadNote | String | 否 | 表头备注 |
| FEntity | Array | 是 | 退货明细,含物料、实退数量、含税单价、仓库 |
| FEntity.FMaterialId | Object | 是 | 明细物料编码 |
| FEntity.FRealQty | Number | 是 | 明细实退数量 |
| FEntity.FTaxPrice | Number | 否 | 明细含税单价 |
| FEntity.FAmount | Number | 否 | 明细退货金额 |
| FEntity.FReturnType | String | 否 | 退货类型,默认 THLX01_SYS |
| FEntity.FStockId | Object | 是 | 明细退货仓库 |
| FEntity.FNote | String | 否 | 明细备注 |
- 返回参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| Result.ResponseStatus.IsSuccess | Boolean | 是否成功 |
| Result.Id | String | 退货单内码 |
| Result.Number | String | 退货单编号 |
接口三:销售退货单状态查询
- 接口说明:查询退货单审核与执行状态,回写智能表格
- 请求参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| FormId | String | 是 | SAL_RETURNSTOCK |
| FieldKeys | String | 是 | FBillNo,FDOCUMENTSTATUS,FDate |
| Filter | String | 是 | 按退货单号过滤 |
- 返回参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| FBillNo | String | 退货单编号 |
| FDOCUMENTSTATUS | String | 单据状态 |
| FDate | Date | 退货日期 |
