用友BIP对接打通轻易云集成平台销售退货列表查询接口与写入空操作接口

汪淼_轻易云

用友BIP对接打通轻易云集成平台销售退货列表查询接口与写入空操作接口

对接系统：用友BIP

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

目标系统:轻易云集成平台

轻易云集成平台，致力于专业的数据集成、数据运营、数据分析服务领域，使繁杂数字化应用从此变得简单、易用，构建万物互联的数字化企业。目前我们已经为86+原厂软件提供了全场景的系统集成能力，为500+客户提供了稳定高效的集成服务，日数据流量超过150万单

系统对接接口配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：用友BIP，源系统 API：销售退货列表查询，目标系统：轻易云集成平台，目标系统 API写入空操作。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

用友BIP接口明细

API：/yonbip/sd/vouchersalereturn/list
NAME：销售退货列表查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 open_createTime_begin制单开始时间制单开始时间 code单据编号单据编号 pageIndex页号默认值：11页号默认值：1 pageSize每页行数默认值：1050每页行数默认值：10 salesOrgId_name销售组织id销售组织id saleReturnStatus单据状态单据状态 saleReturnSourceType退货类型退货类型 orderNo订单编号订单编号 agentId_name客户名称客户名称 open_createTime_end制单结束时间制单结束时间 isSum查询表头示例：false 默认值：false查询表头示例：false 默认值：false simpleVOs查询条件 simpleVOs.field1过滤条件1 simpleVOs.field1.field查询字段createTime simpleVOs.field1.op比较符egt simpleVOs.field1.value1值1{{LAST_SYNC_TIME datetime}}“and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。

响应参数

