用友BIP对接外部旺店通·企业奇门系统

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

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

接通系统：用友BIP

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

配置集成方案

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用系统数据集成平台更加专注于数据集成与流程自动化的应用连接器，通过自研引擎，与各个平台或者服务完成对接，从而打通数据孤岛，实现数据的跨系统自由流转，让数据真正成为企业的核心生产力。

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

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

请求参数

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

响应参数

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

用友BIP接口明细

API：/yonbip/sd/vouchersalereturn/singleSave
NAME：销售退货单个保存
METHOD：POST

请求参数

接口字段名称预设值 resubmitCheckKey保证请求的幂等性{{refund_no}} code单据编码{{refund_no}} salesOrgId销售组织findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} transactionTypeId交易类型1480261131563434158 headFreeItem!define2销售类型{{remark}} agentId客户_findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} retailInvestors是否散户 saleDepartmentId销售部门cs1 vouchdate单据日期 {{created}} corpContact销售业务员 {{creator_name}} settlementOrgId开票组织findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} currency币种CNY exchangeRateType汇率类型01 natCurrency本币CNY retailAgentName散户名称 _findCollection find shop_name from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} saleReturnMemo备注 saleReturnMemo.remark备注 saleReturnMemo.refundStatus退货单退款状态已退货 saleReturnMemo.refundAmount退款金额 {{goods_amount}} saleReturnMemo.isWfControlled是否受审批流控制 false saleReturnMemo.exchRate汇率 1 saleReturnMemo.taxInclusive单价含税true saleReturnMemo.saleReturnSourceType退货类型NONE saleReturnMemo.bizFlow_name流程名称销售退货 saleReturnMemo.bizFlow_version版本信息 V1.0 saleReturnMemo.logisticWayId物流公司id saleReturnMemo.invoiceAgentId开票客户findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} saleReturnMemo.realMoney应付金额 saleReturnMemo.modifyInvoiceType发票类型是否可改 saleReturnMemo.logisticsBillNo物流单号 saleReturnMemo.logisticsUserName司机姓名 saleReturnMemo.logisticsUserPhone司机电话 saleReturnMemo.logisticsCarNum车牌号 saleReturnMemo.receiver收货人 saleReturnMemo.receiveMobile收货人移动电话 saleReturnMemo.receiveTelePhone收货人固定电话 saleReturnMemo.receiveAddress收货地址 saleReturnMemo.receiveZipCode收货人邮编 saleReturnMemo.invoiceUpcType发票类型 saleReturnMemo.invoiceTitleType抬头类型 saleReturnMemo.invoiceTitle发票抬头 1 saleReturnMemo.taxNum纳税识别号 1 saleReturnMemo.bankName开户银行银行 saleReturnMemo.subBankName开户支行银行支行 saleReturnMemo.bankAccount账号 1 saleReturnMemo.invoiceTelephone营业电话 1 saleReturnMemo.invoiceAddress营业地址地址 saleReturnMemo.totalMoney总金额 saleReturnMemo.payMoney退货金额{{refund_amount}} saleReturnMemo.totalMoneyOrigTaxfree无税总金额 saleReturnMemo.payMoneyOrigTaxfree无税退货金额 saleReturnMemo.totalOriTax税额 saleReturnMemo.totalMoneyDomestic本币总金额 saleReturnMemo.payMoneyDomestic本币退货金额 saleReturnMemo.totalMoneyDomesticTaxfree本币无税总金额 saleReturnMemo.payMoneyDomesticTaxfree本币无税退货金额 saleReturnMemo.totalNatTax本币税额 saleReturnMemo.bizFlow流程ID e88e9d81-f134-11ec-9896-6c92bf477043 saleReturnMemo.isFlowCoreBill是否流程核心单据 saleReturnMemo._status操作标识Insert saleReturnMemo.saleReturnDetails退货单详情refund_order_list saleReturnMemo.saleReturnDetails.id表体行ID saleReturnMemo.saleReturnDetails.orderDetailId订单行id saleReturnMemo.saleReturnDetails.orderDetailIdKey订单行idkey saleReturnMemo.saleReturnDetails.sourceid来源单据IDfindCollection find new_id from 83e28b84-9080-34dc-a661-7673b7d4932e where code={{refund_no}} skuCode={{refund_order_list.spec_no}} saleReturnMemo.saleReturnDetails.sourceautoid来源单据子表ID_findCollection find new_orderDetailId from 83e28b84-9080-34dc-a661-7673b7d4932e where code={{refund_no}} skuCode={{refund_order_list.spec_no}} saleReturnMemo.saleReturnDetails.source来源单据类型voucher_order saleReturnMemo.saleReturnDetails.makeRuleCode生单类型编码order_salereturn saleReturnMemo.saleReturnDetails.productId商品{{refund_order_list.spec_no}} saleReturnMemo.saleReturnDetails.skuId商品sku{{refund_order_list.spec_no}} saleReturnMemo.saleReturnDetails.projectId项目 saleReturnMemo.saleReturnDetails.unitExchangeType浮动换算率（销售） saleReturnMemo.saleReturnDetails.unitExchangeTypePrice浮动换算率（计价） saleReturnMemo.saleReturnDetails.taxId税目税率VAT13 saleReturnMemo.saleReturnDetails.stockId仓库{{warehouse_no}} saleReturnMemo.saleReturnDetails.stockOrgId库存组织findCollection find org_code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where code={{warehouse_no}} saleReturnMemo.saleReturnDetails.saleReturnDepartmentId退货部门id saleReturnMemo.saleReturnDetails.iProductAuxUnitId销售单位1463270782005149703 saleReturnMemo.saleReturnDetails.iProductUnitId计价单位1463270782005149703 saleReturnMemo.saleReturnDetails.masterUnitId主计量单位1463270782005149703 saleReturnMemo.saleReturnDetails.orderProductType商品类型SALE saleReturnMemo.saleReturnDetails.bizProductId商家商品id saleReturnMemo.saleReturnDetails.salesOrgId销售组织_findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} saleReturnMemo.saleReturnDetails.enable是否有效状态 saleReturnMemo.saleReturnDetails.orderNo源头订单号 saleReturnMemo.saleReturnDetails.upcode来源单据号{{tid}} saleReturnMemo.saleReturnDetails.modelDescription规格 saleReturnMemo.saleReturnDetails.model型号 saleReturnMemo.saleReturnDetails.specDescription规格描述 saleReturnMemo.saleReturnDetails.invExchRate销售换算率 1 saleReturnMemo.saleReturnDetails.subQty退货销售数量 {{refund_order_list.refund_num}} saleReturnMemo.saleReturnDetails.invPriceExchRate计价换算率 1 saleReturnMemo.saleReturnDetails.priceQty退货计价数量 {{refund_order_list.refund_num}} saleReturnMemo.saleReturnDetails.qty退货数量 {{refund_order_list.refund_num}} saleReturnMemo.saleReturnDetails.batchNo批次 saleReturnMemo.saleReturnDetails.isExpiryDateManage是否有效期管理true saleReturnMemo.saleReturnDetails.productDate生产日期 saleReturnMemo.saleReturnDetails.expireDateNo保质期 saleReturnMemo.saleReturnDetails.expireDateUnit保质期单位 saleReturnMemo.saleReturnDetails.invalidDate有效期至 saleReturnMemo.saleReturnDetails.oriTaxUnitPrice含税成交价 function round(({{refund_order_list.refund_order_amount}}/{{refund_order_list.refund_num}}),6) saleReturnMemo.saleReturnDetails.oriUnitPrice无税单价 _function round(({{refund_order_list.refund_order_amount}}/{{refund_order_list.refund_num}})/1.13,6) saleReturnMemo.saleReturnDetails.oriSum含税金额 {{refund_order_list.refund_order_amount}} saleReturnMemo.saleReturnDetails.oriMoney无税金额 function round({{refund_order_list.refund_order_amount}}/1.13,2) saleReturnMemo.saleReturnDetails.oriTax税额 _function round({{refund_order_list.refund_order_amount}}/1.130.13,2) saleReturnMemo.saleReturnDetails.natTaxUnitPrice本币含税单价 function round(({{refund_order_list.refund_order_amount}}/{{refund_order_list.refund_num}}),6) saleReturnMemo.saleReturnDetails.natUnitPrice本币无税单价 _function round(({{refund_order_list.refund_order_amount}}/{{refund_order_list.refund_num}})/1.13,6) saleReturnMemo.saleReturnDetails.natSum本币含税金额 {{refund_order_list.refund_order_amount}} saleReturnMemo.saleReturnDetails.natMoney本币无税金额 function round({{refund_order_list.refund_order_amount}}/1.13,6) saleReturnMemo.saleReturnDetails.natTax本币税额 _function round({{refund_order_list.refund_order_amount}}/1.13*0.13,2) saleReturnMemo.saleReturnDetails.retNotNeedInvoiceQty退货不开票数量 saleReturnMemo.saleReturnDetails.firstsourceid源头单据id saleReturnMemo.saleReturnDetails.firstsourceautoid源头单据子表id saleReturnMemo.saleReturnDetails.firstsource源头单据类型 saleReturnMemo.saleReturnDetails.firstupcode源头单据号{{refund_no}} saleReturnMemo.saleReturnDetails.orderId销售订单id saleReturnMemo.saleReturnDetails.bodyFreeItem!define1表体备注{{batch_details.remark}} saleReturnMemo.saleReturnDetails._status操作标识, Insert:新增、Update:更新示例：InsertInsert

系统数据集成价值

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。

用友BIP对接外部旺店通·企业奇门系统