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

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

旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算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接口明细

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

请求参数

接口字段字段名称预设值描述 resubmitCheckKey保证请求的幂等性{{refund_no}}保证请求的幂等性,该值由客户端生成,并且必须是全局唯一的，长度不能超过32位。更多信息,请参见«MDD幂等性» code单据编码{{refund_no}}单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传示例："S0T5-0000000000-20210831-000000" salesOrgId销售组织findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}销售组织，传id或者code 示例：2163951720681984 transactionTypeId交易类型1480261131563434158交易类型，传id或者code 示例：2155547426656517 agentId客户_findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}客户，传id或者code 示例：2251598175195392 retailInvestors是否散户是否散户, true:是、false:否、示例：false headFreeItem!define2销售类型{{remark}} saleDepartmentId销售部门销售部门，传id或者code 示例："2163953113665792" vouchdate单据日期 {{modified}}单据日期示例："2021-08-31 00:00:00" corpContact销售业务员销售业务员示例："2163960865427712" settlementOrgId开票组织findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}开票组织，传id或者code 示例："2163951720681984" currency币种CNY币种，传id或者code 示例："2155547424560384" exchangeRateType汇率类型01汇率类型，传id或者code 示例："csrka3z7" natCurrency本币CNY本币，传id或者code 示例："2155547424560384" retailAgentName散户名称 _findCollection find shop_name from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}散户名称示例："散户2" saleReturnMemo备注备注 saleReturnMemo.remark备注备注示例："销售退货" saleReturnMemo.refundStatus退货单退款状态NONE退货单退款状态，由系统业务自动生成，接口无需传值。示例："NONE" saleReturnMemo.refundAmount退款金额退款金额示例：1 saleReturnMemo.isWfControlled是否受审批流控制 false是否受审批流控制示例：false saleReturnMemo.exchRate汇率 1汇率示例：1 saleReturnMemo.taxInclusive单价含税true单价含税, true:是、false:否、示例：true saleReturnMemo.saleReturnSourceType退货类型NONE退货类型, NONE:无来源、DELIVERYEND:销售出库单、ORDER:销售订单示例："DELIVERYEND" saleReturnMemo.bizFlow_name流程名称销售退货流程名称示例："001" saleReturnMemo.bizFlow_version版本信息 V1.0版本信息示例："版本1" saleReturnMemo.logisticWayId物流公司id 物流公司id 示例：321321 saleReturnMemo.invoiceAgentId开票客户findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}开票客户，传id或者code 示例：2216247878177024 saleReturnMemo.realMoney应付金额应付金额，等于表头的退货金额示例：100 saleReturnMemo.modifyInvoiceType发票类型是否可改发票类型是否可改, true:是、false:否、示例：true saleReturnMemo.logisticsBillNo物流单号物流单号示例："4321" saleReturnMemo.logisticsUserName司机姓名司机姓名示例："王一" saleReturnMemo.logisticsUserPhone司机电话司机电话示例："18888888888" saleReturnMemo.logisticsCarNum车牌号车牌号示例："京A-ax245" saleReturnMemo.receiver收货人收货人示例："王二" saleReturnMemo.receiveMobile收货人移动电话收货人移动电话示例："010-12345678" saleReturnMemo.receiveTelePhone收货人固定电话收货人固定电话示例："1555555555" saleReturnMemo.receiveAddress收货地址收货地址示例："北京市海淀区" saleReturnMemo.receiveZipCode收货人邮编收货人邮编示例："011" saleReturnMemo.bdInvoiceTypeId发票类型0:收据,1:增值税电子普通发票,2:增值税电子专用发票,3:增值税普通发票,4:增值税专用发票,5:机动车销售统一发票,8:增值税电子普通发票（成品油）,10:增值税普通发票（成品油）,11:增值税专用发票（成品油）,e0:电子收购发票示例：0 saleReturnMemo.invoiceUpcType发票类型发票类型, 0:收据、1:增值税专用发票、2:增值税普通发票、3:增值税电子普通发票、4:机动车销售销售统一发票、示例：0 saleReturnMemo.invoiceTitleType抬头类型抬头类型, 0:企业、1:个人、2:非营利组织、示例：0 saleReturnMemo.invoiceTitle发票抬头 1发票抬头示例："中央大客户工信部" saleReturnMemo.taxNum纳税识别号 1纳税识别号示例："SH999000999" saleReturnMemo.bankName开户银行银行开户银行示例："中国工商银行" saleReturnMemo.subBankName开户支行银行支行开户支行示例："中国工商银行股份有限公司天津中北支行" saleReturnMemo.bankAccount账号 1账号示例："888888888888888" saleReturnMemo.invoiceTelephone营业电话 1营业电话示例："012-9998893" saleReturnMemo.invoiceAddress营业地址地址营业地址示例："北京市海淀区" saleReturnMemo.totalMoney总金额总金额示例：43214 saleReturnMemo.payMoney退货金额{{actual_refund_amount}}退货金额，需等于表体含税金额的合计示例：312 saleReturnMemo.totalMoneyOrigTaxfree无税总金额无税总金额示例：321 saleReturnMemo.payMoneyOrigTaxfree无税退货金额无税退货金额示例：321 saleReturnMemo.totalOriTax税额税额示例：3 saleReturnMemo.totalMoneyDomestic本币总金额本币总金额示例：643256 saleReturnMemo.payMoneyDomestic本币退货金额本币退货金额示例：5432 saleReturnMemo.totalMoneyDomesticTaxfree本币无税总金额本币无税总金额示例：5432 saleReturnMemo.payMoneyDomesticTaxfree本币无税退货金额本币无税退货金额示例：5432 saleReturnMemo.totalNatTax本币税额本币税额示例：5421 saleReturnMemo.bizFlow流程ID e88e9d81-f134-11ec-9896-6c92bf477043流程ID 示例：213 saleReturnMemo.isFlowCoreBill是否流程核心单据是否流程核心单据示例：true saleReturnMemo.headFreeItem!define5原始单号{{tid}}原始单号 saleReturnMemo._status操作标识Insert操作标识, Insert:新增、Update:更新示例："Insert" saleReturnMemo.saleReturnDetails退货单详情refund_order_list退货单详情[voucher.salereturn.SaleReturnDetail] saleReturnMemo.saleReturnDetails.id表体行ID表体行ID 新增时无需填写，修改时必填示例：4312432 saleReturnMemo.saleReturnDetails.orderDetailId订单行id订单行id，有来源必填示例：2403153858154753 saleReturnMemo.saleReturnDetails.orderDetailIdKey订单行idkey 订单行idkey 示例："6425432" saleReturnMemo.saleReturnDetails.sourceid来源单据ID来源单据ID，有来源必填示例：2403160486547968 saleReturnMemo.saleReturnDetails.sourceautoid来源单据子表ID来源单据子表ID，有来源必填示例：2403160486547970 saleReturnMemo.saleReturnDetails.source来源单据类型来源单据类型（1.ustock.st_salesout销售出库 2.voucher_order 销售订单）有来源必填示例："ustock.st_salesout" saleReturnMemo.saleReturnDetails.makeRuleCode生单类型编码生单类型编码（1.salesoutTosalereturn 由销售出库生单，2.order_salereturn:由销售订单生单），有来源必填示例："salesoutTosalereturn" saleReturnMemo.saleReturnDetails.productId商品{{refund_order_list.refund_order_list_spec_no}}商品，传id或者code 示例：2320711092457728 saleReturnMemo.saleReturnDetails.skuId商品sku{{refund_order_list.refund_order_list_spec_no}}商品sku，传id或者code 示例：2313763385315584 saleReturnMemo.saleReturnDetails.projectId项目项目，传id或者code 示例："123124312" saleReturnMemo.saleReturnDetails.unitExchangeType浮动换算率（销售）浮动换算率（销售）示例：0 saleReturnMemo.saleReturnDetails.unitExchangeTypePrice浮动换算率（计价）浮动换算率（计价）示例：0 saleReturnMemo.saleReturnDetails.taxId税目税率VAT13税目税率，传id或者code 示例："2155547427149061" saleReturnMemo.saleReturnDetails.stockId仓库{{warehouse_no}}仓库，传id或者code 示例：2192242573644032 saleReturnMemo.saleReturnDetails.stockOrgId库存组织findCollection find org_code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where code={{warehouse_no}}库存组织，传id或者code 示例："2163951720681984" saleReturnMemo.saleReturnDetails.saleReturnDepartmentId退货部门id 退货部门id 示例："14321" saleReturnMemo.saleReturnDetails.iProductAuxUnitId销售单位1483333416136474627销售单位，传id或者code 示例：2263072523178240 saleReturnMemo.saleReturnDetails.iProductUnitId计价单位1483333416136474627计价单位，传id或者code 示例：2312582309908736 saleReturnMemo.saleReturnDetails.masterUnitId主计量单位1483333416136474627主计量单位，传id或者code 示例：2261943548399872 saleReturnMemo.saleReturnDetails.orderProductType商品类型SALE商品类型, SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、示例："SALE" saleReturnMemo.saleReturnDetails.bizProductId商家商品id商家商品id 示例：31243141 saleReturnMemo.saleReturnDetails.salesOrgId销售组织_findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}销售组织，传id或者code 示例：6425432 saleReturnMemo.saleReturnDetails.enable是否有效状态是否有效状态示例：true saleReturnMemo.saleReturnDetails.orderNo源头订单号源头订单号，有来源必填示例："QbOJ-000000000-20210825-000017" saleReturnMemo.saleReturnDetails.upcode来源单据号来源单据号示例："XSCK20210825000005" saleReturnMemo.saleReturnDetails.modelDescription规格规格示例："规格01" saleReturnMemo.saleReturnDetails.model型号型号示例："001" saleReturnMemo.saleReturnDetails.specDescription规格描述规格描述示例："规格" saleReturnMemo.saleReturnDetails.invExchRate销售换算率 1销售换算率示例：1 saleReturnMemo.saleReturnDetails.subQty退货销售数量 {{refund_order_list.refund_order_list_refund_num}}退货销售数量示例：100 saleReturnMemo.saleReturnDetails.invPriceExchRate计价换算率 1计价换算率示例：1 saleReturnMemo.saleReturnDetails.priceQty退货计价数量 {{refund_order_list.refund_order_list_refund_num}}退货计价数量示例：100 saleReturnMemo.saleReturnDetails.qty退货数量 {{refund_order_list.refund_order_list_refund_num}}退货数量示例：1 saleReturnMemo.saleReturnDetails.batchNo批次批次示例：2 saleReturnMemo.saleReturnDetails.isExpiryDateManage是否有效期管理是否有效期管理, true:是、false:否、示例：false saleReturnMemo.saleReturnDetails.productDate生产日期生产日期示例：2021-08-31 00:00:00 saleReturnMemo.saleReturnDetails.expireDateNo保质期保质期示例：3 saleReturnMemo.saleReturnDetails.expireDateUnit保质期单位保质期单位, 1:年、2:月、6:天、示例：1 saleReturnMemo.saleReturnDetails.invalidDate有效期至有效期至示例：2021-08-31 00:00:00 saleReturnMemo.saleReturnDetails.oriTaxUnitPrice含税成交价 function round((round({{refund_order_list.refund_order_list_refund_order_amount}},2)/{{refund_order_list.refund_order_list_refund_num}}),2)含税成交价示例：500 saleReturnMemo.saleReturnDetails.oriUnitPrice无税单价 _function round((round({{refund_order_list.refund_order_list_refund_order_amount}},2)/{{refund_order_list.refund_order_list_refund_num}})/1.13,2)无税单价示例：500 saleReturnMemo.saleReturnDetails.oriSum含税金额 function round({{refund_order_list.refund_order_list_refund_order_amount}},2)含税金额示例：500 saleReturnMemo.saleReturnDetails.oriMoney无税金额 _function round(round({{refund_order_list.refund_order_list_refund_order_amount}},2)/1.13,2)无税金额示例：500 saleReturnMemo.saleReturnDetails.oriTax税额 function 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))税额示例：0.0 saleReturnMemo.saleReturnDetails.natTaxUnitPrice本币含税单价 _function round((round({{refund_order_list.refund_order_list_refund_order_amount}},2)/{{refund_order_list.refund_order_list_refund_num}}),2)本币含税单价示例：500 saleReturnMemo.saleReturnDetails.natUnitPrice本币无税单价 function round((round({{refund_order_list.refund_order_list_refund_order_amount}},2)/{{refund_order_list.refund_order_list_refund_num}})/1.13,2)本币无税单价示例：500 saleReturnMemo.saleReturnDetails.natSum本币含税金额 _function round({{refund_order_list.refund_order_list_refund_order_amount}},2)本币含税金额示例：500 saleReturnMemo.saleReturnDetails.natMoney本币无税金额 function round(round({{refund_order_list.refund_order_list_refund_order_amount}},2)/1.13,2)本币无税金额示例：500 saleReturnMemo.saleReturnDetails.natTax本币税额 _function round(round({{refund_order_list.refund_order_list_refund_order_amount}},2)/1.13*0.13,2)本币税额示例：500 saleReturnMemo.saleReturnDetails.retNotNeedInvoiceQty退货不开票数量退货不开票数量示例：100 saleReturnMemo.saleReturnDetails.firstsourceid源头单据id源头单据id，有来源必填示例：2403063657222400 saleReturnMemo.saleReturnDetails.firstsourceautoid源头单据子表id源头单据子表id，有来源必填示例：2403063657238784 saleReturnMemo.saleReturnDetails.firstsource源头单据类型源头单据类型（udinghuo.voucher_order），有来源必填示例：udinghuo.voucher_order saleReturnMemo.saleReturnDetails.firstupcode源头单据号{{refund_no}}源头单据号，有来源必填示例：QbOJ-000000000-20210825-000014 saleReturnMemo.saleReturnDetails.orderId销售订单id销售订单id，有来源必填示例：QbOJ-000000000-20210825-000014 saleReturnMemo.saleReturnDetails.bodyFreeItem!define1表体备注{{refund_order_list.refund_order_list_remark}}销售订单id，有来源必填示例：QbOJ-000000000-20210825-000014 saleReturnMemo.saleReturnDetails.bodyFreeItem!define3子订单号{{refund_order_list.refund_order_list_oid}}销售订单id，有来源必填示例：QbOJ-000000000-20210825-000014 saleReturnMemo.saleReturnDetails.bodyFreeItem!define4原始订单{{refund_order_list.refund_order_list_tid}}销售订单id，有来源必填示例：QbOJ-000000000-20210825-000014 saleReturnMemo.saleReturnDetails.bodyFreeItem!define5旺店通行内码{{refund_order_list.refund_order_list_order_id}}销售订单id，有来源必填示例：QbOJ-000000000-20210825-000014 saleReturnMemo.saleReturnDetails._status操作标识, Insert:新增、Update:更新示例：InsertInsert操作标识, Insert:新增、Update:更新示例：Insert

系统对接概况

全面支持数据集成操作可视化、拖拽流式开发，无代码完成多套异构系统集成，降低使用门槛，提升交付速度。特别是在面向旺店通·企业奇门、用友BIP间API接口集成时，通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理，帮助企业洞察运营状况，进一步优化流程，提高企业商业价值。基于Web图形界面，通过拖拽、连接、配置完成流程设计，数据整合和集成，高效打通业务系统，通过面向运营的统计报表，直观查看API各项指标，实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理，将业务以API的方式对外开放，实现业务创新、能力输出。

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