系统数据集成方案

金蝶云星空和旺店通·企业奇门单据接口对接

接通系统：旺店通·企业奇门

写入目标:金蝶云星空

数据对接方案

通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将旺店通·企业奇门、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，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店铺界面设置），用于获取指定店铺单据数据信息
page_size	分页大小	string	每页返回的数据条数，输入值范围1~50，不传本参数，输入值默认为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	基础资料
FSaledeptid	销售部门	string	基础资料
FHeadNote	备注	string	多行文本
FEntity	明细信息	array
FEntity.FMaterialId	物料编码	string	基础资料
FEntity.FBarcode	零售条形码	string	文本
FEntity.FRealQty	实退数量	string	数量
FEntity.FAllAmount	价税合计	string	单价
FEntity.FIsFree	是否赠品	string	复选框
FEntity.FEntryTaxRate	税率%	string	小数
FEntity.FReturnType	退货类型	string	单选辅助资料列表
FEntity.FOwnerTypeId	货主类型	string	多类别基础资料列表
FEntity.FOwnerId	货主	string	多类别基础资料
FEntity.FStockId	仓库	string	基础资料
FEntity.FStocklocId	仓位	string	维度关联字段
FEntity.FLot	批号	string	批次
FEntity.FDeliveryDate	退货日期	string	长日期
FEntity.FNote	备注	string	文本
FEntity.FSRCTYPE	源单类型	string
FEntity.FSRCBillNo	源单编号	string
FEntity.FSoorDerno	订单单号	string	文本
FEntity.FEntity_Link	关联关系表	array
FEntity.FEntity_Link.FEntity_Link_FRuleId	转换规则	string
FEntity.FEntity_Link.FEntity_Link_FSTableName	源单表	string
FEntity.FEntity_Link.FEntity_Link_FSBillId	源单内码	string
FEntity.FEntity_Link.FEntity_Link_FSId	源单分录内码	string
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgId	结算组织	string	组织
FEntity.SubHeadEntity.FSettleCurrId	结算币别	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	默认仓库模块

数据对接价值

全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与旺店通·企业奇门之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。

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