从旺店通·企业奇门到用友BIP通过接口配置打通数据|轻易云数据集成平台

从旺店通·企业奇门到用友BIP通过接口配置打通数据

接通系统：旺店通·企业奇门

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

集成系统:用友BIP

用友BIP助力行业龙头企业、产业链核心企业以及平台型企业建设产业互联网运营平台，通过运营、管理、协同配置和共享资源，实现产业链上下游连接与协同，并保障安全。

系统对接接口配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：旺店通·企业奇门，并且选择对应的连接器（关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询采购入库单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为用友BIP，并且选择对应连接器。选择对应的采购入库来源生单保存接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

旺店通·企业奇门接口明细

接口：wdt.stockin.order.query.purchase
接口名称：查询采购入库单
接口方法：POST

请求参数

字段	名称	类型	描述
start_time	开始时间	datetime	增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time	结束时间	datetime	增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
status	状态	string	入库单状态 10已取消20编辑中25待价格确认30待审核60待结算80已完成（默认80）
src_order_no	上层单据编号	string	上层单据编号，默认为采购单号，传该字段可以不传开始时间和结束时间
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号)
page_size	分页大小	string	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40，使用举例单击这里
page_no	页号	string	不传值默认从0页开始

响应参数

字段	名称	类型	描述
stockin_id	入库单主键id	string	入库单主键id
order_no	入库单号	string	入库单号
status	状态	string	10已取消20编辑中25待价格确认30待审核60待结算80已完成
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
warehouse_name	仓库	string	仓库
stockin_time	修改时间	string	修改时间，格式：yyyy-MM-dd HH:mm:ss
check_time	审核时间	string	审核时间，格式：yyyy-MM-dd HH:mm:ss
created_time	创建时间	string	创建时间，格式：yyyy-MM-dd HH:mm:ss
src_order_no	采购单号	string	采购单号
remark	备注	string	备注
stockin_reason	入库原因	string	入库原因
order_type	入库类型	string	入库类型（该接口只返回采购入库类型）
order_type_name	入库类型名称	string	入库类型名称（默认为采购入库）
goods_amount	货款总额	string	货款总额
total_price	总成本	string	总成本
discount	优惠	string	优惠
tax_amount	税后金额	string	税后金额
post_fee	邮费	string	邮费
other_fee	其他费用	string	其他费用
logistics_type	物流类型	string	物流方式，详情介绍，单击这里
logistics_code	物流公司编号	string	旺店通系统内物流公司编号
logistics_name	物流公司名称	string	旺店通系统内物流公司名称
logistics_no	物流单号	string	物流单号
purchase_no	采购单编号	string	采购单编号
provider_no	供应商编号	string	供应商编号
provider_name	供应商名称	string	供应商名称
outer_no	外部单号	string	上层单据的采购单号可做该入库单的外部单号
goods_count	货品总数量	string	货品总数量
adjust_num	纠错数量	string	调整量，正数或者负数
adjust_price	纠错金额	string	纠错金额
right_nums	调整后数量	string	调整后数量
right_price	调整后总金额	string	调整后总金额
stockin_no	入库单号	string	入库单号
wms_outer_no	仓储外部编号	string	默认为''，仓储外部编号
wms_status	外部状态	string	默认为'0'，外部状态,与wms对接使用 0初始化 1失败 2成功
wms_result	外部结果	string	默认为''，外部结果,与wms对接使用
warehouse_id	仓库id	string	默认为'0'，仓库id
src_order_type	源单据类型	string	1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库
src_order_id	源单据id	string	默认为'0'，源单据id
reason_id	原因	string	默认为'0'，原因
fa_status	财务同步状态	string	默认为'0'，财务同步状态
logistics_id	物流公司	string	默认为'0'，物流公司
post_share_type	邮费分摊类型	string	默认为'0'，邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊
operator_id	操作员id	string	操作员id
check_operator_id	审核人id	string	默认为'0'，审核人id
goods_type_count	货品种类数	string	默认为'0'，货品种类数
note_count	便签数量	string	默认为'0'，便签数量
flag_id	标记	string	默认为'0'，标记
modified	最后修改时间	string	最后修改时间
details_list	明细节点	array	响应参数的2级数据节点，包含采购入库货品明细属性信息,节点下数据字段详见下述“details_list”
details_list.stockin_id	入库单主键id	string	入库单主键id
details_list.rec_id	入库明细主键	string	入库明细主键
details_list.src_order_detail_id	上层单据明细主键	string	上层单据明细主键
details_list.spec_no	商家编码	string	代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
details_list.goods_count	货品数量	string	货品数量
details_list.discount	优惠金额	string	优惠金额
details_list.cost_price	单价	string	单价
details_list.production_date	生产日期	string	生产日期，格式：yyyy-MM-dd HH:mm:ss
details_list.validity_days	有效期天数	string	有效期天数
details_list.expire_date	有效期	string	有效期，格式：yyyy-MM-dd HH:mm:ss
details_list.src_price	原价	string	原价
details_list.tax_price	税后价	string	税后价
details_list.tax_amount	税后金额	string	税后金额
details_list.tax	税率	string	税率
details_list.total_cost	总成本	string	总成本
details_list.remark	备注	string	备注
details_list.adjust_num	纠错数量	string	调整量，正数或者负数
details_list.adjust_price	纠错金额	string	纠错金额
details_list.right_num	调整后数量	string	调整后数量
details_list.right_price	调整后单价	string	调整后单价
details_list.right_cost	调整后总金额	string	调整后总金额
details_list.brand_no	品牌编号	string	品牌编号
details_list.brand_name	品牌名称	string	品牌名称
details_list.goods_name	货品名称	string	货品名称
details_list.goods_no	货品编号	string	货品编号，代表SPU所有属性的唯一编号，用于获取系统货品的数据，SPU概念介绍，单击这里
details_list.spec_name	规格名称	string	规格名称
details_list.spec_code	规格码	string	规格码
details_list.prop2	自定义属性	string	自定义属性
details_list.goods_unit	单位名称	string	单位名称
details_list.batch_no	批次号	string	批次号
details_list.batch_remark	批次备注	string	批次备注
details_list.position_no	货位编号	string	货位编号
details_list.src_order_type	源单据类型	string	1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库
details_list.org_stockin_detail_id	原始入库单明细	string	默认为'0'，原始入库单明细
details_list.spec_id	规格id	string	规格id
details_list.batch_id	批次	string	默认为'0'，批次
details_list.position_id	货位id	string	默认为'0'，货位ID，入库时默认ID
details_list.num	数量	string	默认为'0.0000'，数量
details_list.num2	数量2	string	默认为'0.0000'，辅助数量
details_list.unit_id	辅助单位	string	默认为'0'，辅助单位
details_list.base_unit_id	基本单位	string	默认为'0'，基本单位
details_list.unit_ratio	单位换算关系	string	默认为'1.0000'，单位换算关系
details_list.expect_num	预期入库数量	string	默认为'0.0000'，预期入库数量
details_list.cost_price2	辅助成本价	string	默认为'0.0000'，辅助成本价
details_list.share_post_cost	邮资分摊成本	string	默认为'0.0000'，邮资分摊成本
details_list.share_post_total	邮资分摊总成本	string	默认为'0.0000'，邮资分摊总成本
details_list.modified	最后修改时间	string	最后修改时间
details_list.created	创建时间	string	创建时间

