旺店通·企业奇门与金蝶云星空对接集成查询退货入库单打通[标准][调拨单单新增]-v2 来源系统:旺店通·企业奇门慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。目标系统:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。接口方案配置通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：旺店通·企业奇门，并且选择对应的连接器（关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询退货入库单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的[标准][调拨单单新增]-v2接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。旺店通·企业奇门接口明细调用接口： wdt.stockin.order.query.refund 接口名称：查询退货入库单方法： POST 请求参数字段字段名称类型配置值 start_time 开始时间 datetime {{LAST_SYNC_TIME datetime}} end_time 结束时间 datetime {{CURRENT_TIME datetime}} status 状态 string shop_no 店铺编号 string stockin_no 入库单号 string RK2211180252 page_size 分页大小 string {{PAGINATION_PAGE_SIZE}} page_no 页号 string {{PAGINATION_START_PAGE}} 响应参数字段字段名称类型配置值 stockin_id 入库单主键id string order_no 入库单号 string warehouse_no 仓库编号 string warehouse_name 仓库名称 string shop_no 店铺编号 string shop_remark 店铺备注 string src_order_no 上层单据（退换单）编号 string process_status 退换单状态 string status 退货入库单状态 string stockin_time 更新时间 string created_time 创建时间 string remark 备注 string trade_no 订单编号 string trade_type 系统订单类别 string order_type 单据类别 string 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 logistics_name 物流名称 string 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 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 wms_result 结果 string warehouse_id 仓库id string src_order_type 入库单类型 string src_order_id 业务单据id string reason_id 原因 string fa_status 财务同步状态 string logistics_id 物流公司d string post_share_type 邮资分摊类型 string operator_id 操作员id string check_operator_id 审核员id string goods_type_count 货品种类数 string adjust_num 调整数量 string note_count 便签条数 string flag_id 标记id string modified 最后修改时间 string details_list 货品列表节点 array details_list.rec_id 明细表主键id string details_list.stockin_id 入库单主键id string details_list.src_order_detail_id 上层单据（退换单）退回货品明细主键 string details_list.spec_no 商家编码 string details_list.goods_count 货品数量 string details_list.discount 优惠金额 string details_list.cost_price 成本价 string details_list.production_date 生产日期 string details_list.validity_days 有效期天数 string details_list.expire_date 有效期 string 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 单品自定义属性2 string details_list.goods_no 货品编号 string 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 订单类型 string details_list.org_stockin_detail_id 原始入库单明细 string details_list.spec_id erp商品主键 string details_list.batch_id 批次 string details_list.position_id 货位id string details_list.unit_id 辅助单位 string details_list.base_unit_id 基本单位 string details_list.unit_ratio 单位比率 string details_list.expect_num 期望数量 string details_list.cost_price2 辅助价格 string details_list.share_post_cost 邮资分摊成本 string details_list.share_post_total 邮资分摊总成本 string details_list.modified 最后修改时间 string details_list.created 创建时间 string 金蝶云星空接口明细 API： batchSave NAME： [标准][调拨单单新增]-v2 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillNo 单据编号 {{order_no}} 单据编号 FBillTypeID 单据类型 ZJDB09_SYS 单据类型 FBizType 业务类型 NORMAL 下拉列表 FTransferDirect 调拨方向 GENERAL 下拉列表 FTransferBizType 调拨类型 InnerOrgTransfer 下拉列表 FSaleOrgId 销售组织 function case when '{{shop_name}}' like '%古神%' then 102 when '{{shop_name}}' like '%广州格物%' then 101 when '{{shop_name}}' like '%广西格物%' then 103 ELSE 100 end 组织 FSettleOrgId 结算组织 _function case when '{{shop_name}}' like '%古神%' then 102 when '{{shop_name}}' like '%广州格物%' then 101 when '{{shop_name}}' like '%广西格物%' then 103 ELSE 100 end 组织 FStockOutOrgId 调出库存组织 100 组织 FOwnerTypeOutIdHead 调出货主类型 BD_OwnerOrg 多类别基础资料列表 FOwnerOutIdHead 调出货主 _function case when '{{shop_name}}' like '%古神%' then 102 when '{{shop_name}}' like '%广州格物%' then 101 when '{{shop_name}}' like '%广西格物%' then 103 ELSE 100 end 多类别基础资料 FStockOrgId 调入库存组织 100 组织 FSETTLECURRID 结算币别 PRE001 基础资料 FDate 日期 {{check_time}} 日期 FNote 备注 {{remark}} 多行文本 FBillEntry 明细信息 details_list 1 FBillEntry.FMaterialId 物料编码 {{details_list.spec_no}} 基础资料 FBillEntry.FCMKBarCode 零售条形码文本 FBillEntry.FQty 调拨数量 {{details_list.num}} 数量 FBillEntry.FLot 调出批号批次 FBillEntry.FSrcStockId 调出仓库 {{shop_no}} 基础资料 FBillEntry.FDestStockId 调入仓库 {{warehouse_no}} 基础资料 FBillEntry.FNoteEntry 备注 {{details_list.remark}} 多行文本 FBillEntry.FSrcStockStatusId 调出库存状态 KCZT01_SYS FBillEntry.FOwnerTypeId 调入货主类型 BD_OwnerOrg FBillEntry.FOwnerId 调入货主 100 FBillEntry.FDestStockStatusId 调入库存状态 KCZT01_SYS FBillEntry.FKeeperTypeId 调入保管者类型 BD_KeeperOrg FBillEntry.FKeeperId 调入保管者 100 FBillEntry.FBaseKeHu 客户 {{shop_no}} FBillEntry.FormId 业务对象表单Id STK_TransferDirect 必须填写金蝶的表单ID如😛UR_PurchaseOrder FBillEntry.Operation 执行的操作 Save FBillEntry.IsAutoSubmitAndAudit 提交并审核 false FBillEntry.IsVerifyBaseDataField 验证基础资料 true 是否验证所有的基础资料有效性，布尔类，默认false（非必录）系统打通概况从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通旺店通·企业奇门到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。

