从旺店通·企业版到金蝶云星空通过接口集成数据
来源系统:旺店通·企业版
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
对接目标系统:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据对接方案
通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：旺店通·企业版，并且选择对应的连接器（关于旺店通·企业版的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询采购退货单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的采购退货新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
旺店通·企业版接口明细
- 接口：purchase_return_query
- 接口名称：查询采购退货单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| page_no | 页号 | string |
| status | 状态 | string |
| page_size | 分页大小 | string |
| start_time | 开始时间 | datetime |
| end_time | 结束时间 | datetime |
| warehouse_no | 仓库编号 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| return_no | 退货单号 | string | |
| provider_name | 供应商 | string | |
| status | 采购单状态 | string | |
| warehouse_no | 仓库编号 | string | |
| warehouse_name | 仓库 | string | |
| purchaser_id | 采购员id | string | |
| purchaser_name | 采购员名称 | string | |
| logistics_type | 物流类型 | string | |
| other_fee | 其它费用 | string | |
| post_fee | 邮费 | string | |
| goods_fee | 总货款 | string | |
| goods_count | 退货开单量 | string | |
| goods_type_count | 货品种类数 | string | |
| goods_out_count | 退货出库量 | string | |
| api_outer_no | 外部接口单号 | string | |
| outer_no | 外部单号 | string | |
| prop1 | 自定义属性1 | string | |
| prop2 | 自定义属性2 | string | |
| provider_no | 供应商编号 | string | |
| purchase_no | 引用采购单号 | string | |
| creator_id | 制单员id | string | |
| creator_name | 制单员姓名 | string | |
| type | 类型 | string | |
| flag_id | 颜色标记 | string | |
| warehouse_id | 出库id | string | |
| provider_id | 供应商id | string | |
| contact | 联系人姓名 | string | |
| telno | 联系电话 | string | |
| receive_address | 退货地址 | string | |
| check_operator_id | 审核人 | string | |
| check_time | 审核时间 | string | |
| note_count | 便签条数 | string | |
| province | 省份 | string | |
| city | 城市 | string | |
| district | 地区 | string | |
| wms_outer_no | 外部仓库的单号 | string | |
| wms_status | 处理状态 | string | |
| error_info | 错误信息 | string | |
| version_id | 版本号 | string | |
| last_load_purchase_id | 最后一次引用的采购单id | string | |
| detail_list | 采购退货单货品列表节点 | array | |
| detail_list.return_id | 采购退货单id | string | |
| detail_list.remark | 备注 | string | |
| detail_list.created | 创建时间 | string | |
| detail_list.modified | 最后修改时间 | string | |
| detail_list.provider_goods_no | 供应商货品编号 | string | |
| detail_list.spec_no | 商家编码 | string | |
| detail_list.goods_no | 货品编码 | string | |
| detail_list.goods_name | 货品名称 | string | |
| detail_list.spec_name | 规格名称 | string | |
| detail_list.spec_code | 规格码 | string | |
| detail_list.num | 退货数量 | string | |
| detail_list.num2 | 辅助退货量 | string | |
| detail_list.unit_id | 出库单位 | string | |
| detail_list.unit_ratio | 单位变换率 | string | |
| detail_list.base_unit_id | 基本单位 | string | |
| detail_list.price | 单价 | string | |
| detail_list.discount | 折扣 | string | |
| detail_list.amount | 税前金额 | string | |
| detail_list.unit_name | 出库单位名称 | string | |
| detail_list.base_unit_name | 基本单位名称 | string | |
| detail_list.tax | 税率 | string | |
| detail_list.tax_amount | 税后金额 | string | |
| detail_list.rec_id | 明细id | string | |
| detail_list.spec_id | 规格id | string | |
| detail_list.out_num | 退货出库数量 | string | |
| detail_list.out_amount | 退货出库金额 | string | |
| detail_list.tax_price | 税后单价 | string | |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：采购退货新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillNo | 单据编号 | string | {{return_no}}YY |
| FDate | 退料日期 | string | {{check_time datetime 2020-02-01}} |
| FSupplierID | 供应商 | string | 0003 |
| FStockOrgId | 退料组织 | string | 100 |
| FMRREASON | 退料原因 | string | 旺店通退料 |
| FRequireOrgId | 需求组织 | string | 100 |
| FDESCRIPTION | 备注 | string | {{warehouse_no}}{{logistics_type}} |
| FSettleOrgId | 结算组织 | string | 100 |
| FPayOrgId | 付款组织 | string | 100 |
| FPURMRBENTRY | 明细信息 | array | detail_list |
| FPURMRBENTRY.FMATERIALID | 物料编码 | string | A01 |
| FPURMRBENTRY.FBarcode | 零售条形码 | string | |
| FPURMRBENTRY.FRMREALQTY | 实退数量 | string | {{detail_list.num}} |
| FPURMRBENTRY.FPrice | 单价 | string | {{detail_list.price}} |
| FPURMRBENTRY.FTAXPRICE | 含税单价 | string | {{detail_list.price}} |
| FPURMRBENTRY.FEntryTaxRate | 税率 | string | |
| FPURMRBENTRY.FSTOCKID | 仓库 | string | CK001 |
| FPURMRBENTRY.FNOTE | 备注 | string | WDT{{detail_list.goods_no}} |
| FPURMRBENTRY.FPURMRBENTRY_Link | 关联关系表 | array | |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId | 转换规则 | string | PUR_MRAPP-PUR_MRB |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName | 源单表 | string | T_PUR_MRAPPENTRY |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId | 源单内码 | string | 5555 |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId | 源单分录内码 | string | 5555 |
| FPURMRBENTRY.FormId | 业务对象表单Id | string | PUR_MRB |
| FPURMRBENTRY.Operation | 执行的操作 | string | batchSave |
| FPURMRBENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| FPURMRBENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统集成总览
基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接旺店通·企业版接口抽取数据后再自动分发到金蝶云星空， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。