用友BIP接口明细

接口：/yonbip/scm/purinrecord/mergeSourceData/save
接口名称：采购入库来源生单保存
接口方法：POST

请求参数

字段	名称	类型	描述
resubmitCheckKey	保证请求的幂等性	string	该值由客户端生成,并且必须是全局唯一的长度不能超过32位。更多信息,请参见«MDD幂等性»
mergeSourceData	合并上游数据	string	固定值传入true。
needCalcLines	表体行计算标识	string	固定值传入true。
calcLinesKey	表体行计算依据	string	固定值传入true。
code	单据编号	string	以系统编码规则配置为准：系统设置为手工编号时必输。系统设置为自动编号时非必输
vouchdate	单据日期	string	日期格式:YYYYMMDD
bustype	交易类型id	string	或交易类型code；业务流中未配置交易类型且未设置默认交易类型时必输。
warehouse	仓库id	string	或仓库code；上游单据未指定仓库时必输
memo	备注	string
_status	操作标识	string	Insert:新增
purInRecords	采购入库单子表	array
purInRecords.makeRuleCode	生单规则编码	string	固定值。订单入库：st_purchaseorder订单退库：st_purchaseorder3，退货入库：st_purchaseorder_return，到货入库：pu_arrivalorder
purInRecords.sourceid	上游单据主表id	string
purInRecords.sourceautoid	上游单据子表id	string
purInRecords.batchno	批次号	string	批次管理的物料必输
purInRecords.producedate	生产日期	string	效期管理的物料必输
purInRecords.goodsposition	货位id	string	或货位code；仓库为货位仓且开启了货位记存量时必输
purInRecords.qty	数量	string	默认上游带入，若传入数量请确保表体行计算标识needCalcLines=true，并确认calcLinesKey是否符合实际业务场景
purInRecords.oriUnitPrice	无税单价	string	仅在表头参数表体行计算标识needCalcLines=true，且calcLinesKey指定当前字段为计算依据时生效。
purInRecords.oriTaxUnitPrice	含税单价	string	仅在表头参数表体行计算标识needCalcLines=true，且calcLinesKey指定当前字段为计算依据时生效。
purInRecords.natSum	本币含税金额	string	仅在表头参数表体行计算标识needCalcLines=true，且calcLinesKey指定当前字段为计算依据时生效。
purInRecords.memo	备注	string
purInRecords._status	操作标识	string	Insert:新增

系统数据对接

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。