从旺店通·企业奇门到金蝶云星空通过接口集成数据

数据源系统:旺店通·企业奇门

旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展

集成系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

多系统对接方案配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：旺店通·企业奇门接口：查询退货入库单通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：[旺店通][销售退货单标准新增]-v1，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

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

接口：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店铺界面设置），用于获取指定店铺单据数据信息 page_size分页大小string每页返回的数据条数，输入值范围1_{50，不传本参数，输入值默认为40，使用举例单击这里} page_no页号string不传值默认从0页开始

响应参数

字段名称类型描述 stockin_id入库单主键idstring入库单主键id 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退换单状态string10已取消,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 remark备注string备注 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_count货品数量string货品数量 goods_amount货款总额string退回货款收入 actual_refund_amount实际退款金额string实际退款金额 total_price扣除优惠后货款总额string退回货品成本 discount优惠金额string优惠金额 tax_amount税后金额string税后金额 post_fee邮费string退货入库单的“邮资” other_fee其他费用string退货入库单的“其它金额” adjust_price纠错金额string纠错金额 right_price调整后总金额string调整后总金额 logistics_type物流类型string响应值为代表物流类型的数字，数字对应的物流类型名称单击这里 logistics_no物流编号string代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置） logistics_name物流名称stringERP设置的物流公司名称 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平台idstring平台id tid订单原始单号string 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仓库idstring默认为'0'，仓库id src_order_type入库单类型string默认为'0'，入库单类型 3退货入库 src_order_id业务单据idstring默认为'0'，业务单据id reason_id原因string原因 fa_status财务同步状态string默认为'0'，财务同步状态 logistics_id物流公司dstring默认为'0'，物流公司id post_share_type邮资分摊类型string默认为'0'，邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊' operator_id操作员idstring操作员id check_operator_id审核员idstring goods_type_count货品种类数string默认为'0'，货品种类数 adjust_num调整数量string默认为'0'，调整数量 note_count便签条数string默认为'0'，便签条数 flag_id标记idstring默认为'0'，标记id modified最后修改时间string details_list货品列表节点array退回货品列表节点 details_list.rec_id明细表主键idstring明细表主键id details_list.stockin_id入库单主键idstring入库单主键id details_list.src_order_detail_id上层单据（退换单）退回货品明细主键string上层单据（退换单）退回货品明细主键，ERP版本V2.3.8.3及以上才可返回 details_list.spec_no商家编码string代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍,单击这里 details_list.goods_count货品数量string货品数量 details_list.discount优惠金额string优惠金额 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_amount税后金额string税后金额 details_list.tax税率string税率 details_list.total_cost总成本string总成本 details_list.remark备注string备注 details_list.adjust_num纠错数量string纠错数量 details_list.adjust_price纠错金额string纠错金额 details_list.right_num调整后数量string调整后数量 details_list.right_price调整后单价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单品自定义属性2string单品自定义属性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.tid原订单原始单号string原订单原始单号 details_list.oid原订单原始子单号string原订单原始子单号 details_list.src_order_type订单类型string1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 details_list.org_stockin_detail_id原始入库单明细string默认为'0'，原始入库单明细 details_list.spec_iderp商品主键stringerp内商品主键 details_list.batch_id批次string默认为'0'，批次 details_list.position_id货位idstring默认为'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.modified最后修改时间string最后修改时间 details_list.created创建时间string创建时间

金蝶云星空接口明细

API：batchSave
NAME：[旺店通][销售退货单标准新增]-v1
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillTypeID单据类型 XSTHD07_SYS单据类型 FBillNo单据编号 {{order_no}}单据编号 FSaleOrgId销售组织 function case when '{{shop_name}}' like '%古神%' then 102 when '{{shop_name}}' like '%广州格物%' then 101 when '{{shop_name}}' like '%广西格物%' then 103 ELSE 100 end组织 FDate日期 {{check_time}}日期 FStockOrgId库存组织 100组织 FRetcustId退货客户 {{shop_no}}基础资料 FHeadNote备注多行文本 FEntity明细信息 FEntity.FMaterialId物料编码 {{details_list.spec_no}}基础资料 FEntity.FRealQty实退数量 {{details_list.goods_count}}数量 FEntity.FTaxPrice含税单价{{details_list.src_price}}单价 FEntity.FStockId仓库 {{warehouse_no}}基础资料 FEntity.FNote备注文本 FEntity.FOrderNo订单单号{{details_list.tid}} FEntity.SubHeadEntity财务信息 FEntity.SubHeadEntity.FSettleOrgId结算组织_function case when '{{shop_name}}' like '%古神%' then 102 when '{{shop_name}}' like '%广州格物%' then 101 when '{{shop_name}}' like '%广西格物%' then 103 ELSE 100 end组织 FEntity.SubHeadEntity.FOwnerTypeIdHead货主类型BD_OwnerOrg FEntity.SubHeadEntity.FOwnerIdHead货主100 FEntity.SubHeadEntity.FormId业务对象表单IdSAL_RETURNSTOCK必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.SubHeadEntity.Operation执行的操作Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit提交并审核true FEntity.SubHeadEntity.IsVerifyBaseDataField验证基础资料true是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.SubHeadEntity.SubSystemId系统模块21

系统打通概况

通过数据集成平台可视化的快速配置调用接口打通旺店通·企业奇门与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

从旺店通·企业奇门到金蝶云星空通过接口集成数据