用友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过滤条件1object simpleVOs.field1.field查询字段string simpleVOs.field1.op比较符string simpleVOs.field1.value1值1string“and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。

响应参数

字段名称类型描述 code单据编号string单据编号 vouchdate单据日期string单据日期 id主体IDstring主体ID parentOrderNo父级订单号string父级订单号 salesOrgId销售组织idstring销售组织id salesOrgId_name销售组织名称string销售组织名称 saleDepartmentId销售部门idstring销售部门id transactionTypeId交易类型idstring交易类型id transactionTypeId_name交易类型名称string交易类型名称 agentId客户idstring客户id agentId_name客户名称string客户名称 receiveContacter客户联系人string客户联系人 receiveContacterPhone客户联系人电话string客户联系人电话 purchaseNo客户采购订单号string客户采购订单号 corpContactUserName销售业务员string销售业务员 settlementOrgId_name开票组织名称string开票组织名称 corpContactUserErpCode业务员erp编码string业务员erp编码 orderPrices订单价格array订单价格 orderPrices.currency币种idstring币种id orderPrices.currency_priceDigit原币单价精度string原币单价精度 orderPrices.currency_moneyDigit原币金额精度string原币金额精度 orderPrices.originalName币种string币种 orderPrices.natCurrency本币pkstring本币pk orderPrices.natCurrency_priceDigit本币单价精度string本币单价精度 orderPrices.natCurrency_moneyDigit本币金额精度string本币金额精度 orderPrices.domesticCode本币简称string本币简称 orderPrices.domesticName本币string本币 orderPrices.exchRate汇率string汇率 orderPrices.exchangeRateType_name汇率类型名称string汇率类型名称 orderPrices.exchangeRateType汇率类型Ididstring汇率类型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开票组织idstring开票组织id orderPrices.lockIn标记锁string标记锁 orderPrices.confirmDate订单确认时间string订单确认时间 orderPrices.payDate订单付款时间string订单付款时间 orderPrices.orderPayType支付方式string支付方式 orderPrices.settlement结算方式idstring结算方式id orderPrices.shippingChoiceId发运方式idstring发运方式id orderPrices.sendDate预计发货日期string预计发货日期 orderPrices.hopeReceiveDate期望收货日期string期望收货日期 orderPrices.opposeMemo驳回批注string驳回批注 orderPrices.haveDelivery是否存在发货单string是否存在发货单 orderPrices.occupyInventory库存占用时机标识string库存占用时机标识 orderPrices.separatePromotionType拆单规则标识string拆单规则标识 orderPrices.reight运费string运费 orderPrices.synSourceOrg协同来源组织idstring协同来源组织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商家idstring商家id orderPrices.bizName商家名称string商家名称 orderPrices.agentRelationId客户交易关系idstring客户交易关系id orderPrices.points积分string积分 orderPrices.pubts时间戳,格式为:yyyy-MM-ddHH:mm:ssstring时间戳,格式为:yyyy-MM-ddHH:mm:ss orderPrices.pubuts时间戳string时间戳 orderPrices.orderInvoice发票信息string发票信息 orderPrices.orderShippingAddress收货地址信息string收货地址信息 orderPrices.orderErp订单erpstring订单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商品idstring商品id orderPrices.isBatchManage是否批次管理string是否批次管理 orderPrices.isExpiryDateManage是否有效期管理string是否有效期管理 orderPrices.expireDateNo保质期string保质期 orderPrices.expireDateUnit保质期单位string保质期单位 orderPrices.skuId商品SKUidstring商品SKUid orderPrices.erpCodeskuERP编码stringskuERP编码 orderPrices.orderProductType商品售卖类型,SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、string商品售卖类型,SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、 orderPrices.productCode商品编码string商品编码 orderPrices.productName商品名称string商品名称 orderPrices.skuCodeSKU编码stringSKU编码 orderPrices.specDescription规格描述string规格描述 orderPrices.projectId项目idstring项目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数目税率idstring数目税率id orderPrices.saleCost报价含税金额string报价含税金额 orderPrices.stockId仓库IDstring仓库ID orderPrices.oriTaxUnitPrice含税成交价string含税成交价 orderPrices.orderDetails_stockOrgId库存组织idstring库存组织id orderPrices.oriSum含税金额string含税金额 orderPrices.taxRate税率string税率 orderPrices.taxItems税目string税目 orderPrices.taxCode税目税率编码string税目税率编码 orderPrices.shoppingCartId购物车idstring购物车id orderPrices.groupId分组Idstring分组Id orderPrices.rebateReturnProductId返货单商品idstring返货单商品id orderPrices.mutualActivities活动的对象,用于校验互斥活动string活动的对象,用于校验互斥活动 orderPrices.activities包含的类型,用于校验互斥string包含的类型,用于校验互斥 orderPrices.sendPayMoney累计已发货含税金额string累计已发货含税金额 orderPrices.invoiceQty累计开票数量string累计开票数量 orderPrices.invoiceOriSum累计开票含税金额string累计开票含税金额 orderPrices.bizProductId商家商品idstring商家商品id orderPrices.takeQuantity已审核收数量string已审核收数量 orderPrices.bizSkuId商家skuidstring商家skuid orderPrices.takeSalePayMoney已审核收金额string已审核收金额 orderPrices.orderDetailPrice订单金额string订单金额 orderPrices.sendQty累计已发货数量string累计已发货数量 orderPrices.closedSumMoney关闭总金额string关闭总金额 orderPrices.closedRowCount行关闭数量string行关闭数量 orderPrices.iDeleted未定义名称string未定义名称 orderPrices.iOrgId组织IDstring组织ID orderPrices.memo备注string备注 orderPrices.createDate创建日期string创建日期 orderPrices.creatorId创建人string创建人 orderPrices.auditorId审核人IDstring审核人ID orderPrices.auditDate审批日期string审批日期 orderPrices.closerId关闭人IDstring关闭人ID orderPrices.closeDate关闭日期string关闭日期 orderPrices.modifierId修改人idstring修改人id orderPrices.modifyDate修改日期string修改日期 orderPrices.cCreator创建人string创建人 orderPrices.iProductAuxUnitId销售单位idstring销售单位id orderPrices.iProductUnitId计价单位idstring计价单位id orderPrices.masterUnitId主计量单位idstring主计量单位id orderPrices.purUOM_Precision销售单位精度string销售单位精度 orderPrices.priceUOM_Precision计价单位精度string计价单位精度 orderPrices.unit_Precision主计量单位精度string主计量单位精度 orderPrices.cBizName供应商名称string供应商名称 orderPrices.orderDetailId主体IDstring主体ID orderPrices.orderId订单IDstring订单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流程IDstring流程ID orderPrices.bmake_voucher_saleinvoice流程开票string流程开票 orderPrices.isFlowCoreBill是否流程核心单据string是否流程核心单据 orderPrices.bizFlow_version版本信息string版本信息 orderPrices.batchNo批次号string批次号 orderPrices.productDate生产日期string生产日期 orderPrices.invalidDate有效期至string有效期至 orderPrices.new_idnew_idstring orderPrices.new_orderDetailIdnew_orderDetailIdstring

轻易云集成平台接口明细

API：写入空操作
NAME：写入空操作
METHOD：POST

系统数据对接

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

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