ERP 接口配置

1. 概述

MISEB 系统支持与外部 ERP 系统对接，通过配置标准 API 接口和数据映射规则，实现商品、会员、订单等数据的互通。本章节主要介绍对接所需的 API 列表及数据映射配置。

2. ERP 必须 API 列表

为了确保系统功能的正常运行，ERP 端需要提供以下标准接口供平台调用。在 系统维护 -> ERP接口配置 中，您需要填写这些接口的具体地址。

接口 Key	描述	输出字段要求	输入参数
erp_dictionary_shop_list	获取门店列表	门店ID, 门店名称	-
erp_dictionary_member_level_list	获取会员级别列表	分类ID, 分类名称	-
erp_dictionary_product_cateogry_list	获取商品分类列表	分类ID, 分类名称, 父级分类ID	-
erp_base_product_list	获取商品列表	商品ID, 名称, 定价, 条形码, 会员价, 库存	商品编码, 名称, 定价, 条形码
erp_base_product_by_id	获取指定商品详情	商品ID, 名称, 定价, 条形码, 会员价, 库存	-

3. 数据映射配置

配置好 API 接口后，需要在 系统维护 -> ERP数据关联 中建立平台数据与 ERP 数据的映射关系。

3.1 映射数据类型

目前支持以下核心数据的映射：

• 商品：建立平台商品与 ERP 商品的对应关系，实现库存和价格同步。
• 会员（C端用户）：关联平台用户与 ERP 会员，实现积分、余额互通。
• 商品平台分类：关联商品分类结构。
• 商品商户分类：关联商户内的自定义分类。
• 用户等级：关联会员等级权益。
• 订单：推送平台订单至 ERP 系统。

3.2 映射表说明

系统使用关联表存储映射关系，主要包含：

• ERP数据主键：外部系统中的唯一标识。
• 平台数据主键：MISEB 系统中的 ID。
• 创建日期：建立关联的时间。

通过这些映射，系统能够在业务流转时准确地转换数据 ID，确保两端数据的一致性。