旺店通·企业版和轻易云集成平台接口打通对接实战

接入系统:旺店通·企业版
慧策最先以旺店通ERP切入商家核心管理痛点——订单管理,之后围绕电商经营管理中的核心管理诉求,先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步,向前向后延伸,全面布局零售企业经营,整体构建一体化智能零售解决方案,打破数据孤岛,AI植入系统,实现智能决策,助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品,从前端吸引流量到后端集约化管理,助力企业智慧决策
目标系统:轻易云集成平台
使用全界面可视化配置集成流,快速应对企业的集成需求使得系统与系统之间的数据接口一站式的快速集成能力,构建企业数据通道,解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准,完成数据的采集、统一、分发、清洗、归集等,帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统,同时具备快速适配新系统的能力,集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统,都可以通过接口相互集成。
数据对接方案
数据集成平台对应的配置旺店通·企业版与轻易云集成平台的对接只要三步就能完成两个系统之间的数据对接。第一步根据旺店通·企业版的接口参数要求记录在轻易云集成平台。第二步配置旺店通·企业版与轻易云集成平台之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。


旺店通·企业版接口明细
- API:purchase_return_query
- NAME:查询采购退货单
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
start_time | 开始时间 | {{DAYS_AGO_1 datetime}} | 增量获取数据,start_time作为开始时间,格式:yyyy-MM-dd HH:mm:ss |
end_time | 结束时间 | {{CURRENT_TIME datetime}} | 增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss |
status | 状态 | | 采购退货单状态:10,已取消,20,编辑中,30,待审核,40,已审核,42,待推送,44,推送失败,46,委外待出库,50,部分出库,60,已完成 |
warehouse_no | 仓库编号 | | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) |
page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} | 每页返回的数据条数,输入值范围1100,不传本参数,输入值默认为40,使用举例单击这里 |
page_no | 页号 | {{PAGINATION_START_PAGE}} | 不传值默认从0页开始 |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
return_id | 采购退货单id | | 采购退货单主键id |
return_no | 退货单号 | | 退货单号 |
provider_name | 供应商 | | 供应商 |
status | 采购单状态 | | 采购退货单状态:10,已取消,20,编辑中,30,待审核,40,已审核,42,待推送,44,推送失败,46,委外待出库,50,部分出库,60,已完成 |
warehouse_no | 仓库编号 | | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
warehouse_name | 仓库 | | 系统仓库名称 |
purchaser_id | 采购员id | | 采购员id |
purchaser_name | 采购员名称 | | 采购员名称 |
logistics_type | 物流类型 | | 物流方式,详情介绍,单击这里 |
other_fee | 其它费用 | | 其它费用 |
post_fee | 邮费 | | 邮费 |
goods_fee | 总货款 | | 总货款 |
goods_count | 退货开单量 | | 退货开单量 |
goods_type_count | 货品种类数 | | 货品种类数 |
goods_out_count | 退货出库量 | | 退货出库量 |
remark | 备注 | | 采购退货单备注 |
created | 建单时间 | | 格式:yyyy-MM-dd HH:mm:ss |
modified | 最后修改时间 | | 格式:yyyy-MM-dd HH:mm:ss |
api_outer_no | 外部接口单号 | | 外部接口单号 |
outer_no | 外部单号 | | 外部单号 |
prop1 | 自定义属性1 | | 自定义属性1 |
prop2 | 自定义属性2 | | 自定义属性2 |
provider_no | 供应商编号 | | 供应商编号 |
purchase_no | 引用采购单号 | | 引用采购单号 |
creator_id | 制单员id | | 制单员id |
creator_name | 制单员姓名 | | 制单员姓名 |
type | 类型 | | 默认为'1',1退货 |
flag_id | 颜色标记 | | 默认为'0',颜色标记 |
warehouse_id | 出库id | | 出库id |
provider_id | 供应商id | | 默认为'0',供应商id |
contact | 联系人姓名 | | 供商商联系人姓名 |
telno | 联系电话 | | 供应商联系电话 |
receive_address | 退货地址 | | 退货地址 |
check_operator_id | 审核人 | | 默认为'0',审核人 |
check_time | 审核时间 | | 默认'0000-00-00 00:00:00',审核时间 |
note_count | 便签条数 | | 默认为'0',便签条数 |
province | 省份 | | 默认为'',省份 |
city | 城市 | | 默认为'',城市 |
district | 地区 | | 默认为'',地区 |
wms_outer_no | 外部仓库的单号 | | 默认为'',对应外部仓库的单号 |
wms_status | 处理状态 | | 默认为'0',处理状态 |
error_info | 错误信息 | | 默认为'',接口调用错误信息 |
version_id | 版本号 | | 默认为'0',版本号 |
last_load_purchase_id | 最后一次引用的采购单id | | 默认为'0',最后一次引用的采购单id |
detail_list | 采购退货单货品列表节点 | | 响应参数的2级数据节点,包含采购退货单货货品明细所有属性信息,节点下数据字段详见下述“detail_list” |
detail_list.return_id | 采购退货单id | | 默认为'0',标记 |
detail_list.provider_goods_no | 供应商货品编号 | | 最后修改时间 |
detail_list.spec_no | 商家编码 | | 响应参数的2级数据节点,包含采购入库货品明细属性信息,节点下数据字段详见下述“details_list” |
detail_list.goods_no | 货品编码 | | 入库单主键id |
detail_list.goods_name | 货品名称 | | 入库明细主键 |
detail_list.spec_name | 规格名称 | | 上层单据明细主键 |
detail_list.spec_code | 规格码 | | 代表单品(sku)所有属性的编码,SKU概念介绍,单击这里 |
detail_list.num | 退货数量 | | 货品数量 |
detail_list.num2 | 辅助退货量 | | 优惠金额 |
detail_list.unit_id | 出库单位 | | 单价 |
detail_list.unit_ratio | 单位变换率 | | 生产日期,格式:yyyy-MM-dd HH:mm:ss |
detail_list.base_unit_id | 基本单位 | | 有效期天数 |
detail_list.price | 单价 | | 有效期,格式:yyyy-MM-dd HH:mm:ss |
detail_list.discount | 折扣 | | 原价 |
detail_list.amount | 税前金额 | | 税后价 |
detail_list.unit_name | 出库单位名称 | | 税后金额 |
detail_list.base_unit_name | 基本单位名称 | | 税率 |
detail_list.remark | 备注 | | 总成本 |
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 | 税后单价 | | 品牌编号 |
detail_list.modified | 最后修改时间 | | 品牌名称 |
detail_list.created | 创建时间 | | 货品名称 |
轻易云集成平台接口明细
- 调用接口:空操作
- 接口名称:写入空操作
- 方法:POST
系统对接概况
全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务,很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象,减少各业务系统间的维护成本,减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题,将企业数据平滑对接,减少信息竖井。
