万里牛与金蝶云星空对接集成查询采购退货订单连通采购退货新增(万里牛采购退货单-金蝶【采购退料单】)
数据源系统:万里牛
万里牛是一家SaaSERP服务商，提供一站式对接全球电商平台解决方案。万里牛系列产品是以ERP/WMS作为核心，并延展到智慧零售、商业智能（BI）、B2B分销及供应链等领域构成完整的SaaS产品矩阵，覆盖鞋服、百货、美妆、食品、家电、3C、快消等行业领域，累计服务30万+用户，以先进的云服务技术助力企业实现数智化转型。
目标系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
配置集成方案
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将万里牛、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。
万里牛接口明细
- 接口：/erp/purchase/purchasereturnbill/query
- 接口名称：查询采购退货订单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| bill_code | 单据编码 | String | 单据编码 |
| modify_time | 修改时间 | Datetime | 修改时间，只能查近3个月 |
| page | 当前页码 | int | 当前页码，从1开始 |
| limit | 每页大小 | int | 每页大小,最大200 |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| bill_code | 单据编码 | String | 单据编码 |
| bill_date | 单据业务时间 | Datetime | 单据业务时间 |
| create_time | 创建时间 | Datetime | 创建时间 |
| details | 明细 | object | 明细 |
| details.article_number | 货号 | String | 货号 |
| details.base_price | 原价 | String | 原价 |
| details.discount_rate | 折扣率 | String | 折扣率 |
| details.goods_name | 商品名称 | String | 商品名称 |
| details.index | 行号 | String | 行号 |
| details.price | 单价 | String | 单价 |
| details.receive | 已入库数量 | String | 已入库数量 |
| details.remark | 备注 | String | 备注 |
| details.size | 数量 | String | 数量 |
| details.spec_code | 规格编码 | String | 规格编码 |
| details.spec_name | 规格名称 | String | 规格名称 |
| details.status | 状态 | int | 状态 1:未到货 2:部分到货 3:全部到货 4:已关闭 |
| details.sum | 总价 | String | 总价 |
| details.tax_rate | 税率 | String | 税率 |
| details.unit | 单位 | String | 单位，默认erp的基本单位 |
| details.modified_time | 修改时间 | Datetime | 修改时间 |
| details.remark | 备注 | String | 备注 |
| details.status | 状态 | int | 状态 1： 未到货 2： 部分到货 3：完成 4 ：关闭 5：待提交 6 ：审核中 |
| details.storage_code | 仓库编码 | String | 仓库编码 |
| details.storage_name | 仓库名称 | String | 仓库名称 |
| details.supplier_code | 供应商编码 | String | 供应商编码 |
| details.supplier_name | 供应商名称 | String | 供应商名称 |
| details.ext_properties | 自定义属性, | String | 自定义属性, key(自定义属性名)-value(设置的属性值) |
金蝶云星空接口明细
- API：batchSave
- NAME：采购退货新增
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBillNo | 单据编号 | {{bill_code}} | 单据编号 |
| FDate | 退料日期 | {{bill_date}} | 日期 |
| FSupplierID | 供应商 | {{supplier_code}} | 基础资料 |
| FStockOrgId | 退料组织 | 999 | 组织 |
| FSettleOrgId | 结算组织 | 101 | 组织 |
| FSETTLETYPEID | 结算方式 | | 基础资料 |
| FSettleCurrId | 结算币别 | PRE001 | 基础资料 |
| FPayOrgId | 付款组织 | 101 | 组织 |
| FOwnerTypeIdHead | 货主类型 | BD_OwnerOrg | 多类别基础资料列表 |
| FOwnerIdHead | 货主 | 999 | 多类别基础资料 |
| FPURMRBENTRY | 明细信息 | | 明细信息 |
| FPURMRBENTRY.FMATERIALID | 物料编码 | {{details.spec_code}} | 基础资料 |
| FPURMRBENTRY.FRMREALQTY | 实退数量 | {{details.size}} | 数量 |
| FPURMRBENTRY.FSTOCKID | 仓库 | {{storage_code}} | 基础资料 |
| FPURMRBENTRY.FPrice | 单价 | {{details.price}} | 单价 |
| FPURMRBENTRY.FLot | 批号 | | 批次 |
| FPURMRBENTRY.FOWNERID | 货主 | 999 | 多类别基础资料 |
| FPURMRBENTRY.FOWNERTYPEID | 货主类型 | BD_OwnerOrg | 多类别基础资料列表 |
| FPURMRBENTRY.FTAXPRICE | 含税单价 | | 单价 |
| FPURMRBENTRY.FPURMRBENTRY_Link_FRuleId | 转换规则 | STK InStock-PUR MRB | |
| FPURMRBENTRY.FPURMRBENTRY_Link_FSTableName | 源单表 | T_STK_INSTOCKENTRY | |
| FPURMRBENTRY.FPURMRBENTRY_Link_FSBillId | 源单内码 | | |
| FPURMRBENTRY.FPURMRBENTRY_Link_FSId | 源单分录内码 | | |
| FPURMRBENTRY.FormId | 业务对象表单Id | PUR_MRB | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FPURMRBENTRY.Operation | 执行的操作 | batchSave | |
| FPURMRBENTRY.IsAutoSubmitAndAudit | 提交并审核 | true | |
| FPURMRBENTRY.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| FPURMRBENTRY.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
系统对接概况
采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。
