从旺店通·企业奇门到用友BIP通过接口配置打通数据

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

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

对接系统：用友BIP

面向数智化市场，用友倾力打造了全球领先的数智商业创新平台——用友BIP，定位为数智商业的应用级基础设施、企业服务产业的共创平台，服务企业数智化转型和商业创新，让企业云服务随需而用，让数智价值无处不在，让商业创新如此便捷。

接口方案配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：旺店通·企业奇门接口：查询退换管理通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：用友BIP接口：客户退款保存，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：用友BIP写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

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

• API：wdt.refund.query

• NAME：查询退换管理

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
process_status	退换单处理状态		退换单处理状态 5 补款 10已取消 20待审核 30已同意 40已拒绝 50待财审 60待收货 63待推送 64推送失败 65委外待收货 69待收货(已结算) 70部分到货 71部分到货(已结算) 80待结算 90已完成
time_type	时间类型		0，最后更新时间，1，结算时间。默认值0
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
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	每页返回的数据条数，输入值范围140，不传本参数，输入值默认为40，使用举例单击这里
shop_no	店铺编号		店铺编号
page_no	页号		不传值默认从0页开始
refund_no	Erp内退换单编号	TK2208020130	Erp内退换单编号，传该字段可以不传时间
src_refund_no	平台原始退换单号		平台原始退换单号，传该字段可以不传时间
trade_no	系统订单编号		系统订单编号，传该字段可以不传时间
tid	原始单号		原始单号，传该字段可以不传时间

响应参数

接口字段	字段名称	预设值	描述
modified	最后修改时间		最后修改时间 格式：yyyy-MM-dd HH:mm:ss
refund_id	退换单主键		退换单主键
refund_no	erp退换单号		erp退换单号，默认TK开头
finish_time	结算时间		旺店通内操作结算的时间 格式：yyyy-MM-dd HH:mm:ss
customer_no	客户档案编号		客户档案编号
api_outer_no	API单号		接口创建退换单的外部单号
platform_id	平台类型		平台类型，响应值为代表平台的ID数字，ID对应的平台名称单击这里
customer_name	收件人姓名		收件人姓名（如需唯一值，以receiver_name为准）
src_no	平台退款单号		平台退款单号
swap_zip	收件人邮编		收件人邮编
swap_logistics_type	换货新订单物流公司类别		响应值为代表换货新订单物流公司类别的数字，数字对应的物流公司类别名称单击这里
type	类型		1退款(未发货，退款申请)2退货3换货4退款不退货5订单补款
process_status	处理状态		5补款10已取消20待审核30已同意40已拒绝50待财审60待收货63待推送64推送失败65委外待收货69待收货(已结算)70部分到货71部分到货(已结算)80待结算90已完成
swap_logistics_name	换货新订单物流公司名称		换货新订单物流公司名称
creator_name	建单员姓名		建单员姓名
status	平台状态		平台状态0表示为空，1取消退款，2已申请退款，3等待退货，4等待收货，5退款成功，10换货待处理，20待买家退货，30买家已退货待收货，40待买家修改，50待发出换货商品，55待买家收货，60换货改退货，70换货关闭，80换货成功
guarantee_mode	担保方式		担保方式1担保交易2非担保交易3非担保在线交易（ecshop）
error_msg	逆向物流错误信息		逆向物流错误信息
cs_status	退款阶段		退款阶段 0售中 1售后
created	创建时间		创建时间
shop_no	店铺编号		代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置）
outer_no	外部编号		默认为''，外部编号,与wms对接使用
shop_name	店铺名称		店铺名称
swap_trade_id	换出原始单id		换出原始单id
warehouse_id	仓库id		默认为'0'，期望退回的仓库
pay_account	买家支付帐号		买家支付帐号
shop_id	店铺id		店铺id
pay_no	支付订单号		支付订单号
advance_status	预先状态
goods_amount	退货金额		退货金额
refund_amount	买家申请退款金额		买家申请退款金额
is_goods_received	是否收到货品		默认为'0'，买家是否收到货
customer_id	客户id		默认为'0'，客户id
direct_refund_amount	线下退款金额		订单确认收货之后的退款金额
guarante_refund_amount	平台退款金额		平台退款金额
swap_warehouse_id	换出仓库id		默认为'0'，换出货品出库仓库
actual_refund_amount	实际退款/收款金额		实际退款/收款金额
swap_logistics_id	换出物流id		默认为'0'，换货新订单物流公司ID
warehouse_type	仓库类型
exchange_amount	换货金额		换货金额
post_amount	邮费金额		邮费金额
wms_status	wms状态		默认为'0'，外部状态,与wms对接使用0初始化1失败2成功
other_amount	其它金额		其它金额
wms_result	wms结果		默认为''，外部结果,与wms对接使用
wms_outer_no	外部仓库的单号		默认为''，对应外部仓库的单号
paid	已退款/已收款		已退款/已收款
from_type	建立方式		默认为'1'，建立方式1api抓单2手式建单3外部导入4天猫换货5菜鸟回传自动创建
tid	订单的原始单号		订单的原始单号
sales_trade_id	系统订单ID		系统订单ID
return_goods_count	退回货品数量		默认为'0'，退回货品数量
sales_tid	系统订单号		系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）
op_constraint	约束		默认为'0'，1不允许拒绝2需要到网页版操作
buyer_nick	昵称		昵称
refund_version	退款版本		默认为''，退款版本,大于0后表明已经从平台下载完成，退款单不可修改
receiver_name	收件人姓名		收件人姓名
consign_mode	发货方式		默认为'0'，发货方式：0默认1审核退款单后立即生成换货订单2退货完成后生成换货订单
receiver_address	收件人地址		收件人地址
logistics_name	物流公司名称		默认为''，物流公司名称
receiver_telno	收件人电话		收件人电话
logistics_no	物流单号		默认为''，物流单号
push_no	物流递交单号		默认为''，物流递交单号
return_name	退货人姓名		退货人姓名
return_mobile	退货人手机号		退货人手机号
logistics_style	物流形式		默认为'0'，取件方式:0客户取件，1顺丰取件，2拒收退回
reason_id	原因		默认为'0'，原因
return_telno	退货人电话		退货人电话
revert_reason	驳回原因		默认为'0'，驳回原因
return_address	退回仓库地址		退回仓库地址
return_logistics_name	退回物流公司名称		退回物流公司名称
bad_reason	错误原因		默认为'0'，错误原因
return_mask	返回标志
return_logistics_no	退回物流单号		退回物流单号
swap_receiver	换货收件人姓名		换货收件人姓名
is_trade_charged	是否结算后生成订单		默认为'0'，是否结算后生成订单
swap_mobile	换收发件人姓名手机		换收发件人姓名手机
stockin_pre_no	预入库单		默认为''，预入库单
swap_telno	换货收件人姓名电话		换货收件人姓名电话
revert_reason_info	驳回原因名称		驳回原因名称
refund_order_list	退款子订单信息		退款子订单信息,refund_order_list结构
refund_order_list.order_id	货品明细主键		退换单退回货品明细主键
refund_order_list.refund_id	退换单主键		退换单主键
refund_order_list.oid	原始子订单id		原始子订单编号
refund_order_list.tid	订单子订单的原始单号		订单子订单的原始单号
refund_order_list.src_no	平台退款单号		平台退款单号
refund_order_list.process_status	处理状态		处理状态0已取消10待递交20待审核30已同意40已拒绝50待财审60待收货70部分到货80已完成
refund_order_list.sales_tid	销售订单编号		销售订单编号
refund_order_list.order_num	实际数量		实际数量
refund_order_list.price	价格		价格
refund_order_list.platform_id	平台类型		平台类型，响应值为代表平台的ID数字，ID对应的平台名称单击这里
refund_order_list.cost_price	成本价		成本价
refund_order_list.original_price	原价		原价
refund_order_list.discount	优惠		优惠
refund_order_list.paid	已付金额		已付金额
refund_order_list.market_price	单品市场价		单品市场价
refund_order_list.refund_num	退款数量		退款数量
refund_order_list.refund_order_amount	明细退款金额		明细退款金额，由主单退款金额分摊
refund_order_list.total_amount	退货金额		退货金额
refund_order_list.spec_id	erp商品主键		erp商品主键
refund_order_list.spec_no	商家编码		代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍,单击这里

