旺店通·企业奇门与用友BIP对接集成查询退换管理连通销售退货单个保存(退换货生成销售退货(线下)-v)

汪淼_轻易云

旺店通·企业奇门与用友BIP对接集成查询退换管理连通销售退货单个保存(退换货生成销售退货(线下)-v)

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

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

写入目标:用友BIP

YonBIP用友商业创新平台，是用友在数字经济时代面向成长型、大型企业及巨型企业，融合了先进且高可用技术平台和公共与关键商业应用与服务，支撑和运行客户的商业创新（业务创新、管理变革），并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。

接口方案配置

数据集成平台对应的配置旺店通·企业奇门与用友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接口明细

调用接口：/yonbip/sd/vouchersalereturn/singleSave
接口名称：销售退货单个保存
方法：POST

请求参数

字段字段名称类型配置值 resubmitCheckKey保证请求的幂等性string{{refund_no}} code单据编码string{{refund_no}} salesOrgId销售组织stringfindCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} transactionTypeId交易类型string1480261131563434158 agentId客户string_findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} retailInvestors是否散户string headFreeItem!define2销售类型string{{remark}} saleDepartmentId销售部门string vouchdate单据日期 string{{modified}} corpContact销售业务员 string settlementOrgId开票组织stringfindCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} currency币种stringCNY exchangeRateType汇率类型string01 natCurrency本币stringCNY retailAgentName散户名称 string_findCollection find shop_name from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} saleReturnMemo备注object saleReturnMemo.remark备注string saleReturnMemo.refundStatus退货单退款状态stringNONE saleReturnMemo.refundAmount退款金额 string saleReturnMemo.isWfControlled是否受审批流控制 stringfalse saleReturnMemo.exchRate汇率 string1 saleReturnMemo.taxInclusive单价含税stringtrue saleReturnMemo.saleReturnSourceType退货类型stringNONE saleReturnMemo.bizFlow_name流程名称string销售退货 saleReturnMemo.bizFlow_version版本信息 stringV1.0 saleReturnMemo.logisticWayId物流公司id string saleReturnMemo.invoiceAgentId开票客户stringfindCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} saleReturnMemo.realMoney应付金额string saleReturnMemo.modifyInvoiceType发票类型是否可改string saleReturnMemo.logisticsBillNo物流单号string saleReturnMemo.logisticsUserName司机姓名 string saleReturnMemo.logisticsUserPhone司机电话 string saleReturnMemo.logisticsCarNum车牌号 string saleReturnMemo.receiver收货人 string saleReturnMemo.receiveMobile收货人移动电话 string saleReturnMemo.receiveTelePhone收货人固定电话 string saleReturnMemo.receiveAddress收货地址 string saleReturnMemo.receiveZipCode收货人邮编 string saleReturnMemo.bdInvoiceTypeId发票类型string saleReturnMemo.invoiceUpcType发票类型string saleReturnMemo.invoiceTitleType抬头类型string saleReturnMemo.invoiceTitle发票抬头 string1 saleReturnMemo.taxNum纳税识别号 string1 saleReturnMemo.bankName开户银行 string银行 saleReturnMemo.subBankName开户支行 string银行支行 saleReturnMemo.bankAccount账号 string1 saleReturnMemo.invoiceTelephone营业电话 string1 saleReturnMemo.invoiceAddress营业地址 string地址 saleReturnMemo.totalMoney总金额 string saleReturnMemo.payMoney退货金额string{{actual_refund_amount}} saleReturnMemo.totalMoneyOrigTaxfree无税总金额 string saleReturnMemo.payMoneyOrigTaxfree无税退货金额 string saleReturnMemo.totalOriTax税额 string saleReturnMemo.totalMoneyDomestic本币总金额 string saleReturnMemo.payMoneyDomestic本币退货金额 string saleReturnMemo.totalMoneyDomesticTaxfree本币无税总金额 string saleReturnMemo.payMoneyDomesticTaxfree本币无税退货金额 string saleReturnMemo.totalNatTax本币税额 string saleReturnMemo.bizFlow流程ID stringe88e9d81-f134-11ec-9896-6c92bf477043 saleReturnMemo.isFlowCoreBill是否流程核心单据 string saleReturnMemo.headFreeItem!define5原始单号string{{tid}} saleReturnMemo._status操作标识stringInsert saleReturnMemo.saleReturnDetails退货单详情arrayrefund_order_list saleReturnMemo.saleReturnDetails.id表体行IDstring saleReturnMemo.saleReturnDetails.orderDetailId订单行idstring saleReturnMemo.saleReturnDetails.orderDetailIdKey订单行idkey string saleReturnMemo.saleReturnDetails.sourceid来源单据IDstring saleReturnMemo.saleReturnDetails.sourceautoid来源单据子表IDstring saleReturnMemo.saleReturnDetails.source来源单据类型string saleReturnMemo.saleReturnDetails.makeRuleCode生单类型编码string saleReturnMemo.saleReturnDetails.productId商品string{{refund_order_list.refund_order_list_spec_no}} saleReturnMemo.saleReturnDetails.skuId商品skustring{{refund_order_list.refund_order_list_spec_no}} saleReturnMemo.saleReturnDetails.projectId项目string saleReturnMemo.saleReturnDetails.unitExchangeType浮动换算率（销售） string saleReturnMemo.saleReturnDetails.unitExchangeTypePrice浮动换算率（计价）string saleReturnMemo.saleReturnDetails.taxId税目税率stringVAT13 saleReturnMemo.saleReturnDetails.stockId仓库string{{warehouse_no}} saleReturnMemo.saleReturnDetails.stockOrgId库存组织stringfindCollection find org_code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where code={{warehouse_no}} saleReturnMemo.saleReturnDetails.saleReturnDepartmentId退货部门id string saleReturnMemo.saleReturnDetails.iProductAuxUnitId销售单位string1483333416136474627 saleReturnMemo.saleReturnDetails.iProductUnitId计价单位string1483333416136474627 saleReturnMemo.saleReturnDetails.masterUnitId主计量单位string1483333416136474627 saleReturnMemo.saleReturnDetails.orderProductType商品类型stringSALE saleReturnMemo.saleReturnDetails.bizProductId商家商品idstring saleReturnMemo.saleReturnDetails.salesOrgId销售组织string_findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} saleReturnMemo.saleReturnDetails.enable是否有效状态 string saleReturnMemo.saleReturnDetails.orderNo源头订单号string saleReturnMemo.saleReturnDetails.upcode来源单据号string saleReturnMemo.saleReturnDetails.modelDescription规格 string saleReturnMemo.saleReturnDetails.model型号 string saleReturnMemo.saleReturnDetails.specDescription规格描述 string saleReturnMemo.saleReturnDetails.invExchRate销售换算率 string1 saleReturnMemo.saleReturnDetails.subQty退货销售数量 string{{refund_order_list.refund_order_list_refund_num}} saleReturnMemo.saleReturnDetails.invPriceExchRate计价换算率 string1 saleReturnMemo.saleReturnDetails.priceQty退货计价数量 string{{refund_order_list.refund_order_list_refund_num}} saleReturnMemo.saleReturnDetails.qty退货数量 string{{refund_order_list.refund_order_list_refund_num}} saleReturnMemo.saleReturnDetails.batchNo批次 string saleReturnMemo.saleReturnDetails.isExpiryDateManage是否有效期管理string saleReturnMemo.saleReturnDetails.productDate生产日期 string saleReturnMemo.saleReturnDetails.expireDateNo保质期 string saleReturnMemo.saleReturnDetails.expireDateUnit保质期单位string saleReturnMemo.saleReturnDetails.invalidDate有效期至 string saleReturnMemo.saleReturnDetails.oriTaxUnitPrice含税成交价 stringfunction round((round({{refund_order_list.refund_order_list_refund_order_amount}},2)/{{refund_order_list.refund_order_list_refund_num}}),2) saleReturnMemo.saleReturnDetails.oriUnitPrice无税单价 string_function round((round({{refund_order_list.refund_order_list_refund_order_amount}},2)/{{refund_order_list.refund_order_list_refund_num}})/1.13,2) saleReturnMemo.saleReturnDetails.oriSum含税金额 stringfunction round({{refund_order_list.refund_order_list_refund_order_amount}},2) saleReturnMemo.saleReturnDetails.oriMoney无税金额 string_function round(round({{refund_order_list.refund_order_list_refund_order_amount}},2)/1.13,2) saleReturnMemo.saleReturnDetails.oriTax税额 stringfunction abs(round(round({{refund_order_list.refund_order_list_refund_order_amount}},2)/1.13,2)-round({{refund_order_list.refund_order_list_refund_order_amount}},2)) saleReturnMemo.saleReturnDetails.natTaxUnitPrice本币含税单价 string_function round((round({{refund_order_list.refund_order_list_refund_order_amount}},2)/{{refund_order_list.refund_order_list_refund_num}}),2) saleReturnMemo.saleReturnDetails.natUnitPrice本币无税单价 stringfunction round((round({{refund_order_list.refund_order_list_refund_order_amount}},2)/{{refund_order_list.refund_order_list_refund_num}})/1.13,2) saleReturnMemo.saleReturnDetails.natSum本币含税金额 string_function round({{refund_order_list.refund_order_list_refund_order_amount}},2) saleReturnMemo.saleReturnDetails.natMoney本币无税金额 stringfunction round(round({{refund_order_list.refund_order_list_refund_order_amount}},2)/1.13,2) saleReturnMemo.saleReturnDetails.natTax本币税额 string_function round(round({{refund_order_list.refund_order_list_refund_order_amount}},2)/1.13*0.13,2) saleReturnMemo.saleReturnDetails.retNotNeedInvoiceQty退货不开票数量 string saleReturnMemo.saleReturnDetails.firstsourceid源头单据idstring saleReturnMemo.saleReturnDetails.firstsourceautoid源头单据子表idstring saleReturnMemo.saleReturnDetails.firstsource源头单据类型string saleReturnMemo.saleReturnDetails.firstupcode源头单据号string{{refund_no}} saleReturnMemo.saleReturnDetails.orderId销售订单idstring saleReturnMemo.saleReturnDetails.bodyFreeItem!define1表体备注string{{refund_order_list.refund_order_list_remark}} saleReturnMemo.saleReturnDetails.bodyFreeItem!define3子订单号string{{refund_order_list.refund_order_list_oid}} saleReturnMemo.saleReturnDetails.bodyFreeItem!define4原始订单string{{refund_order_list.refund_order_list_tid}} saleReturnMemo.saleReturnDetails.bodyFreeItem!define5旺店通行内码string{{refund_order_list.refund_order_list_order_id}} saleReturnMemo.saleReturnDetails._status操作标识, Insert:新增、Update:更新示例：InsertstringInsert

系统集成总览

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