从万里牛到金蝶云星空通过接口配置打通数据
接通系统:万里牛
万里牛是杭州湖畔网络技术有限公司旗下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如:PUR_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架构。