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

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

对接源平台:用友BIP

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

目标系统:用友BIP

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

数据接口配置

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


 

用友BIP接口明细

  • API:/yonbip/sd/vouchersalereturn/list
  • NAME:销售退货列表查询
  • METHOD:POST
请求参数
接口字段字段名称预设值描述
open_createTime_begin制单开始时间制单开始时间
code单据编号单据编号
pageIndex页号    默认值:11页号    默认值:1
pageSize每页行数    默认值:101每页行数    默认值: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值12022-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值1TK“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型号型号

用友BIP接口明细

  • 调用接口:/yonbip/sd/vouchersalereturn/audit
  • 接口名称:销售退货审核
  • 方法:POST
请求参数
字段字段名称类型配置值
id单据主表idstring{{new_id}}

系统打通概况

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

<think>好的,我现在需要帮助用户了解如何在用友BIP平台上开发接口,特别是关于API集成文档和教程。用户提到了几个引用,我需要先仔细看一下这些引用内容,看看里面有没有相关的信息。 首先看引用[1],里面提到了用友系统使用Docusign的API接口,需要集成密钥和客户端密钥。这可能说明用友BIP的API集成可能需要类似的认证方式,比如使用密钥进行身份验证。不过这里的具体步骤可能不同,但用户可能需要获取类似的应用凭证。 引用[2]提到轻易云集成平台如何配置对接方案,包括一键复制已有的方案或手工配置,涉及源平台和目标平台的数据处理逻辑。这可能意味着用友BIP接口开发需要定义数据如何从源系统获取,并转换格式写入目标系统。用户可能需要了解用友BIP的API如何获取数据和提交数据,以及数据格式要求。 引用[3]则具体提到用友BIP对接销售退货列表查询审核接口,并强调用友BIP在产业链协同中的作用。这说明用友BIP的API可能包含各种业务模块的接口,比如销售退货等,用户需要根据具体业务需求调用相应的接口。 用户的问题是如何在用友BIP平台上开发接口,需要教程或文档。根据引用[2]和[3],可能需要通过轻易云集成平台或者用友BIP自身的开发者资源来获取帮助。首先,用户可能需要访问用友BIP的官方开发者门户,注册应用获取API密钥,然后查阅API文档了解各个接口的使用方法、参数和认证机制。此外,引用[2]提到轻易云有海量的对接方案,用户可能可以参考这些方案来加速开发。 接下来需要整理回答的结构,分步骤说明开发接口的流程,可能包括注册开发者账号、创建应用、获取凭证、阅读文档、调用接口等步骤。同时要引用提供的引用内容来支持回答,比如引用[1]的密钥获取,引用[2]的配置方法,引用[3]的具体接口例子。 需要注意的是,用户可能没有提到具体的业务场景,但引用[3]中的销售退货接口可以作为一个例子,说明如何对接特定业务接口。此外,可能还需要提到测试和调试工具,比如Postman,以及如何处理API返回的数据和错误信息。 最后,生成相关问题时要围绕API开发的不同方面,比如认证方式、数据格式、调试工具、业务接口案例以及第三方集成平台的使用。</think>在用友BIP平台上开发接口需遵循以下步骤,结合其API集成规范和生态资源: ### 一、开发准备 1. **注册开发者账号** 访问用友BIP开发者门户完成企业认证,获取平台接入权限[^3]。 2. **创建应用凭证获取** 在开发者控制台创建新应用,系统会自动生成`Client ID`和`Client Secret`,用于OAuth2.0认证流程[^1]。 ### 二、接口开发流程 1. **查阅API文档** 通过开发者门户获取《用友BIP开放平台API文档》,文档包含: - 接口分类(如供应链/财务模块) - 请求参数说明(示例:销售退货审核接口需传递`退货单号`和`审核状态`字段) - 响应数据结构 - 错误代码对照表 2. **接口调用示例** 以查询销售退货列表为例: ```python import requests # 获取访问令牌 auth_url = "https://api.yonyoucloud.com/oauth/token" params = { "client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET", "grant_type": "client_credentials" } token = requests.post(auth_url, data=params).json()['access_token'] # 调用业务接口 headers = {"Authorization": f"Bearer {token}"} api_url = "https://api.yonyoucloud.com/sales/return/list" response = requests.get(api_url, headers=headers) print(response.json()) ``` ### 三、集成方案配置 1. **数据映射规则** 根据业务需求定义数据转换逻辑,例如将从其他系统获取的JSON数据转换为用友BIP要求的XML格式[^2]。 2. **异常处理机制** 建议实现自动重试策略,特别是处理网络超时(建议设置3次重试)和接口限流(HTTP 429状态码)场景。 ### 四、调试测试 使用Postman等工具进行接口测试,重点关注: - 请求头完整性(必须包含`Content-Type`和`Authorization`) - 时间戳参数格式(统一采用ISO 8601标准) - 签名算法验证(涉及敏感操作时需使用HMAC-SHA256)
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值