用友BIP和旺店通·企业奇门单据接口集成

数据源系统:旺店通·企业奇门
慧策最先以旺店通ERP切入商家核心管理痛点——订单管理,之后围绕电商经营管理中的核心管理诉求,先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步,向前向后延伸,全面布局零售企业经营,整体构建一体化智能零售解决方案,打破数据孤岛,AI植入系统,实现智能决策,助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品,从前端吸引流量到后端集约化管理,助力企业智慧决策
接通系统:用友BIP
用友BIP助力行业龙头企业、产业链核心企业以及平台型企业建设产业互联网运营平台,通过运营、管理、协同配置和共享资源,实现产业链上下游连接与协同,并保障安全。
数据接口配置方案
通过数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:旺店通·企业奇门,并且选择对应的连接器(关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的查询采购入库单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为用友BIP,并且选择对应连接器。选择对应的采购入库来源生单保存接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。

旺店通·企业奇门接口明细
- API:wdt.stockin.order.query.purchase
- NAME:查询采购入库单
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
start_time | 开始时间 | {{LAST_SYNC_TIME datetime}} | 增量获取数据,start_time作为开始时间,格式:yyyy-MM-dd HH:mm:ss |
end_time | 结束时间 | {{CURRENT_TIME datetime}} | 增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss |
status | 状态 | 60,80 | 入库单状态 10已取消20编辑中25待价格确认30待审核60待结算80已完成(默认80) |
src_order_no | 上层单据编号 | | 上层单据编号,默认为采购单号,传该字段可以不传开始时间和结束时间 |
warehouse_no | 仓库编号 | | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) |
page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} | 每页返回的数据条数,输入值范围1100,不传本参数,输入值默认为40,使用举例单击这里 |
page_no | 页号 | {{PAGINATION_START_PAGE}} | 不传值默认从0页开始 |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
stockin_id | 入库单主键id | | 入库单主键id |
order_no | 入库单号 | | 入库单号 |
status | 状态 | | 10已取消20编辑中25待价格确认30待审核60待结算80已完成 |
warehouse_no | 仓库编号 | | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
warehouse_name | 仓库 | | 仓库 |
stockin_time | 修改时间 | | 修改时间,格式:yyyy-MM-dd HH:mm:ss |
check_time | 审核时间 | | 审核时间,格式:yyyy-MM-dd HH:mm:ss |
created_time | 创建时间 | | 创建时间,格式:yyyy-MM-dd HH:mm:ss |
src_order_no | 采购单号 | | 采购单号 |
remark | 备注 | | 备注 |
stockin_reason | 入库原因 | | 入库原因 |
order_type | 入库类型 | | 入库类型(该接口只返回采购入库类型) |
order_type_name | 入库类型名称 | | 入库类型名称(默认为采购入库) |
goods_amount | 货款总额 | | 货款总额 |
total_price | 总成本 | | 总成本 |
discount | 优惠 | | 优惠 |
tax_amount | 税后金额 | | 税后金额 |
post_fee | 邮费 | | 邮费 |
other_fee | 其他费用 | | 其他费用 |
logistics_type | 物流类型 | | 物流方式,详情介绍,单击这里 |
logistics_code | 物流公司编号 | | 旺店通系统内物流公司编号 |
logistics_name | 物流公司名称 | | 旺店通系统内物流公司名称 |
logistics_no | 物流单号 | | 物流单号 |
purchase_no | 采购单编号 | | 采购单编号 |
provider_no | 供应商编号 | | 供应商编号 |
provider_name | 供应商名称 | | 供应商名称 |
outer_no | 外部单号 | | 上层单据的采购单号可做该入库单的外部单号 |
goods_count | 货品总数量 | | 货品总数量 |
adjust_num | 纠错数量 | | 调整量,正数或者负数 |
adjust_price | 纠错金额 | | 纠错金额 |
right_nums | 调整后数量 | | 调整后数量 |
right_price | 调整后总金额 | | 调整后总金额 |
stockin_no | 入库单号 | | 入库单号 |
wms_outer_no | 仓储外部编号 | | 默认为'',仓储外部编号 |
wms_status | 外部状态 | | 默认为'0',外部状态,与wms对接使用 0初始化 1失败 2成功 |
wms_result | 外部结果 | | 默认为'',外部结果,与wms对接使用 |
warehouse_id | 仓库id | | 默认为'0',仓库id |
src_order_type | 源单据类型 | | 1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 |
src_order_id | 源单据id | | 默认为'0',源单据id |
reason_id | 原因 | | 默认为'0',原因 |
fa_status | 财务同步状态 | | 默认为'0',财务同步状态 |
logistics_id | 物流公司 | | 默认为'0',物流公司 |
post_share_type | 邮费分摊类型 | | 默认为'0',邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊 |
operator_id | 操作员id | | 操作员id |
check_operator_id | 审核人id | | 默认为'0',审核人id |
goods_type_count | 货品种类数 | | 默认为'0',货品种类数 |
note_count | 便签数量 | | 默认为'0',便签数量 |
flag_id | 标记 | | 默认为'0',标记 |
modified | 最后修改时间 | | 最后修改时间 |
details_list | 明细节点 | | 响应参数的2级数据节点,包含采购入库货品明细属性信息,节点下数据字段详见下述“details_list” |
details_list.stockin_id | 入库单主键id | | 入库单主键id |
details_list.rec_id | 入库明细主键 | | 入库明细主键 |
details_list.src_order_detail_id | 上层单据明细主键 | | 上层单据明细主键 |
details_list.spec_no | 商家编码 | | 代表单品(sku)所有属性的编码,SKU概念介绍,单击这里 |
details_list.goods_count | 货品数量 | | 货品数量 |
details_list.discount | 优惠金额 | | 优惠金额 |
details_list.cost_price | 单价 | | 单价 |
details_list.production_date | 生产日期 | | 生产日期,格式:yyyy-MM-dd HH:mm:ss |
details_list.validity_days | 有效期天数 | | 有效期天数 |
details_list.expire_date | 有效期 | | 有效期,格式:yyyy-MM-dd HH:mm:ss |
details_list.src_price | 原价 | | 原价 |
details_list.tax_price | 税后价 | | 税后价 |
details_list.tax_amount | 税后金额 | | 税后金额 |
details_list.tax | 税率 | | 税率 |
details_list.total_cost | 总成本 | | 总成本 |
details_list.remark | 备注 | | 备注 |
details_list.adjust_num | 纠错数量 | | 调整量,正数或者负数 |
details_list.adjust_price | 纠错金额 | | 纠错金额 |
details_list.right_num | 调整后数量 | | 调整后数量 |
details_list.right_price | 调整后单价 | | 调整后单价 |
details_list.right_cost | 调整后总金额 | | 调整后总金额 |
details_list.brand_no | 品牌编号 | | 品牌编号 |
details_list.brand_name | 品牌名称 | | 品牌名称 |
details_list.goods_name | 货品名称 | | 货品名称 |
details_list.goods_no | 货品编号 | | 货品编号,代表SPU所有属性的唯一编号,用于获取系统货品的数据,SPU概念介绍,单击这里 |
details_list.spec_name | 规格名称 | | 规格名称 |
details_list.spec_code | 规格码 | | 规格码 |
details_list.prop2 | 自定义属性 | | 自定义属性 |
details_list.goods_unit | 单位名称 | | 单位名称 |
details_list.batch_no | 批次号 | | 批次号 |
details_list.batch_remark | 批次备注 | | 批次备注 |
details_list.position_no | 货位编号 | | 货位编号 |
details_list.src_order_type | 源单据类型 | | 1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 |
details_list.org_stockin_detail_id | 原始入库单明细 | | 默认为'0',原始入库单明细 |
details_list.spec_id | 规格id | | 规格id |
details_list.batch_id | 批次 | | 默认为'0',批次 |
details_list.position_id | 货位id | | 默认为'0',货位ID,入库时默认ID |
details_list.num | 数量 | | 默认为'0.0000',数量 |
details_list.num2 | 数量2 | | 默认为'0.0000',辅助数量 |
details_list.unit_id | 辅助单位 | | 默认为'0',辅助单位 |
details_list.base_unit_id | 基本单位 | | 默认为'0',基本单位 |
details_list.unit_ratio | 单位换算关系 | | 默认为'1.0000',单位换算关系 |
details_list.expect_num | 预期入库数量 | | 默认为'0.0000',预期入库数量 |
details_list.cost_price2 | 辅助成本价 | | 默认为'0.0000',辅助成本价 |
details_list.share_post_cost | 邮资分摊成本 | | 默认为'0.0000',邮资分摊成本 |
details_list.share_post_total | 邮资分摊总成本 | | 默认为'0.0000',邮资分摊总成本 |
details_list.modified | 最后修改时间 | | 最后修改时间 |
details_list.created | 创建时间 | | 创建时间 |
用友BIP接口明细
- API:/yonbip/scm/purinrecord/mergeSourceData/save
- NAME:采购入库来源生单保存
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
resubmitCheckKey | 保证请求的幂等性 | {{order_no}} | 该值由客户端生成,并且必须是全局唯一的长度不能超过32位。更多信息,请参见«MDD幂等性» |
mergeSourceData | 合并上游数据 | true | 固定值传入true。 |
needCalcLines | 表体行计算标识 | true | 固定值传入true。 |
calcLinesKey | 表体行计算依据 | oriTaxUnitPrice | 固定值传入true。 |
code | 单据编号 | {{order_no}} | 以系统编码规则配置为准:系统设置为手工编号时必输。系统设置为自动编号时非必输 |
vouchdate | 单据日期 | {{check_time date}} | 日期格式:YYYYMMDD |
bustype | 交易类型id | A15001 | 或交易类型code;业务流中未配置交易类型且未设置默认交易类型时必输。 |
warehouse | 仓库id | {{warehouse_no}} | 或仓库code;上游单据未指定仓库时必输 |
memo | 备注 | {{remark}} | |
status | 操作标识 | Insert | Insert:新增 |
purInRecords | 采购入库单子表 | details_list | |
purInRecords.makeRuleCode | 生单规则编码 | st_purchaseorder | 固定值。订单入库:st_purchaseorder订单退库:st_purchaseorder3,退货入库:st_purchaseorder_return,到货入库:pu_arrivalorder |
purInRecords.sourceid | 上游单据主表id | _findCollection find new_id from ff40fed7-afb6-3d42-b3cb-da2ef31b5d3a where code={{src_order_no}} product_cCode={{details_list.goods_no}} | |
purInRecords.sourceautoid | 上游单据子表id | findCollection find new_purchaseOrders_id from ff40fed7-afb6-3d42-b3cb-da2ef31b5d3a where code={{src_order_no}} product_cCode={{details_list.goods_no}} | |
purInRecords.qty | 数量 | {{details_list.right_num}} | 默认上游带入,若传入数量请确保表体行计算标识needCalcLines=true,并确认calcLinesKey是否符合实际业务场景 |
purInRecords.oriTaxUnitPrice | 含税单价 | _findCollection find oriTaxUnitPrice from ff40fed7-afb6-3d42-b3cb-da2ef31b5d3a where code={{src_order_no}} product_cCode={{details_list.goods_no}} | 仅在表头参数表体行计算标识needCalcLines=true,且calcLinesKey指定当前字段为计算依据时生效。 |
purInRecords.memo | 备注 | {{details_list.remark}} | |
purInRecords._status | 操作标识 | Insert | Insert:新增 |
系统集成总览
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。

