用友BIP和轻易云集成平台接口打通对接实战|轻易云数据集成平台

用友BIP和轻易云集成平台接口打通对接实战

数据源系统:用友BIP

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

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

使用全界面可视化配置集成流，快速应对企业的集成需求使得系统与系统之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。

数据接口配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：用友BIP，然后选择对应的连接器。选择对应的/yonbip/sd/voucherorder/list作为数据对接来源。然后再写入目标平台配置目标系统为轻易云集成平台，并且选择对应连接器（关于轻易云集成平台的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的写入空操作接口作为数据写入动作完成第一步的接口配置。

用友BIP接口明细

接口：/yonbip/sd/voucherorder/list
接口名称：销售订单列表查询
接口方法：POST

请求参数

字段	名称	类型	描述
pageIndex	页号	string	页号示例：1 默认值：1
pageSize	每页行数	string	每页行数示例：10 默认值：10
code	单据编号	string	单据编号示例：UO-20220513000001
nextStatusName	订单状态	string	订单状态, CONFIRMORDER:开立、DELIVERY_PART:部分发货、DELIVERY_TAKE_PART:部分发货待收货、DELIVERGOODS:待发货、TAKEDELIVERY:待收货、ENDORDER:已完成、OPPOSE:已取消、APPROVING:审批中、示例：CONFIRMORDER
open_orderDate_begin	制单日期开始时间	string	制单日期开始时间,格式为:yyyy-MM-dd HH:mm:ss 示例：2022-05-13 00:00:00
open_orderDate_end	制单结束时间	string	制单结束时间,格式为:yyyy-MM-dd HH:mm:ss 示例：2022-05-13 00:00:00
open_confirmDate_begin	审核开始时间	string	审核开始时间,格式为:yyyy-MM-dd HH:mm:ss 示例：2022-05-13 00:00:00
open_confirmDate_end	审核截止时间	string	审核截止时间,格式为:yyyy-MM-dd HH:mm:ss 示例：2022-05-13 00:00:00
open_hopeReceiveDate_begin	期望收货开始时间	string	期望收货开始时间,格式为:yyyy-MM-dd HH:mm:ss 示例：2022-05-13 00:00:00
open_hopeReceiveDate_end	期望收货截止	string	期望收货截止,格式为:yyyy-MM-dd HH:mm:ss 示例：2022-05-13 00:00:00
open_vouchdate_begin	单据开始时间	string	单据开始时间,格式为:yyyy-MM-dd HH:mm:ss 示例：2022-05-13 00:00:00
open_vouchdate_end	单据截止时间	string	单据截止时间,格式为:yyyy-MM-dd HH:mm:ss 示例：2022-05-13 00:00:00
isSum	查询表头	string	查询表头示例：false 默认值：false
simpleVOs	查询条件	object
simpleVOs.field1	过滤条件1	object
simpleVOs.field1.field	查询字段	string
simpleVOs.field1.op	比较符	string
simpleVOs.field1.value1	值1	string	“and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。

响应参数

