管易云对接打通金蝶云星空采购退货单查询接口与采购退货新增接口
源系统:管易云
管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌，总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品
对接系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接口方案配置
系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：管易云的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试
管易云接口明细
- API：gy.erp.purchase.return.get
- NAME：采购退货单查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| page_no | 页码 | | |
| page_size | 每页大小 | | |
| start_create | 创建时间开始段 | | |
| end_create | 创建时间结束段 | | |
| start_approve | 审核时间开始段 | | |
| end_approve | 审核时间结束段 | | |
| start_modify_date | 开始修改时间 | | |
| end_modify_date | 结束修改时间 | | |
| warehouse_code | 仓库代码 | | |
| supplier_code | 供应商代码 | | |
| code | 单据编号 | | |
| status | 订单状态 | | |
| page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} | |
| page_no | 页号 | {{PAGINATION_START_PAGE}} | |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| id | id | | |
| code | 单据编号 | | |
| create_date | 创建时间 | | |
| approve_date | 审核时间 | | |
| account_date | 记账日期 | | |
| modify_date | 修改日期 | | |
| out_warehouse_date | 出库日期 | | |
| warehouse_code | 仓库代码 | | |
| supplier_code | 供应商代码 | | |
| supplier_name | 供应商名称 | | |
| status | 订单状态 | | |
| details | 采购退货明细 | | |
| details.qty | 数量 | | |
| details.price | 实际进价 | | |
| details.amount | 实际金额 | | |
| details.note | 备注 | | |
| details.item_id | 商品iD | | |
| details.item_sku_id | 规格ID | | |
| details.item_code | 商品代码 | | |
| details.sku_code | 规格代码 | | |
| details.sku_note | 规格备注 | | |
| details.sku_name | 规格名称 | | |
| details.detail_unique | 唯一码列表 | | |
| details.detail_batch | 批次列表 | | |
| details.detail_batch.batchNumber | 批次号 | | |
| details.detail_batch.warehousing_time | 入库日期 | | |
| details.detail_batch.production_time | 生产日期 | | |
| details.detail_batch.shelf_life | 保质期 | | |
| details.detail_batch.valid_time | 有效日期 | | |
| details.create_name | 制单人 | | |
| details.delete_date | 作废日期 | | |
| details.delete_status | 作废状态 | | |
| details.out_warehouse_status | 出库状态 | | |
| details.account_status | 记账状态 | | |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：采购退货新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillNo | 单据编号 | string | |
| FDate | 退料日期 | string | |
| FSupplierID | 供应商 | string | |
| FMRTYPE | 退料类型 | string | |
| FMRMODE | 退料方式 | string | |
| FStockOrgId | 退料组织 | string | |
| FMRDeptId | 退料部门 | string | |
| FREPLENISHMODE | 补料方式 | string | |
| FMRREASON | 退料原因 | string | |
| FDESCRIPTION | 备注 | string | |
| FSettleId | 结算方 | string | |
| FCHARGEID | 收款方 | string | |
| FDELIVERYNO | 送货单号 | string | |
| FCARRYNO | 运输单号 | string | |
| FTAKEDELIVERYNO | 提货单号 | string | |
| FSettleOrgId | 结算组织 | string | |
| FSETTLETYPEID | 结算方式 | string | |
| FSettleCurrId | 结算币别 | string | |
| FPayOrgId | 付款组织 | string | |
| FPAYCONDITIONID | 付款条件 | string | |
| FOwnerTypeIdHead | 货主类型 | string | |
| FOwnerIdHead | 货主 | string | |
| FPURMRBENTRY | 明细信息 | array | |
| FPURMRBENTRY.FMATERIALID | 物料编码 | string | |
| FPURMRBENTRY.FBarcode | 零售条形码 | string | |
| FPURMRBENTRY.FRMREALQTY | 实退数量 | string | |
| FPURMRBENTRY.FREPLENISHQTY | 补料数量 | string | |
| FPURMRBENTRY.FKEAPAMTQTY | 扣款数量 | string | |
| FPURMRBENTRY.FSTOCKID | 仓库 | string | |
| FPURMRBENTRY.FSTOCKLOCID | 仓位 | string | |
| FPURMRBENTRY.FNOTE | 备注 | string | |
| FPURMRBENTRY.FPrice | 单价 | string | |
| FPURMRBENTRY.FGiveAway | 是否赠品 | string | |
| FPURMRBENTRY.FLot | 批号 | string | |
| FPURMRBENTRY.FOWNERID | 货主 | string | |
| FPURMRBENTRY.FOWNERTYPEID | 货主类型 | string | |
| FPURMRBENTRY.FENTRYTAXRATE | 税率 | string | |
| FPURMRBENTRY.FDISCOUNTRATE | 折扣率(%) | string | |
| FPURMRBENTRY.FTAXPRICE | 含税单价 | string | |
| FPURMRBENTRY.FORDERNO | 订单单号 | string | |
| FPURMRBENTRY.FCONTRACTNO | 合同单号 | string | |
| FPURMRBENTRY.FMtoNo | 计划跟踪号 | string | |
| FPURMRBENTRY.FPURMRBENTRY_Link | 关联关系表 | array | |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId | 转换规则 | string | |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName | 源单表 | string | |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId | 源单内码 | string | |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId | 源单分录内码 | string | |
| FPURMRBENTRY.FormId | 业务对象表单Id | string | PUR_MRB |
| FPURMRBENTRY.Operation | 执行的操作 | string | batchSave |
| FPURMRBENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| FPURMRBENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | false |
数据对接价值
通过数据集成平台可视化的快速配置调用接口打通管易云与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。
