旺店通·企业奇门和用友BIP接口打通对接实战对接源平台:旺店通·企业奇门慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。目标系统:用友BIP 用友BIP助力行业龙头企业、产业链核心企业以及平台型企业建设产业互联网运营平台，通过运营、管理、协同配置和共享资源，实现产业链上下游连接与协同，并保障安全。系统对接接口配置在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用旺店通·企业奇门接口明细接口： wdt.refund.query 接口名称：查询退换管理接口方法： POST 请求参数字段名称类型描述 process_status 退换单处理状态 string 退换单处理状态 5 补款 10已取消 20待审核 30已同意 40已拒绝 50待财审 60待收货 63待推送 64推送失败 65委外待收货 69待收货(已结算) 70部分到货 71部分到货(已结算) 80待结算 90已完成 time_type 时间类型 string 0，最后更新时间，1，结算时间。默认值0 start_time 开始时间 string 按最后修改（结算）时间增量获取数据,start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss end_time 结束时间 string 按最后修改时间（结算）增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss page_size 分页大小 string 每页返回的数据条数，输入值范围1 40，不传本参数，输入值默认为40，使用举例单击这里 shop_no 店铺编号 string 店铺编号 page_no 页号 string 不传值默认从0页开始 refund_no Erp内退换单编号 string Erp内退换单编号，传该字段可以不传时间 src_refund_no 平台原始退换单号 string 平台原始退换单号，传该字段可以不传时间 trade_no 系统订单编号 string 系统订单编号，传该字段可以不传时间 tid 原始单号 string 原始单号，传该字段可以不传时间响应参数字段名称类型描述 modified 最后修改时间 string 最后修改时间格式：yyyy-MM-dd HH:mm:ss refund_id 退换单主键 string 退换单主键 refund_no erp退换单号 string erp退换单号，默认TK开头 finish_time 结算时间 string 旺店通内操作结算的时间格式：yyyy-MM-dd HH:mm:ss customer_no 客户档案编号 string 客户档案编号 api_outer_no API单号 string 接口创建退换单的外部单号 platform_id 平台类型 string 平台类型，响应值为代表平台的ID数字，ID对应的平台名称单击这里 customer_name 收件人姓名 string 收件人姓名（如需唯一值，以receiver_name为准） src_no 平台退款单号 string 平台退款单号 swap_zip 收件人邮编 string 收件人邮编 swap_logistics_type 换货新订单物流公司类别 string 响应值为代表换货新订单物流公司类别的数字，数字对应的物流公司类别名称单击这里 type 类型 string 1退款(未发货，退款申请)2退货3换货4退款不退货5订单补款 process_status 处理状态 string 5补款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 换出原始单id string 换出原始单id warehouse_id 仓库id string 默认为'0'，期望退回的仓库 pay_account 买家支付帐号 string 买家支付帐号 shop_id 店铺id string 店铺id pay_no 支付订单号 string 支付订单号 advance_status 预先状态 string goods_amount 退货金额 string 退货金额 refund_amount 买家申请退款金额 string 买家申请退款金额 is_goods_received 是否收到货品 string 默认为'0'，买家是否收到货 customer_id 客户id string 默认为'0'，客户id direct_refund_amount 线下退款金额 string 订单确认收货之后的退款金额 guarante_refund_amount 平台退款金额 string 平台退款金额 swap_warehouse_id 换出仓库id string 默认为'0'，换出货品出库仓库 actual_refund_amount 实际退款/收款金额 string 实际退款/收款金额 swap_logistics_id 换出物流id string 默认为'0'，换货新订单物流公司ID warehouse_type 仓库类型 string exchange_amount 换货金额 string 换货金额 post_amount 邮费金额 string 邮费金额 wms_status wms状态 string 默认为'0'，外部状态,与wms对接使用0初始化1失败2成功 other_amount 其它金额 string 其它金额 wms_result wms结果 string 默认为''，外部结果,与wms对接使用 wms_outer_no 外部仓库的单号 string 默认为''，对应外部仓库的单号 paid 已退款/已收款 string 已退款/已收款 from_type 建立方式 string 默认为'1'，建立方式1api抓单2手式建单3外部导入4天猫换货5菜鸟回传自动创建 tid 订单的原始单号 string 订单的原始单号 sales_trade_id 系统订单ID string 系统订单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 原始子订单id string 原始子订单编号 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_id erp商品主键 string erp商品主键 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 货位ID string 货位ID，入库时默认ID refund_order_list.sales_trade_id 系统订单ID string 系统订单ID refund_order_list.sales_order_id 销售订单ID string 默认为'0' refund_order_list.goods_id 平台货品ID string 平台货品ID refund_order_list.suite_id 组合装ID string 默认为'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 换出原始单号 string ERP生成的换出订单的原始订单编号用友BIP接口明细调用接口： /yonbip/sd/vouchersalereturn/singleSave 接口名称：销售退货单个保存方法： POST 请求参数字段字段名称类型配置值 resubmitCheckKey 保证请求的幂等性 string {{refund_no}} code 单据编码 string {{refund_no}} salesOrgId 销售组织 string findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} transactionTypeId 交易类型 string 1480261131563434158 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 开票组织 string findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} currency 币种 string CNY exchangeRateType 汇率类型 string 01 natCurrency 本币 string CNY retailAgentName 散户名称 string _findCollection find shop_name from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} saleReturnMemo 备注 object saleReturnMemo.remark 备注 string saleReturnMemo.refundStatus 退货单退款状态 string NONE saleReturnMemo.refundAmount 退款金额 string saleReturnMemo.isWfControlled 是否受审批流控制 string false saleReturnMemo.exchRate 汇率 string 1 saleReturnMemo.taxInclusive 单价含税 string true saleReturnMemo.saleReturnSourceType 退货类型 string NONE saleReturnMemo.bizFlow_name 流程名称 string 销售退货 saleReturnMemo.bizFlow_version 版本信息 string V1.0 saleReturnMemo.logisticWayId 物流公司id string saleReturnMemo.invoiceAgentId 开票客户 string findCollection 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 发票抬头 string 1 saleReturnMemo.taxNum 纳税识别号 string 1 saleReturnMemo.bankName 开户银行 string 银行 saleReturnMemo.subBankName 开户支行 string 银行支行 saleReturnMemo.bankAccount 账号 string 1 saleReturnMemo.invoiceTelephone 营业电话 string 1 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 string e88e9d81-f134-11ec-9896-6c92bf477043 saleReturnMemo.isFlowCoreBill 是否流程核心单据 string saleReturnMemo.headFreeItem!define5 原始单号 string {{tid}} saleReturnMemo._status 操作标识 string Insert saleReturnMemo.saleReturnDetails 退货单详情 array refund_order_list saleReturnMemo.saleReturnDetails.id 表体行ID string saleReturnMemo.saleReturnDetails.orderDetailId 订单行id string saleReturnMemo.saleReturnDetails.orderDetailIdKey 订单行idkey string saleReturnMemo.saleReturnDetails.sourceid 来源单据ID string saleReturnMemo.saleReturnDetails.sourceautoid 来源单据子表ID string saleReturnMemo.saleReturnDetails.source 来源单据类型 string saleReturnMemo.saleReturnDetails.makeRuleCode 生单类型编码 string saleReturnMemo.saleReturnDetails.productId 商品 string {{refund_order_list.refund_order_list_spec_no}} saleReturnMemo.saleReturnDetails.skuId 商品sku string {{refund_order_list.refund_order_list_spec_no}} saleReturnMemo.saleReturnDetails.projectId 项目 string saleReturnMemo.saleReturnDetails.unitExchangeType 浮动换算率（销售） string saleReturnMemo.saleReturnDetails.unitExchangeTypePrice 浮动换算率（计价） string saleReturnMemo.saleReturnDetails.taxId 税目税率 string VAT13 saleReturnMemo.saleReturnDetails.stockId 仓库 string {{warehouse_no}} saleReturnMemo.saleReturnDetails.stockOrgId 库存组织 string findCollection find org_code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where code={{warehouse_no}} saleReturnMemo.saleReturnDetails.saleReturnDepartmentId 退货部门id string saleReturnMemo.saleReturnDetails.iProductAuxUnitId 销售单位 string 1483333416136474627 saleReturnMemo.saleReturnDetails.iProductUnitId 计价单位 string 1483333416136474627 saleReturnMemo.saleReturnDetails.masterUnitId 主计量单位 string 1483333416136474627 saleReturnMemo.saleReturnDetails.orderProductType 商品类型 string SALE saleReturnMemo.saleReturnDetails.bizProductId 商家商品id string 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 销售换算率 string 1 saleReturnMemo.saleReturnDetails.subQty 退货销售数量 string {{refund_order_list.refund_order_list_refund_num}} saleReturnMemo.saleReturnDetails.invPriceExchRate 计价换算率 string 1 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 含税成交价 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.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 含税金额 string function 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 税额 string 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)) 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 本币无税单价 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.natSum 本币含税金额 string _function round({{refund_order_list.refund_order_list_refund_order_amount}},2) saleReturnMemo.saleReturnDetails.natMoney 本币无税金额 string function 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 源头单据id string saleReturnMemo.saleReturnDetails.firstsourceautoid 源头单据子表id string saleReturnMemo.saleReturnDetails.firstsource 源头单据类型 string saleReturnMemo.saleReturnDetails.firstupcode 源头单据号 string {{refund_no}} saleReturnMemo.saleReturnDetails.orderId 销售订单id string 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:更新示例：Insert string Insert 数据对接价值从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

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