旺店通·企业奇门与金蝶云星空对接集成查询退货入库单打通[标准][调拨单单新增]-v2

庄颜_qeasy

旺店通·企业奇门与金蝶云星空对接集成查询退货入库单打通[标准][调拨单单新增]-v2

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

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

目标系统:金蝶云星空

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

接口方案配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：旺店通·企业奇门，并且选择对应的连接器（关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询退货入库单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的[标准][调拨单单新增]-v2接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

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

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

请求参数

字段	字段名称	类型	配置值
start_time	开始时间	datetime	{{LAST_SYNC_TIME datetime}}
end_time	结束时间	datetime	{{CURRENT_TIME datetime}}
status	状态	string
shop_no	店铺编号	string
stockin_no	入库单号	string	RK2211180252
page_size	分页大小	string	{{PAGINATION_PAGE_SIZE}}
page_no	页号	string	{{PAGINATION_START_PAGE}}

响应参数

字段	字段名称	类型
stockin_id	入库单主键id	string
order_no	入库单号	string
warehouse_no	仓库编号	string
warehouse_name	仓库名称	string
shop_no	店铺编号	string
shop_remark	店铺备注	string
src_order_no	上层单据（退换单）编号	string
process_status	退换单状态	string
status	退货入库单状态	string
stockin_time	更新时间	string
created_time	创建时间	string
remark	备注	string
trade_no	订单编号	string
trade_type	系统订单类别	string
order_type	单据类别	string
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
logistics_name	物流名称	string
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
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
wms_result	结果	string
warehouse_id	仓库id	string
src_order_type	入库单类型	string
src_order_id	业务单据id	string
reason_id	原因	string
fa_status	财务同步状态	string
logistics_id	物流公司d	string
post_share_type	邮资分摊类型	string
operator_id	操作员id	string
check_operator_id	审核员id	string
goods_type_count	货品种类数	string
adjust_num	调整数量	string
note_count	便签条数	string
flag_id	标记id	string
modified	最后修改时间	string
details_list	货品列表节点	array
details_list.rec_id	明细表主键id	string
details_list.stockin_id	入库单主键id	string
details_list.src_order_detail_id	上层单据（退换单）退回货品明细主键	string
details_list.spec_no	商家编码	string
details_list.goods_count	货品数量	string
details_list.discount	优惠金额	string
details_list.cost_price	成本价	string
details_list.production_date	生产日期	string
details_list.validity_days	有效期天数	string
details_list.expire_date	有效期	string
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	单品自定义属性2	string
details_list.goods_no	货品编号	string
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	订单类型	string
details_list.org_stockin_detail_id	原始入库单明细	string
details_list.spec_id	erp商品主键	string
details_list.batch_id	批次	string
details_list.position_id	货位id	string
details_list.unit_id	辅助单位	string
details_list.base_unit_id	基本单位	string
details_list.unit_ratio	单位比率	string
details_list.expect_num	期望数量	string
details_list.cost_price2	辅助价格	string
details_list.share_post_cost	邮资分摊成本	string
details_list.share_post_total	邮资分摊总成本	string
details_list.modified	最后修改时间	string
details_list.created	创建时间	string

