旺店通·企业版和金蝶云星空单据接口对接

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

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:销售出库单查询
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FBillTypeID_FNumber | 单据类型 | string | FBillTypeID.FNumber |
| FBillNo | 单据编号 | string | FBillNo |
| FDate | 日期 | string | FDate |
| FSaleOrgId_FNumber | 销售组织 | string | FSaleOrgId.FNumber |
| FCustomerID_FNumber | 客户 | string | FCustomerID.FNumber |
| FCarriageNO | 运输单号 | string | FCarriageNO |
| FStockOrgId_FNumber | 发货组织 | string | FStockOrgId.FNumber |
| FLinkPhone | 联系电话 | string | FLinkPhone |
| FLinkMan | 收货人姓名 | string | FLinkMan |
| FReceiveAddress | 收货方地址 | string | FReceiveAddress |
| FSettleTypeID_FNumber | 结算方式 | string | FSettleTypeID.FNumber |
| FReceiverAddress | 收货人地址 | string | FReceiverAddress |
| FReceiverMobile | 收货人手机 | string | FReceiverMobile |
| FReceiverCountry | 收货人国家 | string | FReceiverCountry |
| FReceiverState | 收货人省份 | string | FReceiverState |
| FReceiverCity | 收货人城市 | string | FReceiverCity |
| FReceiverDistrict | 收货人地区 | string | FReceiverDistrict |
| FReceiverPhone | 收货人电话 | string | FReceiverPhone |
| FSHOPNUMBER | 网店编码 | string | FSHOPNUMBER |
| FSALECHANNEL | 销售渠道 | string | FSALECHANNEL |
| FVIPCODE | 会员编码 | string | FVIPCODE |
| FCustMatID_FNumber | 客户物料编码 | string | FCustMatID.FNumber |
| FMaterialID_FNumber | 物料编码 | string | FMaterialID.FNumber |
| FBarcode | 零售条形码 | string | FBarcode |
| FMustQty | 应发数量 | string | FMustQty |
| FRealQty | 实发数量 | string | FRealQty |
| FPrice | 单价 | string | FPrice |
| FTaxPrice | 含税单价 | string | FTaxPrice |
| FIsFree | 是否赠品 | string | FIsFree |
| FLot | 批号 | string | FLot |
| FProduceDate | 生产日期 | string | FProduceDate |
| FExpiryDate | 有效期至 | string | FExpiryDate |
| FEntryTaxRate | 税率% | string | FEntryTaxRate |
| FEntryTaxAmount | 税额 | string | FEntryTaxAmount |
| FAmount | 金额 | string | FAmount |
| FAllAmount | 价税合计 | string | FAllAmount |
| FStockID_FNumber | 仓库 | string | FStockID.FNumber |
| FStockStatusID_FNumber | 库存状态 | string | FStockStatusID.FNumber |
| FMtoNo | 计划跟踪号 | string | FMtoNo |
| FEntrynote | 备注 | string | FEntrynote |
| FSrcType | 源单类型 | string | FSrcType |
| FSrcBillNo | 源单编号 | string | FSrcBillNo |
| FSoorDerno | 订单单号 | string | FSoorDerno |
| FDiscountRate | 折扣率% | string | FDiscountRate |
| FDiscount | 折扣额 | string | FDiscount |
| FPriceDiscount | 单价折扣 | string | FPriceDiscount |
| FSOEntryId | 销售订单EntryId | string | FSOEntryId |
| FB2CORDERDETAILID | B2C订单明细Id | string | FB2CORDERDETAILID |
| FThirdEntryId | 管易订单单号 | string | FThirdEntryId |
| FETHIRDBILLID | 第三方单据ID | string | FETHIRDBILLID |
| FETHIRDBILLNO | 第三方单据编号 | string | FETHIRDBILLNO |
| FGYFINDate | 管易到账时间 | string | FGYFINDate |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | SAL_OUTSTOCK |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FBillTypeID_FNumber | 单据类型 | string | |
| FBillNo | 单据编号 | string | |
| FDate | 日期 | string | |
| FSaleOrgId_FNumber | 销售组织 | string | |
| FCustomerID_FNumber | 客户 | string | |
| FBranchId_FNumber | 销售门店 | string | |
| FSaleDeptID_FNumber | 销售部门 | string | |
| FHeadLocationId_FNumber | 交货地点 | string | |
| FCorrespondOrgId_FNumber | 对应组织 | string | |
| FCarrierID_FNumber | 承运商 | string | |
| FCarriageNO | 运输单号 | string | |
| FSalesGroupID_FNumber | 销售组 | string | |
| FSalesManID_FNumber | 销售员 | string | |
| FThirdBillNo | 第三方单据编号 | string | |
| FStockOrgId_FNumber | 发货组织 | string | |
| FDeliveryDeptID_FNumber | 发货部门 | string | |
| FThirdBillId | 第三方单据平台单号 | string | |
| FLinkPhone | 联系电话 | string | |
| FLinkMan | 收货人姓名 | string | |
| FThirdSrcType | 第三方系统来源 | string | |
| FStockerID_FNumber | 仓管员 | string | |
| FBussinessType | 业务类型 | string | |
| FDocumentStatus | 单据状态 | string | |
| FNote | 备注 | string | |
| FReceiverID_FNumber | 收货方 | string | |
| FReceiveAddress | 收货方地址 | string | |
| FSettleID_FNumber | 结算方 | string | |
| FReceiverContactID_FNumber | 收货方联系人 | string | |
| FPayerID_FNumber | 付款方 | string | |
| FSettleOrgID_FNumber | 结算组织 | string | |
| FSettleTypeID_FNumber | 结算方式 | string | |
| FReceiptConditionID_FNumber | 收款条件 | string | |
| FOwnerIdHead_FNumber | 货主 | string | |
| FBuyerNick | 会员名称 | string | |
| FReceiverAddress | 收货人地址 | string | |
| FReceiverName | 收货人 | string | |
| FReceiverMobile | 收货人手机 | string | |
| FReceiverCountry | 收货人国家 | string | |
| FReceiverState | 收货人省份 | string | |
| FReceiverCity | 收货人城市 | string | |
| FReceiverDistrict | 收货人地区 | string | |
| FReceiverPhone | 收货人电话 | string | |
| FSHOPNUMBER | 网店编码 | string | |
| FSALECHANNEL | 销售渠道 | string | |
| FVIPCODE | 会员编码 | string | |
| FCustMatID_FNumber | 客户物料编码 | string | |
| FMaterialID_FNumber | 物料编码 | string | |
| FBarcode | 零售条形码 | string | |
| FMustQty | 应发数量 | string | |
| FRealQty | 实发数量 | string | |
| FPrice | 单价 | string | |
| FTaxPrice | 含税单价 | string | |
| FIsFree | 是否赠品 | string | |
| FLot | 批号 | string | |
| FProduceDate | 生产日期 | string | |
| FExpiryDate | 有效期至 | string | |
| FEntryTaxRate | 税率% | string | |
| FEntryTaxAmount | 税额 | string | |
| FAmount | 金额 | string | |
| FAllAmount | 价税合计 | string | |
| FStockID_FNumber | 仓库 | string | |
| FStockStatusID_FNumber | 库存状态 | string | |
| FMtoNo | 计划跟踪号 | string | |
| FEntrynote | 备注 | string | |
| FSrcType | 源单类型 | string | |
| FSrcBillNo | 源单编号 | string | |
| FSoorDerno | 订单单号 | string | |
| FDiscountRate | 折扣率% | string | |
| FDiscount | 折扣额 | string | |
| FPriceDiscount | 单价折扣 | string | |
| FSOEntryId | 销售订单EntryId | string | |
| FB2CORDERDETAILID | B2C订单明细Id | string | |
| FThirdEntryId | 管易订单单号 | string | |
| FETHIRDBILLID | 第三方单据ID | string | |
| FETHIRDBILLNO | 第三方单据编号 | string | |
| FGYFINDate | 管易到账时间 | string | |
| FReceiverName | 收货人 | string | |
旺店通·企业版接口明细
- 接口:stockout_order_push
- 接口名称:创建其他出库单
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| outer_no | 外部单号 | string | 外部系统的唯一单据编号,避免重复推送数据 |
| is_check | 是否审核 | string | 1:自动审核 0:不自动审核 默认0 |
| warehouse_no | 仓库编号 | string | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
| logistics_code | 物流编号 | string | 代表物流所有属性的唯一编码,用于物流区分,ERP内支持自定义(ERP物流界面设置) |
| logistics_no | 物流单号 | string | 物流公司的运单号 |
| goods_total_amount | 总售价 | string | 总售价 |
| goods_total_cost | 总成本价 | string | 总成本价 |
| post_cost | 邮费 | string | 邮费 |
| remark | 备注 | string | 其他出库单备注 |
| reason | 其他出库原因 | string | 其他出库原因(需要在客户端维护好该原因,如客户端无该原因或者原因停用,则推送失败,路径:设置—>基本设置—>原因列表) |
| detail_list | 货品列表节点 | array | 请求参数的2级数据节点,包含其他出库单所有货品属性信息的数据节点,节点下数据字段详见下述“ detail_list” |
| detail_list.spec_no | 商家编码 | string | 代表单品(sku)所有属性的编码,SKU概念介绍,单击这里 |
| detail_list.num | 出库数量 | string | 出库数量 |
| detail_list.price | 价格 | string | 价格 |
| detail_list.position_no | 货位编号 | string | 货位编号 |
| detail_list.batch_no | 批次号 | string | 指定批次号 |
| detail_list.remark | 备注 | string | 货品明细备注 |
| detail_list.is_enable_sn | 是否开启序列号 | string | 是否开启序列号: 0代表不开启序列号 1代表开启序列号 默认为不开启 |
| detail_list.sn_list | 序列号列表 | string | 序列号列表,多个序列号通过","隔开字符串区分,例如"xxx1,xxx2,xxx3" |
| detail_list.stockout_info | stockout_info | string | |
系统对接概况
全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务,很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象,减少各业务系统间的维护成本,减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题,将企业数据平滑对接,减少信息竖井。

