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

接入系统:用友BIP
YonBIP用友商业创新平台,是用友在数字经济时代面向成长型、大型企业及巨型企业,融合了先进且高可用技术平台和公共与关键商业应用与服务,支撑和运行客户的商业创新(业务创新、管理变革),并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。
对接目标平台:旺店通·企业奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
数据接口配置方案
通过轻易云系统数据集成平台:数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统:用友BIP,然后选择对应的连接器。选择对应的/yonbip/scm/purchaseorder/list作为数据对接来源。然后再写入目标平台配置目标系统为旺店通·企业奇门,并且选择对应连接器(关于旺店通·企业奇门的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息)。选择好对应的wdt.purchase.order.push接口作为数据写入动作完成第一步的接口配置。

用友BIP接口明细
- API:/yonbip/scm/purchaseorder/list
- NAME:采购订单列表查询
- METHOD:POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| pageIndex | 页码 | 1 | 例:1 默认值:1 |
| pageSize | 每页数 | 1000 | 例:10 默认值:10 |
| isSum | 查询表头 | | 例:false 默认值:false |
| simpleVOs | 查询条件 | | |
| simpleVOs.field1 | 过滤条件1 | | |
| simpleVOs.field1.field | 查询字段 | totalQuantity | |
| simpleVOs.field1.op | 比较符 | egt | |
| simpleVOs.field1.value1 | 值1 | | “and” “or” “and not” “or not”,若设置,必填expr1和expr2属性,忽略 column和condition。 |
| simpleVOs.field1.field2 | 过滤条件2 | | |
| simpleVOs.field1.field2.field | 查询字段 | auditTime | |
| simpleVOs.field1.field2.op | 比较符 | egt | |
| simpleVOs.field1.field2.value1 | 值1 | {{LAST_SYNC_TIME datetime}} | “and” “or” “and not” “or not”,若设置,必填expr1和expr2属性,忽略 column和condition。 |
| simpleVOs.field1.field2.field3 | 过滤条件3 | | |
| simpleVOs.field1.field2.field3.field | 查询字段 | org | |
| simpleVOs.field1.field2.field3.op | 比较符 | eq | |
| simpleVOs.field1.field2.field3.value1 | 值1 | 1553156871271481351 | “and” “or” “and not” “or not”,若设置,必填expr1和expr2属性,忽略 column和condition。 |
| simpleVOs.queryOrders | 排序字段 | | |
| simpleVOs.queryOrders.field | 排序条件字段 | id | 必须传实体上有的字段;主表字段查询时字段名(例: id);子表字段查询是子表对象.字段名(例:purchaseOrders.id);参照类型只能传id(例:按物料查询只能传物料id,不能传物料code) 例:id |
| simpleVOs.queryOrders.order | 顺序 | asc | 正序(asc);倒序(desc) 例:asc |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| product_cCode | 物料编码 | | |
| invoiceVendor | 开票供应商id | | |
| priceUOM_Precision | 计价单位精度 | | |
| modifyStatus | 变更状态 | | |
| receiveStatus | 收货状态 | | |
| listOriSum | 含税金额 | | |
| priceUOM_Code | 计价单位编码 | | |
| totalInTaxMoney | 累计入库含税金额 | | |
| totalQuantity | 整单数量 | | |
| natCurrency | 本币 | | |
| listTotalPayOriMoney | 累计付款核销金额 | | |
| unit_code | 主计量编码 | | |
| id | 主表id | | |
| isWfControlled | 是否审批流控制 | | |
| totalArrivedTaxMoney | 累计到货含税金额 | | |
| purchaseOrders_arrivedStatus | 到货状态 | | |
| bmake_st_purinvoice | 流程订货订单开蓝票 | | |
| realProductAttribute | 实物商品属性 | | |
| purchaseOrders_inWHStatus | 入库状态 | | |
| totalSendQty | 发货数量 | | |
| natCurrency_priceDigit | 本币 | | |
| bmake_st_purinrecord_red | 流程退库 | | |
| status | 状态 | | |
| currency_moneyDigit | 本币金额精度 | | |
| listTotalPayApplyAmount | 累计付款申请金额 | | |
| currency_code | 币种编码 | | |
| vouchdate | 单据日期 | | |
| invoiceVendor_name | 开票供应商 | | |
| vendor | 供货供应商id | | |
| purchaseOrders_payStatus | 核销状态 | | |
| listOriMoney | 无税金额 | | |
| currency | 币种 | | |
| pubts | 时间戳 | | |
| org_name | 采购组织 | | |
| generalPurchaseOrderType | 交易类型扩展参数 | | |
| isFlowCoreBill | 是否流程核心单据 | | |
| creator | 创建者 | | |
| product | 物料id | | |
| oriSum | 含税金额 | | |
| inInvoiceOrg_name | 收票组织 | | |
| product_defaultAlbumId | 物料首图片 | | |
| purchaseOrders_id | 订单行id | | |
| totalRecieveQty | 累计到货数量 | | |
| demandOrg_name | 需求组织 | | |
| createTime | 创建时间 | | |
| purUOM_Precision | 采购单位精度 | | |
| currency_priceDigit | 币种单价精度 | | |
| bEffectStock | 影响可用量 | | |
| inOrg | 收货组织id | | |
| bustype_name | 交易类型 | | |
| purchaseOrders_invPriceExchRate | 计价单位换算率 | | |
| subQty | 采购数量 | | |
| inInvoiceOrg | 收票组织id | | |
| product_cName | 物料名称 | | |
| listTaxRate | 税率 | | |
| bmake_st_purinvoice_red | 流程订货订单开红票 | | |
| product_model | 型号 | | |
| storagenum | 已入库数量 | | |
| purchaseOrders_invExchRate | 采购换算率 | | |
| vendor_name | 供应商 | | |
| oriUnitPrice | 无税单价 | | |
| barCode | 单据条码 | | |
| isContract | 是否需要与供应商协同 | | |
| unit_name | 主计量 | | |
| unit | 主计量id | | |
| purchaseOrders_invoiceStatus | 发票状态 | | |
| natCurrency_moneyDigit | 本币 | | |
| qty | 数量 | | |
| unit_Precision | 主计量精度 | | |
| oriTaxUnitPrice | 含税单价 | | |
| moneysum | 金额 | | |
| natCurrency_code | 本币 | | |
| product_modelDescription | 规格说明 | | |
| code | 单据编码 | | |
| demandOrg | 需求组织id | | |
| bizFlow | 流程ID | | |
| realProductAttributeType | 实物商品属性 | | |
| priceUOM | 计价单位id | | |
| bizstatus | 状态 | | |
| totalInQty | 累计入库数量 | | |
| bizFlow_version | 版本信息 | | |
| currency_name | 币种 | | |
| org | 采购组织 | | |
| bmake_st_purinrecord | 流程入库 | | |
| purchaseOrders_purUOM | 采购单位编码 | | |
| bustype | 交易类型id | | |
| listOriTax | 税额 | | |
| retailInvestors | 是否散户 | | |
| inOrg_name | 收货组织 | | |
| listTotalPayAmount | 累计付款金额 | | |
| priceUOM_Name | 计价单位名称 | | |
| listTotalPayNATMoney | 本币累计付款核销金额 | | |
| approvenum | 已审批数量 | | |
| listdiscountTaxType | 扣税类别 | | |
| bizFlow_name | 流程名称 | | |
旺店通·企业奇门接口明细
- 接口: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” |
系统对接总览
采集并引入全业务、多终端、多形态的数据,经过处理以及对应平台接口的数据结构适配,形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施,将沉淀的业务数据进入到平台进行体系化的加工,再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。