金蝶云星空接口明细

API：batchSave
NAME：[标准][调拨单单新增]-v2
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillNo	单据编号	{{order_no}}	单据编号
FBillTypeID	单据类型	ZJDB09_SYS	单据类型
FBizType	业务类型	NORMAL	下拉列表
FTransferDirect	调拨方向	GENERAL	下拉列表
FTransferBizType	调拨类型	InnerOrgTransfer	下拉列表
FSaleOrgId	销售组织	function case when '{{shop_name}}' like '%古神%' then 102 when '{{shop_name}}' like '%广州格物%' then 101 when '{{shop_name}}' like '%广西格物%' then 103 ELSE 100 end	组织
FSettleOrgId	结算组织	_function case when '{{shop_name}}' like '%古神%' then 102 when '{{shop_name}}' like '%广州格物%' then 101 when '{{shop_name}}' like '%广西格物%' then 103 ELSE 100 end	组织
FStockOutOrgId	调出库存组织	100	组织
FOwnerTypeOutIdHead	调出货主类型	BD_OwnerOrg	多类别基础资料列表
FOwnerOutIdHead	调出货主	_function case when '{{shop_name}}' like '%古神%' then 102 when '{{shop_name}}' like '%广州格物%' then 101 when '{{shop_name}}' like '%广西格物%' then 103 ELSE 100 end	多类别基础资料
FStockOrgId	调入库存组织	100	组织
FSETTLECURRID	结算币别	PRE001	基础资料
FDate	日期	{{check_time}}	日期
FNote	备注	{{remark}}	多行文本
FBillEntry	明细信息	details_list	1
FBillEntry.FMaterialId	物料编码	{{details_list.spec_no}}	基础资料
FBillEntry.FCMKBarCode	零售条形码		文本
FBillEntry.FQty	调拨数量	{{details_list.num}}	数量
FBillEntry.FLot	调出批号		批次
FBillEntry.FSrcStockId	调出仓库	{{shop_no}}	基础资料
FBillEntry.FDestStockId	调入仓库	{{warehouse_no}}	基础资料
FBillEntry.FNoteEntry	备注	{{details_list.remark}}	多行文本
FBillEntry.FSrcStockStatusId	调出库存状态	KCZT01_SYS
FBillEntry.FOwnerTypeId	调入货主类型	BD_OwnerOrg
FBillEntry.FOwnerId	调入货主	100
FBillEntry.FDestStockStatusId	调入库存状态	KCZT01_SYS
FBillEntry.FKeeperTypeId	调入保管者类型	BD_KeeperOrg
FBillEntry.FKeeperId	调入保管者	100
FBillEntry.FBaseKeHu	客户	{{shop_no}}
FBillEntry.FormId	业务对象表单Id	STK_TransferDirect	必须填写金蝶的表单ID如😛UR_PurchaseOrder
FBillEntry.Operation	执行的操作	Save
FBillEntry.IsAutoSubmitAndAudit	提交并审核	false
FBillEntry.IsVerifyBaseDataField	验证基础资料	true	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统打通概况

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通旺店通·企业奇门到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。