金蝶云星空和网易互客接口打通对接实战
数据源系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标系统:网易互客
网易互客是赋能销售获客转化的SCRM产品。在互动渠道层面，打通了微信、电话、短信，帮助销售人员打造一体化沟通工作台，实现核心触点的获客转化。在互动内容层面，销售可以在网易互客创建文章、表单等销售资料包，随后一键分享给微信好友或朋友圈，客户阅读文章/填写表单后，网易互客会在第一时间推送浏览行为，让销售抓住最佳跟进时机。
数据接口配置方案
通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的销售退货查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为网易互客，并且选择对应连接器。选择对应的编辑订单接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
金蝶云星空接口明细
- 接口：executeBillQuery
- 接口名称：销售退货查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FID | 实体主键 | String | |
| FBillNo | 单据编号 | String | |
| FDocumentStatus | 单据状态 | String | |
| FSaleOrgId | 销售组织 | String | |
| FDate | 日期 | String | |
| FStockOrgId | 库存组织 | String | |
| FRetcustId | 退货客户 | String | |
| FStockerGroupId | 库存组 | String | |
| FStockerId | 仓管员 | String | |
| FStockDeptId | 库存部门 | String | |
| FSaleGroupId | 销售组 | String | |
| FSaledeptid | 销售部门 | String | |
| FSalesManId | 销售员 | String | |
| FSettleCustId | 结算方 | String | |
| FPayCustId | 付款方 | String | |
| FCreatorId | 创建人 | String | |
| FCreateDate | 创建日期 | String | |
| FModifierId | 最后修改人 | String | |
| FModifyDate | 最后修改日期 | String | |
| FApproverId | 审核人 | String | |
| FApproveDate | 审核日期 | String | |
| FCancellerId | 作废人 | String | |
| FCancelDate | 作废日期 | String | |
| FCancelStatus | 作废状态 | String | |
| FBillTypeID | 单据类型 | String | |
| FReceiveCustId | 收货方 | String | |
| FOwnerTypeIdHead | 货主类型 | String | |
| FOwnerIdHead | 货主 | String | |
| FBussinessType | 业务类型 | String | |
| FReturnReason | 退货原因 | String | |
| FReceiveAddress | 收货方地址 | String | |
| FHeadLocId | 交货地点 | String | |
| FCreditCheckResult | 信用检查结果 | String | |
| FTransferBizType | 跨组织业务类型 | String | |
| FCorrespondOrgId | 对应组织 | String | |
| FReceiveCusContact | 收货方联系人 | String | |
| FIsInterLegalPerson | 组织间结算跨法人标识 | String | |
| FHeadNote | 备注 | String | |
| FIsTotalServiceOrCost | 整单服务标识 | String | |
| FGenFromPOS_CMK | 零售单日结生成 | String | |
| FBranchId | 销售门店 | String | |
| FSHOPNUMBER | 网店编码 | String | |
| FGYDATE | 管易退货日期 | String | |
| FSALECHANNEL | 销售渠道 | String | |
| FGYExpressNo | 管易物流单号 | String | |
| Fentity | 明细信息 | Array | |
| Fentity.FENTRYID | 实体主键 | String | |
| Fentity.FMaterialId | 物料编码 | String | |
| Fentity.FMaterialName | 物料名称 | String | |
| Fentity.FMaterialModel | 规格型号 | String | |
| Fentity.FMaterialType | 物料类别 | String | |
| Fentity.FUnitID | 库存单位 | String | |
| Fentity.FMustqty | 应退数量 | String | |
| Fentity.FRealQty | 实退数量 | String | |
| Fentity.FStockId | 仓库 | String | |
| Fentity.FStockstatusId | 库存状态 | String | |
| Fentity.FOwnerTypeId | 货主类型 | String | |
| Fentity.FOwnerId | 货主 | String | |
| Fentity.FKeeperTypeId | 保管者类型 | String | |
| Fentity.FKeeperId | 保管者 | String | |
| Fentity.FBOMId | BOM版本 | String | |
| Fentity.FAuxpropId | 辅助属性 | String | |
| Fentity.FProduceDate | 生产日期 | String | |
| Fentity.FExpiryDate | 有效期至 | String | |
| Fentity.FBaseunitId | 基本单位 | String | |
| Fentity.FBaseunitQty | 库存基本数量 | String | |
| Fentity.FAuxUnitId | 库存辅单位 | String | |
| Fentity.FAuxUnitQty | 库存辅单位数量 | String | |
| Fentity.FCostPrice | 成本价（本位币） | String | |
| Fentity.FEntryCostAmount | 总成本 | String | |
| Fentity.FOrderNo | 订单单号 | String | |
| Fentity.FNote | 备注 | String | |
| Fentity.FInvoicedQty | 关联应收数量（计价） | String | |
| Fentity.FBaseInvoicedQty | (作废)关联开票数量(基本单位) | String | |
| Fentity.FSumInvoicedQty | 累计应收数量（销售） | String | |
| Fentity.FSumInvoicedAmt | (作废)累计开票金额 | String | |
| Fentity.FSumRecievedAmt | 累计收款金额 | String | |
| Fentity.FStockFlag | 库存更新标示 | String | |
| Fentity.FSrcBillTypeID | 源单类型 | String | |
| Fentity.FExpUnit | 保质期单位 | String | |
| Fentity.FExpPeriod | 保质期 | String | |
| Fentity.FStocklocId | 仓位 | String | |
| Fentity.FF100001 | 仓位 | String | |
| Fentity.FMapId | 客户物料编码 | String | |
| Fentity.FMapName | 客户物料名称 | String | |
| Fentity.FLot | 批号 | String | |
| Fentity.FReturnType | 退货类型 | String | |
| Fentity.FBaseSumInvoicedQty | (作废)累计开票数量(基本单位) | String | |
| Fentity.FCostAmount_LC | 总成本（本位币） | String | |
| Fentity.FPriceUnitId | 计价单位 | String | |
| Fentity.FPriceUnitQty | 计价数量 | String | |
| Fentity.FPrice | 单价 | String | |
| Fentity.FTaxPrice | 含税单价 | String | |
| Fentity.FTaxCombination | 税组合 | String | |
| Fentity.FEntryTaxRate | 税率% | String | |
| Fentity.FPriceCoefficient | 价格系数 | String | |
| Fentity.FSysPrice | 系统定价 | String | |
| Fentity.FLimitDownPrice | 最低限价 | String | |
| Fentity.FBefDisAmt | 折前金额 | String | |
| Fentity.FBefDisAllAmt | 折前价税合计 | String | |
| Fentity.FDiscountRate | 折扣率% | String | |
| Fentity.FDiscount | 折扣额 | String | |
| Fentity.FAmount | 金额 | String | |
| Fentity.FAmount_LC | 金额（本位币） | String | |
| Fentity.FEntryTaxAmount | 税额 | String | |
| Fentity.FTaxAmount_LC | 税额（本位币） | String | |
| Fentity.FAllAmount | 价税合计 | String | |
| Fentity.FAllAmount_LC | 价税合计（本位币） | String | |
| Fentity.FIsFree | 是否赠品 | String | |
| Fentity.FTaxNetPrice | 净价 | String | |
| Fentity.FDeliveryDate | 退货日期 | String | |
| Fentity.FBaseARJoinQty | 关联应收数量（计价基本） | String | |
| Fentity.FBFLowId | 业务流程 | String | |
| Fentity.FBASEARQTY | 累计应收数量（销售基本） | String | |
| Fentity.FARJOINAMOUNT | 关联应收金额 | String | |
| Fentity.FARAMOUNT | 累计应收金额 | String | |
| Fentity.FSalCostPrice | 销售成本价 | String | |
| Fentity.FSrcBillNo | 源单编号 | String | |
| Fentity.FSOBILLTYPEID | 订单类型 | String | |
| Fentity.FSNUnitID | 序列号单位 | String | |
| Fentity.FSNQty | 序列号单位数量 | String | |
| Fentity.FMtoNo | 计划跟踪号 | String | |
| Fentity.FProjectNo | 项目编号 | String | |
| Fentity.FRefuseFlag | 拒收标志 | String | |
| Fentity.FISCONSUMESUM | 消耗汇总 | String | |
| Fentity.FExtAuxUnitId | 辅单位 | String | |
| Fentity.FExtAuxUnitQty | 实退数量（辅单位） | String | |
| Fentity.FInventoryQty | 当前库存 | String | |
| Fentity.FPriceBaseQty | 计价基本数量 | String | |
| Fentity.FSalUnitID | 销售单位 | String | |
| Fentity.FSalUnitQty | 销售数量 | String | |
| Fentity.FSalBaseQty | 销售基本数量 | String | |
| Fentity.FQualifyType | 质量类型 | String | |
| Fentity.FSalBaseNum | 销售基本分子 | String | |
| Fentity.FStockBaseDen | 库存基本分母 | String | |
| Fentity.FStockBaseARJoinQty | 关联应收数量（库存基本） | String | |
| Fentity.FSRCBIZUNITID | 携带的主业务单位 | String | |
| Fentity.FEOwnerSupplierId | 明细货主供应商 | String | |
| Fentity.FIsOverLegalOrg | 组织间结算跨法人标识 | String | |
| Fentity.FESettleCustomerId | 明细结算组织客户 | String | |
| Fentity.FSalBaseARJoinQty | 关联应收数量（销售基本） | String | |
| Fentity.FPriceListEntry | 行价目表 | String | |
| Fentity.FARNOTJOINQTY | 未关联应收数量（计价单位） | String | |
| Fentity.FSOEntryId | 销售订单EntryId | String | |
| Fentity.FIsReturnCheck | 退货检验 | String | |
| Fentity.FRowType | 产品类型 | String | |
| Fentity.FParentMatId | 父项产品 | String | |
| Fentity.FRowId | 行标识 | String | |
| Fentity.FParentRowId | 父行标识 | String | |
| Fentity.FThirdEntryId | 管易订单单号 | String | |
| Fentity.FETHIRDBILLID | 第三方单据ID | String | |
| Fentity.FETHIRDBILLNO | 第三方单据编号 | String | |
| Fentity.FServiceContext | 服务上下文 | String | |
| Fentity.FProPrice | 门店供货价 | String | |
| Fentity.FProAmount | 供货金额 | String | |
| Fentity.FBarcode | 零售条形码 | String | |
| Fentity.FGYFINSTATUS | 管易是否到账 | String | |
| Fentity.FGYFINDate | 管易到账时间 | String | |
| Fentity.FPriceDiscount | 单价折扣 | String | |
| Fentity.FTailDiffFlag | 尾差处理标识 | String | |
| Fentity.FWRITEOFFPRICEBASEQTY | 冲销数量(计价基本) | String | |
| Fentity.FWRITEOFFSALEBASEQTY | 冲销数量(销售基本) | String | |
| Fentity.FWRITEOFFSTOCKBASEQTY | 冲销数量(库存基本) | String | |
| Fentity.FWRITEOFFAMOUNT | 冲销金额 | String | |
| Fentity.FSettleBySon | 按子项结算 | String | |
| Fentity.FBOMEntryId | BOM分录内码 | String | |
| Fentity.F_out_id | 外部ID | String | |
| Fentity.F_out_no | 外部编码 | String | |
| Fentity.F_out_type | 外部业务类型 | String | |
| Fentity.F_ZHHB_Text | 开户单号 | String | |
| Fentity.Limit | 最大行数 | string | 金蝶的查询分页参数 |
| Fentity.StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
| Fentity.TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
| Fentity.FilterString | 过滤条件 | string | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| Fentity.FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| Fentity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FID | 实体主键 | String | |
| FBillNo | 单据编号 | String | |
| FDocumentStatus | 单据状态 | String | |
| FSaleOrgId | 销售组织 | String | |
| FDate | 日期 | String | |
| FStockOrgId | 库存组织 | String | |
| FRetcustId | 退货客户 | String | |
| FStockerGroupId | 库存组 | String | |
| FStockerId | 仓管员 | String | |
| FStockDeptId | 库存部门 | String | |
| FSaleGroupId | 销售组 | String | |
| FSaledeptid | 销售部门 | String | |
| FSalesManId | 销售员 | String | |
| FSettleCustId | 结算方 | String | |
| FPayCustId | 付款方 | String | |
| FCreatorId | 创建人 | String | |
| FCreateDate | 创建日期 | String | |
| FModifierId | 最后修改人 | String | |
| FModifyDate | 最后修改日期 | String | |
| FApproverId | 审核人 | String | |
| FApproveDate | 审核日期 | String | |
| FCancellerId | 作废人 | String | |
| FCancelDate | 作废日期 | String | |
| FCancelStatus | 作废状态 | String | |
| FBillTypeID | 单据类型 | String | |
| FReceiveCustId | 收货方 | String | |
| FOwnerTypeIdHead | 货主类型 | String | |
| FOwnerIdHead | 货主 | String | |
| FBussinessType | 业务类型 | String | |
| FReturnReason | 退货原因 | String | |
| FReceiveAddress | 收货方地址 | String | |
| FHeadLocId | 交货地点 | String | |
| FCreditCheckResult | 信用检查结果 | String | |
| FTransferBizType | 跨组织业务类型 | String | |
| FCorrespondOrgId | 对应组织 | String | |
| FReceiveCusContact | 收货方联系人 | String | |
| FIsInterLegalPerson | 组织间结算跨法人标识 | String | |
| FHeadNote | 备注 | String | |
| FIsTotalServiceOrCost | 整单服务标识 | String | |
| FGenFromPOS_CMK | 零售单日结生成 | String | |
| FBranchId | 销售门店 | String | |
| FSHOPNUMBER | 网店编码 | String | |
| FGYDATE | 管易退货日期 | String | |
| FSALECHANNEL | 销售渠道 | String | |
| FGYExpressNo | 管易物流单号 | String | |
| Fentity | 明细信息 | Array | |
| FENTRYID | 实体主键 | String | |
| FMaterialId | 物料编码 | String | |
| FMaterialName | 物料名称 | String | |
| FMaterialModel | 规格型号 | String | |
| FMaterialType | 物料类别 | String | |
| FUnitID | 库存单位 | String | |
| FMustqty | 应退数量 | String | |
| FRealQty | 实退数量 | String | |
| FStockId | 仓库 | String | |
| FStockstatusId | 库存状态 | String | |
| FOwnerTypeId | 货主类型 | String | |
| FOwnerId | 货主 | String | |
| FKeeperTypeId | 保管者类型 | String | |
| FKeeperId | 保管者 | String | |
| FBOMId | BOM版本 | String | |
| FAuxpropId | 辅助属性 | String | |
| FProduceDate | 生产日期 | String | |
| FExpiryDate | 有效期至 | String | |
| FBaseunitId | 基本单位 | String | |
| FBaseunitQty | 库存基本数量 | String | |
| FAuxUnitId | 库存辅单位 | String | |
| FAuxUnitQty | 库存辅单位数量 | String | |
| FCostPrice | 成本价（本位币） | String | |
| FEntryCostAmount | 总成本 | String | |
| FOrderNo | 订单单号 | String | |
| FNote | 备注 | String | |
| FInvoicedQty | 关联应收数量（计价） | String | |
| FBaseInvoicedQty | (作废)关联开票数量(基本单位) | String | |
| FSumInvoicedQty | 累计应收数量（销售） | String | |
| FSumInvoicedAmt | (作废)累计开票金额 | String | |
| FSumRecievedAmt | 累计收款金额 | String | |
| FStockFlag | 库存更新标示 | String | |
| FSrcBillTypeID | 源单类型 | String | |
| FExpUnit | 保质期单位 | String | |
| FExpPeriod | 保质期 | String | |
| FStocklocId | 仓位 | String | |
| FF100001 | 仓位 | String | |
| FMapId | 客户物料编码 | String | |
| FMapName | 客户物料名称 | String | |
| FLot | 批号 | String | |
| FReturnType | 退货类型 | String | |
| FBaseSumInvoicedQty | (作废)累计开票数量(基本单位) | String | |
| FCostAmount_LC | 总成本（本位币） | String | |
| FPriceUnitId | 计价单位 | String | |
| FPriceUnitQty | 计价数量 | String | |
| FPrice | 单价 | String | |
| FTaxPrice | 含税单价 | String | |
| FTaxCombination | 税组合 | String | |
| FEntryTaxRate | 税率% | String | |
| FPriceCoefficient | 价格系数 | String | |
| FSysPrice | 系统定价 | String | |
| FLimitDownPrice | 最低限价 | String | |
| FBefDisAmt | 折前金额 | String | |
| FBefDisAllAmt | 折前价税合计 | String | |
| FDiscountRate | 折扣率% | String | |
| FDiscount | 折扣额 | String | |
| FAmount | 金额 | String | |
| FAmount_LC | 金额（本位币） | String | |
| FEntryTaxAmount | 税额 | String | |
| FTaxAmount_LC | 税额（本位币） | String | |
| FAllAmount | 价税合计 | String | |
| FAllAmount_LC | 价税合计（本位币） | String | |
| FIsFree | 是否赠品 | String | |
| FTaxNetPrice | 净价 | String | |
| FDeliveryDate | 退货日期 | String | |
| FBaseARJoinQty | 关联应收数量（计价基本） | String | |
| FBFLowId | 业务流程 | String | |
| FBASEARQTY | 累计应收数量（销售基本） | String | |
| FARJOINAMOUNT | 关联应收金额 | String | |
| FARAMOUNT | 累计应收金额 | String | |
| FSalCostPrice | 销售成本价 | String | |
| FSrcBillNo | 源单编号 | String | |
| FSOBILLTYPEID | 订单类型 | String | |
| FSNUnitID | 序列号单位 | String | |
| FSNQty | 序列号单位数量 | String | |
| FMtoNo | 计划跟踪号 | String | |
| FProjectNo | 项目编号 | String | |
| FRefuseFlag | 拒收标志 | String | |
| FISCONSUMESUM | 消耗汇总 | String | |
| FExtAuxUnitId | 辅单位 | String | |
| FExtAuxUnitQty | 实退数量（辅单位） | String | |
| FInventoryQty | 当前库存 | String | |
| FPriceBaseQty | 计价基本数量 | String | |
| FSalUnitID | 销售单位 | String | |
| FSalUnitQty | 销售数量 | String | |
| FSalBaseQty | 销售基本数量 | String | |
| FQualifyType | 质量类型 | String | |
| FSalBaseNum | 销售基本分子 | String | |
| FStockBaseDen | 库存基本分母 | String | |
| FStockBaseARJoinQty | 关联应收数量（库存基本） | String | |
| FSRCBIZUNITID | 携带的主业务单位 | String | |
| FEOwnerSupplierId | 明细货主供应商 | String | |
| FIsOverLegalOrg | 组织间结算跨法人标识 | String | |
| FESettleCustomerId | 明细结算组织客户 | String | |
| FSalBaseARJoinQty | 关联应收数量（销售基本） | String | |
| FPriceListEntry | 行价目表 | String | |
| FARNOTJOINQTY | 未关联应收数量（计价单位） | String | |
| FSOEntryId | 销售订单EntryId | String | |
| FIsReturnCheck | 退货检验 | String | |
| FRowType | 产品类型 | String | |
| FParentMatId | 父项产品 | String | |
| FRowId | 行标识 | String | |
| FParentRowId | 父行标识 | String | |
| FThirdEntryId | 管易订单单号 | String | |
| FETHIRDBILLID | 第三方单据ID | String | |
| FETHIRDBILLNO | 第三方单据编号 | String | |
| FServiceContext | 服务上下文 | String | |
| FProPrice | 门店供货价 | String | |
| FProAmount | 供货金额 | String | |
| FBarcode | 零售条形码 | String | |
| FGYFINSTATUS | 管易是否到账 | String | |
| FGYFINDate | 管易到账时间 | String | |
| FPriceDiscount | 单价折扣 | String | |
| FTailDiffFlag | 尾差处理标识 | String | |
| FWRITEOFFPRICEBASEQTY | 冲销数量(计价基本) | String | |
| FWRITEOFFSALEBASEQTY | 冲销数量(销售基本) | String | |
| FWRITEOFFSTOCKBASEQTY | 冲销数量(库存基本) | String | |
| FWRITEOFFAMOUNT | 冲销金额 | String | |
| FSettleBySon | 按子项结算 | String | |
| FBOMEntryId | BOM分录内码 | String | |
| F_out_id | 外部ID | String | |
| F_out_no | 外部编码 | String | |
| F_out_type | 外部业务类型 | String | |
| F_ZHHB_Text | 开户单号 | String | |
网易互客接口明细
- API：openapi/trade/requestRefund
- NAME：编辑订单
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| tid | 订单tid | _findCollection find platform_code from 436a21f0-9e70-359a-9f2f-b409cf4691e7 where deliverys_mail_no={{FHeadNote}} | |
系统对接总览
可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。
