金蝶云星空、旺店通·企业版通过接口配置数据对接
数据源系统:旺店通·企业版
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
对接目标系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
系统对接接口配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取旺店通·企业版的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。
旺店通·企业版接口明细
- API：purchase_return_query
- NAME：查询采购退货单
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| start_time | 开始时间 | {{LAST_SYNC_TIME datetime}} |
| end_time | 结束时间 | {{CURRENT_TIME datetime}} |
| status | 状态 | |
| warehouse_no | 仓库编号 | |
| page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} |
| page_no | 页号 | {{PAGINATION_START_PAGE}} |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| return_no | 退货单号 | |
| provider_name | 供应商 | |
| status | 采购单状态 | |
| warehouse_no | 仓库编号 | |
| warehouse_name | 仓库 | |
| purchaser_id | 采购员id | |
| purchaser_name | 采购员名称 | |
| logistics_type | 物流类型 | |
| other_fee | 其它费用 | |
| post_fee | 邮费 | |
| goods_fee | 总货款 | |
| goods_count | 退货开单量 | |
| goods_type_count | 货品种类数 | |
| goods_out_count | 退货出库量 | |
| api_outer_no | 外部接口单号 | |
| outer_no | 外部单号 | |
| prop1 | 自定义属性1 | |
| prop2 | 自定义属性2 | |
| provider_no | 供应商编号 | |
| purchase_no | 引用采购单号 | |
| creator_id | 制单员id | |
| creator_name | 制单员姓名 | |
| type | 类型 | |
| flag_id | 颜色标记 | |
| warehouse_id | 出库id | |
| provider_id | 供应商id | |
| contact | 联系人姓名 | |
| telno | 联系电话 | |
| receive_address | 退货地址 | |
| check_operator_id | 审核人 | |
| check_time | 审核时间 | |
| note_count | 便签条数 | |
| province | 省份 | |
| city | 城市 | |
| district | 地区 | |
| wms_outer_no | 外部仓库的单号 | |
| wms_status | 处理状态 | |
| error_info | 错误信息 | |
| version_id | 版本号 | |
| last_load_purchase_id | 最后一次引用的采购单id | |
| detail_list | 采购退货单货品列表节点 | |
| detail_list.return_id | 采购退货单id | |
| detail_list.remark | 备注 | |
| detail_list.created | 创建时间 | |
| detail_list.modified | 最后修改时间 | |
| detail_list.provider_goods_no | 供应商货品编号 | |
| detail_list.spec_no | 商家编码 | |
| detail_list.goods_no | 货品编码 | |
| detail_list.goods_name | 货品名称 | |
| detail_list.spec_name | 规格名称 | |
| detail_list.spec_code | 规格码 | |
| detail_list.num | 退货数量 | |
| detail_list.num2 | 辅助退货量 | |
| detail_list.unit_id | 出库单位 | |
| detail_list.unit_ratio | 单位变换率 | |
| detail_list.base_unit_id | 基本单位 | |
| detail_list.price | 单价 | |
| detail_list.discount | 折扣 | |
| detail_list.amount | 税前金额 | |
| detail_list.unit_name | 出库单位名称 | |
| detail_list.base_unit_name | 基本单位名称 | |
| detail_list.tax | 税率 | |
| detail_list.tax_amount | 税后金额 | |
| detail_list.rec_id | 明细id | |
| detail_list.spec_id | 规格id | |
| detail_list.out_num | 退货出库数量 | |
| detail_list.out_amount | 退货出库金额 | |
| detail_list.tax_price | 税后单价 | |
金蝶云星空接口明细
- API：batchSave
- NAME：采购退货新增
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| FBillNo | 单据编号 | {{return_no}}YY |
| FDate | 退料日期 | {{check_time datetime 2020-02-01}} |
| FSupplierID | 供应商 | 0003 |
| FStockOrgId | 退料组织 | 100 |
| FMRREASON | 退料原因 | 旺店通退料 |
| FRequireOrgId | 需求组织 | 100 |
| FDESCRIPTION | 备注 | {{warehouse_no}}{{logistics_type}} |
| FSettleOrgId | 结算组织 | 100 |
| FPayOrgId | 付款组织 | 100 |
| FPURMRBENTRY | 明细信息 | detail_list |
| FPURMRBENTRY.FMATERIALID | 物料编码 | A01 |
| FPURMRBENTRY.FBarcode | 零售条形码 | |
| FPURMRBENTRY.FRMREALQTY | 实退数量 | {{detail_list.num}} |
| FPURMRBENTRY.FPrice | 单价 | {{detail_list.price}} |
| FPURMRBENTRY.FTAXPRICE | 含税单价 | {{detail_list.price}} |
| FPURMRBENTRY.FEntryTaxRate | 税率 | |
| FPURMRBENTRY.FSTOCKID | 仓库 | CK001 |
| FPURMRBENTRY.FNOTE | 备注 | WDT{{detail_list.goods_no}} |
| FPURMRBENTRY.FPURMRBENTRY_Link | 关联关系表 | |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId | 转换规则 | PUR_MRAPP-PUR_MRB |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName | 源单表 | T_PUR_MRAPPENTRY |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId | 源单内码 | 5555 |
| FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId | 源单分录内码 | 5555 |
| FPURMRBENTRY.FormId | 业务对象表单Id | PUR_MRB |
| FPURMRBENTRY.Operation | 执行的操作 | batchSave |
| FPURMRBENTRY.IsAutoSubmitAndAudit | 提交并审核 | true |
| FPURMRBENTRY.IsVerifyBaseDataField | 验证基础资料 | false |
系统对接总览
全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与旺店通·企业版之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
