接口配置打通金蝶云星空和旺店通·企业奇门数据对接源系统:旺店通·企业奇门旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展对接系统：金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。数据集成方案配置轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：旺店通·企业奇门的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。旺店通·企业奇门接口明细 API： wdt.stockin.order.query.refund NAME：查询退货入库单 METHOD： POST 请求参数接口字段名称预设值 start_time 开始时间 {{LAST_SYNC_TIME datetime}} end_time 结束时间 {{CURRENT_TIME datetime}} status 状态 shop_no 店铺编号 KHTX001,KHTX002,KHTX003,KHTX004,KHTX010,KHTX014,KHTX017,KHTX018,KHTX019,KHTX006,KHTX015,KHTX012,KHTX013,KHTX020,KHJD001,KHJD002,KHJD003,KHJD005,KHJD007,KHPD005,KHPD006.KHPD007,KHPD008,KHWX001,KHDY001,KHDY002,KHDY003,KHDY004,KHDY005,KHDY006,KHDY007,KHDY008,KHDY011,KHDY015,KHDY013,KHDY010,KHDY012,KHDY014,KHDY016,KHDY017,KHDY018,KHDY019,KHDY020,KHDY021,KHDY022,KHDY023,KHDY024,KHKS001,KHKS002,KHKS004,KHTX021,KHDW001,KHTX022,KHVIP001,KHWD002,KHWD004,KHDY025,KHDY026,KHJL001,KHXX002,KHSQ001,KHXX010,KHXX006,KHXX007,KHXX008,KHXX011,KHXX012,KHKS005 page_size 分页大小 {{PAGINATION_PAGE_SIZE}} page_no 页号 {{PAGINATION_START_PAGE}} 响应参数接口字段名称预设值 order_no 入库单号 warehouse_no 仓库编号 warehouse_name 仓库名称 shop_no 店铺编号 shop_remark 店铺备注 src_order_no 上层单据（退换单）编号 process_status 退换单状态 status 退货入库单状态 stockin_time 更新时间 created_time 创建时间 trade_no 订单编号 trade_type 系统订单类别 order_type 单据类别 order_type_name 单据类别名称 goods_amount 货款总额 actual_refund_amount 实际退款金额 total_price 扣除优惠后货款总额 post_fee 邮费 other_fee 其他费用 logistics_type 物流类型 logistics_no 物流编号 logistics_name 物流名称 logistics_code 物流单号 refund_no 退换单编号 check_time 入库审核时间 customer_no 客户编号 customer_name 客户名称 nick_name 客户网名 shop_name 店铺名称 stockin_reason 入库原因 flag_name 退货单标记 platform_id 平台id stockin_operator_name 入库操作人姓名 check_operator_name 审核人姓名 refund_remark 退换备注 refund_operator_name 退货员姓名 stockin_no 入库单号 wms_outer_no 外部仓库单号 wms_status 外部仓库状态 wms_result 结果 warehouse_id 仓库id src_order_id 业务单据id reason_id 原因 fa_status 财务同步状态 logistics_id 物流公司d post_share_type 邮资分摊类型 operator_id 操作员id check_operator_id 审核员id goods_type_count 货品种类数 note_count 便签条数 flag_id 标记id details_list 货品列表节点 details_list.stockin_id 入库单主键id details_list.remark 备注 details_list.goods_count 货品数量 details_list.discount 优惠金额 details_list.tax_amount 税后金额 details_list.adjust_price 纠错金额 details_list.right_price 调整后单价 details_list.tid 原订单原始单号 details_list.src_order_type 订单类型 details_list.adjust_num 纠错数量 details_list.modified 最后修改时间 details_list.rec_id 明细表主键id details_list.src_order_detail_id 上层单据（退换单）退回货品明细主键 details_list.spec_no 商家编码 details_list.cost_price 成本价 details_list.production_date 生产日期 details_list.validity_days 有效期天数 details_list.expire_date 有效期 details_list.src_price 原价 details_list.tax_price 税后单价 details_list.tax 税率 details_list.total_cost 总成本 details_list.right_num 调整后数量 details_list.num 入库数量 details_list.num2 辅助数量 details_list.right_cost 调整后总金额 details_list.brand_no 品牌编号 details_list.brand_name 品牌名称 details_list.goods_name 货品名称 details_list.prop2 单品自定义属性2 details_list.goods_no 货品编号 details_list.spec_name 规格名称 details_list.spec_code 规格编号 details_list.goods_unit 基本单位 details_list.batch_no 入库批次 details_list.batch_remark 批次备注 details_list.position_no 货位编号 details_list.oid 原订单原始子单号 details_list.org_stockin_detail_id 原始入库单明细 details_list.spec_id erp商品主键 details_list.batch_id 批次 details_list.position_id 货位id details_list.unit_id 辅助单位 details_list.base_unit_id 基本单位 details_list.unit_ratio 单位比率 details_list.expect_num 期望数量 details_list.cost_price2 辅助价格 details_list.share_post_cost 邮资分摊成本 details_list.share_post_total 邮资分摊总成本 details_list.created 创建时间金蝶云星空接口明细 API： batchSave NAME：销售退货新增 METHOD： POST 请求参数接口字段名称预设值 FBillTypeID 单据类型 XSTHD01_SYS FBillNo 单据编号 FSaleOrgId 销售组织 {{shop_no}} FDate 日期 {{check_time2}} FStockOrgId 库存组织 101 FRetcustId 退货客户 {{shop_no}} FReturnReason 退货原因 FSaledeptid 销售部门 {{shop_no}} FHeadNote 备注 FEntity 明细信息 FEntity.FMaterialId 物料编码 {{details_list_spec_no}} FEntity.FBarcode 零售条形码 FEntity.FRealQty 实退数量 {{qty}} FEntity.FAllAmount 价税合计 {{amount}} FEntity.FIsFree 是否赠品 FEntity.FEntryTaxRate 税率% FEntity.FStockId 仓库 {{warehouse_no}} FEntity.FDeliveryDate 退货日期 FEntity.FNote 备注 FEntity.SubHeadEntity 财务信息 FEntity.SubHeadEntity.FSettleOrgId 结算组织 {{shop_no}} FEntity.SubHeadEntity.FSETTLECURRID 结算币别 PRE001 FEntity.SubHeadEntity.FormId 业务对象表单Id SAL_RETURNSTOCK FEntity.SubHeadEntity.Operation 执行的操作 Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit 提交并审核 true FEntity.SubHeadEntity.IsVerifyBaseDataField 验证基础资料 true 数据对接价值当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

