旺店通·企业奇门和用友BIP接口打通对接实战

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

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

对接目标平台:用友BIP

用友BIP助力行业龙头企业、产业链核心企业以及平台型企业建设产业互联网运营平台，通过运营、管理、协同配置和共享资源，实现产业链上下游连接与协同，并保障安全。

数据对接方案

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：旺店通·企业奇门，然后选择对应的连接器。选择对应的查询退换管理作为数据对接来源。然后再通过写入目标平台配置目标系统为用友BIP,并且选择对应连接器（关于用友BIP的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的客户退款保存接口作为数据写入动作，既可以完成第一步的数据对接配置。

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

调用接口：wdt.refund.query
接口名称：查询退换管理
方法：POST

请求参数

字段字段名称类型配置值 process_status退换单处理状态string time_type时间类型string start_time开始时间string{{LAST_SYNC_TIME datetime}} end_time结束时间string{{CURRENT_TIME datetime}} page_size分页大小string{{PAGINATION_PAGE_SIZE}} shop_no店铺编号string page_no页号string refund_noErp内退换单编号string src_refund_no平台原始退换单号string trade_no系统订单编号string tid原始单号string

响应参数

字段字段名称类型配置值 modified最后修改时间string refund_id退换单主键string refund_noerp退换单号string finish_time结算时间string customer_no客户档案编号string api_outer_noAPI单号string platform_id平台类型string customer_name收件人姓名string src_no平台退款单号string swap_zip收件人邮编string swap_logistics_type换货新订单物流公司类别string type类型string process_status处理状态string swap_logistics_name换货新订单物流公司名称string creator_name建单员姓名string status平台状态string guarantee_mode担保方式string error_msg逆向物流错误信息string cs_status退款阶段string created创建时间string shop_no店铺编号string outer_no外部编号string shop_name店铺名称string swap_trade_id换出原始单idstring warehouse_id仓库idstring pay_account买家支付帐号string shop_id店铺idstring pay_no支付订单号string advance_status预先状态string goods_amount退货金额string refund_amount买家申请退款金额string is_goods_received是否收到货品string customer_id客户idstring direct_refund_amount线下退款金额string guarante_refund_amount平台退款金额string swap_warehouse_id换出仓库idstring actual_refund_amount实际退款/收款金额string swap_logistics_id换出物流idstring warehouse_type仓库类型string exchange_amount换货金额string post_amount邮费金额string wms_statuswms状态string other_amount其它金额string wms_resultwms结果string wms_outer_no外部仓库的单号string paid已退款/已收款string from_type建立方式string tid订单的原始单号string sales_trade_id系统订单IDstring return_goods_count退回货品数量string sales_tid系统订单号string op_constraint约束string buyer_nick昵称string refund_version退款版本string receiver_name收件人姓名string consign_mode发货方式string receiver_address收件人地址string logistics_name物流公司名称string receiver_telno收件人电话string logistics_no物流单号string push_no物流递交单号string return_name退货人姓名string return_mobile退货人手机号string logistics_style物流形式string reason_id原因string return_telno退货人电话string revert_reason驳回原因string return_address退回仓库地址string return_logistics_name退回物流公司名称string bad_reason错误原因string return_mask返回标志string return_logistics_no退回物流单号string swap_receiver换货收件人姓名string is_trade_charged是否结算后生成订单string swap_mobile换收发件人姓名手机string stockin_pre_no预入库单string swap_telno换货收件人姓名电话string revert_reason_info驳回原因名称string refund_order_list退款子订单信息array refund_order_list.order_id货品明细主键string refund_order_list.refund_id退换单主键string refund_order_list.oid原始子订单idstring refund_order_list.tid订单子订单的原始单号string refund_order_list.src_no平台退款单号string refund_order_list.process_status处理状态string refund_order_list.sales_tid销售订单编号string refund_order_list.order_num实际数量string refund_order_list.price价格string refund_order_list.platform_id平台类型string refund_order_list.cost_price成本价string refund_order_list.original_price原价string refund_order_list.discount优惠string refund_order_list.paid已付金额string refund_order_list.market_price单品市场价string refund_order_list.refund_num退款数量string refund_order_list.refund_order_amount明细退款金额string refund_order_list.total_amount退货金额string refund_order_list.spec_iderp商品主键string refund_order_list.spec_no商家编码string refund_order_list.goods_name货品名称string refund_order_list.goods_no货品编号string refund_order_list.spec_name规格名称string refund_order_list.spec_code规格编码string refund_order_list.suite_no组合装编号string refund_order_list.suite_name组合装名称string refund_order_list.suite_num组合装数量string refund_order_list.stockin_num退货入库数量string refund_order_list.remark退款说明string refund_order_list.is_sn_enable是否启用序列号string refund_order_list.position_no货位编号string refund_order_list.position_id货位IDstring refund_order_list.sales_trade_id系统订单IDstring refund_order_list.sales_order_id销售订单IDstring refund_order_list.goods_id平台货品IDstring refund_order_list.suite_id组合装IDstring refund_order_list.stockin_amount退货入库总额string refund_order_list.modified最后修改时间string refund_order_list.created创建时间string refund_order_list.swap_province换货收件人省份string refund_order_list.refund_out_goods_list换出货品信息列表array refund_order_list.swap_city换货收件人城市string refund_order_list.swap_district换货收件人区县string refund_order_list.swap_area换货收件人省市区string refund_order_list.swap_warehouse_no换出货品出库仓库编号string refund_order_list.swap_address换货收件人姓名地址string refund_order_list.warehouse_no期望退回的仓库编号string refund_order_list.refund_time退款创建时间string refund_order_list.remark退款说明string refund_order_list.refund_reason退款原因string refund_order_list.swap_trade_no换出原始单号string

