用友BIP对接打通轻易云集成平台销售退货列表查询接口与写入空操作接口
对接系统：用友BIP
YonBIP用友商业创新平台，是用友在数字经济时代面向成长型、大型企业及巨型企业，融合了先进且高可用技术平台和公共与关键商业应用与服务，支撑和运行客户的商业创新（业务创新、管理变革），并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。
对接目标平台:轻易云集成平台
从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成
数据接口配置
在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用
用友BIP接口明细
- API：/yonbip/sd/vouchersalereturn/list
- NAME：销售退货列表查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| open_createTime_begin | 制单开始时间 | | 制单开始时间 |
| code | 单据编号 | | 单据编号 |
| pageIndex | 页号 默认值：1 | 1 | 页号 默认值：1 |
| pageSize | 每页行数 默认值：10 | 50 | 每页行数 默认值：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 | 时间戳字符串 | | 时间戳字符串 |
| pubuts | pubuts | | pubuts |
| 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 |
| bizProductId | biz商品id | | biz商品id |
| enable | 是否有效状态 | | 是否有效状态 |
| createdDate | 创建日期 | | 创建日期 |
| upcode | 来源单据号 | | 来源单据号 |
| productCode | 商品编码 | | 商品编码 |
| productName | 商品名称 | | 商品名称 |
| skuCode | SKU编码 | | SKU编码 |
| skuName | SKU名称 | | 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_id | new_id | | new_id |
| new_saleReturnDetailId | new_saleReturnDetailId | | new_saleReturnDetailId |
轻易云集成平台接口明细
- API：写入空操作
- NAME：写入空操作
- METHOD：POST
系统数据集成价值
全面支持数据集成操作可视化、拖拽流式开发，无代码完成多套异构系统集成，降低使用门槛，提升交付速度。特别是在面向用友BIP、轻易云集成平台间API接口集成时，通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理，帮助企业洞察运营状况，进一步优化流程，提高企业商业价值。基于Web图形界面，通过拖拽、连接、配置完成流程设计，数据整合和集成，高效打通业务系统，通过面向运营的统计报表，直观查看API各项指标，实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理，将业务以API的方式对外开放，实现业务创新、能力输出。