接口配置打通金蝶云星空和旺店通·企业奇门数据对接

庄颜_qeasy

接口配置打通金蝶云星空和旺店通·企业奇门数据对接

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

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

对接系统：金蝶云星空

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

数据集成方案配置

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

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

API：wdt.stockin.order.query.refund
NAME：查询退货入库单
METHOD：POST

请求参数

接口字段	名称	预设值
start_time	开始时间	{{LAST_SYNC_TIME datetime}}
end_time	结束时间	{{CURRENT_TIME datetime}}
status	状态
shop_no	店铺编号	KHTX001,KHTX002,KHTX003,KHTX004,KHTX010,KHTX014,KHTX017,KHTX018,KHTX019,KHTX006,KHTX015,KHTX012,KHTX013,KHTX020,KHJD001,KHJD002,KHJD003,KHJD005,KHJD007,KHPD005,KHPD006.KHPD007,KHPD008,KHWX001,KHDY001,KHDY002,KHDY003,KHDY004,KHDY005,KHDY006,KHDY007,KHDY008,KHDY011,KHDY015,KHDY013,KHDY010,KHDY012,KHDY014,KHDY016,KHDY017,KHDY018,KHDY019,KHDY020,KHDY021,KHDY022,KHDY023,KHDY024,KHKS001,KHKS002,KHKS004,KHTX021,KHDW001,KHTX022,KHVIP001,KHWD002,KHWD004,KHDY025,KHDY026,KHJL001,KHXX002,KHSQ001,KHXX010,KHXX006,KHXX007,KHXX008,KHXX011,KHXX012,KHKS005
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}
page_no	页号	{{PAGINATION_START_PAGE}}

响应参数