用友BIP接口明细

API：/yonbip/fi/paybill/save
NAME：客户退款保存
METHOD：POST

请求参数

接口字段字段名称预设值描述 code单据编号{{refund_no}}新增时无需填写，修改时必填 exchangeRateType_code汇率类型档案编码01 vouchdate单据日期格式为:yyyy-MM-dd HH:mm:ss{{modified}} accentity会计主体findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} oriSum付款金额_function round({{refund_amount}},2) natSum本币金额function round({{refund_amount}},2) balance余额 settlemode_code结算方式system_0001 operator_name业务员{{creator_name}} dept_code部门 customer客户id_findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} natCurrency本币币种id1480261131563434007 currency_name币种人民币 natCurrency_priceDigit本币币种单价精度2 currency_moneyDigit币种金额精度2 natCurrency_moneyDigit本币币种金额精度2 exchangeRateType_name汇率类型名称基准汇率 exchRate汇率1 description备注{{remark}} tradetype交易类型id2742928410236975 tradetype_name交易类型名称销售退款 tradetype_code交易类型编码arap_payment_sale org_code销售组织编码findCollection find maping_sale_orgnumber from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} basebilltype_name事项类型名称basebilltype_name basebilltypecode事项类型编码arap_payment caobject收付款对象类型11:客户 billtype单据类型固定为991:销售发票、2:其它应收事项、3:销售发票(红字)、4:其它应收事项(红字)、5:订单日报、6:内部交易结算单、7:收款单、8:其它应付事项、9:客户退款单、10:付款单、11:供应商退款单、12:转账单、13:汇率损益单、14:外币兑换单、id period_code会计期间编码2022-07 period会计期间id2742928426767367 returncount返回次数 orderno订单编号{{sales_tid}} pubts时间戳{{CURRENT_TIME datetime}}格式为:yyyy-MM-dd HH:mm:ss _status操作标识InsertInsert:新增、Update:更新 PayBillb客户退款明细 PayBillb.quickType_code款项类型编码11:预收款 PayBillb.expenseitem_code费用项目编码01 PayBillb.oriSum金额function round({{actual_refund_amount}},2) PayBillb.natSum本币金额_function round({{actual_refund_amount}},2) PayBillb.customer客户idfindCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} PayBillb.customer_name客户名称 PayBillb.org_code销售组织编码_findCollection find maping_sale_orgnumber from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} PayBillb.description备注{{refund_order_list.remark}} PayBillb._status操作标识InsertInsert:新增、Update:更新、Unchanged:不变

数据对接效果

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通旺店通·企业奇门到用友BIP之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。

旺店通·企业奇门和用友BIP接口打通对接实战