旺店通·旗舰奇门和金蝶云星空接口打通对接实战

来源系统:旺店通·旗舰奇门
慧策最先以旺店通ERP切入商家核心管理痛点——订单管理,之后围绕电商经营管理中的核心管理诉求,先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步,向前向后延伸,全面布局零售企业经营,整体构建一体化智能零售解决方案,打破数据孤岛,AI植入系统,实现智能决策,助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品,从前端吸引流量到后端集约化管理,助力企业智慧决策
接通系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接口方案配置
数据集成平台对应的配置旺店通·旗舰奇门与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据旺店通·旗舰奇门的接口参数要求记录在轻易云集成平台。第二步配置旺店通·旗舰奇门与金蝶云星空之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。

旺店通·旗舰奇门接口明细
- API:wdt.wms.stockin.refund.querywithdetail
- NAME:销售退货单查询
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
pager | 分页参数 | | |
pager.page_size | 分页大小 | 50 | |
pager.page_no | 页号 | 1 | |
pager.params | 业务参数 | | |
pager.params.start_time | 开始时间 | {{LAST_SYNC_TIME datetime}} | |
pager.params.end_time | 结束时间 | {{CURRENT_TIME datetime}} | |
pager.params.status | 入库单状态 | 80 | 英文逗号拼接的状态值:10=已取消;20=编辑中;30=待审核;37=待质检;40=质检确认; |
60=待结算;70=暂估结算;80=已完成 |
pager.params.time_type | 时间条件类型 | | 查询的时间条件类型, 0:修改时间; 1:入库时间 不传默认为0 |
pager.params.warehouse_no | 仓库编码 | | |
pager.params.shop_nos | 店铺编号 | | 多个店铺编号使用英文逗号分隔 |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
order_no | 入库单号 | | |
status | 入库单状态 | | |
warehouse_no | 仓库编号 | | |
warehouse_name | 仓库名称 | | |
created_time | 入库单创建时间 | | |
remark | 入库单备注 | | |
fenxiao_nick | 分销商昵称 | | |
operator_name | 退换建单人 | | |
logistics_type | 物流方式 | | |
check_time | 审核时间 | | |
refund_no | 退换单号 | | |
goods_count | 货品总数 | | |
actual_refund_amount | 退换单实际退款金额 | | |
customer_no | 客户编码 | | |
customer_name | 退货人姓名 | | |
nick_name | 客户网名 | | |
shop_name | 店铺名称 | | |
shop_no | 店铺编号 | | |
shop_remark | 店铺备注 | | |
flag_name | 标记名称 | | |
trade_no_list | 订单编号 | | |
total_price | 入库单总金额 | | |
modified | 最后修改时间 | | |
details_list | 入库单明细 | | |
details_list.rec_id | 明细id(主键) | | |
details_list.stockin_id | 入库单id | | |
details_list.num | 数量 | | |
details_list.total_cost | 总成本 | | |
details_list.remark | 明细备注 | | |
details_list.right_num | 调整后数量 | | |
details_list.goods_name | 货品名称 | | |
details_list.goods_no | 货品编码 | | |
details_list.spec_no | 商家编码 | | |
details_list.defect | 是否残次品 | | |
details_list.prop2 | 自定义属性2 | | |
details_list.spec_name | 规格名 | | |
details_list.spec_code | 规格码 | | |
details_list.brand_no | 品牌编号 | | |
details_list.brand_name | 品牌名称 | | |
details_list.goods_unit | 入库单位名称 | | |
details_list.basic_unit_name | 基本单位名称 | | |
details_list.batch_no | 批次号 | | |
details_list.expire_date | 有效期 | | |
details_list.position_no | 货位 | | |
金蝶云星空接口明细
- 调用接口:batchSave
- 接口名称:销售退货新增
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FBillTypeID | 单据类型 | string | XSTHD07_SYS |
FBillNo | 单据编号 | string | {{order_no}} |
FSaleOrgId | 销售组织 | string | 100 |
FDate | 日期 | string | {{check_time datetime}} |
FStockOrgId | 库存组织 | string | 100 |
FRetcustId | 退货客户 | string | {{shop_no}} |
FSaledeptid | 销售部门 | string | |
FSettleCurrId | 结算币别 | string | PRE001 |
FBranchId | 销售门店 | string | |
FReturnReason | 退货原因 | string | |
FCorrespondOrgId | 对应组织 | string | |
FHeadNote | 备注 | string | {{remark}} |
FPayCustId | 付款方 | string | |
FEntity | 明细信息 | array | |
FEntity.FMaterialId | 物料编码 | string | {{details_list.goods_no}} |
FEntity.FBarcode | 零售条形码 | string | |
FEntity.FRealQty | 实退数量 | string | {{details_list.num}} |
FEntity.FPrice | 单价 | string | |
FEntity.FTaxPrice | 含税单价 | string | |
FEntity.FIsFree | 是否赠品 | string | true |
FEntity.FEntryTaxRate | 税率% | string | |
FEntity.FReturnType | 退货类型 | string | |
FEntity.FOwnerTypeId | 货主类型 | string | BD_OwnerOrg |
FEntity.FOwnerId | 货主 | string | 100 |
FEntity.FStockId | 仓库 | string | {{warehouse_no}} |
FEntity.FStocklocId | 仓位 | string | |
FEntity.FLot | 批号 | string | |
FEntity.FDeliveryDate | 退货日期 | string | {{created_time datetime}} |
FEntity.FNote | 备注 | string | {{details_list.remark}} |
FEntity.F_POIH_ZD | 子单原始订单号 | string | {{tid_list}} |
FEntity.F_POIH_TH | 退换单号 | string | {{refund_no}} |
FEntity.SubHeadEntity | 财务信息 | object | |
FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | string | 100 |
FEntity.SubHeadEntity.FSettleTypeId | 结算方式 | string | |
FEntity.SubHeadEntity.FOwnerIdHead | 货主 | string | 100 |
FEntity.SubHeadEntity.FOwnerTypeIdHead | 货主类型 | string | BD_OwnerOrg |
FEntity.SubHeadEntity.FormId | 业务对象表单Id | string | SAL_RETURNSTOCK |
FEntity.SubHeadEntity.Operation | 执行的操作 | string | Save |
FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | bool | false |
FEntity.SubHeadEntity.SubSystemId | 系统模块 | string | 21 |
系统数据对接
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。

