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

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

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

对接目标平台:金蝶云星空

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

多系统对接方案配置

通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将旺店通·企业奇门、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。

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

接口：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_size	分页大小	string	每页返回的数据条数，输入值范围150，不传本参数，输入值默认为40，使用举例单击这里
page_no	页号	string	不传值默认从0页开始

响应参数

字段	名称	类型	描述
stockin_id	入库单主键id	string	入库单主键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	退换单状态	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
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	物流名称	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
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	仓库id	string	默认为'0'，仓库id
src_order_type	入库单类型	string	默认为'0'，入库单类型 3退货入库
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'，货品种类数
adjust_num	调整数量	string	默认为'0'，调整数量
note_count	便签条数	string	默认为'0'，便签条数
flag_id	标记id	string	默认为'0'，标记id
modified	最后修改时间	string
details_list	货品列表节点	array	退回货品列表节点
details_list.rec_id	明细表主键id	string	明细表主键id
details_list.stockin_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.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	单品自定义属性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.tid	原订单原始单号	string	原订单原始单号
details_list.oid	原订单原始子单号	string	原订单原始子单号

金蝶云星空接口明细

API：batchSave

NAME：调拨单新增

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}}	多行文本
FBaseKeHu	客户	{{shop_no}}
FBillEntry	明细信息	details_list	1
FBillEntry.FMaterialId	物料编码	{{details_list.spec_no}}	基础资料
FBillEntry.FCMKBarCode	零售条形码		文本
FBillEntry.FQty	调拨数量	{{details_list.num}}	数量
FBillEntry.FLot	调出批号		批次
FBillEntry.FSrcStockId	调出仓库	{{shop_no}}	基础资料
FBillEntry.FSrcStockLocId	调出仓位		维度关联字段
FBillEntry.FDestStockId	调入仓库	{{warehouse_no}}	基础资料
FBillEntry.FDestStockLocId	调入仓位		维度关联字段
FBillEntry.FNoteEntry	备注		多行文本
FBillEntry.FISFREE	赠品		复选框
FBillEntry.FSrcStockStatusId	调出库存状态	KCZT01_SYS
FBillEntry.FormId	业务对象表单Id	STK_TransferDirect	必须填写金蝶的表单ID如 UR_PurchaseOrder
FBillEntry.IsAutoSubmitAndAudit	提交并审核	true
FBillEntry.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FBillEntry.Operation	执行的操作	Save

数据对接效果

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。