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

对接系统:用友BIP
YonBIP用友商业创新平台,是用友在数字经济时代面向成长型、大型企业及巨型企业,融合了先进且高可用技术平台和公共与关键商业应用与服务,支撑和运行客户的商业创新(业务创新、管理变革),并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。
目标系统:旺店通·企业奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
系统对接接口配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线,所以对接方案的配置极其重要,方案可以选择一键复制,轻易云有海量的对接方案可支持一键复制,复制后直接启动使用(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置,配置只要确认源平台:用友BIP的取数逻辑,例如什么时间取什么样的数据。即可完成配置,目标平台:旺店通·企业奇门,把获取的数据组装成目标系统需要的格式进行写入。


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


