系统数据集成方案

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

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

对接系统：金蝶云星空

配置集成方案

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取旺店通·企业奇门的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。

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

• 接口：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~100，不传本参数，输入值默认为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
• 接口名称：销售退货新增
• 接口方法：POST

请求参数

字段	名称	类型	描述
FBillTypeID	单据类型	string	单据类型
FBillNo	单据编号	string	单据编号
FSaleOrgId	销售组织	string	组织
FDate	日期	string	日期
FStockOrgId	库存组织	string	组织
FRetcustId	退货客户	string	基础资料
FHeadNote	备注	string	多行文本
FEntity	明细信息	array
FEntity.FMaterialId	物料编码	string	基础资料
FEntity.FRealQty	实退数量	string	数量
FEntity.FTaxPrice	含税单价	string	单价
FEntity.FEntryTaxRate	税率%	string	小数
FEntity.FStockId	仓库	string	基础资料
FEntity.FNote	备注	string	文本
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgId	结算组织	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	默认仓库模块

系统对接概况

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。

系统数据对接方案元数据代码