用友BIP和旺店通·企业奇门接口打通对接实战|轻易云数据集成平台

用友BIP和旺店通·企业奇门接口打通对接实战

源系统:用友BIP

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

目标系统:旺店通·企业奇门

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

系统对接接口配置

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

用友BIP接口明细

接口：/yonbip/scm/purchaseorder/list
接口名称：采购订单列表查询
接口方法：POST

请求参数

字段	名称	类型	描述
pageIndex	页码	string	例：1 默认值：1
pageSize	每页数	string	例：10 默认值：10
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。
simpleVOs.field1.field2	过滤条件2	object
simpleVOs.field1.field2.field	查询字段	string
simpleVOs.field1.field2.op	比较符	string
simpleVOs.field1.field2.value1	值1	string	“and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。
simpleVOs.field1.field2.field3	过滤条件3	object
simpleVOs.field1.field2.field3.field	查询字段	string
simpleVOs.field1.field2.field3.op	比较符	string
simpleVOs.field1.field2.field3.value1	值1	string	“and” “or” “and not” “or not”，若设置，必填expr1和expr2属性，忽略 column和condition。
simpleVOs.queryOrders	排序字段	array
simpleVOs.queryOrders.field	排序条件字段	string	必须传实体上有的字段;主表字段查询时字段名(例: id);子表字段查询是子表对象.字段名(例：purchaseOrders.id);参照类型只能传id(例:按物料查询只能传物料id,不能传物料code) 例：id
simpleVOs.queryOrders.order	顺序	string	正序(asc);倒序(desc) 例：asc

响应参数

字段	名称	类型	描述
product_cCode	物料编码	string
invoiceVendor	开票供应商id	string
priceUOM_Precision	计价单位精度	string
modifyStatus	变更状态	string
receiveStatus	收货状态	string
listOriSum	含税金额	string
priceUOM_Code	计价单位编码	string
totalInTaxMoney	累计入库含税金额	string
totalQuantity	整单数量	string
natCurrency	本币	string
listTotalPayOriMoney	累计付款核销金额	string
unit_code	主计量编码	string
id	主表id	string
isWfControlled	是否审批流控制	string
totalArrivedTaxMoney	累计到货含税金额	string
purchaseOrders_arrivedStatus	到货状态	string
bmake_st_purinvoice	流程订货订单开蓝票	string
realProductAttribute	实物商品属性	string
purchaseOrders_inWHStatus	入库状态	string
totalSendQty	发货数量	string
natCurrency_priceDigit	本币	string
bmake_st_purinrecord_red	流程退库	string
status	状态	string
currency_moneyDigit	本币金额精度	string
listTotalPayApplyAmount	累计付款申请金额	string
currency_code	币种编码	string
vouchdate	单据日期	string
invoiceVendor_name	开票供应商	string
vendor	供货供应商id	string
purchaseOrders_payStatus	核销状态	string
listOriMoney	无税金额	string
currency	币种	string
pubts	时间戳	string
org_name	采购组织	string
generalPurchaseOrderType	交易类型扩展参数	string
isFlowCoreBill	是否流程核心单据	string
creator	创建者	string
product	物料id	string
oriSum	含税金额	string
inInvoiceOrg_name	收票组织	string
product_defaultAlbumId	物料首图片	string
purchaseOrders_id	订单行id	string
totalRecieveQty	累计到货数量	string
demandOrg_name	需求组织	string
createTime	创建时间	string
purUOM_Precision	采购单位精度	string
currency_priceDigit	币种单价精度	string
bEffectStock	影响可用量	string
inOrg	收货组织id	string
bustype_name	交易类型	string
purchaseOrders_invPriceExchRate	计价单位换算率	string
subQty	采购数量	string
inInvoiceOrg	收票组织id	string
product_cName	物料名称	string
listTaxRate	税率	string
bmake_st_purinvoice_red	流程订货订单开红票	string
product_model	型号	string
storagenum	已入库数量	string
purchaseOrders_invExchRate	采购换算率	string
vendor_name	供应商	string
oriUnitPrice	无税单价	string
barCode	单据条码	string
isContract	是否需要与供应商协同	string
unit_name	主计量	string
unit	主计量id	string
purchaseOrders_invoiceStatus	发票状态	string
natCurrency_moneyDigit	本币	string
qty	数量	string
unit_Precision	主计量精度	string
oriTaxUnitPrice	含税单价	string
moneysum	金额	string
natCurrency_code	本币	string
product_modelDescription	规格说明	string
code	单据编码	string
demandOrg	需求组织id	string
bizFlow	流程ID	string
realProductAttributeType	实物商品属性	string
priceUOM	计价单位id	string
bizstatus	状态	string
totalInQty	累计入库数量	string
bizFlow_version	版本信息	string
currency_name	币种	string
org	采购组织	string
bmake_st_purinrecord	流程入库	string
purchaseOrders_purUOM	采购单位编码	string
bustype	交易类型id	string
listOriTax	税额	string
retailInvestors	是否散户	string
inOrg_name	收货组织	string
listTotalPayAmount	累计付款金额	string
priceUOM_Name	计价单位名称	string
listTotalPayNATMoney	本币累计付款核销金额	string
approvenum	已审批数量	string
listdiscountTaxType	扣税类别	string
bizFlow_name	流程名称	string

旺店通·企业奇门接口明细

接口：wdt.purchase.order.push
接口名称：创建采购单
接口方法：POST

请求参数

字段	名称	类型	描述
provider_no	供应商编号	string	供应商编号，ERP供应商档案必须存在此编号，否则推送失败
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于创建指定仓库数据信息(不支持一次推送多个仓库编码)
outer_no	API单号	string	API单号（如果【使用API单号作为系统采购单号】，那么该字段长度不能超过20）保证唯一
is_use_outer_no	传入ERP采购单号	string	使用api外部单号作为系统采购单号（1使用，0不使用），默认不使用
is_check	自动审核	string	是否自动审核，0 不审核，1 审核，默认不自动审核（不影响财务审核）
contact	收货人姓名	string	收货人姓名
purchase_name	采购员	string	采购员
remark	备注	string	采购单备注
details_list	采购明细节点	array	请求参数的2级数据节点，包含采购单所有货品明细信息的数据节点，节点下数据字段详见下述“details_list”
details_list.spec_no	商家编码	string	代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
details_list.num	采购量	string	采购量
details_list.price	采购价格	string	采购价格,按采购单位，税前单价
details_list.discount	折扣	string	折扣（1为不打折，0.9为9折，以此类推，0即为免费，接口计算公式在上边）
details_list.tax	税率	string	货品的税率，传值范围大于等于0小于等于1
details_list.tax_price	税后单价	string	税后单价，推送税后单价时折扣（discount）传值不生效，由接口计算，公式为discount=tax_price/(price*(1+tax))
details_list.remark	备注	string	采购货品明细备注
details_list.prop1	采购类型	string
details_list.purchase_info	采购列表节点	string	请求参数的1级数据节点，包含采购单所有属性信息的数据节点，节点下数据字段详见下述“purchase_info”

系统打通概况

采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。