从旺店通·旗舰奇门到金蝶云星空通过接口配置打通数据
接入系统:旺店通·旗舰奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
接通系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接口方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:旺店通·旗舰奇门,源系统 API:退货入库单查询,目标系统:金蝶云星空,目标系统 API销售退货单新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
旺店通·旗舰奇门接口明细
- 接口:wdt.wms.stockin.refund.querywithdetail
- 接口名称:退货入库单查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
pager | 分页参数 | object | |
pager.page_size | 分页大小 | string | |
pager.page_no | 页号 | string | |
pager.params | 业务参数 | object | |
pager.params.start_time | 开始时间 | string | |
pager.params.end_time | 结束时间 | string | |
pager.params.status | 入库单状态 | string | 英文逗号拼接的状态值:10=已取消;20=编辑中;30=待审核;37=待质检;40=质检确认; |
60=待结算;70=暂估结算;80=已完成 |
pager.params.time_type | 时间条件类型 | string | 查询的时间条件类型, 0:修改时间; 1:入库时间 不传默认为0 |
pager.params.warehouse_no | 仓库编码 | string | |
pager.params.shop_nos | 店铺编号 | string | 多个店铺编号使用英文逗号分隔 |
pager.params.stockin_no | 入库单号 | string | |
响应参数
字段 | 名称 | 类型 | 描述 |
order_no | 入库单号 | string | |
status | 入库单状态 | string | |
warehouse_no | 仓库编号 | string | |
warehouse_name | 仓库名称 | string | |
created_time | 入库单创建时间 | string | |
fenxiao_nick | 分销商昵称 | string | |
operator_name | 退换建单人 | string | |
logistics_type | 物流方式 | string | |
check_time | 审核时间 | string | |
refund_no | 退换单号 | string | |
goods_count | 货品总数 | string | |
actual_refund_amount | 退换单实际退款金额 | string | |
customer_no | 客户编码 | string | |
customer_name | 退货人姓名 | string | |
nick_name | 客户网名 | string | |
shop_name | 店铺名称 | string | |
shop_no | 店铺编号 | string | |
shop_remark | 店铺备注 | string | |
flag_name | 标记名称 | string | |
trade_no_list | 订单编号 | string | |
total_price | 入库单总金额 | string | |
modified | 最后修改时间 | string | |
details_list | 入库单明细 | array | |
details_list.remark | 明细备注 | string | |
details_list.rec_id | 明细id(主键) | string | |
details_list.stockin_id | 入库单id | string | |
details_list.num | 数量 | string | |
details_list.total_cost | 总成本 | string | |
details_list.right_num | 调整后数量 | string | |
details_list.goods_name | 货品名称 | string | |
details_list.goods_no | 货品编码 | string | |
details_list.spec_no | 商家编码 | string | |
details_list.defect | 是否残次品 | string | |
details_list.prop2 | 自定义属性2 | string | |
details_list.spec_name | 规格名 | string | |
details_list.spec_code | 规格码 | string | |
details_list.brand_no | 品牌编号 | string | |
details_list.brand_name | 品牌名称 | string | |
details_list.goods_unit | 入库单位名称 | string | |
details_list.basic_unit_name | 基本单位名称 | string | |
details_list.batch_no | 批次号 | string | |
details_list.expire_date | 有效期 | string | |
details_list.position_no | 货位 | string | |
details_list.shop_platform_id | 店铺平台id | string | |
金蝶云星空接口明细
- API:batchSave
- NAME:销售退货单新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillTypeID | 单据类型 | DSXSTHD07 | 单据类型 |
FBillNo | 单据编号 | {{order_no}} | 单据编号 |
FStockOrgId | 库存组织 | 106 | 组织 |
FSaleOrgId | 销售组织 | findCollection find zip from ec445d8c-9d91-3845-9175-79fb0588e1b3 where shop_no={{shop_no}} | 组织 |
FDate | 日期 | {{check_time datetime}} | 日期 |
FRetcustId | 退货客户 | {{shop_no}} | 基础资料 |
FSaledeptid | 销售部门 | | 基础资料 |
FSettleCurrId | 结算币别 | PRE001 | 基础资料 |
FBranchId | 销售门店 | | 基础资料 |
FReturnReason | 退货原因 | | 单选辅助资料列表 |
FCorrespondOrgId | 对应组织 | | 组织 |
FHeadNote | 备注 | {{remark}} | 多行文本 |
FPayCustId | 付款方 | | 基础资料 |
FEntity | 明细信息 | details_list | |
FEntity.FMaterialId | 物料编码 | {{details_list.goods_no}} | 基础资料 |
FEntity.FBarcode | 零售条形码 | | 文本 |
FEntity.FRealQty | 实退数量 | {{details_list.num}} | 数量 |
FEntity.FPrice | 单价 | | 单价 |
FEntity.FTaxPrice | 含税单价 | {{details_list.refund_order_detail_list.0.price}} | 单价 |
FEntity.FIsFree | 是否赠品 | | 复选框 |
FEntity.FEntryTaxRate | 税率% | 13 | 小数 |
FEntity.FReturnType | 退货类型 | | 单选辅助资料列表 |
FEntity.FOwnerTypeId | 货主类型 | BD_OwnerOrg | 多类别基础资料列表 |
FEntity.FOwnerId | 货主 | 100 | 多类别基础资料 |
FEntity.FStockId | 仓库 | _findCollection find FNumber from 9c02adb6-7e63-326e-b5b3-dea634490062 where F_KD_WDTSTOCK={{warehouse_no}} | 基础资料 |
FEntity.FStocklocId | 仓位 | | 维度关联字段 |
FEntity.FLot | 批号 | | 批次 |
FEntity.FDeliveryDate | 退货日期 | {{created_time datetime}} | 长日期 |
FEntity.FNote | 备注 | {{details_list.remark}} | 文本 |
FEntity.F_POIH_ZD | 子单原始订单号 | {{tid_list}} | |
FEntity.F_POIH_TH | 退换单号 | {{refund_no}} | |
FEntity.FSoorDerno | 原始单号 | {{tid_list}} | |
FEntity.FETHIRDBILLNO | 第三方平台单号 | {{trade_no_list}} | |
FEntity.SubHeadEntity | 财务信息 | | |
FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | _findCollection find zip from ec445d8c-9d91-3845-9175-79fb0588e1b3 where shop_no={{shop_no}} | 组织 |
FEntity.SubHeadEntity.FSettleTypeId | 结算方式 | | 基础资料 |
FEntity.SubHeadEntity.FOwnerIdHead | 货主 | 106 | |
FEntity.SubHeadEntity.FOwnerTypeIdHead | 货主类型 | BD_OwnerOrg | |
FEntity.SubHeadEntity.Freamount | 退货金额 | {{actual_refund_amount}} | |
FEntity.SubHeadEntity.FBuyerNo | 客户编码 | {{customer_no}} | |
FEntity.SubHeadEntity.FLogisticsNos | 物流单号 | {{logistics_no}} | |
FEntity.SubHeadEntity.FLogComName | 物流公司 | {{logistics_name}} | |
FEntity.SubHeadEntity.FThirdBillNo | 第三方单据编号 | {{refund_no}} | 对接退货入库单号 |
FEntity.SubHeadEntity.FormId | 业务对象表单Id | KD_DSSAL_RTNSTOCK | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FEntity.SubHeadEntity.Operation | 执行的操作 | Save | |
FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | true | |
FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
FEntity.SubHeadEntity.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
系统打通概况
可视化配置,即便是普通业务人员也可以快速轻松对接多个平台,解决企业面临的数据孤岛,数据混乱等问题,实现数据可见、可用、可运营。进行统一化,模块化,标准化的服务能力和输出,实现对业务端数据需求的精准满足和高效响应,也可以在业务数据需求的不断增加下,让企业有整套的可复用的api资产以更换,支持业务的正常运转,节省开发成本。在不同的着重点和应用上解决数据共享,实现平台之间的独立管理。