用友BIP对接打通旺店通·企业奇门采购订单列表查询接口与创建采购单接口

对接源平台:用友BIP
YonBIP用友商业创新平台,是用友在数字经济时代面向成长型、大型企业及巨型企业,融合了先进且高可用技术平台和公共与关键商业应用与服务,支撑和运行客户的商业创新(业务创新、管理变革),并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。
对接目标系统:旺店通·企业奇门
旺店通是北京掌上先机网络科技有限公司旗下品牌,国内的零售云服务提供商,基于云计算SaaS服务模式,以体系化解决方案,助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案,致力于帮助企业实现数字化转型,企业规模化发展
系统对接接口配置
数据集成平台对应的配置用友BIP与旺店通·企业奇门的对接只要三步就能完成两个系统之间的数据对接。第一步根据用友BIP的接口参数要求记录在轻易云集成平台。第二步配置用友BIP与旺店通·企业奇门之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。

用友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 | findCollection find code from 4d0d581a-83ea-3f1f-bbce-900cf14fe56e where id={{new_vendor}} |
warehouse_no | 仓库编号 | string | _findCollection find code from 4f73f755-1c4f-33e6-b5a1-7e3b8d894800 where id={{new_warehouse}} |
outer_no | API单号 | string | {{code}} |
is_use_outer_no | 传入ERP采购单号 | string | 1 |
is_check | 自动审核 | string | 1 |
contact | 收货人姓名 | string | |
purchase_name | 采购员 | string | {{creator}} |
remark | 备注 | string | {{new_memo}} |
details_list | 采购明细节点 | array | detail_list |
details_list.spec_no | 商家编码 | string | {{detail_list.product_cCode}} |
details_list.num | 采购量 | string | {{detail_list.purchaseOrders_subQty}} |
details_list.price | 采购价格 | string | {{detail_list.oriTaxUnitPrice}} |
details_list.discount | 折扣 | string | 1 |
details_list.tax | 税率 | string | |
details_list.tax_price | 税后单价 | string | {{detail_list.oriTaxUnitPrice}} |
details_list.remark | 备注 | string | {{detail_list.new_purchaseOrders_memo}} |
details_list.prop1 | 采购类型 | string | {{new_headFreeItem}} |
details_list.purchase_info | 采购列表节点 | string | |
数据对接效果
全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务,很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象,减少各业务系统间的维护成本,减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题,将企业数据平滑对接,减少信息竖井。