接口字段	名称	预设值
order_no	入库单号
warehouse_no	仓库编号
warehouse_name	仓库名称
shop_no	店铺编号
shop_remark	店铺备注
src_order_no	上层单据（退换单）编号
process_status	退换单状态
status	退货入库单状态
stockin_time	更新时间
created_time	创建时间
trade_no	订单编号
trade_type	系统订单类别
order_type	单据类别
order_type_name	单据类别名称
goods_amount	货款总额
actual_refund_amount	实际退款金额
total_price	扣除优惠后货款总额
post_fee	邮费
other_fee	其他费用
logistics_type	物流类型
logistics_no	物流编号
logistics_name	物流名称
logistics_code	物流单号
refund_no	退换单编号
check_time	入库审核时间
customer_no	客户编号
customer_name	客户名称
nick_name	客户网名
shop_name	店铺名称
stockin_reason	入库原因
flag_name	退货单标记
platform_id	平台id
stockin_operator_name	入库操作人姓名
check_operator_name	审核人姓名
refund_remark	退换备注
refund_operator_name	退货员姓名
stockin_no	入库单号
wms_outer_no	外部仓库单号
wms_status	外部仓库状态
wms_result	结果
warehouse_id	仓库id
src_order_id	业务单据id
reason_id	原因
fa_status	财务同步状态
logistics_id	物流公司d
post_share_type	邮资分摊类型
operator_id	操作员id
check_operator_id	审核员id
goods_type_count	货品种类数
note_count	便签条数
flag_id	标记id
details_list	货品列表节点
details_list.stockin_id	入库单主键id
details_list.remark	备注
details_list.goods_count	货品数量
details_list.discount	优惠金额
details_list.tax_amount	税后金额
details_list.adjust_price	纠错金额
details_list.right_price	调整后单价
details_list.tid	原订单原始单号
details_list.src_order_type	订单类型
details_list.adjust_num	纠错数量
details_list.modified	最后修改时间
details_list.rec_id	明细表主键id
details_list.src_order_detail_id	上层单据（退换单）退回货品明细主键
details_list.spec_no	商家编码
details_list.cost_price	成本价
details_list.production_date	生产日期
details_list.validity_days	有效期天数
details_list.expire_date	有效期
details_list.src_price	原价
details_list.tax_price	税后单价
details_list.tax	税率
details_list.total_cost	总成本
details_list.right_num	调整后数量
details_list.num	入库数量
details_list.num2	辅助数量
details_list.right_cost	调整后总金额
details_list.brand_no	品牌编号
details_list.brand_name	品牌名称
details_list.goods_name	货品名称
details_list.prop2	单品自定义属性2
details_list.goods_no	货品编号
details_list.spec_name	规格名称
details_list.spec_code	规格编号
details_list.goods_unit	基本单位
details_list.batch_no	入库批次
details_list.batch_remark	批次备注
details_list.position_no	货位编号
details_list.oid	原订单原始子单号
details_list.org_stockin_detail_id	原始入库单明细
details_list.spec_id	erp商品主键
details_list.batch_id	批次
details_list.position_id	货位id
details_list.unit_id	辅助单位
details_list.base_unit_id	基本单位
details_list.unit_ratio	单位比率
details_list.expect_num	期望数量
details_list.cost_price2	辅助价格
details_list.share_post_cost	邮资分摊成本
details_list.share_post_total	邮资分摊总成本
details_list.created	创建时间

金蝶云星空接口明细

API：batchSave
NAME：销售退货新增
METHOD：POST

请求参数

接口字段	名称	预设值
FBillTypeID	单据类型	XSTHD01_SYS
FBillNo	单据编号
FSaleOrgId	销售组织	{{shop_no}}
FDate	日期	{{check_time2}}
FStockOrgId	库存组织	101
FRetcustId	退货客户	{{shop_no}}
FReturnReason	退货原因
FSaledeptid	销售部门	{{shop_no}}
FHeadNote	备注
FEntity	明细信息
FEntity.FMaterialId	物料编码	{{details_list_spec_no}}
FEntity.FBarcode	零售条形码
FEntity.FRealQty	实退数量	{{qty}}
FEntity.FAllAmount	价税合计	{{amount}}
FEntity.FIsFree	是否赠品
FEntity.FEntryTaxRate	税率%
FEntity.FStockId	仓库	{{warehouse_no}}
FEntity.FDeliveryDate	退货日期
FEntity.FNote	备注
FEntity.SubHeadEntity	财务信息
FEntity.SubHeadEntity.FSettleOrgId	结算组织	{{shop_no}}
FEntity.SubHeadEntity.FSETTLECURRID	结算币别	PRE001
FEntity.SubHeadEntity.FormId	业务对象表单Id	SAL_RETURNSTOCK
FEntity.SubHeadEntity.Operation	执行的操作	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	true

数据对接价值

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