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