用友BIP和旺店通·企业奇门单据接口集成

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

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

接入系统：用友BIP

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

数据集成方案配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：旺店通·企业奇门的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：用友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保证请求的幂等性{{random}} code单据编码{{refund_no}} salesOrgId销售组织findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} transactionTypeId交易类型RET0010 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备注{{remark}} saleReturnMemo.refundStatus退货单退款状态NONE saleReturnMemo.refundAmount退款金额 {{goods_amount}} saleReturnMemo.isWfControlled是否受审批流控制 false saleReturnMemo.exchRate汇率 1 saleReturnMemo.taxInclusive单价含税true saleReturnMemo.saleReturnStatus单据状态 saleReturnMemo.saleReturnSourceType退货类型NONE saleReturnMemo.bizFlow_name流程名称 saleReturnMemo.bizFlow_version版本信息 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发票抬头 saleReturnMemo.taxNum纳税识别号 saleReturnMemo.bankName开户银行 saleReturnMemo.subBankName开户支行 saleReturnMemo.bankAccount账号 saleReturnMemo.invoiceTelephone营业电话 saleReturnMemo.invoiceAddress营业地址 saleReturnMemo.totalMoney总金额 saleReturnMemo.payMoney退货金额{{actual_refund_amount}} saleReturnMemo.totalMoneyOrigTaxfree无税总金额 saleReturnMemo.payMoneyOrigTaxfree无税退货金额 saleReturnMemo.totalOriTax税额 saleReturnMemo.totalMoneyDomestic本币总金额 saleReturnMemo.payMoneyDomestic本币退货金额 saleReturnMemo.totalMoneyDomesticTaxfree本币无税总金额 saleReturnMemo.payMoneyDomesticTaxfree本币无税退货金额 saleReturnMemo.totalNatTax本币税额 saleReturnMemo.bizFlow流程ID 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批次 {{batch_details.batch_no}} saleReturnMemo.saleReturnDetails.isExpiryDateManage是否有效期管理true saleReturnMemo.saleReturnDetails.productDate生产日期 saleReturnMemo.saleReturnDetails.expireDateNo保质期 saleReturnMemo.saleReturnDetails.expireDateUnit保质期单位 saleReturnMemo.saleReturnDetails.invalidDate有效期至 saleReturnMemo.saleReturnDetails.oriTaxUnitPrice含税成交价 {{refund_order_list.cost_price}} saleReturnMemo.saleReturnDetails.oriUnitPrice无税单价 {{refund_order_list.price}} saleReturnMemo.saleReturnDetails.oriSum含税金额 {{refund_order_list.refund_order_amount}} saleReturnMemo.saleReturnDetails.oriMoney无税金额 {{refund_order_list.refund_order_amount}} saleReturnMemo.saleReturnDetails.oriTax税额 function {{refund_order_list.refund_order_amount}}/1.130.13 saleReturnMemo.saleReturnDetails.natTaxUnitPrice本币含税单价 1 saleReturnMemo.saleReturnDetails.natUnitPrice本币无税单价 {{refund_order_list.price}} saleReturnMemo.saleReturnDetails.natSum本币含税金额 {{refund_order_list.refund_order_amount}} saleReturnMemo.saleReturnDetails.natMoney本币无税金额 {{refund_order_list.refund_order_amount}} saleReturnMemo.saleReturnDetails.natTax本币税额 _function {{refund_order_list.refund_order_amount}}/1.13*0.13 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._status操作标识, Insert:新增、Update:更新示例：InsertInsert

系统打通概况

通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接旺店通·企业奇门和用友BIP，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。

用友BIP和旺店通·企业奇门单据接口集成