万里牛对接打通金蝶云星空查询采购订单接口与采购订单新增接口
对接系统万里牛
万里牛是一家SaaSERP服务商，提供一站式对接全球电商平台解决方案。万里牛系列产品是以ERP/WMS作为核心，并延展到智慧零售、商业智能（BI）、B2B分销及供应链等领域构成完整的SaaS产品矩阵，覆盖鞋服、百货、美妆、食品、家电、3C、快消等行业领域，累计服务30万+用户，以先进的云服务技术助力企业实现数智化转型。
对接目标平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取万里牛的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。
万里牛接口明细
- 接口：/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 | {{bill_code}} |
| FDate | 采购日期 | string | {{bill_date datetime}} |
| FPurchaseOrgId | 采购组织 | string | 101 |
| FSupplierId | 供应商 | string | {{supplier_code}} |
| FPurchaserGroupId | 采购组 | string | |
| FPurchaserId | 采购员 | string | |
| FBillTypeID | 单据类型 | string | CGDD01_SYS |
| FBusinessType | 业务类型 | string | CG |
| FPOOrderEntry | 明细信息 | array | details |
| FPOOrderEntry.FMaterialId | 物料编码 | string | {{details.spec_code}} |
| FPOOrderEntry.FQty | 采购数量 | string | {{details.size}} |
| FPOOrderEntry.FPrice | 单价 | string | |
| FPOOrderEntry.FEntryDiscountRate | 折扣率% | string | |
| FPOOrderEntry.FEntryTaxRate | 税率% | string | |
| FPOOrderEntry.FTaxNetPrice | 净价 | string | |
| FPOOrderEntry.FEntryAmount | 金额 | string | |
| FPOOrderEntry.FAllAmount | 价税合计 | string | |
| FPOOrderEntry.FEntryNote | 备注 | string | |
| FPOOrderEntry.FTaxPrice | 含税单价 | string | {{details.price}} |
| FPOOrderEntry.FEntryTaxAmount | 税额 | string | |
| FPOOrderEntry.FReceiveOrgId | 收料组织 | string | 999 |
| FPOOrderEntry.FRequireOrgId | 需求组织 | string | |
| FPOOrderEntry.FRowCost | 行费用 | string | |
| FPOOrderEntry.FEntryPayOrgId | 付款组织 | string | 101 |
| FPOOrderEntry.FEntrySettleOrgId | 结算组织 | string | 101 |
| FPOOrderEntry.FDeliveryDate | 交货日期 | string | |
| FPOOrderEntry.FMtoNo | 计划跟踪号 | string | |
| FPOOrderEntry.FGiveAway | 是否赠品 | string | |
| FPOOrderEntry.F_POIH_Remarks | 银行账号 | string | |
| FPOOrderEntry.FormId | 业务对象表单Id | string | PUR_PurchaseOrder |
| FPOOrderEntry.Operation | 执行的操作 | string | BatchSave |
| FPOOrderEntry.IsAutoSubmitAndAudit | 提交并审核 | bool | false |
| FPOOrderEntry.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统对接总览
采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。
