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