旺店通·企业奇门和金蝶云星空接口打通对接实战|轻易云数据集成平台

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

接通系统：旺店通·企业奇门

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

接通系统：金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

数据集成方案配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：旺店通·企业奇门的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。

旺店通·企业奇门接口明细

接口：wdt.stockin.order.query.refund
接口名称：查询退货入库单
接口方法：POST

请求参数

字段	名称	类型	描述
start_time	开始时间	datetime	增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time	结束时间	datetime	增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
status	状态	string	入库单状态 10已取消20编辑中30待审核60待结算80已完成（默认查询80已完成单据）
shop_no	店铺编号	string	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息
stockin_no	入库单号	string
page_no	页号	string
page_size	分页大小	string	每页返回的数据条数，输入值范围1~50，不传本参数，输入值默认为40，使用举例单击这里
page_no	页号	string	不传值默认从0页开始

响应参数

字段	名称	类型	描述
order_no	入库单号	string	入库单号
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
warehouse_name	仓库名称	string	仓库名称
shop_no	店铺编号	string	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺数据信息
shop_remark	店铺备注	string	店铺备注
src_order_no	上层单据（退换单）编号	string
process_status	退换单状态	string	10已取消,20待审核,30已同意,40已拒绝,50待财审,60待收货,63待推送,64推送失败,65委外待收货,69待收货(已结算),70部分到货,71部分到货(已结算),80待结算 ,90已完成。ERP版本V2.3.8.4及以上才可返回
status	退货入库单状态	string	入库单状态 10已取消20编辑中30待审核60待结算80已完成
stockin_time	更新时间	string	更新时间格式：yyyy-MM-dd HH:mm:ss
created_time	创建时间	string	创建时间格式：yyyy-MM-dd HH:mm:ss
trade_no	订单编号	string	系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）
trade_type	系统订单类别	string	系统订单类别（1网店销售,2线下零售,3售后换货,4批发业务,5保修换新,6保修完成,7订单补发 .. 101自定义类型1,102自定义类型2,103自定义类型3,104自定义类型4 ,105自定义类型5,106自定义类型6）
order_type	单据类别	string	单据类别，默认返回3
order_type_name	单据类别名称	string	单据类别名称，默认为“退货入库”
goods_amount	货款总额	string	退回货款收入
actual_refund_amount	实际退款金额	string	实际退款金额
total_price	扣除优惠后货款总额	string	退回货品成本
post_fee	邮费	string	退货入库单的“邮资”
other_fee	其他费用	string	退货入库单的“其它金额”
logistics_type	物流类型	string	响应值为代表物流类型的数字，数字对应的物流类型名称单击这里
logistics_no	物流编号	string	代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
logistics_name	物流名称	string	ERP设置的物流公司名称
logistics_code	物流单号	string	物流单单号
refund_no	退换单编号	string	退换单编号
check_time	入库审核时间	string
customer_no	客户编号	string	客户编号
customer_name	客户名称	string	退货人的姓名
nick_name	客户网名	string	客户网名
shop_name	店铺名称	string	店铺名称
stockin_reason	入库原因	string	入库原因
flag_name	退货单标记	string	退换单界面的标记
platform_id	平台id	string	平台id
stockin_operator_name	入库操作人姓名	string	默认为''，入库操作人姓名
check_operator_name	审核人姓名	string	默认为''，审核人姓名
refund_remark	退换备注	string	默认为''，退换备注
refund_operator_name	退货员姓名	string	默认为''，退货员姓名
stockin_no	入库单号	string	入库单号
wms_outer_no	外部仓库单号	string	默认为''，对应外部仓库的单号
wms_status	外部仓库状态	string	默认为'0'，外部状态,与wms对接使用 0初始化 1失败 2成功'
wms_result	结果	string	默认为''，错误信息
warehouse_id	仓库id	string	默认为'0'，仓库id
src_order_id	业务单据id	string	默认为'0'，业务单据id
reason_id	原因	string	原因
fa_status	财务同步状态	string	默认为'0'，财务同步状态
logistics_id	物流公司d	string	默认为'0'，物流公司id
post_share_type	邮资分摊类型	string	默认为'0'，邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊'
operator_id	操作员id	string	操作员id
check_operator_id	审核员id	string
goods_type_count	货品种类数	string	默认为'0'，货品种类数
note_count	便签条数	string	默认为'0'，便签条数
flag_id	标记id	string	默认为'0'，标记id
details_list	货品列表节点	array	退回货品列表节点
details_list.stockin_id	入库单主键id	string	入库单主键id
details_list.remark	备注	string	备注
details_list.goods_count	货品数量	string	货品数量
details_list.discount	优惠金额	string	优惠金额
details_list.tax_amount	税后金额	string	税后金额
details_list.adjust_price	纠错金额	string	纠错金额
details_list.right_price	调整后单价	string	调整后单价
details_list.tid	原订单原始单号	string	原订单原始单号
details_list.src_order_type	订单类型	string	1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库
details_list.adjust_num	纠错数量	string	纠错数量
details_list.modified	最后修改时间	string	最后修改时间
details_list.rec_id	明细表主键id	string	明细表主键id
details_list.src_order_detail_id	上层单据（退换单）退回货品明细主键	string	上层单据（退换单）退回货品明细主键，ERP版本V2.3.8.3及以上才可返回
details_list.spec_no	商家编码	string	代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍,单击这里
details_list.cost_price	成本价	string	成本价
details_list.production_date	生产日期	string	生产日期，格式：yyyy-MM-dd HH:mm:ss
details_list.validity_days	有效期天数	string	有效期天数
details_list.expire_date	有效期	string	有效期，格式：yyyy-MM-dd HH:mm:ss
details_list.src_price	原价	string	原价
details_list.tax_price	税后单价	string	税后单价
details_list.tax	税率	string	税率
details_list.total_cost	总成本	string	总成本
details_list.right_num	调整后数量	string	调整后数量
details_list.num	入库数量	string	入库数量
details_list.num2	辅助数量	string	辅助数量
details_list.right_cost	调整后总金额	string	调整后总金额
details_list.brand_no	品牌编号	string	品牌编号
details_list.brand_name	品牌名称	string	品牌名称
details_list.goods_name	货品名称	string	货品名称
details_list.prop2	单品自定义属性2	string	单品自定义属性2
details_list.goods_no	货品编号	string	代表货品(spu)所有属性的唯一编号，用于系统货品区分，，SPU概念介绍,单击这里
details_list.spec_name	规格名称	string	规格名称
details_list.spec_code	规格编号	string	规格编号
details_list.goods_unit	基本单位	string	基本单位
details_list.batch_no	入库批次	string	入库批次
details_list.batch_remark	批次备注	string	批次备注
details_list.position_no	货位编号	string	货位编号
details_list.oid	原订单原始子单号	string	原订单原始子单号
details_list.org_stockin_detail_id	原始入库单明细	string	默认为'0'，原始入库单明细
details_list.spec_id	erp商品主键	string	erp内商品主键
details_list.batch_id	批次	string	默认为'0'，批次
details_list.position_id	货位id	string	默认为'0'，货位ID，入库时默认ID
details_list.unit_id	辅助单位	string	默认为'0'，辅助单位
details_list.base_unit_id	基本单位	string	默认为'0'，基本单位
details_list.unit_ratio	单位比率	string	默认为'1.0000'，单位换算关系
details_list.expect_num	期望数量	string	默认为'0.0000'，预期入库数量（基本单位数量，显示可自动转换成辅助单位）
details_list.cost_price2	辅助价格	string	默认为'0.0000'，辅助成本价
details_list.share_post_cost	邮资分摊成本	string	默认为'0.0000'，邮资分摊成本
details_list.share_post_total	邮资分摊总成本	string	默认为'0.0000'，邮资分摊总成本
details_list.created	创建时间	string	创建时间

金蝶云星空接口明细

接口：batchSave
接口名称：[旺店通][销售退货单标准新增]-v1
接口方法：POST

请求参数

字段	名称	类型	描述
FBillTypeID	单据类型	string	单据类型
FBillNo	单据编号	string	单据编号
FSaleOrgId	销售组织	string	组织
FDate	日期	string	日期
FStockOrgId	库存组织	string	组织
FRetcustId	退货客户	string	基础资料
FHeadNote	备注	string	多行文本
F_SWPA_Combo_LYXT	来源系统	string	多行文本
F_SWPA_Assistant_dp	店铺	string	多行文本
FEntity	明细信息	array
FEntity.FMaterialId	物料编码	string	基础资料
FEntity.FRealQty	实退数量	string	数量
FEntity.FTaxPrice	含税单价	string	单价
FEntity.FStockId	仓库	string	基础资料
FEntity.FNote	备注	string	文本
FEntity.F_SWPA_PTDH	平台单号	string	文本
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FChageCondition	收款条件	string	组织
FEntity.SubHeadEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FEntity.SubHeadEntity.Operation	执行的操作	string
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	bool
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubHeadEntity.SubSystemId	系统模块	string

系统对接概况

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。