关一帆qeasy

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

对接源平台:旺店通·企业奇门

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

目标系统:用友BIP

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

系统对接接口配置

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

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

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

请求参数

字段	名称	类型	描述
process_status	退换单处理状态	string	退换单处理状态 5 补款 10已取消 20待审核 30已同意 40已拒绝 50待财审 60待收货 63待推送 64推送失败 65委外待收货 69待收货(已结算) 70部分到货 71部分到货(已结算) 80待结算 90已完成
time_type	时间类型	string	0，最后更新时间，1，结算时间。默认值0
start_time	开始时间	string	按最后修改（结算）时间增量获取数据,start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time	结束时间	string	按最后修改时间（结算）增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
page_size	分页大小	string	每页返回的数据条数，输入值范围1_{40，不传本参数，输入值默认为40，使用举例单击这里}
shop_no	店铺编号	string	店铺编号
page_no	页号	string	不传值默认从0页开始
refund_no	Erp内退换单编号	string	Erp内退换单编号，传该字段可以不传时间
src_refund_no	平台原始退换单号	string	平台原始退换单号，传该字段可以不传时间
trade_no	系统订单编号	string	系统订单编号，传该字段可以不传时间
tid	原始单号	string	原始单号，传该字段可以不传时间

响应参数

字段	名称	类型	描述
modified	最后修改时间	string	最后修改时间格式：yyyy-MM-dd HH:mm:ss
refund_id	退换单主键	string	退换单主键
refund_no	erp退换单号	string	erp退换单号，默认TK开头
finish_time	结算时间	string	旺店通内操作结算的时间格式：yyyy-MM-dd HH:mm:ss
customer_no	客户档案编号	string	客户档案编号
api_outer_no	API单号	string	接口创建退换单的外部单号
platform_id	平台类型	string	平台类型，响应值为代表平台的ID数字，ID对应的平台名称单击这里
customer_name	收件人姓名	string	收件人姓名（如需唯一值，以receiver_name为准）
src_no	平台退款单号	string	平台退款单号
swap_zip	收件人邮编	string	收件人邮编
swap_logistics_type	换货新订单物流公司类别	string	响应值为代表换货新订单物流公司类别的数字，数字对应的物流公司类别名称单击这里
type	类型	string	1退款(未发货，退款申请)2退货3换货4退款不退货5订单补款
process_status	处理状态	string	5补款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	换出原始单id	string	换出原始单id
warehouse_id	仓库id	string	默认为'0'，期望退回的仓库
pay_account	买家支付帐号	string	买家支付帐号
shop_id	店铺id	string	店铺id
pay_no	支付订单号	string	支付订单号
advance_status	预先状态	string
goods_amount	退货金额	string	退货金额
refund_amount	买家申请退款金额	string	买家申请退款金额
is_goods_received	是否收到货品	string	默认为'0'，买家是否收到货
customer_id	客户id	string	默认为'0'，客户id
direct_refund_amount	线下退款金额	string	订单确认收货之后的退款金额
guarante_refund_amount	平台退款金额	string	平台退款金额
swap_warehouse_id	换出仓库id	string	默认为'0'，换出货品出库仓库
actual_refund_amount	实际退款/收款金额	string	实际退款/收款金额
swap_logistics_id	换出物流id	string	默认为'0'，换货新订单物流公司ID
warehouse_type	仓库类型	string
exchange_amount	换货金额	string	换货金额
post_amount	邮费金额	string	邮费金额
wms_status	wms状态	string	默认为'0'，外部状态,与wms对接使用0初始化1失败2成功
other_amount	其它金额	string	其它金额
wms_result	wms结果	string	默认为''，外部结果,与wms对接使用
wms_outer_no	外部仓库的单号	string	默认为''，对应外部仓库的单号
paid	已退款/已收款	string	已退款/已收款
from_type	建立方式	string	默认为'1'，建立方式1api抓单2手式建单3外部导入4天猫换货5菜鸟回传自动创建
tid	订单的原始单号	string	订单的原始单号
sales_trade_id	系统订单ID	string	系统订单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	原始子订单id	string	原始子订单编号
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_id	erp商品主键	string	erp商品主键
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	货位ID	string	货位ID，入库时默认ID
refund_order_list.sales_trade_id	系统订单ID	string	系统订单ID
refund_order_list.sales_order_id	销售订单ID	string	默认为'0'
refund_order_list.goods_id	平台货品ID	string	平台货品ID
refund_order_list.suite_id	组合装ID	string	默认为'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	换出原始单号	string	ERP生成的换出订单的原始订单编号

