用友BIP对接打通用友BIP销售退货列表查询接口与销售退货审核接口对接源平台:用友BIP 用友BIP助力行业龙头企业、产业链核心企业以及平台型企业建设产业互联网运营平台，通过运营、管理、协同配置和共享资源，实现产业链上下游连接与协同，并保障安全。目标系统:用友BIP YonBIP用友商业创新平台，是用友在数字经济时代面向成长型、大型企业及巨型企业，融合了先进且高可用技术平台和公共与关键商业应用与服务，支撑和运行客户的商业创新（业务创新、管理变革），并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。数据接口配置通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：用友BIP接口：销售退货列表查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：用友BIP接口：销售退货审核，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：用友BIP写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况用友BIP接口明细 API： /yonbip/sd/vouchersalereturn/list NAME：销售退货列表查询 METHOD： POST 请求参数接口字段字段名称预设值描述 open_createTime_begin 制单开始时间制单开始时间 code 单据编号单据编号 pageIndex 页号默认值：1 1 页号默认值：1 pageSize 每页行数默认值：10 1 每页行数默认值：10 salesOrgId_name 销售组织id 销售组织id saleReturnStatus 单据状态 SALERETURNING 单据状态 saleReturnSourceType 退货类型退货类型 orderNo 订单编号订单编号 agentId_name 客户名称客户名称 open_createTime_end 制单结束时间制单结束时间 isSum 查询表头示例：false 默认值：false 查询表头示例：false 默认值：false simpleVOs 查询条件 simpleVOs.field1 过滤条件1 simpleVOs.field1.field 查询字段 pubts simpleVOs.field1.op 比较符 egt simpleVOs.field1.value1 值1 {{LAST_SYNC_TIME datetime}} “and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。 simpleVOs.field1.field2 过滤条件2 simpleVOs.field1.field2.field 查询字段 vouchdate simpleVOs.field1.field2.op 比较符 egt simpleVOs.field1.field2.value1 值1 2022-08-01 “and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。 simpleVOs.field1.field2.field3 过滤条件3 simpleVOs.field1.field2.field3.field 查询字段 code simpleVOs.field1.field2.field3.op 比较符 like simpleVOs.field1.field2.field3.value1 值1 TK “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 型号型号用友BIP接口明细调用接口： /yonbip/sd/vouchersalereturn/audit 接口名称：销售退货审核方法： POST 请求参数字段字段名称类型配置值 id 单据主表id string {{new_id}} 系统打通概况通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接用友BIP和用友BIP，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。

用友BIP对接打通用友BIP销售退货列表查询接口与销售退货审核接口

庄颜_qeasy

用友BIP对接打通用友BIP销售退货列表查询接口与销售退货审核接口

对接源平台:用友BIP

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

目标系统:用友BIP

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

数据接口配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：用友BIP接口：销售退货列表查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：用友BIP接口：销售退货审核，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：用友BIP写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

用友BIP接口明细

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

请求参数

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

用友BIP接口明细

调用接口：/yonbip/sd/vouchersalereturn/audit
接口名称：销售退货审核
方法：POST

请求参数

字段	字段名称	类型	配置值
id	单据主表id	string	{{new_id}}

系统打通概况

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