万里牛对接打通金蝶云星空查询采购退货订单接口与采购退货新增接口
对接系统万里牛
万里牛是杭州湖畔网络技术有限公司旗下SaaS软件品牌，主要针对电商、外贸、实体门店等业务群体，帮助企业快速布局新零售，提升订单处理效率，实现数据化业务管理，为企业降本增效。
接入系统：金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将万里牛、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。数据管道ETL：构建一体化的数据融合平台。高级数据转换： 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。
万里牛接口明细
- API：/erp/purchase/purchasereturnbill/query
- NAME：查询采购退货订单
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| bill_code | 单据编码 | |
| modify_time | 修改时间 | |
| page | 当前页码 | 1 |
| limit | 每页大小 | 200 |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| bill_code | 单据编码 | |
| bill_date | 单据业务时间 | |
| create_time | 创建时间 | |
| details | 明细 | |
| details.article_number | 货号 | |
| details.base_price | 原价 | |
| details.discount_rate | 折扣率 | |
| details.goods_name | 商品名称 | |
| details.index | 行号 | |
| details.price | 单价 | |
| details.receive | 已入库数量 | |
| details.remark | 备注 | |
| details.size | 数量 | |
| details.spec_code | 规格编码 | |
| details.spec_name | 规格名称 | |
| details.status | 状态 | |
| details.sum | 总价 | |
| details.tax_rate | 税率 | |
| details.unit | 单位 | |
| details.modified_time | 修改时间 | |
| details.remark | 备注 | |
| details.status | 状态 | |
| details.storage_code | 仓库编码 | |
| details.storage_name | 仓库名称 | |
| details.supplier_code | 供应商编码 | |
| details.supplier_name | 供应商名称 | |
| details.ext_properties | 自定义属性, | |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：采购退货新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillNo | 单据编号 | string | {{bill_code}} |
| FDate | 退料日期 | string | {{bill_date}} |
| FSupplierID | 供应商 | string | {{supplier_code}} |
| FStockOrgId | 退料组织 | string | 999 |
| FSettleOrgId | 结算组织 | string | 101 |
| FSETTLETYPEID | 结算方式 | string | |
| FSettleCurrId | 结算币别 | string | PRE001 |
| FPayOrgId | 付款组织 | string | 101 |
| FOwnerTypeIdHead | 货主类型 | string | BD_OwnerOrg |
| FOwnerIdHead | 货主 | string | 999 |
| FPURMRBENTRY | 明细信息 | array | |
| FPURMRBENTRY.FMATERIALID | 物料编码 | string | {{details.spec_code}} |
| FPURMRBENTRY.FRMREALQTY | 实退数量 | string | {{details.size}} |
| FPURMRBENTRY.FSTOCKID | 仓库 | string | {{storage_code}} |
| FPURMRBENTRY.FPrice | 单价 | string | {{details.price}} |
| FPURMRBENTRY.FLot | 批号 | string | |
| FPURMRBENTRY.FOWNERID | 货主 | string | 999 |
| FPURMRBENTRY.FOWNERTYPEID | 货主类型 | string | BD_OwnerOrg |
| FPURMRBENTRY.FTAXPRICE | 含税单价 | string | |
| FPURMRBENTRY.FPURMRBENTRY_Link_FRuleId | 转换规则 | string | STK InStock-PUR MRB |
| FPURMRBENTRY.FPURMRBENTRY_Link_FSTableName | 源单表 | string | T_STK_INSTOCKENTRY |
| FPURMRBENTRY.FPURMRBENTRY_Link_FSBillId | 源单内码 | string | |
| FPURMRBENTRY.FPURMRBENTRY_Link_FSId | 源单分录内码 | string | |
| FPURMRBENTRY.FormId | 业务对象表单Id | string | PUR_MRB |
| FPURMRBENTRY.Operation | 执行的操作 | string | batchSave |
| FPURMRBENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| FPURMRBENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | false |
| FPURMRBENTRY.SubSystemId | 系统模块 | string | 21 |
数据对接效果
通过数据集成平台可视化的快速配置调用接口打通万里牛与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。
