订单打通 - 尘锋SCRM开放平台

订单系统对接场景

客户在自有订单系统管理订单，将订单信息同步到尘锋进行展示，方便销售后续对联系人进行跟进。

业务架构图

场景举例：XX整形机构在三方系统存储有付费用户的订单，为了方便后续销售在尘锋平台针对付费用户进行精准化营销，从而进一步提升付费用户的复购率，需要将三方系统的订单导入导入至尘锋，以便销售能查看会员的订单情况。

当三方系统需要将订单导入至尘锋系统时，需进行以下操作：

第一步:获取联系人 ：调用“查询联系人”接口，来获取尘锋系统的联系人信息

第二步:获取员工：调用“查询员工信息”接口，获取员工信息，即在批量导入订单的时候，该订单希望指定给哪个员工及员工对应的部门

第三步:获取订单自定义字段：调用“获取订单自定义字段”接口，来获取订单自定义字段信息

订单自定义字段应用场景：举例：比如XX整形医院想在订单时备注客户的VIP卡号信息时，则可以通过自定义的配置方式来完成。

操作路径：在尘锋后台定义自定义字段-VIP卡号，通过“获取订单自定义字段”接口，获取该VIP字段的ID，往该字段传VIP卡号信息即可

4:获取商品信息：调用“获取商品列表”接口来获取商品的goodsId信息。该接口的调用是由于订单内的商品必须是尘锋已存在的商品，如该商品在尘锋不存在，请调用（新增商品）先创建商品信息。

创建商品信息时注意：

若外部系统商品有唯一的商品编码，可以将商品编码以code的值传入

商品创建成功后，将拿到尘锋的唯一商品goods_id，该值在尘锋系统内唯一，建议使用该值与自身商品做映射关联

code在尘锋系统中代表外部的商品编码，尘锋不做唯一性校验

该接口不支持批量调用，多个商品时请轮询调用创建即可

5:获取商品SkuId信息：通过返回的goodsId信息，调用“获取商品详情接口” 获取商品的SkuId信息。

SkuId：同一个商品（goodsId）可能会存在不同的规格（SKuId），所以在批量导入订单的时候，需要传对应的规格SkuId

6:批量订单导入：（新增&编辑订单）将三方系统订单信息导入至尘锋系统。

涉及接口清单：

接口名称	接口备注
查询联系人	使用接口鉴权说明调用授权。
查询员工信息	使用接口鉴权说明调用授权。
查询订单自定义字段	使用接口鉴权说明调用授权。
查询订单来源	使用接口鉴权说明调用授权。
查询商品列表	使用接口鉴权说明调用授权。
查询商品详情	使用接口鉴权说明调用授权。
新增&编辑订单	使用接口鉴权说明调用授权。用于第三方系统订单导入至尘锋（批量导入和单个订单导入）