从金蝶云星空到网易互客通过接口配置打通数据
接入系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
对接目标系统:网易互客
网易互客一款简单、互动、高效的SCRM产品。在互动渠道层面，打通了微信、电话、短信，帮助销售人员打造一体化沟通工作台，实现核心触点的获客转化。在互动内容层面，销售可以在网易互客创建文章、表单等销售资料包，随后一键分享给微信好友或朋友圈，客户阅读文章/填写表单后，网易互客会在第一时间推送浏览行为，让销售抓住最佳跟进时机。
系统对接接口配置
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：收款单查询，目标系统：网易互客，目标系统 API编辑订单。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：收款单查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FID | 实体主键 | FID | |
| FBillNo | 单据编号 | FBillNo | |
| FDOCUMENTSTATUS | 单据状态 | FDOCUMENTSTATUS | |
| FCreatorId | 创建人 | FCreatorId | |
| FAPPROVERID | 审核人 | FAPPROVERID | |
| FCreateDate | 创建日期 | FCreateDate | |
| FSETTLEORGID | 结算组织 | FSETTLEORGID.FNumber | |
| FApproveDate | 审核日期 | FApproveDate | |
| FSALEORGID | 销售组织 | FSALEORGID.FNumber | |
| FEXCHANGETYPE | 汇率类型 | FEXCHANGETYPE | |
| FRECEIVEAMOUNTFOR_H | 表头-应收金额 | FRECEIVEAMOUNTFOR_H | |
| FMAINBOOKCURID | 本位币 | FMAINBOOKCURID | |
| FRECEIVEAMOUNT_H | 表头-应收金额本位币 | FRECEIVEAMOUNT_H | |
| FCURRENCYID | 币别 | FCURRENCYID.FNumber | |
| FDATE | 业务日期 | FDATE | |
| FModifyDate | 修改日期 | FModifyDate | |
| FModifierId | 修改人 | FModifierId | |
| FEXCHANGERATE | 汇率 | FEXCHANGERATE | |
| FWRITTENOFFSTATUS | 核销状态 | FWRITTENOFFSTATUS | |
| FSALEERID | 销售员 | FSALEERID.FNumber | |
| FSALEGROUPID | 销售组 | FSALEGROUPID.FNumber | |
| FSALEDEPTID | 销售部门 | FSALEDEPTID.FNumber | |
| FBillTypeID | 单据类型 | FBillTypeID.FNumber | |
| FREALRECAMOUNTFOR | 表头-实收金额 | FREALRECAMOUNTFOR | |
| FREALRECAMOUNT_H | 表头-实收金额本位币 | FREALRECAMOUNT_H | |
| FACCOUNTSYSTEM | 会计核算体系 | FACCOUNTSYSTEM | |
| FCancelDate | 作废日期 | FCancelDate | |
| FCancelStatus | 作废状态 | FCancelStatus | |
| FCancellerId | 作废人 | FCancellerId | |
| FCONTACTUNITTYPE | 往来单位类型 | FCONTACTUNITTYPE | |
| FCONTACTUNIT | 往来单位 | FCONTACTUNIT.FNumber | |
| FPAYUNITTYPE | 付款单位类型 | FPAYUNITTYPE | |
| FPAYUNIT | 付款单位 | FPAYUNIT.FNumber | |
| FBUSINESSTYPE | 业务类型 | FBUSINESSTYPE | |
| FCreditCheckResult | 信用检查结果 | FCreditCheckResult | |
| FISINIT | 是否期初单据 | FISINIT | |
| FDepartment | 部门 | FDepartment | |
| FPAYORGID | 收款组织 | FPAYORGID.FNumber | |
| FIsSameOrg | 是否相同组织 | FIsSameOrg | |
| FSOURCESYSTEM | 来源系统 | FSOURCESYSTEM | |
| FCASHSALE | 现销 | FCASHSALE | |
| FSETTLECUR | 结算币别 | FSETTLECUR | |
| FSETTLERATE | 结算汇率 | FSETTLERATE | |
| FRECAMOUNTFOR | 收款金额 | FRECAMOUNTFOR | |
| FRECAMOUNT | 表头-收款金额本位币 | FRECAMOUNT | |
| FISB2C | B2C业务 | FISB2C | |
| FWBSETTLENO | 流水号/对账码 | FWBSETTLENO | |
| FIsWriteOff | 是否转销 | FIsWriteOff | |
| FMatchMethodID | 核销方式 | FMatchMethodID | |
| FScanPoint | 扫描点 | FScanPoint | |
| FKDPAYNO | 金蝶支付流水号 | FKDPAYNO | |
| FREMARK | 备注 | FREMARK | |
| FTHIRDBILLNO | 第三方单据编号 | FTHIRDBILLNO | |
| FSETTLEMAINBOOKID | 结算本位币 | FSETTLEMAINBOOKID | |
| FSETTLEEXCHANGETYPE | 结算汇率类型 | FSETTLEEXCHANGETYPE | |
| FOUTCONTACTID | 转出往来单位 | FOUTCONTACTID | |
| FOUTCONTACTTYPE | 转出往来单位类型 | FOUTCONTACTTYPE | |
| FGYACCOUNTWATERID | 管易财务流水内码 | FGYACCOUNTWATERID | |
| FISCARRYRATE | 是否下推携带汇率到结算汇率 | FISCARRYRATE | |
| FPRESETBASE1 | 预设基础资料字段1 | FPRESETBASE1 | |
| FPRESETBASE2 | 预设基础资料字段2 | FPRESETBASE2 | |
| FPRESETASSISTANT1 | 预设辅助资料字段1 | FPRESETASSISTANT1 | |
| FPRESETASSISTANT2 | 预设辅助资料字段2 | FPRESETASSISTANT2 | |
| FPRESETTEXT1 | 预设文本字段1 | FPRESETTEXT1 | |
| FPRESETTEXT2 | 预设文本字段2 | FPRESETTEXT2 | |
| FISFROMSALORDER | 来源销售订单下推 | FISFROMSALORDER | |
| FVirIsSameAcctOrg | 是否同一核算组织 | FVirIsSameAcctOrg | |
| FSETTLETYPEID | 结算方式 | FSETTLETYPEID | |
| FSETTLERECAMOUNTFOR | 折后金额 | FSETTLERECAMOUNTFOR | |
| FSETTLEDISTAMOUNTFOR | 现金折扣 | FSETTLEDISTAMOUNTFOR | |
| FRECTOTALAMOUNTFOR | 表体-应收金额 | FRECTOTALAMOUNTFOR | |
| FSETTLERECAMOUNT | 折后金额本位币 | FSETTLERECAMOUNT | |
| FSETTLEDISTAMOUNT | 现金折扣本位币 | FSETTLEDISTAMOUNT | |
| FRECTOTALAMOUNT | 表体-应收金额本位币 | FRECTOTALAMOUNT | |
| FWRITTENOFFSTATUS_D | 表体明细-核销状态 | FWRITTENOFFSTATUS_D | |
| FWRITTENOFFAMOUNTFOR_D | 表体明细-已核销金额 | FWRITTENOFFAMOUNTFOR_D | |
| FCOMMENT | 备注 | FCOMMENT | |
| FOPPOSITEBANKACCOUNT | 对方银行账号 | FOPPOSITEBANKACCOUNT | |
| FOPPOSITECCOUNTNAME | 对方账户名称 | FOPPOSITECCOUNTNAME | |
| FRECEIVEITEM | 预收销售订单 | FRECEIVEITEM | |
| FHANDLINGCHARGEFOR | 手续费 | FHANDLINGCHARGEFOR | |
| FHANDLINGCHARGE | 手续费本位币 | FHANDLINGCHARGE | |
| FREALRECAMOUNTFOR_D | 表体-实收金额 | FREALRECAMOUNTFOR_D | |
| FREALRECAMOUNT_D | 表体-实收金额本位币 | FREALRECAMOUNT_D | |
| FASSTOTALAMOUNTFOR | 关联总金额 | FASSTOTALAMOUNTFOR | |
| FRECEIVEITEMTYPE | 预收项目类型 | FRECEIVEITEMTYPE | |
| FSaleOrderID | 预收销售订单号内码 | FSaleOrderID | |
| FACCOUNTID | 我方银行账号 | FACCOUNTID.FNumber | |
| FOVERUNDERAMOUNTFOR | 长短款 | FOVERUNDERAMOUNTFOR | |
| FOPPOSITEBANKNAME | 对方开户行 | FOPPOSITEBANKNAME | |
| FSETTLENO | 结算号 | FSETTLENO | |
| FBLEND | 勾对 | FBLEND | |
| FPURPOSEID | 收款用途 | FPURPOSEID.FNumber | |
| FOVERUNDERAMOUNT | 长短款本位币 | FOVERUNDERAMOUNT | |
| FINNERACCOUNTID | 内部账号 | FINNERACCOUNTID | |
| FINNERACCOUNTNAME | 内部账户名称 | FINNERACCOUNTNAME | |
| FReFundAmount | 退款关联金额 | FReFundAmount | |
| FCashAccount | 现金账号 | FCashAccount | |
| FRECAMOUNTFOR_E | 收款金额 | FRECAMOUNTFOR_E | |
| FRECAMOUNT_E | 收款金额本位币 | FRECAMOUNT_E | |
| FPOSTDATE | 登账日期 | FPOSTDATE | |
| FISPOST | 是否登账 | FISPOST | |
| FMATERIALID | 物料编码 | FMATERIALID.FNumber | |
| FMATERIALNAME | 物料名称 | FMATERIALNAME | |
| FSALEORDERNO | 销售订单号 | FSALEORDERNO | |
| FMATERIALSEQ | 订单行号 | FMATERIALSEQ | |
| FORDERENTRYID | 销售订单明细内码 | FORDERENTRYID | |
| FTOPAYMENTAMOUNTFOR | 保证金转货款金额 | FTOPAYMENTAMOUNTFOR | |
| FWRITTENOFFAMOUNT | 已核销金额本位币 | FWRITTENOFFAMOUNT | |
| FNOTVERIFICATEAMOUNT | 未核销金额 | FNOTVERIFICATEAMOUNT | |
| FPRICEUNITID | 计价单位 | FPRICEUNITID | |
| FPrice | 含税单价 | FPrice | |
| FQty | 数量 | FQty | |
| FCOSTID | 费用项目 | FCOSTID.FNumber | |
| FCOSTDEPARTMENTID | 费用承担部门 | FCOSTDEPARTMENTID.FNumber | |
| FCOSTNAME | 费用项目名称 | FCOSTNAME | |
| FLinkRowId | 关联行ID | FLinkRowId | |
| FSALEORDERBase | 销售订单（基础资料） | FSALEORDERBase | |
| FRECEIVEBILLSRCENTRY_FEntryID | FRECEIVEBILLSRCENTRY_FEntryID | FRECEIVEBILLSRCENTRY_FEntryID | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | AR_RECEIVEBILL | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FID | 实体主键 | | |
| FBillNo | 单据编号 | | |
| FDOCUMENTSTATUS | 单据状态 | | |
| FCreatorId | 创建人 | | |
| FAPPROVERID | 审核人 | | |
| FCreateDate | 创建日期 | | |
| FSETTLEORGID | 结算组织 | | |
| FApproveDate | 审核日期 | | |
| FSALEORGID | 销售组织 | | |
| FEXCHANGETYPE | 汇率类型 | | |
| FRECEIVEAMOUNTFOR_H | 表头-应收金额 | | |
| FMAINBOOKCURID | 本位币 | | |
| FRECEIVEAMOUNT_H | 表头-应收金额本位币 | | |
| FCURRENCYID | 币别 | | |
| FDATE | 业务日期 | | |
| FModifyDate | 修改日期 | | |
| FModifierId | 修改人 | | |
| FEXCHANGERATE | 汇率 | | |
| FWRITTENOFFSTATUS | 核销状态 | | |
| FSALEERID | 销售员 | | |
| FSALEGROUPID | 销售组 | | |
| FSALEDEPTID | 销售部门 | | |
| FBillTypeID | 单据类型 | | |
| FREALRECAMOUNTFOR | 表头-实收金额 | | |
| FREALRECAMOUNT_H | 表头-实收金额本位币 | | |
| FACCOUNTSYSTEM | 会计核算体系 | | |
| FCancelDate | 作废日期 | | |
| FCancelStatus | 作废状态 | | |
| FCancellerId | 作废人 | | |
| FCONTACTUNITTYPE | 往来单位类型 | | |
| FCONTACTUNIT | 往来单位 | | |
| FPAYUNITTYPE | 付款单位类型 | | |
| FPAYUNIT | 付款单位 | | |
| FBUSINESSTYPE | 业务类型 | | |
| FCreditCheckResult | 信用检查结果 | | |
| FISINIT | 是否期初单据 | | |
| FDepartment | 部门 | | |
| FPAYORGID | 收款组织 | | |
| FIsSameOrg | 是否相同组织 | | |
| FSOURCESYSTEM | 来源系统 | | |
| FCASHSALE | 现销 | | |
| FSETTLECUR | 结算币别 | | |
| FSETTLERATE | 结算汇率 | | |
| FRECAMOUNTFOR | 收款金额 | | |
| FRECAMOUNT | 表头-收款金额本位币 | | |
| FISB2C | B2C业务 | | |
| FWBSETTLENO | 流水号/对账码 | | |
| FIsWriteOff | 是否转销 | | |
| FMatchMethodID | 核销方式 | | |
| FScanPoint | 扫描点 | | |
| FKDPAYNO | 金蝶支付流水号 | | |
| FREMARK | 备注 | | |
| FTHIRDBILLNO | 第三方单据编号 | | |
| FSETTLEMAINBOOKID | 结算本位币 | | |
| FSETTLEEXCHANGETYPE | 结算汇率类型 | | |
| FOUTCONTACTID | 转出往来单位 | | |
| FOUTCONTACTTYPE | 转出往来单位类型 | | |
| FGYACCOUNTWATERID | 管易财务流水内码 | | |
| FISCARRYRATE | 是否下推携带汇率到结算汇率 | | |
| FPRESETBASE1 | 预设基础资料字段1 | | |
| FPRESETBASE2 | 预设基础资料字段2 | | |
| FPRESETASSISTANT1 | 预设辅助资料字段1 | | |
| FPRESETASSISTANT2 | 预设辅助资料字段2 | | |
| FPRESETTEXT1 | 预设文本字段1 | | |
| FPRESETTEXT2 | 预设文本字段2 | | |
| FISFROMSALORDER | 来源销售订单下推 | | |
| FVirIsSameAcctOrg | 是否同一核算组织 | | |
| FSETTLETYPEID | 结算方式 | | |
| FSETTLERECAMOUNTFOR | 折后金额 | | |
| FSETTLEDISTAMOUNTFOR | 现金折扣 | | |
| FRECTOTALAMOUNTFOR | 表体-应收金额 | | |
| FSETTLERECAMOUNT | 折后金额本位币 | | |
| FSETTLEDISTAMOUNT | 现金折扣本位币 | | |
| FRECTOTALAMOUNT | 表体-应收金额本位币 | | |
| FWRITTENOFFSTATUS_D | 表体明细-核销状态 | | |
| FWRITTENOFFAMOUNTFOR_D | 表体明细-已核销金额 | | |
| FCOMMENT | 备注 | | |
| FOPPOSITEBANKACCOUNT | 对方银行账号 | | |
| FOPPOSITECCOUNTNAME | 对方账户名称 | | |
| FRECEIVEITEM | 预收销售订单 | | |
| FHANDLINGCHARGEFOR | 手续费 | | |
| FHANDLINGCHARGE | 手续费本位币 | | |
| FREALRECAMOUNTFOR_D | 表体-实收金额 | | |
| FREALRECAMOUNT_D | 表体-实收金额本位币 | | |
| FASSTOTALAMOUNTFOR | 关联总金额 | | |
| FRECEIVEITEMTYPE | 预收项目类型 | | |
| FSaleOrderID | 预收销售订单号内码 | | |
| FACCOUNTID | 我方银行账号 | | |
| FOVERUNDERAMOUNTFOR | 长短款 | | |
| FOPPOSITEBANKNAME | 对方开户行 | | |
| FSETTLENO | 结算号 | | |
| FBLEND | 勾对 | | |
| FPURPOSEID | 收款用途 | | |
| FOVERUNDERAMOUNT | 长短款本位币 | | |
| FINNERACCOUNTID | 内部账号 | | |
| FINNERACCOUNTNAME | 内部账户名称 | | |
| FReFundAmount | 退款关联金额 | | |
| FCashAccount | 现金账号 | | |
| FRECAMOUNTFOR_E | 收款金额 | | |
| FRECAMOUNT_E | 收款金额本位币 | | |
| FPOSTDATE | 登账日期 | | |
| FISPOST | 是否登账 | | |
| FMATERIALID | 物料编码 | | |
| FMATERIALNAME | 物料名称 | | |
| FSALEORDERNO | 销售订单号 | | |
| FMATERIALSEQ | 订单行号 | | |
| FORDERENTRYID | 销售订单明细内码 | | |
| FTOPAYMENTAMOUNTFOR | 保证金转货款金额 | | |
| FWRITTENOFFAMOUNT | 已核销金额本位币 | | |
| FNOTVERIFICATEAMOUNT | 未核销金额 | | |
| FPRICEUNITID | 计价单位 | | |
| FPrice | 含税单价 | | |
| FQty | 数量 | | |
| FCOSTID | 费用项目 | | |
| FCOSTDEPARTMENTID | 费用承担部门 | | |
| FCOSTNAME | 费用项目名称 | | |
| FLinkRowId | 关联行ID | | |
| FSALEORDERBase | 销售订单（基础资料） | | |
| FRECEIVEBILLSRCENTRY_FEntryID | FRECEIVEBILLSRCENTRY_FEntryID | | |
网易互客接口明细
- 接口：openapi/trade/addPayBacks
- 接口名称：编辑订单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| payBacks | payBacks | array | |
| payBacks.payBackAmount | 回款金额 | string | 订单字段id，可以通过“查询订单字段”API获取 |
| payBacks.payBackTime | 回款时间 | string | 订单id对应的字段的值，传入值须符合对应字段限制，否则将无法传入 标签类型需传入标签Id |
| payBacks.payStatus | 回款状态 | string | |
| payBacks.tid | 订单tid | string | |
系统对接概况
可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。
