# 订单打通 **订单系统对接场景** 客户在自有订单系统管理订单，将订单信息同步到尘锋进行展示，方便销售后续对联系人进行跟进。 **业务架构图** ​ ![img](https://wdcdn.qpic.cn/MTY4ODg1NzQwODQwNDA2Mw_841374_YDeXOcz2OU5QLhi2_1670815558?w=1000&h=830) **场景举例**：XX整形机构在三方系统存储有付费用户的订单，为了方便后续销售在尘锋平台针对付费用户进行精准化营销，从而进一步提升付费用户的复购率，需要将三方系统的订单导入导入至尘锋，以便销售能查看会员的订单情况。 ​ ![img](https://wdcdn.qpic.cn/MTY4ODg1NzQwODQwNDA2Mw_661315_FZsrwKGSPHM8j1rS_1670815623?w=1280&h=1443.7045203969128) 当三方系统需要将订单导入至尘锋系统时，需进行以下操作： - 第一步:**获取联系人** ：调用“查询联系人”接口，来获取尘锋系统的联系人信息 - 第二步:**获取员工**：调用“查询员工信息”接口，获取员工信息，即在批量导入订单的时候，该订单希望指定给哪个员工及员工对应的部门 - 第三步:**获取订单自定义字段**：调用“获取订单自定义字段”接口，来获取订单自定义字段信息 订单自定义字段应用场景：举例：比如XX整形医院想在订单时备注客户的VIP卡号信息时，则可以通过自定义的配置方式来完成。 操作路径：在尘锋后台定义 自定义字段-VIP卡号，通过“获取订单自定义字段”接口，获取该VIP字段的ID，往该字段传VIP卡号信息即可 ​ ![img](https://wdcdn.qpic.cn/MTY4ODg1NzQwODQwNDA2Mw_835696_yV18_-fx2eMLMNPk_1670815639?w=1000&h=855) 4:**获取商品信息**：调用“获取商品列表”接口来获取商品的goodsId信息。该接口的调用是由于订单内的商品必须是尘锋已存在的商品，如该商品在尘锋不存在，请调用（[新增商品](https://open.dustess.com/doc-5168124.md)）先创建商品信息。 **创建商品信息时注意：** - 若外部系统商品有唯一的商品编码，可以将商品编码以code的值传入 - 商品创建成功后，将拿到尘锋的唯一商品goods_id，该值在尘锋系统内唯一，建议使用该值与自身商品做映射关联 - code在尘锋系统中代表外部的商品编码，尘锋不做唯一性校验 - 该接口不支持批量调用，多个商品时请轮询调用创建即可 **5:获取商品SkuId信息**：通过返回的goodsId信息，调用“获取商品详情接口” 获取商品的SkuId信息。 SkuId： 同一个商品（goodsId）可能会存在不同的规格（SKuId），所以在批量导入订单的时候，需要传对应的规格SkuId **6:批量订单导入：**（[新增&编辑订单](https://open.dustess.com/doc-5168134.md)）将三方系统订单信息导入至尘锋系统。 **涉及接口清单：** | 接口名称 | 接口备注 | | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [查询联系人](https://open.dustess.com/doc-5147939.md) | 使用[接口鉴权说明](https://open.dustess.com/doc-5147803.md)调用授权。 | | [查询员工信息](https://open.dustess.com/doc-5158538.md) | 使用[接口鉴权说明](https://open.dustess.com/doc-5147803.md)调用授权。 | | [查询订单自定义字段](https://open.dustess.com/doc-5168136.md) | 使用[接口鉴权说明](https://open.dustess.com/doc-5147803.md)调用授权。 | |[查询订单来源](https://open.dustess.com/doc-5168128.md) | 使用[接口鉴权说明](https://open.dustess.com/doc-5147803.md)调用授权。 | | [查询商品列表](https://open.dustess.com/doc-5168121.md) | 使用[接口鉴权说明](https://open.dustess.com/doc-5147803.md)调用授权。 | | [查询商品详情](https://open.dustess.com/doc-5168122.md) | 使用[接口鉴权说明](https://open.dustess.com/doc-5147803.md)调用授权。 | | [新增&编辑订单](https://open.dustess.com/doc-5168134.md) | 使用[接口鉴权说明](https://open.dustess.com/doc-5147803.md)调用授权。用于第三方系统订单导入至尘锋（批量导入和单个订单导入） |