用友BIP接口明细

• 调用接口：/yonbip/fi/paybill/save

• 接口名称：客户退款保存

• 方法：POST

请求参数

字段	字段名称	类型	配置值
code	单据编号	string	{{refund_no}}
exchangeRateType_code	汇率类型档案编码	string	01
vouchdate	单据日期 格式为:yyyy-MM-dd HH:mm:ss	string	{{modified}}
accentity	会计主体	string	findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
oriSum	付款金额	string	{{refund_amount}}
natSum	本币金额	string	{{refund_amount}}
balance	余额	string
settlemode_code	结算方式	string	system_0001
operator_name	业务员	string	{{creator_name}}
dept_code	部门	string
customer	客户id	string	_findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
natCurrency	本币币种id	string	2742928420541440
currency_name	币种	string	人民币
natCurrency_priceDigit	本币币种单价精度	string	2
currency_moneyDigit	币种金额精度	string	2
natCurrency_moneyDigit	本币币种金额精度	string	2
exchangeRateType_name	汇率类型名称	string	基准汇率
exchRate	汇率	string	1
description	备注	string	{{remark}}
tradetype	交易类型id	string	2742928410236975
tradetype_name	交易类型名称	string	销售退款
tradetype_code	交易类型编码	string	arap_payment_sale
org_code	销售组织编码	string	findCollection find maping_sale_orgnumber from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
basebilltype_name	事项类型名称	string	basebilltype_name
basebilltypecode	事项类型编码	string	arap_payment
caobject	收付款对象类型	string	1
billtype	单据类型 固定为9	string	9
period_code	会计期间编码	string	2022-07
period	会计期间id	string	2742928426767367
returncount	返回次数	string
orderno	订单编号	string	{{sales_tid}}
pubts	时间戳	string	{{CURRENT_TIME datetime}}
_status	操作标识	string	Insert
PayBillb	客户退款明细	array
PayBillb.quickType_code	款项类型编码	string	1
PayBillb.expenseitem_code	费用项目编码	string	01
PayBillb.oriSum	金额	string	{{refund_amount}}
PayBillb.natSum	本币金额	string	{{refund_amount}}
PayBillb.customer	客户id	string	findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
PayBillb.customer_name	客户名称	string
PayBillb.org_code	销售组织编码	string	_findCollection find maping_sale_orgnumber from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
PayBillb.description	备注	string	{{refund_order_list.remark}}
PayBillb._status	操作标识	string	Insert

数据对接效果

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。