从万里牛到金蝶云星空通过接口配置打通数据
接通系统：万里牛
万里牛是杭州湖畔网络技术有限公司旗下SaaS软件品牌，主要针对电商、外贸、实体门店等业务群体，帮助企业快速布局新零售，提升订单处理效率，实现数据化业务管理，为企业降本增效。
接通系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据集成方案配置
通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：万里牛，然后选择对应的连接器。选择对应的/erp/purchase/purchasebill/query作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。
万里牛接口明细
- 接口：/erp/purchase/purchasebill/query
- 接口名称：查询采购订单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| bill_code | 单据编码 | String | 单据编码 |
| status | 单据状态 | Integer | 单据状态 1： 未到货 2： 部分到货 3：完成 4 ：关闭 5：待提交 6 ：审核中 |
| supplierCode | 供应商编码 | String | 供应商编码 |
| modify_time | 采购单据修改时间 | datetime | 采购单据修改时间，只能查近3个月 |
| page | 当前页码 | int | 当前页码，从1开始 |
| limit | 每页大小 | int | 每页大小,最大200 |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| bill_code | 单据编码 | String | 单据编码 |
| bill_date | 单据业务时间 | Datetime | 单据业务时间 |
| create_time | 创建时间 | Datetime | 创建时间 |
| details | 明细 | array | 明细 |
| details.article_number | 货号 | String | 货号 |
| details.base_price | 原价 | Number | 原价 |
| details.discount_rate | 折扣率 | Number | 折扣率 |
| 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 | （0表示未到货，1表示 部分到货，2表示全部到货（已完成），3表示已关闭） |
| details.sum | 总价 | String | 总价 |
| details.tax_rate | 税率 | String | 税率 |
| details.unit | 单位 | String | 单位，默认erp的基本单位 |
| details.expecte_date | 预计到货日期 | Datetime | 预计到货日期 |
| 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 | 自定义属性, key(自定义属性名)-value(设置的属性值) | String | 自定义属性, key(自定义属性名)-value(设置的属性值) |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：采购订单新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBillNo | 单据编号 | string | |
| FDate | 采购日期 | string | |
| FPurchaseOrgId | 采购组织 | string | |
| FSupplierId | 供应商 | string | |
| FPurchaserGroupId | 采购组 | string | |
| FPurchaserId | 采购员 | string | |
| FBillTypeID | 单据类型 | string | |
| FBusinessType | 业务类型 | string | |
| FPOOrderEntry | 明细信息 | array | |
| FPOOrderEntry.FMaterialId | 物料编码 | string | |
| FPOOrderEntry.FQty | 采购数量 | string | |
| FPOOrderEntry.FPrice | 单价 | string | |
| FPOOrderEntry.FEntryDiscountRate | 折扣率% | string | |
| FPOOrderEntry.FEntryTaxRate | 税率% | string | |
| FPOOrderEntry.FTaxNetPrice | 净价 | string | |
| FPOOrderEntry.FEntryAmount | 金额 | string | |
| FPOOrderEntry.FAllAmount | 价税合计 | string | |
| FPOOrderEntry.FEntryNote | 备注 | string | |
| FPOOrderEntry.FTaxPrice | 含税单价 | string | |
| FPOOrderEntry.FEntryTaxAmount | 税额 | string | |
| FPOOrderEntry.FReceiveOrgId | 收料组织 | string | |
| FPOOrderEntry.FRequireOrgId | 需求组织 | string | |
| FPOOrderEntry.FRowCost | 行费用 | string | |
| FPOOrderEntry.FEntryPayOrgId | 付款组织 | string | |
| FPOOrderEntry.FEntrySettleOrgId | 结算组织 | string | |
| FPOOrderEntry.FDeliveryDate | 交货日期 | string | |
| FPOOrderEntry.FMtoNo | 计划跟踪号 | string | |
| FPOOrderEntry.FGiveAway | 是否赠品 | string | true false |
| FPOOrderEntry.F_POIH_Remarks | 银行账号 | string | |
| FPOOrderEntry.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FPOOrderEntry.Operation | 执行的操作 | string | |
| FPOOrderEntry.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FPOOrderEntry.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
系统数据对接
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通万里牛到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。