接口字段字段名称预设值描述 salesOrgId销售组织id销售组织id code单据编号单据编号 orderNo订单号订单号 vouchdate单据日期单据日期 agentId客户id客户id saleDepartmentId销售部门id销售部门id salesOrgId_name销售组织名称销售组织名称 corpContact企业业务员id企业业务员id saleReturnStatus单据状态,SUBMITSALERETURN:待退货审批、CONFIRMSALERETURNORDER:待退货、SALERETURNING:退货中、ENDSALERETURN:已完成、OPPOSESALERETURN:已驳回、单据状态,SUBMITSALERETURN:待退货审批、CONFIRMSALERETURNORDER:待退货、SALERETURNING:退货中、ENDSALERETURN:已完成、OPPOSESALERETURN:已驳回、 agentId_name客户名称客户名称 refundStatus退款状态,NONE:全部未退款、PARTNONECONFIRM:部分退款待审核、PARTNONE:部分退款、CONFIRM:退款待审批、FINISH:已退款、退款状态,NONE:全部未退款、PARTNONECONFIRM:部分退款待审核、PARTNONE:部分退款、CONFIRM:退款待审批、FINISH:已退款、 saleDepartmentId_name销售部门名称销售部门名称 payMoney合计含税金额合计含税金额 creatorId制单人id制单人id corpContactUserName业务员业务员 id主表id主表id currencyCode原币简称原币简称 pubts时间戳字符串时间戳字符串 pubutspubutspubuts currencyName币种币种 logisticWayId物流公司id物流公司id isWfControlled是否受审批流控制是否受审批流控制 verifystate审批状态审批状态 status框架单据状态框架单据状态 currency_priceDigit原币单价精度原币单价精度 currency_moneyDigit原币金额精度原币金额精度 natCurrency_priceDigit本币单价精度本币单价精度 natCurrency_moneyDigit本币金额精度本币金额精度 exchangeRateType汇率类型Id汇率类型Id saleReturnDetailId退货单详情id退货单详情id orderDetailId订单行id订单行id exchRate汇率汇率 orderDetailIdKey订单行idkey订单行idkey natCurrencyCode本币简称本币简称 sourceautoid来源单据行号来源单据行号 productId商品id商品id natCurrencyName本币本币 skuId商品SKUid商品SKUid saleReturnSourceType退货类型,NONE:无来源、DELIVERYEND:销售出库单、退货类型,NONE:无来源、DELIVERYEND:销售出库单、 projectId项目id项目id unitExchangeType浮动（销售）浮动（销售） unitExchangeTypePrice浮动（计价）浮动（计价） bizFlow_version版本信息版本信息 salePrice含税单价含税单价 creator制单人制单人 taxId数目税率id数目税率id createTime创建时间创建时间 stockId仓库ID仓库ID saleReturnDetails_stockOrgId库存组织id库存组织id saleReturnDepartmentId退货部门id退货部门id totalOutStockOriTaxMoney累计出库含税金额累计出库含税金额 totalOutStockOriMoney累计出库无税金额累计出库无税金额 totalOutStockOriTax累计出库税额累计出库税额 isBatchManage是否批次管理,true:是、false:否、是否批次管理,true:是、false:否、 isExpiryDateManage是否有效期管理,true:是、false:否、是否有效期管理,true:是、false:否、 expireDateNo保质期保质期 expireDateUnit保质期单位保质期单位 iProductAuxUnitId销售单位id销售单位id iProductUnitId计价单位id计价单位id masterUnitId主计量单位id主计量单位id purUOM_Precision销售单位精度销售单位精度 priceUOM_Precision计价单位精度计价单位精度 unit_Precision主计量单位精度主计量单位精度 bizId供应商id供应商id bizName供应商名称供应商名称 orderProductType商品类型,SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、商品类型,SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、 groupId分组id分组id bizProductIdbiz商品idbiz商品id enable是否有效状态是否有效状态 createdDate创建日期创建日期 upcode来源单据号来源单据号 productCode商品编码商品编码 productName商品名称商品名称 skuCodeSKU编码SKU编码 skuNameSKU名称SKU名称 specDescription规格描述规格描述 productAuxUnitName销售单位销售单位 invExchRate销售换算率销售换算率 subQty退货销售数量退货销售数量 productUnitName计价单位计价单位 invPriceExchRate计价换算率计价换算率 priceQty退货计价数量退货计价数量 qtyName主计量主计量 qty退货数量退货数量 stockName退货仓库退货仓库 batchNo批次批次 productDate生产日期生产日期 invalidDate有效期至有效期至 projectId_code项目编码项目编码 projectId_name项目名称名称项目名称名称 stockOrgId_name库存组织名称库存组织名称 oriTaxUnitPrice含税成交价含税成交价 oriUnitPrice无税单价无税单价 oriSum含税金额含税金额 oriMoney无税金额无税金额 taxItems税目税目 taxCode税目税率编码税目税率编码 taxRate税率税率 oriTax税额税额 natTaxUnitPrice本币含税单价本币含税单价 natUnitPrice本币无税单价本币无税单价 natSum本币含税金额本币含税金额 natMoney本币无税金额本币无税金额 natTax本币税额本币税额 totalOutStockQuantity累计出库数量累计出库数量 totalOutStockSubQty累计出库件数累计出库件数 invoiceQty累计开票数量累计开票数量 invoiceOriSum累计含税开票金额累计含税开票金额 bmake_voucher_saleinvoice流程开票流程开票 bizFlow流程IDid流程IDid isFlowCoreBill是否流程核心单据是否流程核心单据 transactionTypeId_name交易类型名称交易类型名称 auditDate审批日期审批日期 retailAgentName散户名称散户名称 settlementOrgId_name开票组织名称开票组织名称 taxInclusive单价含税,true:是、false:否、单价含税,true:是、false:否、 saleReturnMemo备注备注 bizFlow_name流程名称名称流程名称名称 modifier修改人修改人 modifyTime修改时间修改时间 auditor审核人审核人 auditTime审核时间审核时间 logisticWayId_name物流公司名称物流公司名称 logisticsBillNo物流单号物流单号 logisticsUserName司机姓名司机姓名 logisticsUserPhone司机电话司机电话 logisticsCarNum车牌号车牌号 receiver收货人收货人 receiveMobile收货人移动电话收货人移动电话 receiveTelePhone收货人固定电话收货人固定电话 receiveAddress收货地址收货地址 receiveZipCode收货人邮编收货人邮编 invoiceAgentId_name开票客户名称开票客户名称 invoiceUpcType发票类型,0:收据、1:增值税专用发票、2:增值税普通发票、3:增值税电子普通发票、4:机动车销售销售统一发票、发票类型,0:收据、1:增值税专用发票、2:增值税普通发票、3:增值税电子普通发票、4:机动车销售销售统一发票、 invoiceTitleType抬头类型,0:企业、1:个人、2:非营利组织、抬头类型,0:企业、1:个人、2:非营利组织、 invoiceTitle发票抬头发票抬头 taxNum纳税识别号纳税识别号 bankName开户银行开户银行 subBankName开户支行开户支行 bankAccount账号账号 invoiceTelephone营业电话营业电话 invoiceAddress营业地址营业地址 totalMoney总金额总金额 totalMoneyOrigTaxfree无税总金额无税总金额 payMoneyOrigTaxfree无税退货金额无税退货金额 totalMoneyDomestic本币总金额本币总金额 payMoneyDomestic本币退货金额本币退货金额 totalMoneyDomesticTaxfree本币无税总金额本币无税总金额 payMoneyDomesticTaxfree本币无税退货金额本币无税退货金额 modelDescription规格规格 model型号型号 new_idnew_idnew_id new_saleReturnDetailIdnew_saleReturnDetailIdnew_saleReturnDetailId

轻易云集成平台接口明细

接口：写入空操作
接口名称：写入空操作
接口方法：POST

系统对接总览

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。