字段	名称	类型	描述
code	单据编号	string	单据编号
vouchdate	单据日期	string	单据日期
id	主体ID	string	主体ID
parentOrderNo	父级订单号	string	父级订单号
salesOrgId	销售组织id	string	销售组织id
salesOrgId_name	销售组织名称	string	销售组织名称
saleDepartmentId	销售部门id	string	销售部门id
transactionTypeId	交易类型id	string	交易类型id
transactionTypeId_name	交易类型名称	string	交易类型名称
agentId	客户id	string	客户id
agentId_name	客户名称	string	客户名称
receiveContacter	客户联系人	string	客户联系人
receiveContacterPhone	客户联系人电话	string	客户联系人电话
purchaseNo	客户采购订单号	string	客户采购订单号
corpContactUserName	销售业务员	string	销售业务员
settlementOrgId_name	开票组织名称	string	开票组织名称
corpContactUserErpCode	业务员erp编码	string	业务员erp编码
orderPrices	订单价格	array	订单价格
orderPrices.currency	币种id	string	币种id
orderPrices.currency_priceDigit	原币单价精度	string	原币单价精度
orderPrices.currency_moneyDigit	原币金额精度	string	原币金额精度
orderPrices.originalName	币种	string	币种
orderPrices.natCurrency	本币pk	string	本币pk
orderPrices.natCurrency_priceDigit	本币单价精度	string	本币单价精度
orderPrices.natCurrency_moneyDigit	本币金额精度	string	本币金额精度
orderPrices.domesticCode	本币简称	string	本币简称
orderPrices.domesticName	本币	string	本币
orderPrices.exchRate	汇率	string	汇率
orderPrices.exchangeRateType_name	汇率类型名称	string	汇率类型名称
orderPrices.exchangeRateType	汇率类型Idid	string	汇率类型Idid
orderPrices.payMoney	合计含税金额	string	合计含税金额
orderPrices.orderPayMoney	商品实付金额	string	商品实付金额
orderPrices.realMoney	应收金额	string	应收金额
orderPrices.orderRealMoney	商品应付金额	string	商品应付金额
orderPrices.statusCode	订单当前状态码	string	订单当前状态码
orderPrices.nextStatus	订单状态	string	订单状态,CONFIRMORDER:开立、DELIVERY_PART:部分发货、DELIVERY_TAKE_PART:部分发货待收货、DELIVERGOODS:待发货、TAKEDELIVERY:待收货、ENDORDER:已完成、OPPOSE:已取消、APPROVING:审批中、
orderPrices.currentStatus	当前状态位置	string	当前状态位置
orderPrices.payStatusCode	付款状态	string	付款状态,NOTPAYMENT:未付款、PARTPAYMENT:部分付款、CONFIRMPAYMENT:部分付款待确认、CONFIRMPAYMENT_ALL:付款待确认、FINISHPAYMENT:付款完成、
orderPrices.settlementOrgId	开票组织id	string	开票组织id
orderPrices.lockIn	标记锁	string	标记锁
orderPrices.confirmDate	订单确认时间	string	订单确认时间
orderPrices.payDate	订单付款时间	string	订单付款时间
orderPrices.orderPayType	支付方式	string	支付方式
orderPrices.settlement	结算方式id	string	结算方式id
orderPrices.shippingChoiceId	发运方式id	string	发运方式id
orderPrices.sendDate	预计发货日期	string	预计发货日期
orderPrices.hopeReceiveDate	期望收货日期	string	期望收货日期
orderPrices.opposeMemo	驳回批注	string	驳回批注
orderPrices.haveDelivery	是否存在发货单	string	是否存在发货单
orderPrices.occupyInventory	库存占用时机标识	string	库存占用时机标识
orderPrices.separatePromotionType	拆单规则标识	string	拆单规则标识
orderPrices.reight	运费	string	运费
orderPrices.synSourceOrg	协同来源组织id	string	协同来源组织id
orderPrices.synSourceTenant	协同来源租户	string	协同来源租户
orderPrices.pointsMoney	积分抵扣金额	string	积分抵扣金额
orderPrices.synSourceOrg_name	协同来源组织名称	string	协同来源组织名称
orderPrices.totalMoney	总金额	string	总金额
orderPrices.tagName	采购组织弹框	string	采购组织弹框
orderPrices.rebateMoney	返利金额	string	返利金额
orderPrices.rebateCashMoney	抵现金额	string	抵现金额
orderPrices.particularlyMoney	特殊优惠	string	特殊优惠
orderPrices.promotionMoney	促销	string	促销
orderPrices.unConfirmPrice	未审核的金额	string	未审核的金额
orderPrices.confirmPrice	已支付金额	string	已支付金额
orderPrices.bizId	商家id	string	商家id
orderPrices.bizName	商家名称	string	商家名称
orderPrices.agentRelationId	客户交易关系id	string	客户交易关系id
orderPrices.points	积分	string	积分
orderPrices.pubts	时间戳,格式为:yyyy-MM-ddHH:mm:ss	string	时间戳,格式为:yyyy-MM-ddHH:mm:ss
orderPrices.pubuts	时间戳	string	时间戳
orderPrices.orderInvoice	发票信息	string	发票信息
orderPrices.orderShippingAddress	收货地址信息	string	收货地址信息
orderPrices.orderErp	订单erp	string	订单erp
orderPrices.deliveryDate	交货日期	string	交货日期
orderPrices.isWfControlled	是否审批流控制	string	是否审批流控制
orderPrices.verifystate	审批状态	string	审批状态
orderPrices.status	状态	string	状态
orderPrices.isFinishDelivery	订单是否发完货	string	订单是否发完货
orderPrices.productId_pbatchName	商品包装单位	string	商品包装单位
orderPrices.idKey	行标识	string	行标识
orderPrices.productId	商品id	string	商品id
orderPrices.isBatchManage	是否批次管理	string	是否批次管理
orderPrices.isExpiryDateManage	是否有效期管理	string	是否有效期管理
orderPrices.expireDateNo	保质期	string	保质期
orderPrices.expireDateUnit	保质期单位	string	保质期单位
orderPrices.skuId	商品SKUid	string	商品SKUid
orderPrices.erpCode	skuERP编码	string	skuERP编码
orderPrices.orderProductType	商品售卖类型,SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、	string	商品售卖类型,SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、
orderPrices.productCode	商品编码	string	商品编码
orderPrices.productName	商品名称	string	商品名称
orderPrices.skuCode	SKU编码	string	SKU编码
orderPrices.specDescription	规格描述	string	规格描述
orderPrices.projectId	项目id	string	项目id
orderPrices.unitExchangeType	浮动（计价）	string	浮动（计价）
orderPrices.unitExchangeTypePrice	浮动（销售）	string	浮动（销售）
orderPrices.productAuxUnitName	销售单位	string	销售单位
orderPrices.invExchRate	销售换算率	string	销售换算率
orderPrices.subQty	销售数量	string	销售数量
orderPrices.productUnitName	计价单位	string	计价单位
orderPrices.invPriceExchRate	计价换算率	string	计价换算率
orderPrices.priceQty	计价数量	string	计价数量
orderPrices.qtyName	主计量	string	主计量
orderPrices.qty	数量	string	数量
orderPrices.orderDetailPrices	订单商品金额	string	订单商品金额
orderPrices.stockName	发货仓库	string	发货仓库
orderPrices.stockOrgId_name	库存组织	string	库存组织
orderPrices.consignTime	计划发货日期	string	计划发货日期
orderPrices.projectId_name	项目名称	string	项目名称
orderPrices.projectId_code	项目编码	string	项目编码
orderPrices.salePrice	含税报价	string	含税报价
orderPrices.taxId	数目税率id	string	数目税率id
orderPrices.saleCost	报价含税金额	string	报价含税金额
orderPrices.stockId	仓库ID	string	仓库ID
orderPrices.oriTaxUnitPrice	含税成交价	string	含税成交价
orderPrices.orderDetails_stockOrgId	库存组织id	string	库存组织id
orderPrices.oriSum	含税金额	string	含税金额
orderPrices.taxRate	税率	string	税率
orderPrices.taxItems	税目	string	税目
orderPrices.taxCode	税目税率编码	string	税目税率编码
orderPrices.shoppingCartId	购物车id	string	购物车id
orderPrices.groupId	分组Id	string	分组Id
orderPrices.rebateReturnProductId	返货单商品id	string	返货单商品id
orderPrices.mutualActivities	活动的对象,用于校验互斥活动	string	活动的对象,用于校验互斥活动
orderPrices.activities	包含的类型,用于校验互斥	string	包含的类型,用于校验互斥
orderPrices.sendPayMoney	累计已发货含税金额	string	累计已发货含税金额
orderPrices.invoiceQty	累计开票数量	string	累计开票数量
orderPrices.invoiceOriSum	累计开票含税金额	string	累计开票含税金额
orderPrices.bizProductId	商家商品id	string	商家商品id
orderPrices.takeQuantity	已审核收数量	string	已审核收数量
orderPrices.bizSkuId	商家skuid	string	商家skuid
orderPrices.takeSalePayMoney	已审核收金额	string	已审核收金额
orderPrices.orderDetailPrice	订单金额	string	订单金额
orderPrices.sendQty	累计已发货数量	string	累计已发货数量
orderPrices.closedSumMoney	关闭总金额	string	关闭总金额
orderPrices.closedRowCount	行关闭数量	string	行关闭数量
orderPrices.iDeleted	未定义名称	string	未定义名称
orderPrices.iOrgId	组织ID	string	组织ID
orderPrices.memo	备注	string	备注
orderPrices.createDate	创建日期	string	创建日期
orderPrices.creatorId	创建人	string	创建人
orderPrices.auditorId	审核人ID	string	审核人ID
orderPrices.auditDate	审批日期	string	审批日期
orderPrices.closerId	关闭人ID	string	关闭人ID
orderPrices.closeDate	关闭日期	string	关闭日期
orderPrices.modifierId	修改人id	string	修改人id
orderPrices.modifyDate	修改日期	string	修改日期
orderPrices.cCreator	创建人	string	创建人
orderPrices.iProductAuxUnitId	销售单位id	string	销售单位id
orderPrices.iProductUnitId	计价单位id	string	计价单位id
orderPrices.masterUnitId	主计量单位id	string	主计量单位id
orderPrices.purUOM_Precision	销售单位精度	string	销售单位精度
orderPrices.priceUOM_Precision	计价单位精度	string	计价单位精度
orderPrices.unit_Precision	主计量单位精度	string	主计量单位精度
orderPrices.cBizName	供应商名称	string	供应商名称
orderPrices.orderDetailId	主体ID	string	主体ID
orderPrices.orderId	订单ID	string	订单ID
orderPrices.creator	创建人	string	创建人
orderPrices.createTime	创建时间	string	创建时间
orderPrices.auditor	审批人	string	审批人
orderPrices.auditTime	审批时间	string	审批时间
orderPrices.closeTime	关闭时间	string	关闭时间
orderPrices.closer	关闭人	string	关闭人
orderPrices.modifier	修改人	string	修改人
orderPrices.modifyTime	修改时间	string	修改时间
orderPrices.bmake_st_salesout	流程入库	string	流程入库
orderPrices.bmake_voucher_delivery	流程发货	string	流程发货
orderPrices.bizFlow	流程ID	string	流程ID
orderPrices.bmake_voucher_saleinvoice	流程开票	string	流程开票
orderPrices.isFlowCoreBill	是否流程核心单据	string	是否流程核心单据
orderPrices.bizFlow_version	版本信息	string	版本信息
orderPrices.batchNo	批次号	string	批次号
orderPrices.productDate	生产日期	string	生产日期
orderPrices.invalidDate	有效期至	string	有效期至
orderPrices.new_id	new_id	string
orderPrices.new_orderDetailId	new_orderDetailId	string

轻易云集成平台接口明细

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

数据对接效果

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。