从旺店通·企业奇门到用友BIP通过接口配置打通数据
接通系统：旺店通·企业奇门
旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展
对接目标平台:用友BIP
YonBIP用友商业创新平台，是用友在数字经济时代面向成长型、大型企业及巨型企业，融合了先进且高可用技术平台和公共与关键商业应用与服务，支撑和运行客户的商业创新（业务创新、管理变革），并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。
数据接口配置方案
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：旺店通·企业奇门，并且选择对应的连接器（关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询退货入库单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为用友BIP，并且选择对应连接器。选择对应的销售出库来源生单保存接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
旺店通·企业奇门接口明细
- API：wdt.stockin.order.query.refund
- NAME：查询退货入库单
- METHOD：POST
请求参数
接口字段字段名称预设值描述
start_time开始时间{{LAST_SYNC_TIME datetime}}增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time结束时间{{CURRENT_TIME datetime}}增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
status状态入库单状态 10已取消20编辑中30待审核60待结算80已完成（默认查询80已完成单据）
shop_no店铺编号代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息
page_size分页大小{{PAGINATION_PAGE_SIZE}}每页返回的数据条数，输入值范围1
50，不传本参数，输入值默认为40，使用举例单击这里
page_no页号{{PAGINATION_START_PAGE}}不传值默认从0页开始
响应参数
接口字段字段名称预设值描述
stockin_id入库单主键id入库单主键id
order_no入库单号入库单号
warehouse_no仓库编号代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
warehouse_name仓库名称仓库名称
shop_no店铺编号代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺数据信息
shop_remark店铺备注店铺备注
src_order_no上层单据（退换单）编号
process_status退换单状态10已取消,20待审核,30已同意,40已拒绝,50待财审,60待收货,63待推送,64推送失败,65委外待收货,69待收货(已结算),70部分到货,71部分到货(已结算),80待结算 ,90已完成。ERP版本V2.3.8.4及以上才可返回
status退货入库单状态入库单状态 10已取消20编辑中30待审核60待结算80已完成
stockin_time更新时间更新时间 格式：yyyy-MM-dd HH:mm:ss
created_time创建时间创建时间 格式：yyyy-MM-dd HH:mm:ss
remark备注备注
trade_no订单编号系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）
trade_type系统订单类别系统订单类别（1网店销售,2线下零售,3售后换货,4批发业务,5保修换新,6保修完成,7订单补发 .. 101自定义类型1,102自定义类型2,103自定义类型3,104自定义类型4 ,105自定义类型5,106自定义类型6）
order_type单据类别单据类别，默认返回3
order_type_name单据类别名称单据类别名称，默认为“退货入库”
goods_count货品数量货品数量
goods_amount货款总额退回货款收入
actual_refund_amount实际退款金额实际退款金额
total_price扣除优惠后货款总额退回货品成本
discount优惠金额优惠金额
tax_amount税后金额税后金额
post_fee邮费退货入库单的“邮资”
other_fee其他费用退货入库单的“其它金额”
adjust_price纠错金额纠错金额
right_price调整后总金额调整后总金额
logistics_type物流类型响应值为代表物流类型的数字，数字对应的物流类型名称单击这里
logistics_no物流编号代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
logistics_name物流名称ERP设置的物流公司名称
logistics_code物流单号物流单单号
refund_no退换单编号退换单编号
check_time入库审核时间
customer_no客户编号客户编号
customer_name客户名称退货人的姓名
nick_name客户网名客户网名
shop_name店铺名称店铺名称
stockin_reason入库原因入库原因
flag_name退货单标记退换单界面的标记
platform_id平台id平台id
tid订单原始单号
stockin_operator_name入库操作人姓名默认为''，入库操作人姓名
check_operator_name审核人姓名默认为''，审核人姓名
refund_remark退换备注默认为''，退换备注
refund_operator_name退货员姓名默认为''，退货员姓名
stockin_no入库单号入库单号
wms_outer_no外部仓库单号默认为''，对应外部仓库的单号
wms_status外部仓库状态默认为'0'，外部状态,与wms对接使用 0初始化 1失败 2成功'
wms_result结果默认为''，错误信息
warehouse_id仓库id默认为'0'，仓库id
src_order_type入库单类型默认为'0'，入库单类型 3退货入库
src_order_id业务单据id默认为'0'，业务单据id
reason_id原因原因
fa_status财务同步状态默认为'0'，财务同步状态
logistics_id物流公司d默认为'0'，物流公司id
post_share_type邮资分摊类型默认为'0'，邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊'
operator_id操作员id操作员id
check_operator_id审核员id
goods_type_count货品种类数默认为'0'，货品种类数
adjust_num调整数量默认为'0'，调整数量
note_count便签条数默认为'0'，便签条数
flag_id标记id默认为'0'，标记id
modified最后修改时间
details_list货品列表节点退回货品列表节点
details_list.rec_id明细表主键id明细表主键id
details_list.stockin_id入库单主键id入库单主键id
details_list.src_order_detail_id上层单据（退换单）退回货品明细主键上层单据（退换单）退回货品明细主键，ERP版本V2.3.8.3及以上才可返回
details_list.spec_no商家编码代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍,单击这里
details_list.goods_count货品数量货品数量
details_list.discount优惠金额优惠金额
details_list.cost_price成本价成本价
details_list.production_date生产日期生产日期，格式：yyyy-MM-dd HH:mm:ss
details_list.validity_days有效期天数有效期天数
details_list.expire_date有效期有效期，格式：yyyy-MM-dd HH:mm:ss
details_list.src_price原价原价
details_list.tax_price税后单价税后单价
details_list.tax_amount税后金额税后金额
details_list.tax税率税率
details_list.total_cost总成本总成本
details_list.remark备注备注
details_list.adjust_num纠错数量纠错数量
details_list.adjust_price纠错金额纠错金额
details_list.right_num调整后数量调整后数量
details_list.right_price调整后单价调整后单价
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单品自定义属性2
details_list.goods_no货品编号代表货品(spu)所有属性的唯一编号，用于系统货品区分，，SPU概念介绍,单击这里
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.tid原订单原始单号原订单原始单号
details_list.oid原订单原始子单号原订单原始子单号
details_list.src_order_type订单类型1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库
details_list.org_stockin_detail_id原始入库单明细默认为'0'，原始入库单明细
details_list.spec_iderp商品主键erp内商品主键
details_list.batch_id批次默认为'0'，批次
details_list.position_id货位id默认为'0'，货位ID，入库时默认ID
details_list.unit_id辅助单位默认为'0'，辅助单位
details_list.base_unit_id基本单位默认为'0'，基本单位
details_list.unit_ratio单位比率默认为'1.0000'，单位换算关系
details_list.expect_num期望数量默认为'0.0000'，预期入库数量（基本单位数量，显示可自动转换成辅助单位）
details_list.cost_price2辅助价格默认为'0.0000'，辅助成本价
details_list.share_post_cost邮资分摊成本默认为'0.0000'，邮资分摊成本
details_list.share_post_total邮资分摊总成本默认为'0.0000'，邮资分摊总成本
details_list.modified最后修改时间最后修改时间
details_list.created创建时间创建时间
用友BIP接口明细
- 接口：/yonbip/scm/salesout/mergeSourceData/save
- 接口名称：销售出库来源生单保存
- 接口方法：POST
请求参数
字段名称类型描述
mergeSourceData是否合并上游数据string是否合并上游数据。值为true的话则sourceid：来源单据主表id，sourceautoid：来源单据行id，makeRuleCode：单据转换规则，
status：操作标识，不可为空。 示例：true
vouchdate单据日期 string单据日期 示例：2020-11-30 00:00:00
warehouse仓库id或编码 string仓库id或编码 示例：Z001
bizFlowbizFlowstring流程ID
bizFlow_versionbizFlow_versionstring
code单据编号string单据编号 示例:XSCK20201130000002 自动编码可以不携带
bustype交易类型id或编码string交易类型id或编码 示例:A30001
details销售出库单子表array销售出库单子表[st.salesout.SalesOuts]
details.qty数量 string数量 示例：12
details.sourceid来源单据主表idstring来源单据主表id，如果有来源则必输
details.sourceautoid来源单据行idstring来源单据行id，有来源必输
details.batchno批次号string批次号,仓库商品均开启批次管理则必填
details.makeRuleCode单据转换规则string单据转换规则，deliveryTostoreout：发货单生销售出库，salereturnTosalesout：退货单生销售出库，orderTosalesout：销售订单生销售出库
details.goodsposition货位string货位，仓库开启货位则必填 示例：whhw2467516
details._status操作标识string操作标识, Insert:新增 示例：Insert
details._status操作标识string操作标识, Insert:新增 示例：Insert
系统数据对接
采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。