用友BIP接口明细

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

请求参数

字段	字段名称	类型	配置值
resubmitCheckKey	保证请求的幂等性	string	{{refund_no}}
code	单据编码	string	{{refund_no}}
salesOrgId	销售组织	string	findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
transactionTypeId	交易类型	string	1480261131563434158
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	开票组织	string	findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
currency	币种	string	CNY
exchangeRateType	汇率类型	string	01
natCurrency	本币	string	CNY
retailAgentName	散户名称	string	_findCollection find shop_name from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}}
saleReturnMemo	备注	object
saleReturnMemo.remark	备注	string
saleReturnMemo.refundStatus	退货单退款状态	string	NONE
saleReturnMemo.refundAmount	退款金额	string
saleReturnMemo.isWfControlled	是否受审批流控制	string	false
saleReturnMemo.exchRate	汇率	string	1
saleReturnMemo.taxInclusive	单价含税	string	true
saleReturnMemo.saleReturnSourceType	退货类型	string	NONE
saleReturnMemo.bizFlow_name	流程名称	string	销售退货
saleReturnMemo.bizFlow_version	版本信息	string	V1.0
saleReturnMemo.logisticWayId	物流公司id	string
saleReturnMemo.invoiceAgentId	开票客户	string	findCollection 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	发票抬头	string	1
saleReturnMemo.taxNum	纳税识别号	string	1
saleReturnMemo.bankName	开户银行	string	银行
saleReturnMemo.subBankName	开户支行	string	银行支行
saleReturnMemo.bankAccount	账号	string	1
saleReturnMemo.invoiceTelephone	营业电话	string	1
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	string	e88e9d81-f134-11ec-9896-6c92bf477043
saleReturnMemo.isFlowCoreBill	是否流程核心单据	string
saleReturnMemo.headFreeItem!define5	原始单号	string	{{tid}}
saleReturnMemo._status	操作标识	string	Insert
saleReturnMemo.saleReturnDetails	退货单详情	array	refund_order_list
saleReturnMemo.saleReturnDetails.id	表体行ID	string
saleReturnMemo.saleReturnDetails.orderDetailId	订单行id	string
saleReturnMemo.saleReturnDetails.orderDetailIdKey	订单行idkey	string
saleReturnMemo.saleReturnDetails.sourceid	来源单据ID	string
saleReturnMemo.saleReturnDetails.sourceautoid	来源单据子表ID	string
saleReturnMemo.saleReturnDetails.source	来源单据类型	string
saleReturnMemo.saleReturnDetails.makeRuleCode	生单类型编码	string
saleReturnMemo.saleReturnDetails.productId	商品	string	{{refund_order_list.refund_order_list_spec_no}}
saleReturnMemo.saleReturnDetails.skuId	商品sku	string	{{refund_order_list.refund_order_list_spec_no}}
saleReturnMemo.saleReturnDetails.projectId	项目	string
saleReturnMemo.saleReturnDetails.unitExchangeType	浮动换算率（销售）	string
saleReturnMemo.saleReturnDetails.unitExchangeTypePrice	浮动换算率（计价）	string
saleReturnMemo.saleReturnDetails.taxId	税目税率	string	VAT13
saleReturnMemo.saleReturnDetails.stockId	仓库	string	{{warehouse_no}}
saleReturnMemo.saleReturnDetails.stockOrgId	库存组织	string	findCollection find org_code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where code={{warehouse_no}}
saleReturnMemo.saleReturnDetails.saleReturnDepartmentId	退货部门id	string
saleReturnMemo.saleReturnDetails.iProductAuxUnitId	销售单位	string	1483333416136474627
saleReturnMemo.saleReturnDetails.iProductUnitId	计价单位	string	1483333416136474627
saleReturnMemo.saleReturnDetails.masterUnitId	主计量单位	string	1483333416136474627
saleReturnMemo.saleReturnDetails.orderProductType	商品类型	string	SALE
saleReturnMemo.saleReturnDetails.bizProductId	商家商品id	string
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	销售换算率	string	1
saleReturnMemo.saleReturnDetails.subQty	退货销售数量	string	{{refund_order_list.refund_order_list_refund_num}}
saleReturnMemo.saleReturnDetails.invPriceExchRate	计价换算率	string	1
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	含税成交价	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.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	含税金额	string	function 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	税额	string	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))
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	本币无税单价	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.natSum	本币含税金额	string	_function round({{refund_order_list.refund_order_list_refund_order_amount}},2)
saleReturnMemo.saleReturnDetails.natMoney	本币无税金额	string	function 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	源头单据id	string
saleReturnMemo.saleReturnDetails.firstsourceautoid	源头单据子表id	string
saleReturnMemo.saleReturnDetails.firstsource	源头单据类型	string
saleReturnMemo.saleReturnDetails.firstupcode	源头单据号	string	{{refund_no}}
saleReturnMemo.saleReturnDetails.orderId	销售订单id	string
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:更新示例：Insert	string	Insert

数据对接价值

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。